Aprenda o básico sobre como configurar uma integração de sincronização de processo remoto para vincular os processos automatizados entre duas ou mais instâncias ServiceNow®.
Nota:
IntegrationHub A Sincronização de processo remoto requer uma assinatura do pacote IntegrationHub Enterprise. Para obter mais informações, consulte Solicitação IntegrationHub.
Antes de começar a usar a integração de 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 se há erros com sua integração de sincronização de processo remoto, consulte Filas de saída e filas de entrada e Monitoramento e solução de problemas da sua 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 Flow Designer.
Nota:
Criar e gerenciar uma integração de sincronização de processo remoto em sua instância também requer que você colabore de forma eficaz com os usuários da instância remota ou 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 que sua integração de várias instâncias processa.
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 da sua integração de 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 de definição de sincronização de processo, preencha os seguintes campos:
Campo
Descrição
Nome
Insira um nome que descreva com precisão qual parte do processo de negócios sua instância processa. Por exemplo, se os usuários em sua instância trabalharem para atender a 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 qual parte do seu processo de negócios essa definição de sincronização de processo processa.
Se o seu processo estiver relacionado a um domínio específico, escolha um domínio diferente de global. Para obter mais informações, consulte Domain Separation para provedores de serviço.
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.
Capturar definições
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 do 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 de 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 houver 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 mais baixos são respeitados antes dos valores de ordem mais altos.
Se o seu processo estiver relacionado a um domínio específico, escolha um domínio diferente de global. Para obter mais informações, consulte Domain Separation para provedores de serviço.
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 sua definição de sincronização de processo seja acionada. Quando as condições do gatilho especificado na definição de captura são atendidas, todos os fluxos de saída associados à definição de sincronização do 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.
Filtro
Use o construtor de condição para adicionar condições que, quando atendidas, acionarão sua definição de sincronização de 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 for atualizado para Trabalho em andamento.
Por fim, na seção Capturar, adicione os campos à lista Selecionado que você deseja incluir na carga do fluxo de saída.
Campo
Descrição
Incluir campos
Adicione campos à lista Selecionado que você deseja sincronizar com campos na instância remota sempre que sua definição de sincronização de processo for acionada. Use o ícone adicionar item ( ícone ) para adicionar campos da lista Disponível à lista Selecionado.
Nota:
Quando sua integração é executada, a carga útil 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 ifluxos nbound.
Incluir anexos
Se selecionado, todos os anexos associados aos registros-gatilho em sua instância local serão sincronizados com os anexos em registros correlacionados na instância remota. Para obter mais informações, consulte
Um evento de processo especifica qual parte do seu processo de negócios começa em sua 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 seu processo de negócios que começa em sua instância local e termina na instância remota. Por exemplo, se os usuários em sua instância solicitarem software que será provisionado na instância remota, você poderá nomear o evento de processo Solicitações de software pelo usuário.
Nota:
Um administrador da instância remota, ou instâncias remotas, também deve criar um evento de processo com o mesmo nome usado aqui. Criar esses eventos de processo em instâncias separadas cria o link lógico que permite integrar dados entre várias instâncias.
Se o seu processo estiver relacionado a um domínio específico, escolha um domínio diferente de global. Para obter mais informações, consulte Domain Separation para provedores de serviço.
Sistemas remotos
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 sua integração de sincronização de processo remoto abranger duas instâncias, instância A e instância B, use o ID do sistema do registro do sistema remoto da instância A como o ID externo na instância B e vice-versa. Conectar os IDs do sistema e os IDs externos dessa maneira ajuda várias instâncias a saber a qual instância se conectar quando os fluxos de saída e de entrada automatizados são executados.
Se o seu processo estiver relacionado a um domínio específico, escolha um domínio diferente de global. Para obter mais informações, consulte Domain Separation para provedores de serviço.
Subfluxo de erro
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 do processo. Você pode exibir sistemas remotos aos quais sua instância não consegue se conectar navegando até IntegrationHub > Remote Process Synchronization > Sistemas remotos - Com erros.
Alias de Conexão
Selecione a pesquisa usando o ícone de 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
Definido 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 depois de 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 para o 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
Definido 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 depois de 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 subfluxos Flow Designer 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 ifluxos nbound
Um fluxo de saída especifica qual subfluxo Flow Designer 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 ( ) 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 Flow Designer 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 modelo em qualquer registro de fluxo de saída. No entanto, você pode personalizar o subfluxo Modelo de fluxo de saída de sincronização de processo remoto - 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 exigem autenticação com a instância remota. O registro de sistema remoto escolhido deve ser a instância remota que lida com a parte de entrada da integração do Remote Process Synchronization.
Se o seu processo estiver relacionado a um domínio específico, escolha um domínio diferente de global. Para obter mais informações, consulte Domain Separation para provedores de serviço.
Um fluxo de entrada especifica qual subfluxo Flow Designer 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 sua 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 a pesquisa usando o ícone de lista ( ) para localizar e escolher o subfluxo Flow Designer 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 subfluxo Modelo de fluxo de entrada de sincronização de processo remoto - 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 do Remote Process Synchronization. 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 exigem autenticação com a instância remota. O registro de sistema remoto escolhido deve ser a instância remota que lida com a parte de saída da integração do Remote Process Synchronization.
Se o seu processo estiver relacionado a um domínio específico, escolha um domínio diferente de global. Para obter mais informações, consulte Domain Separation para provedores de serviço.
Nota:
Cada fluxo de saída e fluxo de entrada deve estar sempre associado a um evento de processo e apenas a um sistema remoto.
Antes de simplesmente escolher o Modelo de fluxo de saída de sincronização de processo remoto - Básico ou o Modelo de fluxo de entrada de sincronização de processo remoto - Básico fornecido pelo sistema para a definição de sincronização de processo, convém personalizar esses subfluxos em Flow Designer.
Sincronizando anexos
Você pode optar por enviar anexos associados ao seu registro local usando a opção Incluir anexos na definição de captura. No entanto, o Remote Process Synchronization lida com anexos de forma diferente de outros dados na sua integração devido a problemas de segurança e de tamanho de arquivo de anexo:
Na primeira vez em que um registro é sincronizado em sua integração, todos os anexos são enviados na carga útil 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 útil de entrada com os da 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.
Sincronizando comentários e anotações de trabalho
Em sua integração, os comentários e anotações de trabalho são sincronizados entre as 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 em sua 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 de 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
Ignorado
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 úteis 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 executados para dados que foram enviados de uma instância remota para sua instância local. Para exibir os registros em sua 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
Ignorado
Nota:
Se um registro de Fila de entrada tiver um status de Erro, altere o status para Pronto para tentar processar novamente a carga útil de entrada.
Tipo de operação de registro que a instância remota executou, o que fez com que a instância remota acionasse e enviasse dados. As opções incluem:
Criar
Atualizar
Excluir
Contexto de transformação
SYS ID do registro de execução do fluxo de entrada que processou a carga
ID de correlação local
ID de correlação na instância local
ID de correlação remota
ID de correlação na instância remota
Sistema remoto
Registro desistema remoto associado à instância que enviou os dados
Domínio
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.
Monitoramento e solução de problemas da sua integração
Você pode usar as tabelas a seguir 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
Exiba a seção process_sync_queue para obter informações sobre as filas de saída e de entrada para 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 da sua instância.
Estado da fila de saída
Exiba o estado dos registros na tabela Fila de saída.
Fila de entrada
Exiba a fila de entrada combinada e a tabela de registros.
Logs
Comece ativando a depuração definindo a propriedade do sistema glide.ih.process.sync.debug como verdadeiro. 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 do Remote Process Synchronization, comece confirmando se o erro é um erro de conexão ou um erro 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
Os erros de processamento de dados geralmente ocorrem como resultado de erros em um fluxo de saída ou de entrada. Para solucionar esses erros, você pode adicionar ações de tratamento de erros ao fluxo, como uma ação de log ou uma ação de envio de e-mail, quando o estado do fluxo muda 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 houver 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 Selecionado.
de contexto) na exibição de formulário do registro. Por exemplo, se sua integração de sincronização de processo remoto abranger duas instâncias, instância A e instância B, use o ID do sistema do registro do sistema remoto da instância A como o ID externo na instância B e vice-versa. Conectar os IDs do sistema e os IDs externos dessa maneira ajuda várias instâncias a saber a qual instância se conectar quando os fluxos de saída e de entrada automatizados são executados.