Crie uma ação para remover um usuário

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura

    • Crie uma ação para desativar ou excluir uma conta de usuário na aplicação SaaS.

    Antes de Iniciar

    Se você estiver usando um existente ServiceNow® IntegrationHub spoke, descubra se ele tem uma ação para remover um usuário que você pode usar em vez de criar um.

    Função necessária: flow_designer ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Esta ação é usada para recuperar assinaturas não utilizadas para reduzir as despesas de software da sua empresa.

    Procedimento

    1. Navegar até Tudo > Flow Designer > Designer.
    2. Clique em Novo e selecione Ação .
    3. No formulário, preencha os campos.
      Tabela 1. Formulário Propriedades da ação
      Campo Valor
      Nome Nome de sua escolha. Por exemplo, Remover usuário .
      Acessível de Todos os escopos da aplicação .
      Categoria Deixe este campo em branco.
      Proteção Nenhum .
      Aplicação Aplicativo spoke a ser integrado à aplicação SaaS. Este pode ser um existente IntegrationHub spoke ou um novo spoke que você criou.
      Anotação em fluxo Deixe este campo em branco.
      Descrição Descrição de sua escolha.
    4. Clique em Enviar.
    5. Na seção Entradas da Descrição da ação, clique em Criar entrada .
    6. Adicione uma entrada de ID de usuário.

      É assim que a ação obtém o ID do usuário a ser excluído.

      Tabela 2. Entradas
      Rótulo Nome Tipo Obrigatório(a)
      ID do usuário userID Cadeia de caracteres Sim
    7. Se a API com a qual você está trabalhando exigir autenticação do usuário para solicitações, adicione entradas para autenticação.
      Exemplos de entradas comuns de autenticação de usuário são ID de usuário administrador e nome do site. Consulte a documentação da API escolhida para saber mais sobre os requisitos de autenticação do usuário em seu caso específico. . Se a API exigir um token de acesso, um Valor da credencial a variável é criada automaticamente mais tarde para que você não precise adicioná-la como uma entrada.

      Ao usar sua ação concluída em um subfluxo, você define quais valores passar como essas entradas.

    8. Adicione um Etapa SOAP ou Etapa REST para a descrição da ação.
      Sua escolha dependerá da API da aplicação SaaS com a qual você está integrando.
    9. Se você selecionou SOAP preencha o formulário conforme mostrado.
      Tabela 3. Formulário de etapa SOAP
      Campo Valor
      Detalhes da Conexão
      Conexão Usar Alias de Conexão .
      Alias de conexão Alias de conexão que você criou quando criou o perfil de integração. Se você ainda não criou um perfil de integração, siga as etapas a. crie um perfil de integração personalizado com um alias de conexão.
      Endpoint Este valor é preenchido automaticamente quando você seleciona o alias de conexão. É definido como o URL de conexão do registro de conexão HTTP(s) vinculado ao alias.
      Detalhes da solicitação
      Criar os Envelopes Manualmente .
      Ações de SOAP Solicitação de API para excluir ou desativar um usuário. Consulte a documentação da API escolhida para selecionar a solicitação apropriada.
      Envelopes de SOAP Mensagem de solicitação XML para excluir um usuário. Consulte a documentação da API escolhida para saber como gravar uma mensagem de solicitação XML. Em geral, o cabeçalho deve ter suas variáveis de entrada para autenticação do usuário, bem como Valor da credencial o token de acesso. O corpo deve incluir a solicitação para excluir um usuário e a entrada de ID do usuário.
      Nota:
      Para obter um exemplo de um envelope SOAP, consulte a ação Remover usuário usada em Webex Recuperar subfluxo de assinatura.
    10. Se você selecionou REST, preencha o formulário conforme mostrado.
      Tabela 4. Formulário de etapa REST
      Campo Valor
      Detalhes da Conexão
      Conexão Usar Alias de Conexão .
      Alias de conexão Alias de conexão que você criou quando criou o perfil de integração. Se você ainda não criou um perfil de integração, siga as etapas a. crie um perfil de integração personalizado com um alias de conexão.
      URL base Este valor é preenchido automaticamente quando você seleciona o alias de conexão. É definido como o URL de conexão do registro de conexão HTTP(s) vinculado ao alias.
      Detalhes da solicitação
      Criar solicitação Manualmente .
      Caminho do recurso Caminho para o recurso. Este valor é anexado à URL de base. Consulte a documentação da API com a qual você está trabalhando para saber como criar o caminho do recurso.
      Método HTTP EXCLUIR .
      Parâmetros de Consulta Adicione um parâmetro para o ID do usuário. Defina o valor como a entrada de ID do usuário.
    11. Adicione um Etapa de script Para a Descrição da ação para tratamento de erros.
      1. Para Tempo de execução necessário , selecione Instância .
      2. Criar variáveis de entrada.
        Tabela 5. Variáveis de entrada
        Nome Valor
        resposta Saída do corpo da resposta da etapa SOAP ou REST
        status_code Saída do código de status da etapa SOAP ou REST
      3. Criar variáveis de saída.
        Tabela 6. Variáveis de saída
        Rótulo Nome Tipo Obrigatório(a)
        status status Escolha Sim
        error_message error_message Cadeia de caracteres Sim
      4. Em Script escreva um script para atribuir valores às saídas de mensagem de status e erro.
        • Use status_code entrada para verificar se há um erro. Defina a saída de status igual a. Erro se houver um erro e. Sucesso se não houver erro.
        • Nos casos em que houver um erro, use resposta entrada para obter informações sobre o tipo de erro. Defina mensagem de erro saída para uma descrição do erro para que um usuário possa entender o que deu errado.
    12. Na Descrição da ação, clique em Saídas .
    13. Criar variáveis de saída.
      Tabela 7. Variáveis de saída
      Rótulo Nome Tipo Obrigatório(a)
      Status status Escolha Não
      Mensagem de erro error_message Cadeia de caracteres Não
    14. Atribua valores às variáveis de saída.
      Tabela 8. Variáveis de saída
      Rótulo Valor
      Status status variável de saída da etapa de script
      Mensagem de erro error_message variável de saída da etapa de script
    15. Para testar sua ação, clique em Teste .
      1. Exiba os resultados do teste e os logs do sistema para obter detalhes sobre quaisquer erros.
        Para exibir logs do sistema, navegue até Logs do sistema > Log do Sistema > Tudo.
      2. Se sua ação tiver erros, verifique se você está usando os endpoints corretos e se a solicitação de API está estruturada conforme o esperado.
      Nota:
      Ao testar, lembre-se de que esta ação desativa um usuário. Teste esta ação em um ambiente de subprodução. Se somente um ambiente de produção estiver disponível, você poderá criar usuários falsos para teste.
    16. Depois de verificar se a ação está funcionando conforme o esperado, clique em Publicar .