Crie uma ação personalizada para gerar uma matriz de cadeias de caracteres 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.
• Procure no máximo três registros de função do usuário que tenham a entrada de ação de 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 contenha a lista de registros de função do usuário.
• Script de gravação que cria uma matriz de usuários vazia.
• Escreva o script que itera na 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 de usuário atual.
• Crie variáveis de saída de script para a matriz de usuários e a cadeia de caracteres de 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ção
   O sistema exibe a caixa de diálogo Propriedades da ação.
5. Insira estes valores de amostra.

   Campo	Valor
   Nome	Crie usuários com matriz de funções de cadeias de caracteres
   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 Criar ação .
   O sistema exibe o. Workflow Studio interface.
7. Na 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 estes valores.

   

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

9. Na Descrição da ação, selecione Adicione uma nova etapa .
   O sistema exibe uma lista de etapas disponíveis.
10. Selecione Pesquisar registros
11. Configure a etapa com estes valores.

    

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

    Nota:

    Este exemplo limita o. Máximo de resultados definindo para três registros apenas para fins de demonstração.
12. Na Descrição da ação, selecione Adicione 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 estes 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 Registros de função do usuário Cápsula de dados do painel de dados ou do botão Seletor de cápsulas 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 estes valores.

    

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

19. Expanda Matriz.Cadeia de caracteres de usuários e renomeie a cadeia de caracteres secundária como usuário .
20. Configure o item secundário com estes valores.

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

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

    

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

23. Expanda Matriz.Cadeia de caracteres de usuários e renomeie a cadeia de caracteres secundária como usuário .
24. Configure o item secundário com estes valores.

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

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 etapa de script usuários Cápsula de dados do painel de dados ou do botão Seletor de cápsulas 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 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.