Criar uma ação personalizada para gerar uma matriz de cadeias de caracteres a partir de uma lista de registros

Gere uma matriz de cadeias de caracteres a partir de uma lista de registros de função do usuário. Aprenda a usar uma etapa Script para fazer iteração por meio de uma lista de registros.

Antes de Iniciar

Função necessária: administrador de flow_designer

Por Que e Quando Desempenhar Esta Tarefa

Use este exemplo para ver demonstrações dessas operações e etapas.

• Crie uma entrada de ação para um registro de Função.
• Pesquise no máximo três registros de Função do usuário que tenham a entrada de ação Função.
• Configure uma etapa de script para processar uma lista de registros de função do usuário.
• Crie uma variável de entrada de script que contém a lista de registros de função do usuário.
• Script de gravação que cria uma matriz de usuários vazia.
• Escreva um script que itera por meio da lista de registros de função do usuário.
• Script de gravação que preenche a matriz de usuários com o valor do campo do usuário atual.
• Crie variáveis de saída de script para a matriz de usuários e a cadeia de caracteres do usuário secundário.
• Gere a matriz de cadeias de caracteres de usuários gerada como uma cápsula de dados.
• Teste a ação com três usuários de amostra.

Procedimento

1. Opcional: Crie uma aplicação para armazenar seu trabalho.
   Você pode usar App Engine Studio para planejar, criar e implantar aplicações. Para obter mais informações sobre como criar uma aplicação personalizada, consulte Building apps in App Engine Studio.
   Por exemplo, crie uma aplicação chamada Minha aplicação.
2. Navegar até Tudo > Automação de Processo > Workflow Studio.
3. Na página inicial, selecione Ações.
4. Selecionar Novo(a) > Ação
   O sistema exibe a caixa de diálogo Propriedades da ação.
5. Insira estes valores de amostra.

   Campo	Valor
   Nome	Criar usuários com matriz de cadeias de caracteres de função
   Aplicação	Global
   Acessível de	Todos os escopos de aplicação

   Nota:

   Se você criou uma aplicação para armazenar e implantar sua ação personalizada, use essa aplicação em vez de global.
6. Selecione Build action (Criar ação).
   O sistema exibe a interface Workflow Studio.
7. Em Descrição da ação, selecione Entradas > Criar Entrada
   O sistema exibe uma nova entrada de ação.
8. Configure a entrada de ação com esses valores.

   

   Campo	Valor
   Rótulo	Função
   Tipo	Referência.Função [Reference.sys_user_role]
   Obrigatório	Verdadeiro

9. Em Descrição da ação, selecione Adicionar uma nova etapa.
   O sistema exibe uma lista de etapas disponíveis.
10. Selecionar registros de pesquisa
11. Configure a etapa com esses valores.

    

    Campo	Valor
    Tabela	Função do usuário [sys_user_has_role]
    Condições	[Função][é][ação->Função] Nota: Selecione a cápsula de dados Função em Variáveis de entrada.
    Ordenar por	Função
    Tipo de Classificação	a até z
    Máximo de Resultados	3

    Nota:

    Este exemplo limita a configuração de resultados máximos a três registros apenas para fins de demonstração.
12. Em Descrição da ação, selecione Adicionar uma nova etapa.
    O sistema exibe uma lista de etapas disponíveis.
13. Selecione Script.
14. Na seção Variáveis de entrada, selecione Criar variável.
15. Configure a variável de entrada com esses valores.

    

    Campo	Valor
    Nome	userRoleRecords
    Valor	[etapa->Pesquisar registros etapa->Registros de função do usuário] Nota: Selecione a cápsula de dados de registros de função do usuário na etapa Pesquisar registros.

    Nota:

    Você pode selecionar a cápsula de dados Registros de função do usuário no painel de dados ou no botão Seletor de cápsula de dados.
16. Para Script, insira o texto a seguir.

    (function execute(inputs, outputs) {
      //Create an empty array
      var usersArray = [];
      var i = 0;
      //Iterate through the list of User Role records
      while(inputs.userRoleRecords.next()) {
        //Query User Role records for user field value
        var user = inputs.userRoleRecords.getDisplayValue('user');
        //Add current user name to array
        usersArray[i] = user;
        i += 1;
      }
      outputs.users = usersArray;
    })(inputs, outputs);

17. Em Variáveis de saída, selecione Criar variável.
18. Configure a variável de saída com esses valores.

    

    Rótulo	Nome	Tipo	Obrigatório
    usuários	usuários	Array.String	Verdadeiro

19. Expanda Array.String dos usuários e renomeie a cadeia de caracteres secundária para usuário.
20. Configure o item secundário com esses valores.

    Rótulo	Nome	Tipo	Obrigatório
    usuário	usuário	Cadeia de caracteres	Falso

21. Em Descrição da ação, selecione Saídas > Criar Saída.
22. Configure a saída de ação com esses valores.

    

    Rótulo	Nome	Tipo	Obrigatório
    usuários	usuários	Array.String	Verdadeiro

23. Expanda Array.String dos usuários e renomeie a cadeia de caracteres secundária para usuário.
24. Configure o item secundário com esses valores.

    Rótulo	Nome	Tipo	Obrigatório
    usuário	usuário	Cadeia de caracteres	Falso

25. Selecione Sair do modo de edição.
    O sistema exibe os campos de saída que você criou.
26. Para usuários, selecione [etapa->Etapa de script->usuários].

    

    Nota:

    Você pode selecionar a cápsula de dados Usuários da etapa de script no painel de dados ou no botão Seletor de cápsula de dados.
27. Clique em Salvar.
28. Selecione Testar.
    O sistema exibe a caixa de diálogo Ação de teste.
29. Insira o seguinte valor de teste:

    

    Entrada	Valor
    Função	administrador

30. Selecione Run Test (Executar teste).
    O sistema executa a ação com os valores de teste fornecidos.
31. Selecione A execução do seu teste foi concluída. Visualize os detalhes de execução da ação.
    O sistema exibe os detalhes da execução da ação.
32. Revise o valor de tempo de execução dos dados de saída da ação.

    

    O sistema exibe os dados de saída no formato JSON.
    Para este exemplo, a matriz de usuários contém três usuários que têm a função de administrador.

    {
        "users": [
            "System Administrator",
            "Rob Phillips",
            "Fred Luddy"
        ]
    }
    

Resultado

Você tem uma ação personalizada que pesquisa os usuários que têm uma determinada função e converte esses usuários em uma matriz de cadeias de caracteres de nome de usuário.

O que Fazer Depois

Personalize esta ação para usar sua própria lógica.