Para establecer un tiempo de espera controlado, envíe un mensaje con un conjunto de elementos con nombres conocidos a un nodo TimeoutControl. Estos elementos controlan las propiedades del tiempo de espera que se va a crear o suprimir.
El ejemplo siguiente muestra los elementos y el formato de un mensaje de petición de tiempo de espera, mostrando los nombres conocidos y los valores permisibles.
<TimeoutRequest>
<Action>SET | CANCEL</Action>
<Identifier>String (cualquier serie alfanumérica)</Identifier>
<StartDate>String (TODAY | aaaa-mm-dd)</StartDate>
<StartTime>String (NOW | hh:mm:ss)</StartTime>
<Interval>Integer (segundos)</Interval>
<Count>Integer (mayor que 0 o -1)</Count>
<IgnoreMissed>TRUE | FALSE</IgnoreMissed>
<AllowOverwrite>TRUE | FALSE</AllowOverwrite>
</TimeoutRequest>
La siguiente tabla describe los campos del mensaje. La columna con la cabecera M indica si la propiedad es obligatoria y la columna con la cabecera C indica si la propiedad es configurable.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Action | Sí | No | Ninguno | Establezca este elemento en SET o CANCEL. Se generará un error si omite este elemento o lo establece con un valor distinto. Si lo establece en CANCEL, el único otro elemento que se necesita es el identificador que debe coincidir con el identificador de la petición de tiempo de espera que se debe cancelar. |
Identifier | Sí | No | Ninguno | Entre una serie de caracteres alfanumérica. Se generará un error si omite este elemento. |
StartDate | No | No | TODAY | Establezca este elemento en TODAY o en una fecha especificada en formato aaaa-mm-dd. El valor predeterminado es TODAY. |
StartTime | No | No | NOW | Establezca este elemento en NOW o en una hora
futura especificada en formato hh:mm:ss. El valor predeterminado es NOW. Se supone que la hora de inicio es la hora local del intermediario. La hora de inicio puede calcularse añadiendo un intervalo a la hora actual. Si se produce un retraso entre el nodo que calcula la hora de inicio y el nodo TimeoutControl, la hora de inicio en el mensaje habrá pasado cuando llegue al nodo TimeoutControl. Si la hora de inicio es anterior a los cinco minutos, aproximadamente, anteriores a la hora actual, se emite un aviso y el nodo TimeoutControl rechaza la petición de tiempo de espera. Si la hora de inicio está dentro de los cinco minutos anteriores a la hora actual, el nodo procesa la petición como si fuera inmediata. Por lo tanto, asegúrese de que la hora de inicio en el mensaje de petición de tiempo de espera sea ahora una hora futura. |
Interval | No | Sí | 0 | Establezca este elemento en un entero que especifique el número de segundos entre propagaciones del mensaje. El valor predeterminado es 0. |
Count | No | Sí | 1 | Establezca este elemento en un valor entero que sea mayor que 0 ó -1 (que especifica una petición de tiempo de espera que no termina nunca). El valor predeterminado es 1. |
IgnoreMissed | Sí | No | TRUE | Establezca este elemento en TRUE (verdadero) o FALSE (falso)
para controlar si los tiempos de espera que se producen mientras el intermediario o
el flujo de notificaciones de tiempo de espera se ha detenido se procesarán la
siguiente vez que el intermediario o el flujo de notificaciones de tiempo de espera
se inicie. El valor predeterminado es TRUE, lo que significa que el nodo
TimeoutNotification ignorará los tiempos de espera no logrados cuando se
inicie el intermediario o el flujo de
mensajes. Si este valor se establece en FALSE, el nodo TimeoutNotification
procesará inmediatamente todos
los tiempos de espera que falten cuando se inicie el flujo. Es necesario establecer la propiedad Persistencia de peticiones del nodo TimeoutControl en Sí o Automático (siendo persistente el mensaje de petición de origen) para que los tiempos de espera almacenados se conserven después del reinicio del intermediario o del flujo de notificación del tiempo de espera. |
AllowOverwrite | N | N | TRUE | Establezca este elemento en TRUE o FALSE para indicar si las peticiones subsiguientes de tiempo de espera que tengan un Identificador coincidente pueden sobrescribir esta petición de tiempo de espera. El valor predeterminado es TRUE. |
Establezca la Ubicación de peticiones en el nodo TimeoutControl en InputRoot.XML.TimeoutRequest para leer estas propiedades. Si desea obtener propiedades de una parte distinta del mensaje, especifique el nombre de correlación adecuado para el elemento padre de las propiedades. El nombre de correlación del elemento padre puede estar en el entorno local.
Para obtener detalles sobre cómo TimeoutControl utiliza estos valores, consulte Nodo TimeoutControl