Configurar uma integração de tabela remota

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

    • Este caso de uso ilustra como um agente em uma instituição financeira pode acessar consumidores individuais, contas bancárias e dados transacionais que residem em um sistema externo de terceiros. Esta metodologia de integração pode ser aplicada em todos os setores, como integrar a um sistema de administração de apólices em seguros.

    Cenário

    Um consumidor da instituição financeira liga para obter mais informações sobre uma transação recente em sua conta poupança. O agente na instituição financeira cria um registro de interação enquanto está ao telefone com o consumidor. O agente deseja revisar a atividade transacional recente, para preencher os detalhes do consumidor no campo Consumidor e salvar.

    O campo Consumidor faz referência a uma tabela remota, o que significa que o registro do consumidor está sendo recuperado da ferramenta de CRM da instituição financeira sem ser armazenado em ServiceNow.

    Depois que o agente seleciona o consumidor no campo Consumidor, ele pode ver todas as contas-poupança relacionadas em um campo separado, rotulado Conta de depósito. Este campo faz referência às informações da conta de um sistema externo. A lista de contas bancárias é filtrada para a do consumidor usando um qualificador de referência.

    Quando o agente abre o registro do consumidor, ele pode ver as contas bancárias relacionadas e as transações relacionadas que residem no sistema externo. O agente pode encontrar facilmente a transação sobre a qual o consumidor está chamando e avançar no processo de resolução.

    O agente cria um caso a partir do registro de interação por meio de uma ação de IU. Os dados remotos da interação são recuperados e preenchidos previamente no formulário de caso.

    Objetivos

    Este caso de uso atinge o seguinte:
    • Pesquisar um cliente individual (consumidor) a partir de uma interação armazenada em um sistema externo
    • Filtre a lista de contas de depósito disponíveis no registro de interação com base no consumidor selecionado
    • Depois de abrir a página de detalhes do consumidor, forneça uma lista relacionada intitulada "Contas bancárias", que extrai todas as contas bancárias armazenadas em um sistema externo para esse registro do consumidor
    • Depois de selecionar um registro "Conta bancária", forneça uma lista relacionada intitulada "Transações", que extrai todas as transações armazenadas em um sistema externo para essa Conta bancária
    • Aproveite uma política de IU para criar um caso de serviços financeiros a partir do registro de interação e preencher previamente as informações do consumidor e da conta bancária preenchidas pelo agente no registro de interação

    Procedimento de configuração de alto nível

    A tabela a seguir mostra as etapas para configurar uma integração de tabela remota e exibir os dados na interface do usuário.

    Tabela 1. Procedimento de configuração de alto nível
    Etapa Descrição
    Ativar o plug-in de tabelas remotas O plug-in de tabelas remotas deve estar habilitado para ServiceNow instância para oferecer suporte a tabelas remotas. Para obter mais informações, consulte Activate the remote tables plugin.
    Inspecione os dados de origem Com base na abordagem que você planeja adotar, você deve determinar quais dados externos serão mostrados no sistema. Os endpoints e os dados de origem consultados variam dependendo do layout arquitetônico individual.
    Crie as tabelas remotas necessárias Crie as tabelas remotas necessárias para que você possa ver os dados apropriados recuperados da fonte externa.

    Uma tabela remota precisa de uma chave primária externa para relacionar seus dados temporários aos dados armazenados na fonte externa.

    Você deve identificar os elementos de dados que deseja extrair das fontes externas e exibir no seu espaço. Por exemplo, ao extrair informações do consumidor, além da chave primária externa, você pode querer incluir nome completo, código do país, cidade e assim por diante.
    Criar mensagens REST de saída Configure as solicitações de mensagem REST de saída para executar chamadas GET apropriadas para o sistema externo em que as informações estão armazenadas. Navegar até Tudo > Serviços web do sistema > Saída > Mensagens de REST para fazer isso.
    Criar definição de tabela remota do consumidor Crie as definições apropriadas em que você define o script e informa ServiceNow Que ações executar ao invocar cada chamada da REST API.

    Nesta etapa, você alinhará os valores que deseja exibir em sua tabela remota com os valores especificados em seu sistema externo.

    Você também deve mapear o campo sys_id para a chave primária externa designada no sistema externo.
    Crie relacionamentos de entidade por meio de tabelas remotas Ao criar outras tabelas remotas, crie relacionamentos entre elas mapeando a chave primária externa exclusiva para o campo sys_id da tabela remota.

    Por exemplo, para relacionar uma conta bancária ou apólice de seguro ao consumidor, a chave primária externa deve ser mapeada para o campo sys_id na definição da tabela remota do consumidor.

    Configure as listas relacionadas para que o consumidor exiba os registros relacionados. Isso pode ser feito abrindo o menu de contexto do registro do consumidor e navegando até Configurar > Listas relacionadas.
    Atualize os campos no registro de interação para fazer referência a tabelas remotas Esta etapa fornece ao agente a capacidade de pesquisar os dados remotos quando necessário.

    Crie campos personalizados que façam referência a suas tabelas remotas em uma interação. Isso pode ser feito abrindo o menu de contexto do registro de interação e navegando até Configurar > Layout do formulário.
    Adicione qualificadores de referência nos campos Esta etapa permite a filtragem da lista para que ela mostre apenas, por exemplo, contas ou políticas no sistema externo relacionadas ao consumidor selecionado.

    Para obter mais informações, consulte Reference qualifiers.
    Crie uma ação de IU para preencher dados remotos Crie uma ação de IU para preencher dados remotos da interação no caso ou nos respectivos objetos em seu fluxo de trabalho.

    Para obter mais informações, consulte Create a UI action.
    Utilize a ação do cliente Pesquisa de FSO A ação Pesquisar cliente UXF, incluída no plug-in Tabelas remotas de serviços financeiros, é essencial para configurar a ação Cliente de pesquisa de FSO.

    Esta ação integra a Definição de carga da ação e é usada em um decorador de campo como uma ação de cliente UXF.

    Ele está disponível como parte da aplicação Pesquisa de tabela remota, mas requer integração com um decorador de campo ou uma ação declarativa.

    Para obter mais informações sobre a ação Pesquisar cliente de FSO, consulte FSO Pesquisar ação do cliente.
    Exiba transações remotas da conta financeira armazenada localmente Você pode optar por manter as informações que mudam com frequência em tabelas remotas (como transações) enquanto armazena outros dados que não mudam em tabelas locais.

    Por exemplo, você pode exibir transações de uma conta bancária persistente como uma lista relacionada em que todos os dados transacionais permanecem em um sistema externo. Para obter mais informações, consulte Create defined related lists.

    Ao criar o relacionamento, especifique a tabela remota como Consultas da tabela valor. Use uma função no Consulta com campo para definir o relacionamento entre as transações e a conta.

    Para obter mais informações sobre o passo a passo da implementação, consulte o guia de configuração da Tabela remota de FSO.