Para configurar um tempo limite controlado, envie uma mensagem com um conjunto de elementos com nomes bem conhecidos para um nó TimeoutControl. Estes elementos controlam as propriedades do tempo limite a serem criadas ou excluídas.
O exemplo a seguir mostra os elementos e formato de uma mensagem de pedido de tempo limite, mostrando nomes bem conhecidos e valores permitidos.
<TimeoutRequest>
<Action>SET | CANCEL</Action>
<Identifier>String (any alphanumeric string)</Identifier>
<StartDate>String (TODAY | yyyy-mm-dd)</StartDate>
<StartTime>String (NOW | hh:mm:ss)</StartTime>
<Interval>Integer (seconds)</Interval>
<Count>Integer (greater than 0 or -1)</Count>
<IgnoreMissed>TRUE | FALSE</IgnoreMissed>
<AllowOverwrite>TRUE | FALSE</AllowOverwrite>
</TimeoutRequest>
A tabela a seguir descreve os campos na mensagem. A coluna com o título M indica se a propriedade é obrigatória e a coluna com título C indica se a propriedade é configurável.
Propriedade | M | P | Padrão | Descrição |
---|---|---|---|---|
Ação | SIM | Não | Nenhuma | Defina esse elemento para SET ou CANCEL. Um erro é gerado se você omitir esse elemento ou defini-lo para um valor diferente. Se você defini-lo para CANCEL, o outro único elemento que é exigido é o Identifier, que deve corresponder ao Identificador de TimeoutRequest que deve ser cancelado. |
Identificador | SIM | Não | Nenhuma | Digite uma cadeia alfanumérica. Um erro é gerado se você omitir esse elemento. |
StartDate | Não | Não | TODAY | Defina esse elemento para TODAY ou para um data especificada no formato aaaa-mm-dd. O valor padrão é TODAY. |
StartTime | Não | Não | NOW | Configure este elemento como NOW ou como uma hora no futuro especificada
no formato hh:mm:ss. O valor padrão é NOW. StartTime supõe-se que seja a hora local do intermediário. A hora de início pode ser calculada incluindo um intervalo na hora atual. Se ocorrer um atraso entre o nó que calcula a hora de início e o nó TimeoutControl, a hora de início na mensagem terá decorrido no momento em que atingiu o nó TimeoutControl. Se a hora de início for maior do que aproximadamente cinco minutos no passado, será emitido um aviso e o nó TimeoutControl rejeitará o pedido de tempo limite. Se a hora de início for menor do que cinco minutos no passado, o nó processará o pedido como se ele fosse imediato. Portanto, assegure que a hora de início na mensagem de pedido de tempo limite seja agora ou uma hora no futuro. |
Intervalo | Não | SIM | 0 | Defina esse elemento para um inteiro que especifica o número de segundos entre as propagações da mensagem. O valor padrão é 0. |
Count | Não | SIM | 1 | Defina esse elemento para um valor inteiro que seja maior que 0 ou seja -1 (o que especifica um pedido de tempo limite que nunca expira). O valor padrão é 1. |
IgnoreMissed | SIM | Não | TRUE | Configure este elemento como TRUE ou FALSE para controlar se os tempos limite
que ocorrem enquanto o intermediário ou o fluxo de notificação de tempo limite é parado
serão processados na próxima vez em que o intermediário ou fluxo de notificação de tempo limite
for iniciado. O valor padrão é TRUE, o que significa que os tempos limites ausentes são ignorados
pelo nó TimeoutNotification quando o intermediário ou o
fluxo de mensagens é iniciado. Se esse valor for definido para FALSE,
os tempos limites ausentes serão processados imediatamente pelo nó TimeoutNotification quando o fluxo for iniciado. Você deve definir a propriedade Persistência de Pedido do nó TimeoutControl para Sim ou Automático (com a mensagem de pedido original sendo persistente) para os tempos limites armazenados persistirem além da reinicialização do intermediário ou do fluxo de notificação de tempo limite. |
AllowOverwrite | N | N | TRUE | Defina esses elementos para TRUE ou FALSE, para especificar se os pedidos de tempo limite subseqüentes com um Identificador de correspondência podem sobrescrever esse pedido de tempo limite. O valor padrão é TRUE. |
Configure o Local do Pedido no nó TimeoutControl como InputRoot.XML.TimeoutRequest para ler estas propriedades. Se desejar obter propriedades de uma parte diferente de sua mensagem, especifique o nome de correlação apropriado para o elemento-pai para propriedades. O nome de correlação para o elemento-pai pode estar no ambiente local.
Para obter detalhes sobre como o TimeoutControl utiliza estes valores, consulte Nó TimeoutControl