Definición de objetos de negocio para habilitar el flujo de información bidireccional (en desuso)

Puede utilizar la documentación de parámetros de un objeto de negocio para definir cómo puede configurarse un flujo bidireccional entre la transacción SAP de la interfaz de usuario HTML de SAP y la instancia de proceso en IBM® BPM.

Acerca de esta tarea

Cada parámetro del objeto de negocio está enlazado con uno o varios elementos HTML de la pantalla de transacciones SAP. La información de enlace se proporciona en forma de uno o más descriptores en el campo Documentación de cada parámetro.

Para obtener más información sobre cómo definir los descriptores y selectores para habilitar el flujo de información bidireccional, revise la información siguiente y el ejemplo proporcionado más adelante en este tema.

Tema principal: Habilitación del flujo de información entre las transacciones de SAP e IBM BPM (en desuso)

Definición de descriptores

Acerca de esta tarea

Los descriptores siguientes pueden especificarse manualmente en la documentación de cada parámetro.
Tabla 1. Descriptores que se pueden definir manualmente en la documentación de parámetros
Descriptor Descripción Valores válidos Valor predeterminado Ejemplo
selector Un selector CSS obligatorio que especifica la ubicación del elemento HTML. ANY EMPTY selector = span[id='helloworld']
input Un parámetro booleano que especifica si el parámetro de transacción es de tipo entrada o salida. true o false true input=false
readonly Si readonly se establece en true, el elemento HTML localizado no se puede modificar manualmente. true o false false readonly=true
required Si necesaria se establece en true, el valor capturado de este parámetro no puede estar vacío; de lo contrario, la actividad no se puede completar. sólo se aplica cuando input se establece en false. true o false false required=true
extractregex Una expresión regular que extrae el valor del elemento HTML seleccionado. Para obtener más información, consulte Expresiones regulares. ANY EMPTY extractregex =\s\d+?(?=se ha guardado)

Extrae una serie de tipo entero antes de la serie "se ha guardado" del valor capturado.
format Una expresión regular que formatea el valor de salida. Si los datos no se ajustan al formato, el valor se ignora. Para obtener más información, consulte Expresiones regulares. ANY EMPTY format=1\d+

El valor debe ser una serie de tipo entero a partir de 1.
exclude Una matriz JSON que especifica qué valor o valores deben ignorarse. Si el valor capturado se encuentra dentro de la matriz, se ignora. Matriz JSON ANY Matriz JSON EMPTY exclude=[‘exclude1’, ‘exclude2’]

Los valores ‘exclude1’ y ‘exclude2’ se ignoran.

Definición de selectores

Acerca de esta tarea

Utilice el selector CSS para localizar el elemento HTML en que desea rellenar datos o del que desea capturar datos. Son necesarios algunos conocimientos de desarrollo para definir el selector. Para localizar el elemento HTML de destino, puede utilizar un atributo identificador del elemento HTML o de su padre. Utilizando la información HTML localizada, puede utilizar patrones de selector para definir el descriptor de selector.

Contenido HTML en elementos supervisados

Acerca de esta tarea

Para localizar el contenido de HTML de un elemento de destino, complete los pasos siguientes en Mozilla Firefox:

Procedimiento

  1. Abra Mozilla Firefox.
  2. Pulse Herramientas > Desarrollador web > Inspector. Se abre la vista Inspector.
  3. Pulse el icono Seleccionar elemento con el ratón icono Seleccionar elemento con el ratón en el extremo superior izquierdo de la ventana de la vista Inspector.
  4. Seleccione el elemento que desea supervisar y, a continuación, localice el contenido HTML del elemento seleccionado.

Patrones de selector

Acerca de esta tarea

En la tabla siguiente se proporcionan algunos de los patrones que se pueden utilizar para definir el descriptor de selector final. Sin embargo, la definición de selector puede ser muy flexible.

La definición de selector se utiliza para localizar el elemento HTML que se desea supervisar. Cada elemento HTML pueden tener muchos selectores válidos. Para seleccionar el selector correcto, asegúrese de que pueda utilizarse el selector CSS para localizar lo que desea. Para obtener más información, consulte la Referencia de selector CSS.

Tabla 2. Resumen de patrones de selector
Condición Pattern Ejemplo de elemento Ejemplo de selector
Si el elemento seleccionado tiene un atributo de ID exclusivo 
{tagName}[id=’{ID Value}’]
 
<input id=”inputid” type=”text”/>
 
selector=input[id=’inputid’]
Si el padre del elemento seleccionado tiene un ID exclusivo 
{parent’s tagName}[id=’{parent’s ID}’] > {tagName}:nth-child ({child index})
 
<div id="parent">
	<div class="child">
	<div class="child"></div>
</div>
 
selector=div[id=’parent’] > div: nth-child(2)
Si el elemento seleccionado tiene un valor de atributo exclusivo que puede utilizarse como identificador 
{tagName}[{attributeName}={attributeValue}]
 
<div class="a"></div>
<div class="a" unique="b"></div>
 
selector=div[unique=’b’]
Si el valor de atributo varía en función del sistema, pero contiene una parte coherente. Por ejemplo, "myuni1" y "myuni2" son posibles valores del atributo, pero ambos contienen 'myuni'. 
{tagName}[{attributeName}*={attributePattern}]
 
<div class=”a” unique=”myuni1”></div>
 
selector=div[unique*=’myuni’]
Si este parámetro corresponde a una columna de tabla 
{table selector} > tbody>tr>td:nth-of-type({column index})
 
<table id="tableId">
<tbody>
<tr><td></td><td></td></tr>
<tr><td></td><td></td></tr>
<tr><td></td><td></td></tr>
</tbody>
</table>
 
selector=table[id='tableId']>tbody>tr>td:nth-of-type(2)

Ejemplo

Acerca de esta tarea

El ejemplo siguiente ilustra cómo puede utilizarse la documentación de parámetros para los objetos de negocio CreateOrder y CreateOrder_Material para rellenar datos de la transacción VA01 y capturar datos de ella.

Tabla 3. Documentación de parámetros para los objetos de negocio CreateOrder y CreateOrder_Material
Objeto de negocio: CreateOrder
Parámetro Documentación
DistributionChannel 
input=true 
selector=input[id*='__AGIM0:U:::6:22']
Division 
input=true 
selector=input[id*='__AGIM0:U:::7:22']
NetValue 
selector=input[id*='input#__AGIM0:U:1::0:56'] 
input=false 
exclude=['0,00']
orderId 
selector=span[id=‘messagebar’]
input=false
required=true
extractRegex=\d+
exclude=['0,00']
Objeto de negocio: CreateOrder_Material
Parámetro Documentación
quantity 
input=true
selector=[id='__AGIM0:U:2:3:2:1-mrss-cont-none-content']>tbody>tr>td:nth-of-type(1)
material 
input=true
selector=[id='__AGIM0:U:2:3:2:1-mrss-cont-left-content']>tbody>tr>td:nth-of-type(3)