Cada etapa em um processo pode ter uma condição prévia. Essa condição prévia
determina se a etapa é executada. Assim como os scripts de pós-processamento, as condições prévias
usam JavaScript.
As condições prévias retornam valores booleanos. Se a condição prévia retornar True, a
etapa será executada como de costume.
Se a condição prévia retornar algo diferente de True, o processo
ignorará essa etapa. Na solicitação de processo, a etapa é rotulada como "Condição prévia
com falha". No entanto, neste caso, o processo continua a ser executado; o
processo segue os links de sucesso dessa etapa como se a etapa
tivese sido bem-sucedida.
A condição prévia tem acesso às mesmas propriedades que a etapa. Por exemplo, os
processos de aplicativos têm acesso às seguintes propriedades:
- Propriedades de aplicativos
- Propriedades de processos de aplicativos
- Propriedades de ambiente, incluindo propriedades do ambiente do componente
- Propriedades de sistemas
Depois de executar um processo, é possível ver as
propriedades às quais o processo teve acesso abrindo a solicitação de processo e clicando
na guia
Propriedades.
Para acessar uma propriedade, use o comando
properties.get().
Por
exemplo, o código a seguir recupera o valor de uma propriedade de aplicativo:
properties.get("application/property1")
A condição prévia de exemplo a seguir permite que a etapa seja executada apenas se a
propriedade de aplicativo
property existir e não for nula:
properties.get("application/property1") !== undefined &&
properties.get("application/property1") !== null &&
properties.get("application/property1") !== ""
Scripts de condição prévia podem acessar as propriedades do processo. Por exemplo, se
o processo tiver uma propriedade denominada
processProperty1, você
poderá acessar essa propriedade com o seguinte código:
properties.get("processProperty1")
Os scripts de condição prévia em processos de componentes e processos genéricos podem
acessar as propriedades de saída das etapas anteriores. Por exemplo, suponha que o script
de pós-processamento de uma etapa denominada
Step1 especifique uma
propriedade denominada
OutputProp1. O script de condição prévia a seguir
só permitirá que outra etapa seja executada se o valor dessa propriedade for
value1:
properties.get("Step1/OutputProp1") == "value1"
As condições prévias têm acesso a uma propriedade denominada
hasFailures.
Essa propriedade será
true se qualquer
uma das etapas no processo falhar. Será indefinida se nenhuma etapa falhar. Por exemplo,
para executar uma etapa apenas se nenhuma outra etapa no processo falhar, use a condição
prévia a seguir:
properties.get('hasFailures') == undefined