Introdução ao Remote Process Sync

Aprenda os conceitos básicos da configuração de uma integração do Remote Process Sync para vincular os processos automatizados entre dois ou mais ServiceNow® instâncias juntas.

Nota:

IntegrationHub O Remote Process Sync requer uma assinatura do IntegrationHub Pacote empresarial. Para obter mais informações, consulte Solicitação IntegrationHub.

Antes de começar a usar sua integração do Remote Process Sync

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 ServiceNow AI 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 remota de processos substitui o spoke 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 o Remote Process Sync como sua estrutura de integração de várias instâncias, a próxima etapa será aprender sobre a diferença entre:

1. Criando sua integração, e.
2. Gerenciando sua integração

Criando sua integração envolve a criação e a configuração de uma definição de sincronização de processo e seus registros relacionados. Para obter mais informações sobre como começar a criar sua integração do Remote Process Sync, siga um exemplo de como fazê-lo Crie sua primeira integração do Remote Process Sync ou saiba mais sobre Definições de sincronização de processo .

Figura 2. Criando sua integração do Remote Process Sync

Gerenciando 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 sua integração do Remote Process Sync, consulte Filas de saída e filas de entrada e. Monitoramento e solução de problemas de 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 Workflow Studio.

Nota:

Criar e gerenciar uma integração do Remote Process Sync 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. Gerenciar sua integração do Remote Process Sync

Definições de sincronização de processo

. definição de sincronização do processo Contém todas as configurações da integração do Remote Process Sync. 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 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	Como opção, descreva qual parte do processo de negócios esta definição de sincronização de processo lida.
Aplicação	Definido automaticamente como seu atual escopo da aplicação .
Domínio	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 Enviar E, em seguida, você pode ver o registro de Definição de sincronização de processo recém-criado na lista. Em seguida, selecione o registro 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 para cada um desses itens relacionados.

Definições de captura

