Criando valores de processo expostos (EPVs)

No IBM® Process Designer, é possível criar valores de processo expostos (EPVs) para definir um conjunto de variáveis que você deseja expor a usuários específicos. Essas variáveis podem ser modificadas pelos usuários enquanto instâncias de um processo estão em execução. Por exemplo, se você criar um processo para manipular expense reimbursement, você talvez queira ativar supervisores para alterar os valores permitidos para as despesas diariamente, ou a quantidade em dólares que coincide com vários níveis de aprovadores. Criando EPVs, é possível fornecer este tipo de flexibilidade, permite que os usuários ajustem valores específicos das variáveis como constantes, afetando, assim o fluxo de todas as instâncias de processo em execução, as designações de tarefas, e assim por diante.

O EPV retornado depende da configuração de Tarefas em andamento usam novos valores; ele é desconfigurado por padrão.

Se Tarefas em andamento usam novos valores estiver configurado, a API tw.epv retornará o EPV que tiver uma data Em vigor em no passado e que estiver mais perto da hora atual.
Se Tarefas em andamento usam novos valores estiver desconfigurado, a API tw.epv usará o horário em que a instância de tarefa iniciou, o que significa que ela localizará o EPV que tiver uma data Em vigor em no passado e estiver mais perto do horário em que a instância de tarefa iniciou.

Durante a migração, o último EPV é copiado da captura instantânea anterior para a atual. Para evitar um comportamento inesperado,

Verifique suas configurações para garantir que o comportamento é o que você espera.
Configure um valor padrão para o EPV.

Procedimento

Abra o IBM Process Designer.
Expanda Data e selecione Exposed Process Value. A janela Novo Exposed Process Value é aberta.
No campo Nome , digite um nome para o valor e clique em Concluir. A visualização da configuração EPV é aberta.
Configure o EPV:
1. No campo Documentação , insira uma descrição da EPV para os desenvolvedores.
2. Para permitir que os usuários enviar feedback sobre este EPV, digite um endereço de email no campo Contato de Email para Feedback .
  A página Gerenciar Exposed Process Valores no Process Admin Console inclui um link de feedback que utiliza esse endereço de e-mail.
3. No campo Descrição Externa , insira uma descrição da EPV para os usuários. A descrição que você fornece aqui é exibida na página Gerenciar Valores de Processo Expostos no Process Admin Console.
Inclua uma ou várias variáveis para o EPV, aplicando as seguintes etapas:
1. Na seção Variáveis de valor do processo exposto, clique em + para incluir uma variável para este EPV.
  Por exemplo, se você desejar permitir que os usuários ajustem as quantias em dólar que correspondem com vários níveis de aprovadores para um processo de expense reimbursement, inclua uma variável para cada nível disponível.
2. Na seção Detalhes da Variável, no campo Nome Externo , digite o nome da variável para os usuários. Esse nome aparece na Lista de Variáveis para esse EPV no Process Admin Console.
3. No campo Nome de Variável , digite o nome da variável para processamento interno.
  Nota: Os nomes de variáveis devem começar com uma letra minúscula, com as palavras subsequentes alteradas para letras maiúsculas da seguinte forma: myVar. Não use espaços em nomes de variáveis. Os nomes fazem distinção entre maiúsculas e minúsculas.
4. No campo Descrição Externa , digite o texto para descrever esta variável para os usuários. Essa descrição aparece na Lista de Variáveis para este EPV no Process Admin Console.
5. Opcional: Na caixa de texto Valor Padrão , digite um padrão válido para essa variável.
6. Para permitir que as tarefas em andamento usem o valor atualizado dessa variável quando os usuários editam seu valor, selecione a caixa de seleção Usar novos valores.
7. Para selecionar um tipo de variável, clique em Selecionar... e selecione um objeto de negócios ou clique em Novo para criar um objeto de negócios customizado novo (tipo de variável).
  Nota: É necessário ter cuidado ao usar um tipo não sequencial para variáveis EPV. O uso de tipos não sequenciais não é recomendado e pode resultar em problemas com a conversão de tipo JavaScript. Se é necessário usar um tipo não sequencial para variáveis EPV, consulte a seção "Exemplo" abaixo.
Na seção Expondo, clique em Selecionar para escolher a equipe cujos membros poderão gerenciar esse EPV e ajustar seus valores de variável.
Clique em Salvar ou Concluir edição.

Resultados

O EPV é criado, é possível ligá-lo a um processo, serviço ou relatório.

É possível referir-se ao nome do EPV e suas variáveis, como: tw.epv.[epv_name].[epv_variable_name].

É possível utilizar o EPV em um gateway de decisão para controlar o fluxo de um processo. Também é possível referir-se ao EPV de qualquer código JavaScript em um processo vinculado, como o código dentro de um componente de serviço de script de servidor.

Exemplo

Para usar um número inteiro ou tipo decimal para uma variável EPV (em vez do tipo de sequência recomendado), é necessário considerar a criação de uma variável local correspondente do número inteiro ou tipo decimal. A operação deve ser executada na variável local em vez disso, por exemplo

tw.local.number = tw.epv.myepvs.number; tw.local.number = tw.local.number + 1;

Alternativamente, para utilizar variáveis EPV no código JavaScript, é necessário usar cast de tipo, por exemplo

var mynumber = parseFloat(tw.epv.myepvs.number);