---
sourceDocument: Yokohama Gestão de ativos de TI
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/it-asset-management

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Gestão de ativos de TI

ft:clusterId :

    - itam

bundleId :

    - itam

workflow :

    - Technology


---

# Crie um subfluxo para obter usuários

# Crie um subfluxo para obter usuários {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 [Crie uma ação de fluxo de dados para obter usuários](https://servicenow-prod.fluidtopics.net/OByRO6CXDPwGxsvuS3ThjA "Crie uma ação de fluxo de dados para obter uma lista de assinaturas de usuário do SaaSaplicação.").

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 JiraDownload de assinaturas e. WebexBaixar subfluxos de assinaturas.

## Procedimento

1. Navegar até TudoFlow DesignerDesigner.
2. Selecione Novo e, em seguida, selecione Subfluxo .
3. No formulário, preencha os campos.  
   {#create-subflow-get-users__table_dk4_brb_njb__entry__2}

   | Campo | Valor |
   |-|-|
   | Nome | Nome de sua escolha. Por exemplo, <kbd class="ph userinput">Aplicação </kbd>Download de assinaturas, onde <kbd class="ph userinput">Aplicação </kbd>é o nome do SaaSa aplicação à qual você está integrando. |
   | Aplicação | Gestão de ativos de software - Gestão de licenças de SaaS |
   | Acessível de | Selecione Todos os escopos da aplicação . |
   | Categoria | Deixe este campo em branco. |
   | Proteção | Selecione 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. |
   [Tabela 1. Formulário Propriedades do subfluxo]

   {#create-subflow-get-users__table_dk4_brb_njb}
4. Selecione Enviar.
5. Adicione uma entrada de perfil de integração.  
   {#create-subflow-get-users__table_wvn_3qb_njb__entry__4}

   | Rótulo | Nome | Tipo | Necessários |
   |-|-|-|-|
   | Perfil de integração | integration_profile | Perfil de integração.Referência | Sim |
   [Tabela 2. Entradas]

   {#create-subflow-get-users__table_wvn_3qb_njb}
6. Na seção Ações, selecione o ícone de mais e, em seguida, selecione Ação para adicionar uma nova ação.
7. Selecione o spoke para SaaSa aplicação à qual você deseja integrar a partir da lista de spokes instalados.  
   Nota:  
   Para adicionar spokes adicionais à sua lista de spokes instalados, solicite-os no [ServiceNow Store](https://store.servicenow.com). Para obter uma lista completa de spokes disponíveis, consulte [Spokes disponíveis do IntegrationHub](https://www.servicenow.com/docs/access?context=spokes-list&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US). Se não houver spoke existente para SaaScom a qual você deseja integrar, você pode [crie um novo spoke](https://servicenow-prod.fluidtopics.net/K11HvyOak9MrR3Ecpj1I6g "Para configurar uma integração personalizada em Gestão de licenças de SaaS, crie um spoke para se conectar a um SaaSaplicação.").
8. Selecione uma ação de fluxo de dados para obter usuários.
9. Defina os valores a serem aprovados para todas as entradas de autenticação do 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 de IF como secundária da ação Obter fluxo de dados de usuários.

   A quantidade de filtragem necessária, se houver, depende da aplicação com a qual você está se integrando. Por exemplo, se o usuário targetObject tiver um active, você pode adicionar uma condição para verificar se o valor é verdadeiro para confirmar que o subfluxo não baixa usuários desativados. Um exemplo de filtragem usado pelo JiraO subfluxo de Download de assinaturas é que o tipo de conta não pode ser app para ajudar a impedir que o subfluxo retorne contas que não são 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 o. Upsert user subscription using subscription identifieração do Gestão de ativos de softwarefalou como secundário da lógica de fluxo.
   * Se você não estiver filtrando usuários, adicione o. Upsert user subscription using subscription identifieração como secundária da ação obter fluxo de dados de usuários. Esta ação adiciona o. SaaSAssinatura do usuário da aplicação para a tabela Assinatura de software \[samp_sw_subscription\]. Se a assinatura já estiver na tabela, a ação atualizará o registro de assinatura.
   {#create-subflow-get-users__ul_pkk_1dp_rcc}
10. Preencha as entradas aplicáveis à sua integração.  
    Use valores do painel de dados para preencher as entradas de ação. Sua pergunta para SaaSA API pode não retornar dados para todas as entradas.
    {#create-subflow-get-users__table_cch_lsr_njb__entry__2}

    | Campo | Valor |
    |-|-|
    | ID de usuário externo | ID do usuário ou ID da conta do usuário targetObject. Geralmente, é 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 e 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 usuário targetObject. Por exemplo, a hora do último login. |
    | Externo criado | Data de criação da conta 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 de usuário foi criada, um candidato a recuperação não será criado para esse usuário porque é uma nova conta em vez de uma conta não usada. |
    | 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 [Configure um identificador](https://servicenow-prod.fluidtopics.net/Z~maWCB16dSzAM~5TBJw9A#configure-identifier "Se ele não existir, configure um identificador para identificar uma integração."). |
    | Atributos adicionais | Isso é usado para atualizar qualquer outro campo na tabela Assinaturas de software \[samp_sw_subscription\] que não tenha sido mencionado anteriormente. |
    [Tabela 3. Upsert ação de assinatura do usuário]

    {#create-subflow-get-users__table_cch_lsr_njb}
11. Para testar seu subfluxo, selecione Teste .
    1. Exiba os resultados de testes e os logs do sistema para obter detalhes sobre erros.  
       Para exibir logs do sistema, navegue até Logs do sistemaLog do SistemaTudo.

    {#create-subflow-get-users__substeps_tnl_zxq_zjb}  
    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 Assinaturas 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 registrar os resultados.
12. Depois de verificar se o subfluxo está funcionando conforme esperado, selecione Publicar .  
    Dica:  
    Você ainda pode editar o subfluxo depois que ele for publicado.
{#create-subflow-get-users__steps_qf1_x3t_4jb}

## Configure um identificador {#ariaid-title2}

Se ele não existir, configure um identificador 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. Em formulário , preencha os campos.  
      {#configure-identifier__table_gnp_l4q_xvb__entry__2}

      | Campo | Descrição |
      |-|-|
      | Fornecedor | Fornecedor 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 que indica 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 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 que indica que este produto é usado ou não. |
      [ ]

      {#configure-identifier__table_gnp_l4q_xvb}
   3. Selecione Enviar.
   {#configure-identifier__substeps_ncp_24q_xvb} {#configure-identifier__step1}
{#configure-identifier__step1}
2. Crie um mapa de descoberta personalizado criando uma definição de direito personalizada na tabela Mapas de descoberta \[samp_custom_sw_entitlement_definition\].
   1. Selecione Novo.
   2. Em formulário , preencha os campos.  
      {#configure-identifier__table_xfz_dpq_xvb__entry__2}

      | Campo | Descrição |
      |-|-|
      | Produto | Nome do produto de software atual. Produto personalizado que você criou em [etapa 1](https://servicenow-prod.fluidtopics.net/Z~maWCB16dSzAM~5TBJw9A#configure-identifier__step1). |
      | Condição de versão | Qualificador de condição para o campo Versão: * começa com * é * é qualquer coisa {#configure-identifier__ul_ohq_ypr_xvb} 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 {#configure-identifier__ul_xbt_cqr_xvb} 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. |
      [ ]

      {#configure-identifier__table_xfz_dpq_xvb}
   3. Selecione Enviar.
   {#configure-identifier__substeps_e4w_bpq_xvb} {#configure-identifier__step2}
{#configure-identifier__step2}
3. Crie uma definição de produto de assinatura personalizada criando uma definição de direito personalizada na tabela Definições de produto de assinatura personalizada \[samp_sw_custom_subscription_product_definition\].
   1. Selecione Novo.
   2. Em formulário , preencha os campos.  
      {#configure-identifier__table_gdg_4pq_xvb__entry__2}

      | Campo | Descrição |
      |-|-|
      | Identificador | Identificador de assinatura relacionado ao produto personalizado. |
      | Integração de assinatura | Lista de SaaSE provedores de SSO 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 em [etapa 2](https://servicenow-prod.fluidtopics.net/Z~maWCB16dSzAM~5TBJw9A#configure-identifier__step2). |
      | Ativo | Caixa de seleção que indica que o identificador é usado ou não. |
      [ ]

      {#configure-identifier__table_gdg_4pq_xvb}
   3. Selecione Enviar.
   {#configure-identifier__substeps_dg5_mpq_xvb}