. 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 das suas definições de sincronização de processo gatilho e. 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 o ícone de pesquisa usando lista ( Para escolher o registro de evento de processo que você deseja associar a esta definição de captura. Se nenhum evento de processo existir ainda, 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 Eventos de processo .
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 de 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. Valores de ordem mais baixa são respeitados antes dos valores de ordem mais altos.
Aplicação	Definido automaticamente como seu atual escopo da aplicação .
Domínio	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 acionar sua definição de sincronização de 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 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 sua definição de sincronização de processo. Por exemplo, selecionando [Estado] > [é] > [Trabalho em andamento] Faz com que sua definição de sincronização de 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 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 a definição de sincronização de processo for acionada. Use o ícone adicionar item ( ) Para adicionar campos da lista Disponível à lista Selecionado. Nota: Quando sua integração é executada, a carga de saída enviada para instâncias remotas sempre contém esses campos capturados, independentemente de eles 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 eu fluxos nbound.
Incluir anexos	Se selecionado, todos os anexos associados a 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

Nota:

O RPS captura mudanças interativas e não interativas. Você pode configurar o RPS para ignorar mudanças não interativas, como mudanças feitas por meio de um trabalho agendado, definindo glide.hub.process.sync.capture.non_interactive.changespropriedade para falso . Para obter mais informações, consulte Como configurar a estrutura de Sincronização de processos remotos (RPS) para ignorar mudanças não interativas nos registros [KB1565025] artigo no Now Support Base de conhecimento.

Processar eventos

. evento do 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 eles 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 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. Criar esses eventos de processo em instâncias separadas cria o link lógico que permite integrar dados entre várias instâncias.
Aplicação	Definido automaticamente como seu atual escopo da aplicação .
Domínio	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

. sistema remoto contém as configurações das conexões de saída e de entrada relacionadas a outra ServiceNow instância. 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, Cliente A, insira 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 ( na exibição do formulário do registro. Por exemplo, se a integração do Remote Process Sync abranger duas instâncias, Instância A e Instância B, use o SYS ID do registro do sistema remoto da Instância A como o ID externo na Instância B e vice-versa. Conectar os SYS IDs e 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 entrada são executados.
Aplicação	Definido automaticamente como seu atual escopo da aplicação .
Domínio	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	Ícone de pesquisa usando 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 depois que a definição de sincronização de processo for acionada. 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	Ícone de pesquisa usando lista ( ) Para encontrar 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 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 Crie um alias de conexão e credencial .
Estado de saída	Definido como Desabilitado por padrão. Você pode mudar o valor deste campo para Ativo selecionando Validar e ativar o sistema remoto Link relacionado na exibição do formulário deste registro do sistema remoto depois que você 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.
Execute fluxos de entrada como	Ícone de pesquisa usando 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 para especificar o usuário que executa o fluxo. Você pode selecionar o 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 do incidente sejam provenientes do usuário que iniciou o fluxo. 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 mudar o valor deste campo para Ativo selecionando Validar e ativar o sistema remoto Link relacionado na exibição do formulário deste registro do sistema remoto depois que você terminar de criar o registro.

Nota:

Depois de criar um registro do sistema remoto com os campos apropriados preenchidos, você deve clicar em Validar e ativar o sistema remoto link relacionado. 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 com esses registros para que as ações automatizadas sejam executadas sempre que a definição de sincronização de processo for acionada.

Fluxos de saída e eu fluxos nbound

Um fluxo de saída especifica qual Workflow Studio subfluxo que sua instância usa para:

1. Processe dados locais, como campos capturados na definição de captura, que serão enviados para a instância remota
2. Correlacione esses dados com os dados na instância remota
3. Envie esses dados para a instância remota

Um registro de Fluxo de Saída tem os seguintes campos:

Campo	Descrição
Processar evento	Ícone de pesquisa usando 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 de processo for acionada. Por exemplo, se o fluxo de saída mapear 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	Ícone de pesquisa usando lista ( ) para encontrar e escolher Workflow Studio subfluxo que você deseja executar sempre que sua definição de sincronização de processo for acionada. Sua instância fornece um subfluxo Modelo de fluxo de saída de sincronização de processo remoto - 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 do Remote Process Sync. Para obter mais informações, consulte Crie sua primeira integração do Remote Process Sync .
Sistema remoto	Ícone de pesquisa usando lista ( Para encontrar 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 do sistema remoto escolhido deve ser a instância remota que lida com a parte de entrada da integração do Remote Process Sync.
Aplicação	Definido automaticamente como seu atual escopo da aplicação .
Domínio	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 Workflow Studio subfluxo que sua instância usa para:

1. Correlacione os dados na instância local com os dados enviados da instância remota
2. Mapear campos enviados da instância remota para campos na instância local
3. Processar dados 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	Ícone de pesquisa usando 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 mapear 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	Ícone de pesquisa usando lista ( ) para encontrar e escolher Workflow Studio subfluxo que você deseja executar sempre que sua instância lida 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 Sync. Para obter mais informações, consulte Crie sua primeira integração do Remote Process Sync .
Sistema remoto	Ícone de pesquisa usando lista ( Para encontrar 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 do sistema remoto escolhido deve ser a instância remota que lida com a parte de saída da integração do Remote Process Sync.
Aplicação	Definido automaticamente como seu atual escopo da aplicação .
Domínio	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 sempre deve ser associado a um evento de processo e somente um sistema remoto.

Antes de simplesmente escolher os subfluxos Modelo de fluxo de saída de sincronização de processo remoto - Básico ou Modelo de fluxo de entrada de sincronização de processo remoto - Básico 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 seu registro local usando a opção Incluir anexos em seu definição de captura . No entanto, o Remote Process Sync 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 que um registro em sua integração é sincronizado, todos os anexos são enviados na carga de saída. Sincronizações subsequentes podem enviar mudanças em 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 os da instância. Em seguida, ocorre o seguinte processo:
  1. O sistema de origem valida a chave e envia anexos para o registro de correlação.
  2. O sistema de origem notifica o sistema remoto de que os anexos estão concluídos.
  3. 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, comentários e anotações de trabalho são sincronizados entre as instâncias somente quando ocorrem mudanças nesses campos de registro. 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 a anotação de trabalho e quando ela foi criada.

Filas de saída e filas de entrada

Depois de criar sua integração do Remote Process Sync 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.

Um fila de saída contém o status, as informações de erro, os dados de novas tentativas e as informações de contexto de fluxo para subfluxos de saída que foram executados para os dados que foram enviados da 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 em	Data em que ocorreu a ação automatizada em sua integração
Informações do erro	Mensagem de status da carga de saída
Processar evento	Evento do processo
Sistema remoto	Sistema remoto
Recuperar metadados	Metadados para políticas de novas tentativas 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 da sua integração foi executada
Contexto de subfluxo de saída	SYS ID do registro de execução do 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 nos registros da Fila de saída associados. Para acessar esses registros, navegue até IntegrationHub > Remote Process Synchronization > Fila de saída.

Um fila de entrada contém o status, a sequência de processamento e as informações de correlação para 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 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 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.
Processar evento	Evento do processo associado à ação de integração
Operação	Tipo de operação de registro que a instância remota realizou, 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	Sistema remoto registro associado à instância que enviou os dados
Domínio	Domínio no qual a ação automatizada da 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 de sua integração

Você pode usar as seguintes tabelas para monitorar sua integração do Remote Process Sync, depois que ela estiver criada e em execução:

Tabela	Descrição
Estatísticas XML	Exiba process_sync_queueseção para obter informações sobre as filas de saída e de entrada para sua integração, incluindo o tamanho da fila, bem como taxas de erro e processamento.
Fila de saída	Exiba os dados de captura de registros que estão preparados para serem enviados para fora 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 registro.
Logs	Para começar, ative a depuração definindo glide.ih.process.sync.debugpropriedade do sistema para verdadeiro . Em seguida, verifique os Logs em busca de mensagens de erro começando com OutboundQueueDao e. QueueDao de entrada 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 Sync, 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 automaticamente várias vezes antes de definir o Estado de saída do registro do sistema remoto como Erro. Se os erros continuarem ocorrendo em uma conexão de saída, confirme se nada foi alterado 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 fluxo de entrada. Para solucionar esses erros, você pode adicionar ações de tratamento de erros ao seu fluxo, como uma ação Log 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.