Configure o. First Advantage spoke

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 7 min. de leitura
  • Integrar o. ServiceNow instância com seu First AdvantageConta usando uma chave de API para autenticar ServiceNow solicitações.

    Antes de Iniciar

    • Solicitar uma assinatura de IntegrationHub.
    • Ative o. First Advantage spoke.
    • Função necessária: administrador

    Criar registro de conexão para First Advantage spoke

    Crie um registro de conexão para integrar seu ServiceNow E o servidor First Advantage. . ServiceNow A instância usa este registro de conexão para executar as ações do spoke do First Advantage.

    Antes de Iniciar

    Função necessária: administrador

    Adquira a chave de API do servidor First Advantage.

    Procedimento

    1. Navegar até Tudo > Automação de Processo > Workflow Studio.
    2. Selecione Integrações .
    3. Selecione Conexões guia.
    4. No campo Pesquisar todas as conexões, insira Primeira vantagem .
      Confirme se Saída selecionado.
    5. No bloco FirstAdvantage, selecione Exibir detalhes .
      Botão Exibir detalhes no bloco de alias do FirstAdvantage.
    6. Selecione Configurar.
    7. Preencha o formulário.
      Tabela 1. Formulário de conexão do spoke do First Advantage
      Campo Descrição
      Nome da conexão O nome da conexão. O nome padrão e somente leitura do primeiro registro é o mesmo do alias de conexão. Você pode fornecer um nome diferente ao criar um registro de conexão clicando em Adicionar conexão .
      URL de conexão Opção para fornecer o URL de conexão para o servidor First Advantage. O URL é https://rest-ua.fadv.com.
      E-mail de distribuição Opção para fornecer um ID de e-mail de distribuição.
      Versão Opção para fornecer a versão da API.
      Chave de API Opção para inserir a chave de API que o servidor First Advantage usa para autenticar solicitações de acesso.
      Formulário de conexão First Advantage.
    8. Selecione Configurar conexão.
      O registro de conexão está configurado.

    Criar First Advantageestados em seu ServiceNow instância

    Criar First Advantageestados a serem exibidos no Estado lista em seu ServiceNow instância.

    Antes de Iniciar

    Função necessária: administrador

    Crie os estados Rascunho, Pronto e Em andamento

    Crie os estados Rascunho, Pronto e Em andamento na tabela Tarefa [task].

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. No Navegador de filtros, insira sys_choice.list .
      Os registros na tabela Escolha [sys_choice] são exibidos.
    2. Clique em Nova.
    3. No formulário, preencha esses valores e crie três registros para o estado Rascunho.
      Tabela 2. Registro 1 - Estado de rascunho
      Campo Valor
      Tabela Tarefa [task]
      Elemento estado
      Rótulo Rascunho
      Valor 137
      Nota:
      • Forneça os números exatos no Valor conforme mencionado aqui. Os fluxos do spoke não serão acionados se houver alguma mudança nesses números.
      • Certifique-se de que o registro seja criado no Global aplicação.
    4. Clique em Enviar.
    5. Da mesma forma, crie registros para os estados Pronto e Em andamento.
      Tabela 3. Registro 2 - Estado Pronto
      Campo Valor
      Tabela Tarefa [task]
      Elemento estado
      Rótulo Pronto
      Valor 173
      Tabela 4. Registro 3 - Estado em andamento
      Campo Valor
      Tabela Tarefa [task]
      Elemento estado
      Rótulo Em andamento
      Valor 181
      Nota:
      • Forneça os números exatos no Valor conforme mencionado aqui. Os fluxos do spoke não serão acionados se houver alguma mudança nesses números.
      • Certifique-se de que o registro seja criado no Global aplicação.

    Resultado

    Os estados Rascunho, Pronto e Em andamento são criados na tabela Tarefa [task]

    Crie os estados Concluído e Cancelado

    Crie os estados Concluído e Cancelado na tabela Tarefa First Advantage [sn_fadv_spoke_first_advanage_task].

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Spoke do First Advantage > Tarefas de pedido.
    2. Clique em Nova.
      Nota:
      Certifique-se de que o registro seja criado no Primeira vantagem aplicação.
    3. Clique com o botão direito do mouse Estado e clique em Configurar opções .
    4. Execute estas etapas para criar o estado Cancelado:
      1. Insira Cancelado em Novo texto do item .
      2. Insira 149 em Valor numérico .
        Nota:
        Forneça os números exatos no Valor numérico conforme mencionado aqui. Os fluxos do spoke não serão acionados se houver alguma mudança nesses números.
      3. Clique em Adicionar.
      4. Clique em Salvar.
    5. Execute estas etapas para criar o estado Concluído:
      1. Insira Concluído em Novo texto do item .
      2. Insira 127 em Valor numérico .
        Nota:
        Forneça os números exatos no Valor numérico conforme mencionado aqui. Os fluxos do spoke não serão acionados se houver alguma mudança nesses números.
      3. Clique em Adicionar.
      4. Clique em Salvar.

    Resultado

    Os estados Concluído e Cancelado são criados na tabela Tarefa First Advantage [sn_fadv_spoke_first_adventage_task].

    Crie os estados Concluído - Sucesso e Concluído - Acordo quebrado

    Crie os estados Concluído - Sucesso e Concluído - Acordo quebrado na tabela Tarefa do funcionário do First Advantage [sn_fadv_spoke_first_adventage_employee_task_table].

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Spoke do First Advantage > Tarefa do funcionário.
    2. Clique em Nova.
      Nota:
      Certifique-se de que o registro seja criado no Primeira vantagem aplicação.
    3. Clique com o botão direito do mouse Estado e clique em Configurar opções .
    4. Execute estas etapas para criar o estado Cancelado:
      1. Insira Concluído - Sucesso em Novo texto do item .
      2. Insira 161 em Valor numérico .
        Nota:
        Forneça os números exatos no Valor numérico conforme mencionado aqui. Os fluxos do spoke não serão acionados se houver alguma mudança nesses números.
      3. Clique em Adicionar.
      4. Clique em Salvar.
    5. Execute estas etapas para criar o estado Concluído:
      1. Insira Concluído - negócio quebrado em Novo texto do item .
      2. Insira 117 em Valor numérico .
        Nota:
        Forneça os números exatos no Valor numérico conforme mencionado aqui. Os fluxos do spoke não serão acionados se houver alguma mudança nesses números.
      3. Clique em Adicionar.
      4. Clique em Salvar.

    Resultado

    Os estados Concluído - Sucesso e Concluído - Acordo quebrado são criados na tabela Tarefa do funcionário do First Advantage [sn_fadv_spoke_first_advanage_employee_task_table].

    Configurar First Advantagewebhooks

    Receba convites e atualizações de eventos de pedido no seu ServiceNow configurando os webhooks.

    Antes de Iniciar

    Função necessária: administrador

    Crie uma chave de autorização para o spoke First Advantage

    Crie uma chave de autorização para autorizar solicitações do Jenkins.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Definição do Sistema > Scripts - Segundo Plano.
    2. Insira este comando no Executar script (JavaScript executado no servidor) campo de texto:
      gs.info(GlideSecureRandomUtil.getSecureRandomString(32));
    3. Clique em Executar script .
    4. Copie e registre o valor gerado para uso posterior.
      Chave de autorização ou segredo do cliente

    Forneça a chave em seu ServiceNow instância

    Configure o. First Advantagewebhook fornecendo chave para First Advantagecliente do webhook.

    Antes de Iniciar

    Procedimento

    1. Navegar até Tudo > Spoke do First Advantage > Detalhes de cliente do Webhook FADV.
    2. Clique em Nova.
    3. No formulário, preencha estes valores.
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro.
      Chave de Autorização Chave de autorização que você gerou. Para obter mais informações, consulte Crie uma chave de autorização para o spoke First Advantage.
    4. Clique em Enviar.

    Endpoints de API de acesso

    Acesse o endpoint da API para os eventos de convite e pedido e compartilhe os detalhes necessários com First Advantagepara configurar os webhooks.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Serviços web do sistema > Scripted REST APIs.
    2. Abra o registro do First Advantage spoke, por exemplo, Webhook First Advantage .
    3. Em Recursos guia:
      1. Abra o registro do evento de convite, por exemplo, Status do convite .
      2. Copie e registre o caminho fornecido em Caminho do recurso , por exemplo, /api/sn_fadv_spoke/fadv/invite_status .
      3. Abra o registro do evento de pedido, por exemplo, Status do pedido .
      4. Copie e registre o caminho fornecido em Caminho do recurso , por exemplo, /api/sn_fadv_spoke/fadv/order_status .

    O que Fazer Depois

    Contato First Advantagepara configurar webhooks para seu ServiceNow instância. Para isso, compartilhe esses detalhes com First Advantage:
    • Cabeçalho personalizado neste formato: FadvKey <authorization-key> .
      Nota:
      • Certifique-se de que o cabeçalho personalizado esteja somente neste formato. Os fluxos do spoke não serão acionados se houver alguma mudança.
      • Forneça a mesma chave fornecida anteriormente em Spoke do First Advantage > Detalhes de cliente do Webhook FADV.
      • Use o mesmo caso mencionado aqui: PadvKey .
    • Endpoint de API para os eventos de convite neste formato: <ServiceNow-instance-URL>/api/sn_fadv_spoke/fadv/invite_status
    • Endpoint de API para os eventos de pedido neste formato: <ServiceNow-instance-URL>/api/sn_fadv_spoke/fadv/order_status

    Sincronizar First Advantagecontas e pacotes com ServiceNow

    Armazene os detalhes do First Advantagecontas e pacotes por sincronização First Advantagecontas e pacotes com ServiceNow.

    Antes de Iniciar

    Função necessária: Administrador do First Advantage

    Procedimento

    1. Navegar até Tudo > Spoke do First Advantage > Contas.
    2. Clique em Nova.
    3. No formulário, preencha os valores.
      Tabela 5. Formulário da conta
      Campo Descrição
      Conta principal Opção para especificar que a conta é uma conta primária. Marque a caixa de seleção.
      ID da conta ID da conta primária.
      Nome da Conta Nome da conta primária.
    4. Clique em Enviar.
      A conta primária é criada e o registro é exibido.
    5. Navegar até Spoke do First Advantage > Contas.
    6. Clique em Obter contas lista relacionada.
    7. Navegar até Spoke do First Advantage > Pacotes.
    8. Clique em Obter pacotes link relacionado.

    Resultado

    . First Advantageos detalhes da conta e do pacote são recuperados.
    Nota:
    Somente usuários com a função de administrador FADV podem sincronizar os detalhes da conta e do pacote. Usuários com função de usuário FADV só podem exibir os detalhes recuperados.