Conexão ServiceNow (Descontinuada) no Jitterbit Studio
Aviso
O conector ServiceNow foi descontinuado e não é mais suportado. Em uma versão futura, este conector será permanentemente removido. Use o conector ServiceNow v2 em seu lugar.
Introdução
Uma conexão ServiceNow, criada usando o conector ServiceNow, estabelece acesso ao ServiceNow. Após configurar uma conexão, você pode criar instâncias de atividades ServiceNow associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).
Nota
Antes de configurar uma conexão ServiceNow, consulte os pré-requisitos do ServiceNow para garantir que a instância do ServiceNow tenha sido configurada corretamente.
Nota
Este conector suporta a política organizacional Ativar Reautenticação na Alteração. Se ativada, uma alteração em ID do Cliente, Nome de Usuário ou Instância nesta conexão exigirá que os usuários reinserçam a Senha do Cliente e a Senha da conexão.
Criar ou editar uma conexão ServiceNow
Uma nova conexão ServiceNow é criada usando o conector ServiceNow de um destes locais:
- A guia Endpoints do projeto e conectores da paleta de componentes de design (consulte Paleta de componentes de design).
- A página Endpoints Globais (consulte Criar um endpoint global em Endpoints Globais).
Uma conexão ServiceNow existente pode ser editada a partir destes locais:
- A guia Endpoints do projeto e conectores da paleta de componentes de design (consulte Paleta de componentes de design).
- A guia Componentes do painel do projeto (consulte Menu de ações de componente em Guia Componentes do painel do projeto).
- A página Endpoints Globais (consulte Editar um endpoint global em Endpoints Globais).
Configurar uma conexão ServiceNow
Cada elemento da interface do usuário da tela de configuração da conexão ServiceNow é descrito abaixo.
Dica
Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete de abertura [ no campo ou clicando no ícone de variável para exibir um menu listando as variáveis existentes para escolher.
-
Nome da Conexão: Digite um nome para identificar a conexão. O nome deve ser único para cada conexão ServiceNow e não deve conter barras
/ou dois-pontos:. Este nome também é usado para identificar o endpoint ServiceNow, que se refere a uma conexão específica e suas atividades. -
ID do Cliente: Digite o ID do cliente para a instância ServiceNow. Consulte pré-requisitos do ServiceNow para obter detalhes.
-
Senha do Cliente: Digite a senha do cliente para a instância ServiceNow. Consulte pré-requisitos do ServiceNow para obter detalhes.
-
Nome de Usuário: Digite o nome de usuário para a instância ServiceNow. Consulte pré-requisitos do ServiceNow para obter detalhes.
-
Senha: Digite a senha para a instância ServiceNow. Consulte pré-requisitos do ServiceNow para obter detalhes.
-
Instância: Insira a URL da instância do ServiceNow, como
https://example.service-now.com/. -
Configurações Avançadas: Quando selecionado, exibe a tabela Propriedades de Configurações Avançadas, usada para adicionar propriedades de configuração adicionais como pares de chave-valor. Clique no ícone adicionar para adicionar uma linha à tabela abaixo e insira um par de chave-valor para cada propriedade.
Para salvar a linha, clique no ícone enviar na coluna mais à direita.
Para editar ou excluir uma única linha, passe o mouse sobre a coluna mais à direita e use o ícone editar ou o ícone excluir .
Para excluir todas as linhas, clique em Limpar Tudo.
Importante
Os campos da tabela Propriedades de Configurações Avançadas exibem o ícone de variável apenas no modo de edição. Para que os valores das variáveis desses campos sejam preenchidos no tempo de execução, a versão do agente deve ser pelo menos 10.75 / 11.13.
Os campos da tabela Propriedades de Configurações Avançadas não suportam o uso de variáveis para passar JSON bruto. Se seu caso de uso não permitir definir JSON bruto diretamente nos campos, escape o conteúdo JSON antes de passar com uma variável. Por exemplo, ao fazer escape de
{"success": "true"};vira{\"success\": \"true\"};. -
Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelos agentes no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política de organização Desabilitar Atualização Automática de Conector.
-
Salvar: Clique para salvar e fechar a configuração da conexão.
-
Descartar alterações: Depois de fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme se deseja descartar as alterações.
-
Excluir: Depois de abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme se deseja excluir a conexão.
Configurar conexões OAuth
Este conector suporta uma conexão usando OAuth mediante o uso de propriedades de configuração específicas. Após especificar a propriedade de configuração avançada InitiateOAuth, é possível especificar a configuração necessária usando propriedades adicionais, conforme descrito abaixo.
Nota
IDs adicionais, segredos, escopos e outros tokens de autenticação podem ser necessários para completar com sucesso a autenticação OAuth. Consulte a documentação do endpoint para obter informações adicionais sobre seus requisitos.
Para este conector, dois cenários são suportados. Em qualquer um dos cenários, será necessário usar uma ferramenta de terceiros (como Postman ou uma ferramenta semelhante) para obter o token de acesso ou tokens necessários do endpoint envolvido. Ambos esses cenários funcionam apenas para grupos de agentes únicos. Estes são grupos de agentes que consistem em um único agente.
-
Cenário 1: Usando um token de acesso OAuth que expira após um período definido.
Com essa configuração, você fornece um token de acesso OAuth que dura um período definido, conforme determinado pelo endpoint específico. O conector usará o token para fazer a conexão. No entanto, a conexão deixará de funcionar após o token de acesso expirar. Você configuraria o conector para usar o token definindo estas propriedades:
Propriedade de Configuração Valor InitiateOAuth OFFOAuthAccessToken Defina como o valor do token de acesso OAuth obtido do endpoint -
Cenário 2: Usando um token de acesso OAuth combinado com um token de atualização OAuth para ativar a atualização automática de acesso.
Com essa configuração, o conector usará um token de atualização para obter um novo token de acesso quando o token de acesso atual expirar. Geralmente, este é o melhor método para configurar OAuth.
Você fornece um token de acesso OAuth e um token de atualização OAuth, conforme determinado pelo endpoint específico. Você configuraria o conector para usar esses tokens definindo essas propriedades:
Propriedade de Configuração Valor InitiateOAuth REFRESHOAuthAccessToken Definir para o valor do token de acesso OAuth obtido do endpoint OAuthRefreshToken Definir para o valor do token de atualização OAuth obtido do endpoint
Próximas etapas
Após criar uma conexão ServiceNow, coloque um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).
As ações de menu para uma conexão e seus tipos de atividade são acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, consulte Menus de ações em Noções básicas de conector.
Estes tipos de atividade estão disponíveis:
-
Query: Recupera registros do ServiceNow e destina-se a ser usado como uma fonte em uma operação.
-
Create: Cria novos registros no ServiceNow e destina-se a ser usado como um destino em uma operação.
-
Update: Atualiza registros existentes no ServiceNow e destina-se a ser usado como um destino em uma operação.
-
Delete: Exclui registros existentes do ServiceNow e destina-se a ser usado como um destino em uma operação.