Criando interfaces com o usuário para instâncias de processo

Para criar uma interface com o usuário da instância de processo, primeiro crie um serviço manual do lado do cliente que inclua uma página gerada. É possível, então, criar sua interface customizada, modificando o serviço e a página gerados.

1. Abra o processo para o qual você deseja criar a interface com o usuário.
2. Alterne para a página Visualizações .
3. Selecione a interface que deseja criar, por exemplo, Padrão em UI de Detalhes ou UI de Ativação.
4. Clique em Novo ao lado de Serviço manual do lado do cliente e insira um nome para sua interface com o usuário.
5. Clique em Avançar.
   Na página Novo serviço manual do lado do cliente, você vê uma lista de variáveis que podem passar e retornar do serviço manual do lado do cliente.

   Não é necessário mapear as variáveis entre o processo e o serviço manual. As variáveis do processo já são mapeadas para as variáveis de serviço manual com o mesmo nome.

6. Clique em Concluir.
7. O editor de serviços manuais do lado do cliente é aberto. Alterne para a página Variáveis
   Observe que as variáveis de entrada e saída que são mapeadas a partir do processo são bloqueadas. É possível editar essas variáveis apenas no editor de processos. Você pode, no entanto, incluir variáveis privadas que estão disponíveis apenas para o serviço manual.

   Se você estiver criando uma UI de ativação, uma variável cancelLaunch do tipo Booleano será gerada. O valor padrão é false. Somente é possível visualizar esta variável, não é possível a alterar ou a excluir. O valor da variável é configurado pelo serviço manual da UI de Ativação. Se o valor de cancelLaunch for true quando um usuário concluir o serviço manual durante a ativação, a ativação será cancelada. Se o valor for false, o processo será iniciado.

8. Alterne para a página Diagrama ..
   Um diagrama básico é gerado para você. Se você estiver criando uma UI de detalhes, o diagrama incluirá um manipulador de eventos de mudança de dados para o gerenciamento de mudanças de dados na UI no tempo de execução. O manipulador de eventos está pronto para uso. No entanto, você pode customizar a implementação clicando duas vezes no nó Mudança de dados. Para obter mais informações, consulte Manipulando Mudanças de Dados
9. Conclua o digrama de serviço manual e customize as páginas.
   • Para uma UI de detalhes, o serviço manual gerado tem duas páginas:
     • Visualizar detalhes da instância, que contém as seguintes visualizações:

       Modelo de detalhes da instância padrão

       Exibe os detalhes da instância no Workplace.

       Seção de dados

       Exibe os valores das variáveis passadas para o serviço manual.

     • Mostrar erro, que retorna um erro se a instância não for localizada.
   • Para uma UI de ativação, o serviço manual gerado tem uma página Inserir dados, com um controle para cada variável do processo mapeada. Ao especificar uma UI do processo de ativação, uma variável cancelLaunch do tipo Booleano é gerada. O valor da variável é configurado pelo serviço manual da UI de Ativação. Se o valor de cancelLaunch for true quando um usuário conclui o serviço manual de ativação, a ativação será cancelada. Se o valor de cancelLaunch for false, o processo é iniciado. O valor padrão é false. A UI de ativação gerada tem uma página com dois botões; OK e Cancelar. Se um usuário clica em Cancelar, a variável cancelLaunch é configurada como true.
     É possível modificar sua UI de Ativação para que um usuário possa visualizar ou incluir documentos na pasta de processo que você especificou na página Pastas. Para isso, use visualizações que são fornecidas no kit de ferramentas do Content Management para visualizar e recuperar documentos no armazenamento de conteúdo. Por exemplo, o Explorador de Documento de controle. Esses controles estão disponíveis no kit de Gerenciamento de Conteúdo. Para obter mais informações, consulte:

     • Como usar visualizações para armazenar ou visualizar documentos

     Nota: Se a ativação do processo for cancelada, os documentos e pastas localizados em um sistema Enterprise Content Management externo que são referenciados a partir da pasta do processo não serão excluídos.
10. Clique em Salvar ou em Concluir Edição.
    Para obter detalhes sobre a declaração de variáveis para os serviços humanos no lado do cliente, consulte Declaração de variáveis
11. Teste o serviço manual do lado do cliente.
    • Em Launch UI, clique em Run para testar o serviço humano no lado do cliente e a página.
    • Para obter detalhes da UI, execute um dos seguintes procedimentos:
      • Se o fluxo de serviço manual não for customizado, execute a IU da instância no Workplace
      • Se quiser testar e construir de forma incremental sua UI customizada:
        1. Execute uma instância do processo que está associado à UI customizada e anote o ID da instância.
        2. O serviço manual tem a lógica que mostrará um erro se o ID da instância do processo for nulo. Remova essa lógica conectando o nó Iniciar diretamente ao nó Dados de inicialização do lado do cliente.
        3. No script Dados de inicialização do lado do cliente, modifique a primeira linha conforme a seguir:

           tw.local.selectedInstanceId ='6'; 

           em que 6 é o ID da instância que você anotou na etapa a.
        4. Execute o serviço manual.
        5. Depois de satisfeito que o serviço funciona como esperado, reverta as mudanças que você fez nas etapas b e c. Teste novamente executando a IU da instância no Process Portal