Ejemplos de reglas que se crean desde una instancia y un esquema de mensaje

Las reglas empresariales y los parámetros dependen de un esquema.

El ejemplo siguiente muestra cómo el mensaje de entrada y esquema XML se relacionan con los parámetros que se pasan a las reglas empresariales. El ejemplo también muestra la lógica empresarial que las reglas aplican a los datos del mensaje.

Considere el ejemplo siguiente de esquema.
<?xml version="1.0" encoding="UTF-8"?><xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <xsd:element name="purchase" type="purchseType"/>
  <xsd:complexType name="purchaseType">
    <xsd:sequence>
      <xsd:element name="items" type="orderType"/>
      <xsd:element name="company" type="xsd:string"/>
    </xsd:sequence>
  </xsd:complexType>

  <xsd:complexType name="orderType">
    <xsd:sequence>
      <xsd:element maxOccurs="unbounded" minOccurs="1" name="nextitem" type="sale"/>
    </xsd:sequence>
  </xsd:complexType>

  <xsd:complexType name="sale">
    <xsd:sequence>
      <xsd:element name="title" type="xsd:string"/>
      <xsd:element name="price" type="xsd:decimal"/>
      <xsd:element name="quantity" type="xsd:integer"/>
    </xsd:sequence>
  </xsd:complexType>
</xsd:schema>
El mensaje de entrada siguiente utiliza el esquema anterior.
<purchase xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="simple.xsd">
  <items>
    <nextitem>
      <title>one</title>
      <price>1.0</price)
      <quantity>1</quantity>
    </nextitem>
    <nextitem>
      <title>two</title>
      <price>2.0</price>
      <quantity>2</quantity>
    </nextitem>
  </items>
  <company>the company</company>
</purchase>
El elemento <items> en la instancia del mensaje contiene un elemento de repetición, <nextitem>. Una regla que se escribe para cambiar un elemento en esa estructura de repetición (por ejemplo, el valor en el campo "price") debe utilizar una construcción de reglas empresariales que puedan acceder a un elemento de repetición. Puede utilizar la construcción "for each" con la condición "if...then" para acceder al elemento de repetición, tal como se muestra en el ejemplo siguiente:
if <condition met> then
for each <object> [called <variable>,] in <list>:
  - <action>;*
En este ejemplo, "object" es el objeto actual (en este caso, el elemento de repetición) y "list" es el padre del elemento de repetición.
Si este ejemplo contiene un parámetro de entrada (con la verbalización predeterminada de "parameter") que es el tipo de elemento raíz "purchaseType", se puede escribir una regla que cambie el precio en cada elemento de repetición:
Si la compañía del parámetro contiene "the",
para cada venta de elementos de parámetro: 
  - establezca el precio de esta venta en 99; 
(Para obtener una guía de consulta sobre el Lenguaje de acciones de negocio (BAL), que se utiliza para crear las reglas empresariales, consulte IBM® Operational Decision Manager Version 8.5 Information Center online.)
En este ejemplo, se proporciona un parámetro de entrada que tiene el tipo raíz del mensaje. Se utilizan dos partes del mensaje en esta regla: el nombre de la empresa y el precio de cada elemento que se solicita. Por lo tanto, en lugar de pasar un parámetro, que es el mensaje entero, puede pasar dos parámetros: La regla se puede construir tal como se muestra en el siguiente ejemplo.
si 'the name of the company' contiene "the",
para cada venta en nextitems del parámetro: 
  -establezca el precio de esta venta en 55;  
Este ejemplo también muestra cómo pasar un tipo simple como un parámetro, en lugar de un tipo complejo. En el campo Ubicación de datos de la tabla de parámetros del nodo DecisionService, añadiría las siguientes expresiones XPath para cada parámetro:

La elección de si se pasa un solo parámetro o varios parámetros depende hasta cierto punto del tamaño del mensaje. Las reglas empresariales se basan en un esquema, por lo tanto, los parámetros se forman como documentos de instancia XML, y luego se pasan a las reglas para la evaluación. Si un parámetro está definido como un tipo complejo que puede contener contenido grande, este contenido se serializa y se vuelve a analizar para la evaluación de las reglas. Si las reglas sólo evalúan parte del contenido, el rendimiento y el uso de la memoria se pueden mejorar si los parámetros van destinados a las estructuras anidadas específicas.

Además, tenga en cuenta que un cambio que realice en una estructura anidada puede sobrescribirse por un cambio realizado en la estructura padre. Por lo tanto, al añadir expresiones XPath de ubicación de datos, evite acceder a los campos anidados padre e hijo en un árbol de mensajes.

Cuando crea reglas empresariales, está considerando los objetos de negocio a los que aplicar la regla. Por lo tanto, si tiene un esquema que describe un pedido de cliente, pase el tipo de pedido para el pedido, en lugar de los componentes individuales del pedido (como por ejemplo, el pedido de cliente, y los artículos solicitados). Sin embargo, también debe tener en cuenta el tamaño del mensaje. Si el mensaje es grande, puede intentar reducir el tiempo de proceso pasando tipos que definen una pequeña parte del mensaje en lugar del mensaje completo.

Formato XML

Para cada parámetro de una regla, el nodo DecisionService crea un documento de instancia XML, que se pasa a las reglas para la evaluación. Cuando se han evaluado todas las reglas, el nodo DecisionService recibe de nuevo los documentos XML para cada parámetro. A continuación, el nodo DecisionService analiza el XML de cada parámetro y llena el árbol de mensajes de salida, sustituyendo la estructura XML existente que se ha pasado al conjunto de reglas. Sin embargo, las partes de la estructura XML que están clasificadas como formato no se conservan. Por lo tanto, si el nodo DecisionService procesa un mensaje XML que se obtiene de los parámetros del servicio de decisiones, el formato y el contenido que no están relacionados con el esquema XML podrían perderse.

Considere la estructura siguiente:
Person:
 - FirstName
 - Surname
 - DateofBirth
 - Address
 - AdditionalInfo
Cuando se crea un servicio de decisiones para trabajar con esta estructura XML, puede pasar un parámetro, "Person" y, a continuación, utilizar los campos para este parámetro. O bien, puede pasar los 5 parámetros para "FirstName", "Surname", "DateofBirth", "Address" y "AdditionalInfo".
Los mensajes XML tienen previsto el formato siguiente:
<Person>
 <!-- A continuacion viene el nombre de la persona-->
 <FirstName>John</FirsName>
 <!-- A continuación viene el apellido de la persona -->
 <Surname>Smith</Surname>
 <!-- A continuación viene la fecha de nacimiento en formato dd/mm/aaaa -->
 <DateofBirth>01/01/1970</DateofBirth>
 <!-- A continuación, viene la dirección de la persona -->
 <Address>123 High Street, London</Address>
 <AdditionalInfo></AdditionalInfo>
</Person> 
En este caso, si pasa "Person" como un parámetro individual, se pierden los comentarios y el espacio en blanco adicional entre los códigos. Sin embargo, para conservar los comentarios, pase los 5 parámetros hijo.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última actualización:
        
        Última actualización: 2013-07-16 12:52:51


Tema de conceptoTema de concepto | IBM Integration Bus Versión 9.0.0.0 | bc23820_