Criar um subfluxo para obter usuários

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 6 min. de leitura

    • Crie um subfluxo para adicionar uma lista de usuários à tabela Assinatura de software.

    Antes de Iniciar

    Este subfluxo requer uma ação de fluxo de dados para obter usuários. Para obter mais informações, consulte Criar uma ação de fluxo de dados para obter usuários.

    Função necessária: flow_designer ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Nota:
    Para obter exemplos de subfluxos para obter usuários, consulte os subfluxos Jira Assinaturas de download e Webex Assinaturas de download.

    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 à sua escolha. Por exemplo, Assinaturas de download da aplicação, em que Aplicação é o nome da aplicação SaaS com a qual você está integrando.
      Aplicação Software Asset Management - Gestão de licenças de SaaS
      Nota:
      Se você salvar o subfluxo na aplicação Gestão de ativos de software - Gestão de licenças de SaaS, ele será incluído com sua assinatura Gestão de ativos de software. Se você salvar o subfluxo em qualquer outra aplicação, poderá ser cobrado por ServiceNow® IntegrationHub transações. Se você estiver publicando sua aplicação de 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 de fluxo Deixe este campo em branco.
      Descrição Descrição de sua escolha.
      Executar como Usuário que inicia a sessão.
    4. Clique em Enviar.
    5. Adicione uma entrada de perfil de integração.
      Tabela 2. Entradas
      Rótulo Nome Tipo Obrigatório
      Perfil de Integração integration_profile Referência.Perfil de integração Sim
    6. Na seção Ações, clique no ícone de adição e em Ação para adicionar uma nova ação.
    7. Selecione o spoke para a aplicação SaaS com a qual você deseja integrar na lista de spokes instalados.
      Nota:
      Para adicionar outros 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 para a aplicação SaaS com a qual você deseja integrar, você poderá criar um novo spoke.
    8. Selecione uma ação de fluxo de dados para obter usuários.
    9. Defina os valores a serem passados para qualquer entrada de autenticação de usuário para a ação de fluxo de dados.

      A ação de fluxo de dados pode retornar usuários que você não deseja incluir em sua lista de assinaturas de usuário. Se você executar a filtragem para excluir alguns usuários, adicione uma lógica de fluxo If como um secundário da ação de fluxo de dados de obter usuários.

      A quantidade de filtragem necessária, se houver, depende da aplicação com a qual você está integrando. Por exemplo, se o usuário targetObject tiver uma propriedade active, você poderá adicionar uma condição para verificar se o valor é verdadeiro para garantir que o subfluxo não baixe usuários desativados. Um exemplo de filtragem usada pelo subfluxo Jira Assinaturas de download é que o tipo de conta não pode ser app para impedir que o subfluxo retorne contas que não sejam usuários reais.

      Adicione condições à lógica de fluxo If para qualquer filtragem necessária. Se você estiver usando uma lógica de fluxo If para filtrar usuários, adicione a ação Upsert user subscription using subscription identifier do Gestão de ativos de software spoke como um secundário da lógica de fluxo. Se você não estiver filtrando usuários, adicione a ação Upsert user subscription using subscription identifier como secundária da ação de fluxo de dados de obter usuários.

      Esta ação adiciona a assinatura de usuário da aplicação SaaS à tabela de assinatura de software [samp_sw_subscription]. Se a assinatura já estiver na tabela, a ação atualizará o registro de assinatura.

    10. Preencha as entradas que são aplicáveis à sua integração.

      Use valores do painel de dados para preencher as entradas da ação. Sua solicitação para a API SaaS pode não retornar dados para todas as entradas.

      Tabela 3. Ação de assinatura do usuário do upsert
      Campo Valor
      ID de usuário externo ID do usuário ou ID da conta do targetObject do usuário. Em geral, é um valor numérico não legível. Este valor deve ser exclusivo.
      Nome principal do usuário Endereço de e-mail do usuário targetObject. Se um endereço de e-mail não estiver disponível, use outro valor, como nome de usuário mais ID de usuário. Este valor deve ser legível.
      Perfil de Integração Entrada de perfil de integração que você criou para o subfluxo.
      Última Atividade Data da atividade mais recente do targetObject do usuário. Por exemplo, a hora do último login.
      Externo criado

      Data de criação da conta a partir do targetObject do usuário.

      Este valor ajuda a criar melhores candidatos de recuperação. Um novo usuário pode não ter nenhuma atividade ainda. Se o registro mostrar que a conta do usuário foi criada, um candidato de recuperação não será criado para esse usuário porque é uma nova conta em vez de uma conta não utilizada.
      Identificador Um identificador exclusivo para identificar a integração. Os modelos de software são criados automaticamente para assinatura com um identificador que corresponde a um identificador na tabela Definições de produto de assinatura [samp_sw_subscription_product_definition].

      Se um identificador não existir, configure um identificador. Para obter mais informações, consulte Configurar um identificador.
      Atributos adicionais Isso é usado para atualizar qualquer outro campo na tabela samp_sw_subscription que não seja mencionado acima.
    11. Para testar seu subfluxo, clique em Testar.
      1. Exiba os resultados do teste e os logs do sistema para obter detalhes sobre erros.
        Para exibir os logs do sistema, navegue até Logs do sistema > Log do Sistema > Todos.
      Nota:
      A ação de fluxo de dados para obter usuários deve recuperar várias páginas de usuários com sucesso. Não grave na tabela Assinatura de software [samp_sw_subscription] até verificar se a ação de fluxo de dados recupera todos os usuários. Para verificar, você pode criar um subfluxo que consome o fluxo de dados e registra os resultados.
    12. Depois de verificar se o subfluxo está funcionando conforme o esperado, clique em Publicar.
      Dica:
      Você ainda pode editar o subfluxo depois que ele for publicado.

    Configurar um identificador

    Configure um identificador se ele não existir para identificar uma integração.

    Antes de Iniciar

    Função necessária: sam_admin

    Procedimento

    1. Crie um produto personalizado quando seu produto não existir na tabela Produto de software [samp_sw_product].
      1. Selecione Novo.
      2. No formulário, preencha os campos.
        Campo Descrição
        Fornecedor Editor do produto personalizado.
        Produto Nome do produto personalizado.
        Tipo de produto Tipo de produto do produto de software personalizado.
        Classificação de produto Classificação do UNSPSC oficial
        Software de assinatura Opção indicando que seu produto é baseado em assinatura.
        Ignorar instalações Opção que indica que o tipo de produto é licenciável.

        Esta caixa de seleção será exibida somente se você selecionar o tipo de produto como Licenciável e o software de assinatura estiver definido como verdadeiro.
        Excluir de serviço de conteúdo Opção que indica que o produto será excluído do serviço de conteúdo.

        Você não deve marcar esta caixa de seleção.
        Ativo Opção indicando que este produto é usado ou não.
      3. Selecione Enviar.
    2. Crie um mapa de descoberta personalizado criando uma definição de direito personalizada a partir da tabela de mapas do Discovery [samp_custom_sw_entitlement_definition].
      1. Selecione Novo.
      2. No formulário, preencha os campos.
        Campo Descrição
        Produto Nome do produto de software atual. Produto personalizado que você criou na etapa 1.
        Condição de versão Qualificador de condição para o campo Versão:
        • começa com
        • é
        • é qualquer coisa

        Padrão é qualquer coisa.
        Versão Versão do produto de software.

        Obrigatório se o valor da condição da versão for Começar com ou é.
        Condição de edição Qualificador de condição para o campo Edição:
        • começa com
        • é
        • é qualquer coisa

        Padrão é qualquer coisa.
        Edição Plataforma do produto de software a ser usada ao pesquisar o modelo de descoberta normalizado.
        Plataforma Plataforma do produto de software a ser usada ao pesquisar o modelo de descoberta normalizado.
        Idioma Idioma do produto de software a ser usado ao pesquisar o modelo de descoberta normalizado, que é preenchido depois de normalizado ou adicionado manualmente.
      3. Selecione Enviar.
    3. Crie uma definição de produto de assinatura personalizada criando uma definição de direito personalizada a partir da tabela Definições de produto de assinatura personalizada [samp_sw_custom_subscription_product_definition].
      1. Selecione Novo.
      2. No formulário, preencha os campos.
        Campo Descrição
        Identificador Identificador de assinatura relacionado ao produto personalizado.
        Integração de assinatura Lista de provedores de SaaS e SSO que são mapeados para produtos de assinatura na tabela Definição de produto de assinatura [samp_sw_subscription_product_definition].

        Para este cenário, selecione Integração personalizada.
        Definição de direito Mapa de descoberta personalizado que você criou na etapa 2.
        Ativo Caixa de seleção indicando que o identificador é usado ou não.
      3. Selecione Enviar.