Criar um subfluxo para recuperar um usuário

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura

    • Crie um subfluxo para recuperar uma assinatura de usuário.

    Antes de Iniciar

    Este subfluxo requer uma ação para remover um usuário. Para obter mais informações, consulte Criar uma ação para remover um usuário.

    Função necessária: flow_designer ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Nota:
    Para obter exemplos de subfluxos para recuperar um usuário, consulte os subfluxos Jira Recuperar assinatura e Webex Recuperar assinatura.

    Procedimento

    1. Navegar até Todos > Flow Designer > Designer.
    2. Clique em Novo e selecione Subfluxo.
    3. No formulário, preencha os campos.
      Tabela 1. Formulário Propriedades do subfluxo
      Campo Valor
      Nome Nome de sua escolha. Por exemplo, Assinatura de recuperação de aplicação, em que Aplicação é o nome da aplicação SaaS com a qual você está integrando.
      Aplicação Software Asset Management - Integrações de gestão de licenças de SaaS.
      Nota:
      Se você salvar o subfluxo na aplicação Gestão de ativos de software - Integrações de gestão de licenças SaaS, ele será incluído na sua assinatura Gestão de ativos de software. Se você salvar o subfluxo em qualquer outra aplicação, poderá ser cobrado por ServiceNow® Integration Hub transações. Se você estiver publicando sua aplicação spoke personalizada no ServiceNow Store, selecione sua aplicação personalizada.
      Acessível de Todos os escopos da aplicação.
      Categoria Deixe este campo em branco.
      Proteção Nenhum.
      Anotação em fluxo Deixe este campo em branco.
      Descrição Descrição de sua escolha.
      Executar como Usuário que inicia a sessão.
    4. Adicione uma entrada de perfil de integração e uma entrada de assinatura de usuário.
      Tabela 2. Entradas
      Rótulo Nome Tipo Obrigatório
      Perfil de Integração integration_profile Referência.Perfil de integração Sim
      Assinatura de usuário assinatura_usuário Referência.Assinatura de software Sim
    5. Adicione uma saída de mensagem de erro e uma saída de status.
      Tabela 3. Saídas
      Rótulo Nome Tipo
      Mensagem de erro ErrorMessage Cadeia de caracteres
      Status status Cadeia de caracteres
    6. Na seção Ações, clique no ícone de adição e, em seguida, clique em Ação para adicionar uma nova ação.
    7. Na lista de spokes instalados, selecione o spoke da aplicação SaaS com a qual você está integrando.
      Nota:
      Para adicionar mais spokes à sua lista de spokes instalados, solicite-os na ServiceNow Store. Para obter uma lista completa de spokes disponíveis, consulte Spokes disponíveis do IntegrationHub. Se não houver nenhum spoke existente para a aplicação SaaS com a qual você deseja integrar, você poderá criar um novo spoke.
    8. Para remover um usuário, selecione uma ação.
      1. Defina o valor a ser passado como a entrada de ID do usuário.
        O valor usado depende da API com a qual você está trabalhando, mas geralmente será o ID do usuário externo ou o campo Nome principal do usuário da entrada de assinatura do usuário para este subfluxo.
      2. Defina os valores a serem passados para todas as entradas de autenticação de usuário para a ação.
    9. Para verificar se a ação Remover usuário retorna um erro, adicione uma lógica de fluxo If.
    10. Adicione uma lógica de fluxo secundário para atribuir saídas de subfluxo.
      Tabela 4. Atribuir Saídas de Subfluxo
      Nome Dados
      Mensagem de erro Saída de mensagem de erro da ação Remover usuário
      Status falha
    11. Adicione uma lógica de fluxo Else no mesmo nível da lógica If para casos em que a ação Remover usuário não retornar um erro.
    12. Adicione uma lógica de fluxo secundário para atribuir saídas de subfluxo.
      Tabela 5. Atribuir Saídas de Subfluxo
      Nome Dados
      Status êxito

      A imagem a seguir mostra um exemplo concluído de um subfluxo para recuperar uma assinatura de usuário. O exemplo mostrado é o subfluxo Webex Recuperar assinatura.

      Subfluxo de exemplo para recuperar uma assinatura de usuário
    13. Para testar seu subfluxo, clique em Testar.
      1. Veja os resultados de testes e os logs do sistema para obter detalhes sobre erros.
        Para exibir logs do sistema, navegue até Logs do sistema > Log do Sistema > Todos.
      Nota:
      Ao testar, lembre-se de que este subfluxo desativa um usuário. Teste este subfluxo em um ambiente de subprodução. Se apenas um ambiente de produção estiver disponível, você poderá criar usuários falsos para teste.
    14. Depois de verificar se o subfluxo está funcionando conforme o esperado, clique em Publicar.
      Dica:
      Você ainda pode editar o subfluxo após sua publicação.