Aprenda os conceitos básicos de configuração de uma integração de sincronização de processo remoto para vincular os processos automatizados entre duas ou mais ServiceNow® instâncias.
Nota:
Integration Hub A Sincronização de processo remoto requer uma assinatura do pacote Integration Hub Enterprise. Para obter mais informações, consulte Solicitação Integration Hub.
Antes de começar com a integração da Sincronização de processo remoto
Antes de decidir avançar com a sincronização de processos remotos como sua estrutura de integração, considere como esta estrutura se compara a outras integrações Now Platform® de várias instâncias. Enquanto soluções como Instance Data Replication e o spoke de instância remota é compatível com integrações de várias instâncias simples, a Sincronização de processos remotos é compatível com casos de uso de integração de várias instâncias mais complexos, com foco na integração de instâncias por processos de negócios de alto nível.
Nota:
A sincronização de processo remoto substitui o spoke do eBonding para integrar instâncias.
Figura 1. Comparação de Replicação de dados da instância, spoke de instância remota e sincronização de processo remoto
Se você optar por usar a Sincronização de processo remoto como sua estrutura de integração de várias instâncias, a próxima etapa é aprender sobre a diferença entre:
Figura 2. Como criar sua integração de sincronização de processo remoto
Gerenciar sua integração envolve o monitoramento das filas de saída e de entrada e a verificação de erros relacionados a quaisquer definições de sincronização de processo acionadas. Para obter mais informações sobre como monitorar e verificar erros com a integração da Sincronização de processo remoto, consulte Filas de saída e filas de entrada e Como monitorar e solucionar problemas de integração. Você também pode avaliar periodicamente os fluxos de saída e de entrada que são executados automaticamente para sua integração e determinar se deve fazer mudanças nesses fluxos em Workflow Studio.
Nota:
A criação e o gerenciamento de uma integração de Sincronização de processo remoto em sua instância também exigem que você colabore efetivamente com os usuários da instância remota ou das instâncias remotas. Certifique-se de se reunir com as partes interessadas envolvidas em sua integração regularmente para planejar, gerenciar e melhorar continuamente os processos de negócios automatizados com os quais sua integração de várias instâncias lida.
Figura 3. Gerenciando sua integração de sincronização de processo remoto
Definições de sincronização de processo
Uma definição de sincronização de processo contém todas as configurações para a integração da Sincronização de processo remoto. Comece criando um novo registro de definição de sincronização de processo para sua integração. Navegar até IntegrationHub > Remote Process Synchronization > Definições de sincronização de processoe, em seguida, clique em Novo. No formulário Definição de sincronização de processo, preencha os seguintes campos:
Campo
Descrição
Nome
Insira um nome que descreva com precisão com qual parte do processo de negócios sua instância lida. Por exemplo, se os usuários em sua instância trabalharem para atender às solicitações do Catálogo de serviços para seus clientes, insira um nome como Execução de solicitação do Catálogo de serviços.
Descrição
Opcionalmente, descreva com qual parte do seu processo de negócios essa definição de sincronização de processo lida.
Clique em Enviare você poderá ver o registro de definição de sincronização de processo recém-criado na lista. Em seguida, selecione o registro de definição de sincronização de processo que você acabou de criar. Você pode ver que o registro de definição de sincronização de processo tem as seguintes listas relacionadas:
Definições de captura
Processar eventos
Sistemas remotos
Fluxos de saída
Fluxos de entrada
Consulte as seções a seguir para saber como definir as configurações de cada um desses itens relacionados.
Definições de captura
Uma definição de captura especifica quando sua instância deve enviar dados para uma instância remota e quais dados sua instância deve enviar. Uma definição de captura contém as configurações do gatilho da definição de sincronização de processo e dos campos capturados. O gatilho especifica qual operação de registro, como criar, atualizar ou excluir um registro, faz com que sua instância envie dados para uma instância remota. Quando uma definição de captura é acionada, ela cria um objeto a partir de um registro de origem, que contém campos capturados. Em seguida, o fluxo de saída começa a ser executado e correlaciona os campos capturados do registro de origem aos campos em um registro relacionado no sistema remoto.
Um registro de definição de captura tem os seguintes campos:
Campo
Descrição
Processar evento
No formulário Definição de captura, use a pesquisa usando o ícone de lista ( ) para escolher o registro de evento de processo que você deseja associar a esta definição de captura. Se ainda não existir nenhum evento de processo, insira um nome para o evento de processo e o sistema criará automaticamente um registro de evento de processo e associará o registro à sua definição de captura. Para obter mais informações, consulte Processar eventos.
Estado
Escolha Ativo para ativar esta definição de captura para que a definição de sincronização do processo primário seja acionada quando as condições definidas na seção Gatilho deste formulário forem atendidas.
Ordem
Insira um valor para a ordem na qual você deseja que sua definição de captura seja acionada em relação a outras definições de captura. Os valores de ordem inferior são respeitados antes dos valores de ordem superior.
Na seção Gatilho, escolha uma tabela de origem autorizada cujos registros você deseja que acionem a definição de sincronização do processo. Você também pode adicionar condições de campo que, quando atendidas, fazem com que a definição de sincronização do processo seja acionada. Quando as condições são atendidas para o gatilho especificado na definição de captura, todos os fluxos de saída associados à definição de sincronização de processo começam a ser executados. Para obter mais informações, consulte Fluxos de saída e fluxos de entrada.
Campo
Descrição
Nome da tabela de origem
Escolha uma tabela autorizada cujos registros acionarão sua definição de sincronização de processo sempre que os registros forem criados, atualizados e excluídos.
Filtrar
Use o construtor de condições para adicionar condições que, quando atendidas, acionarão a definição de sincronização do processo. Por exemplo, selecionar [Estado] > [é] > [Trabalho em andamento] faz com que a definição de sincronização do processo seja acionada sempre que um registro no Estado da tabela selecionada é atualizado para Trabalho em andamento.
Por fim, na seção Capturar, adicione à lista Selecionado os campos que você deseja incluir na carga útil do fluxo de saída.
Campo
Descrição
Incluir campos
Adicione campos à lista Selecionada que você deseja sincronizar com campos na instância remota sempre que a definição de sincronização do processo for acionada. Use o ícone ) para adicionar campos da lista Disponível à lista Selecionada.
Nota:
Quando a integração é executada, a carga de saída enviada para instâncias remotas sempre contém esses campos capturados, independentemente de terem sido atualizados ou não.
Você pode mapear esses campos capturados para campos na instância remota configurando mapeamentos no fluxo de entrada da instância remota que está associado ao mesmo evento de processo. Para obter mais informações, consulte Fluxos de saída e eufluxos nbound.
Incluir anexos
Se selecionado, todos os anexos associados aos registros de acionamento em sua instância local serão sincronizados com anexos em registros correlacionados na instância remota. Para obter mais informações, consulte
Um evento de processo especifica qual parte do processo de negócios começa na instância local e termina na instância remota. O registro de evento de processo em sua instância local e na instância remota deve ter o mesmo nome porque o evento de processo significa o link entre essas instâncias que permite que elas compartilhem partes do mesmo processo de negócios. Um registro de evento de processo tem os seguintes campos:
Campo
Descrição
Nome
Insira um nome que descreva a parte do processo de negócios que começa na instância local e termina na instância remota. Por exemplo, se os usuários em sua instância solicitarem o software que será provisionado na instância remota, você poderá nomear o evento de processo O usuário solicita software.
Nota:
Um administrador da instância remota, ou instâncias remotas, também deve criar um evento de processo com o mesmo nome que você usa aqui. A criação desses eventos de processo em instâncias separadas cria o link lógico que permite integrar dados entre várias instâncias.
Um sistema remoto contém as configurações das conexões de saída e de entrada relacionadas a outra instância ServiceNow. Um registro de sistema remoto tem os seguintes campos:
Campo
Descrição
Nome
Insira um nome que descreva a instância remota. Por exemplo, se a instância for gerenciada por um de seus clientes, o Cliente A, insira a Instância do cliente A no campo de nome.
Descrição
Opcionalmente, insira mais detalhes que descrevam a finalidade geral da instância remota em seu processo de negócios.
ID externo
Insira o SYS ID do registro do sistema remoto que compartilha o mesmo evento de processo com sua instância. Para obter o SYS ID de um registro, selecione Copiar sys_id no menu de contexto ( de contexto) na exibição de formulário do registro. Por exemplo, se a integração da Sincronização de processo remoto abranger duas instâncias, a Instância A e a Instância B, use o SYS ID do registro de Sistema remoto da Instância A como o ID externo na Instância B e vice-versa. Conectar os SYS IDs e os IDs externos dessa maneira ajuda várias instâncias a saber a qual instância se conectar quando os fluxos automatizados de saída e de entrada são executados.
Selecione a pesquisa usando o ícone de lista ( ) para localizar e escolher um subfluxo que você deseja executar quando a conexão com a instância remota falhar. O subfluxo selecionado será executado sempre que sua instância local não puder se conectar à instância remota após o gatilho da definição de sincronização de processo. Você pode exibir os sistemas remotos aos quais sua instância falha ao se conectar navegando até IntegrationHub > Remote Process Synchronization > Sistemas remotos - Com erros.
Alias de conexão
Selecione o ícone Pesquisar usando lista ( ) para localizar e escolher um registro de alias de conexão e credencial que você deseja usar para autenticar com a instância remota. Se você ainda não configurou um registro de alias de conexão e credencial para essa finalidade, crie um novo registro com conexão e credencial no campo tipo. Para obter mais informações, consulte Criar um alias de conexão e credencial.
Estado de saída
Defina como Desabilitado por padrão. Você pode alterar o valor deste campo para Ativo selecionando o link relacionado Validar e ativar sistema remoto na exibição de formulário deste registro de sistema remoto após terminar de criar o registro.
Usuário da API de entrada
Usuário que pode se conectar à instância remota. Este usuário deve ter credenciais que correspondam às do usuário com a função ih_process_sync_api na instância remota.
Executar fluxos de entrada como
Selecione a pesquisa usando o ícone de lista ( ) para localizar e escolher um usuário para o qual você deseja executar o fluxo de entrada do evento de processo associado. Opção que você pode selecionar para especificar que o fluxo seja executado como um usuário do sistema ou o usuário que inicia a sessão. Selecione o usuário que inicia a opção de sessão quando as atualizações devem vir do usuário que acionou o fluxo. Por exemplo, use esta opção quando quiser que os comentários do registro de incidente sejam do usuário atual ou se quiser que os e-mails de aprovação sejam originados pelo aprovador. As configurações da opção "run as" em um fluxo não se aplicam a subfluxos secundários.
Estado de entrada
Defina como Desabilitado por padrão. Você pode alterar o valor deste campo para Ativo selecionando o link relacionado Validar e ativar sistema remoto na exibição de formulário deste registro de sistema remoto após terminar de criar o registro.
Nota:
Depois de criar um registro de sistema remoto com os campos apropriados preenchidos, você deve clicar no link relacionado Validar e ativar sistema remoto. Clicar neste link verifica se você pode se conectar com sucesso à instância remota e ativa as conexões de saída e de entrada.
Depois de criar um registro de evento de processo e um registro de sistema remoto, você pode associar Workflow Studio subfluxos a esses registros para que as ações automatizadas sejam executadas sempre que a definição de sincronização do processo for acionada.
Fluxos de saída e eufluxos nbound
Um fluxo de saída especifica qual subfluxo Workflow Studio sua instância usa para:
Processar dados locais, como campos capturados na definição de captura, que serão enviados para a instância remota
Correlacione esses dados com os dados na instância remota
Enviar estes dados para a instância remota
Um registro de Fluxo de saída tem os seguintes campos:
Campo
Descrição
Processar evento
Selecione a pesquisa usando o ícone de lista (ícone a lista) para localizar e escolher o registro de evento de processo que você deseja associar a este fluxo de saída. O evento de processo selecionado deve estar logicamente relacionado às ações automatizadas que o fluxo de saída executará quando a definição de sincronização do processo for acionada. Por exemplo, se o fluxo de saída mapeia campos de um registro de Solicitação de Item do Catálogo de serviços enviado por usuários em sua instância local para campos relacionados na instância remota, escolha um evento de processo relacionado aos usuários que fazem solicitações de item do Catálogo de serviços.
Subfluxo de saída
Selecione a pesquisa usando o ícone de lista ( ) para localizar e escolher o subfluxo Workflow Studio que você deseja executar sempre que a definição de sincronização do processo for acionada. Sua instância fornece um modelo de fluxo de saída de sincronização de processo remoto - Subfluxo básico que você pode usar como um modelo em qualquer registro de fluxo de saída. No entanto, você pode personalizar o modelo de fluxo de saída de sincronização de processo remoto - subfluxo básico para que ele atenda às necessidades do seu processo de negócios. Você pode personalizar este subfluxo usando as ações de saída da Sincronização de processo remoto. Para obter mais informações, consulte Criar sua primeira integração de sincronização de processo remoto.
Sistema remoto
Selecione a pesquisa usando o ícone de lista ( ) para localizar e escolher o registro do sistema remoto ao qual você deseja se conectar quando o fluxo de saída executar ações automatizadas que exijam autenticação com a instância remota. O registro do sistema remoto escolhido deve ser a instância remota que lida com a parte de entrada da integração do Remote Process Synchronization.
Um fluxo de entrada especifica qual subfluxo Workflow Studio sua instância usa para:
Correlacionar dados na instância local com os dados enviados da instância remota
Mapear campos enviados da instância remota para campos na instância local
Dados de processo enviados da instância remota para a instância local
Um registro de Fluxo de entrada tem os seguintes campos:
Campo
Descrição
Processar evento
Selecione a pesquisa usando o ícone de lista ( ) para localizar e escolher o registro de evento de processo que você deseja associar a este fluxo de entrada. O evento de processo selecionado deve estar logicamente relacionado às ações automatizadas que o fluxo de entrada executará quando a instância local estiver pronta para lidar com a carga enviada pela instância remota. Por exemplo, se o fluxo de entrada mapeia campos de um registro de solicitação de item do Catálogo de serviços que os usuários na instância remota enviaram para campos relacionados em sua instância local, escolha um evento de processo relacionado aos usuários que fazem solicitações de item do Catálogo de serviços.
Subfluxo de entrada
Selecione o ícone Pesquisar usando lista ( ) para localizar e escolher o subfluxo Workflow Studio que você deseja executar sempre que sua instância lidar com dados enviados por uma instância remota. Sua instância fornece um modelo de fluxo de entrada de sincronização de processo remoto - Subfluxo básico que você pode usar como modelo em qualquer registro de fluxo de entrada. No entanto, você pode personalizar o modelo de fluxo de entrada de sincronização de processo remoto - subfluxo básico para que ele atenda às necessidades do seu processo de negócios. Você pode personalizar este subfluxo usando as ações de entrada da Sincronização de processo remoto. Para obter mais informações, consulte Criar sua primeira integração de sincronização de processo remoto.
Sistema remoto
Selecione a pesquisa usando o ícone de lista ( ) para localizar e escolher o registro do sistema remoto ao qual você deseja se conectar quando o fluxo de entrada executar ações automatizadas que exijam autenticação com a instância remota. O registro do sistema remoto escolhido deve ser a instância remota que lida com a parte de saída da integração do Remote Process Synchronization.
Cada fluxo de saída e fluxo de entrada deve estar sempre associado a um evento de processo e somente a um sistema remoto.
Antes de simplesmente escolher os subfluxos Modelo de fluxo de saída de Sincronização de processo remoto - Básica ou Modelo de fluxo de entrada de Sincronização de processo remoto - Básica fornecidos pelo sistema para sua definição de sincronização de processo, convém personalizar esses subfluxos em Workflow Studio.
Sincronizando anexos
Você pode optar por enviar anexos associados ao registro local usando a opção Incluir anexos na definição de captura. No entanto, a Sincronização de processo remoto lida com anexos de forma diferente de outros dados em sua integração devido a problemas de segurança e tamanho do arquivo de anexo:
Na primeira vez em que um registro em sua integração é sincronizado, todos os anexos são enviados na carga de saída. As sincronizações subsequentes podem enviar mudanças para anexos ou todos os anexos.
Os metadados do anexo são sempre enviados com a carga de saída. Esses metadados incluem uma chave sintética criptografada, hash, nome de arquivo, tipo de conteúdo e tamanho.
A instância remota decide quais anexos receber comparando cada hash e nome de arquivo da carga de entrada com aqueles na instância. Em seguida, ocorre o seguinte processo:
O sistema de origem valida a chave e envia anexos para o registro de correlação.
O sistema de origem notifica o sistema remoto de que os anexos estão concluídos.
O sistema remoto move os anexos do registro de correlação para o registro de destino.
Como sincronizar comentários e anotações de trabalho
Em sua integração, os comentários e anotações de trabalho são sincronizados entre instâncias somente quando ocorrem mudanças nesses campos de diário. Os metadados de mudança são incluídos nas cargas úteis para que os sistemas remotos possam identificar qual usuário criou o comentário ou anotação de trabalho e quando ele foi criado.
Filas de saída e filas de entrada
Depois de criar sua integração de Sincronização de processo remoto criando e configurando os registros mencionados nas seções anteriores, você pode gerenciar sua integração monitorando a fila de saída e a fila de entrada em sua instância.
Uma fila de saída contém o status, informações de erro, dados de nova tentativa e informações de contexto de fluxo para subfluxos de saída que foram executados para dados que foram enviados de sua instância. Para exibir os registros na fila de saída, navegue até IntegrationHub > Remote Process Synchronization > Estado da fila de saída.
Um registro de Estado da fila de saída tem os seguintes campos:
Campo
Descrição
Criação
Data em que ocorreu a ação automatizada na sua integração
Metadados para todas as políticas de nova tentativa configuradas para sua carga de saída
Status
Status de processamento da carga na fila de saída. As opções incluem:
Pronto
Processado
Erro
Omitido
Domínio
Domínio no qual a ação automatizada para sua integração foi executada
Contexto de subfluxo de saída
SYS ID do registro de execução para o fluxo de saída que processou a carga
Nota:
Você pode obter informações de solução de problemas mais detalhadas para cargas de saída em registros de Fila de saída associados. Para acessar esses registros, navegue até IntegrationHub > Remote Process Synchronization > Fila de saída.
Uma fila de entrada contém o status, a sequência de processamento e as informações de correlação dos subfluxos de entrada que foram executados para dados que foram enviados de uma instância remota para sua instância local. Para exibir os registros na fila de entrada, navegue até IntegrationHub > Remote Process Synchronization > Fila de entrada.
Um registro de Fila de entrada tem os seguintes campos:
Campo
Descrição
Sequência
Ordem na fila. Um número menor é processado antes de um número maior.
Status
Status de processamento da carga na fila de entrada. As opções incluem:
Pronto
Processado
Erro
Omitido
Nota:
Se um registro de Fila de entrada tiver um status de Erro, altere o status para Pronto para tentar processar novamente a carga de entrada.
Domínio no qual a ação automatizada para sua integração foi executada
Carga
Cadeia de caracteres como carga JSON para dados de entrada
Nota:
As tabelas Fila de saída e Fila de entrada são mantidas por limpadores de tabela que removem registros dessas tabelas a cada 30 dias.
Como monitorar e solucionar problemas de integração
Você pode usar as seguintes tabelas para monitorar sua integração de Sincronização de processo remoto, depois que ela estiver criada e em execução:
Tabela
Descrição
Estatísticas de XML
Consulte a seção process_sync_queue para obter informações sobre as filas de saída e de entrada da sua integração, incluindo o tamanho da fila, bem como as taxas de erro e de processamento.
Fila de saída
Exiba os dados de captura dos registros que são preparados para serem enviados para fora da sua instância.
Estado da fila de saída
Exibir o estado dos registros na tabela Fila de saída.
Fila de entrada
Exiba a fila de entrada e a tabela de registros combinadas.
Logs
Comece ativando a depuração definindo a propriedade do sistema glide.ih.process.sync.debug como verdadeira. Em seguida, verifique os logs em busca de mensagens de erro que começam com OutboundQueueDao e InboundQueueDao para encontrar mensagens de log com mais informações sobre possíveis problemas com sua integração.
Se ocorrer um erro com a integração da Sincronização de processo remoto, comece confirmando se o erro é de conexão ou de processamento de dados:
Erros de conexão
Os erros de conexão de saída tentam novamente várias vezes antes de definir o Estado de saída do registro do sistema remoto como Erro. Se os erros continuarem ocorrendo para uma conexão de saída, confirme se nada mudou com o usuário da API de entrada do sistema remoto, como uma mudança nas credenciais do usuário. Em seguida, valide e ative o registro do sistema remoto novamente.
Erros de processamento de dados
Erros de processamento de dados normalmente ocorrem como resultado de erros em um fluxo de saída ou de entrada. Para solucionar esses erros, você pode adicionar ações de manipulação de erros ao fluxo, como uma ação Registrar ou Enviar e-mail, quando o Estado do fluxo mudar para Erro. Você também pode adicionar ações que reprocessam ou ignoram o processamento de registros nas tabelas Fila de saída ou Fila de entrada se ocorrer um erro com o fluxo.
) para escolher o registro de evento de processo que você deseja associar a esta definição de captura. Se ainda não existir nenhum evento de processo, insira um nome para o evento de processo e o sistema criará automaticamente um registro de evento de processo e associará o registro à sua definição de captura. Para obter mais informações, consulte Processar eventos.
) para adicionar campos da lista Disponível à lista Selecionada.
de contexto) na exibição de formulário do registro. Por exemplo, se a integração da Sincronização de processo remoto abranger duas instâncias, a Instância A e a Instância B, use o SYS ID do registro de Sistema remoto da Instância A como o ID externo na Instância B e vice-versa. Conectar os SYS IDs e os IDs externos dessa maneira ajuda várias instâncias a saber a qual instância se conectar quando os fluxos automatizados de saída e de entrada são executados.