Ir para o conteúdo

Conexão ServiceNow v2 no Jitterbit Studio

Introdução

Uma conexão ServiceNow v2, criada usando o conector ServiceNow v2, estabelece acesso ao ServiceNow. Após configurar uma conexão, você pode criar instâncias de atividades ServiceNow v2 associadas a essa conexão para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Importante

Antes de configurar uma conexão ServiceNow v2, revise os pré-requisitos do ServiceNow v2 para garantir que a instância do ServiceNow tenha sido configurada corretamente e que você tenha as credenciais necessárias para o tipo de autenticação necessário.

Este conector também suporta a política organizacional Habilitar Reautenticação ao Alterar. Se habilitada, uma alteração no Nome de usuário, ID do cliente ou Instância do ServiceNow nesta conexão exigirá que os usuários reinsiram a Senha e o Segredo do cliente (OAuth2.0) da conexão.

Criar ou editar uma conexão ServiceNow v2

Uma nova conexão ServiceNow v2 é criada usando o conector ServiceNow v2 em um destes locais:

Uma conexão ServiceNow v2 existente pode ser editada nestes locais:

Configurar uma conexão ServiceNow v2

Cada elemento da interface do usuário da tela de configuração da conexão ServiceNow v2 é 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 clique no ícone de variável para exibir uma lista das 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 v2 e não deve conter barras / ou dois-pontos :. Este nome também é usado para identificar o endpoint ServiceNow v2, que se refere a uma conexão específica e suas atividades.

  • Instância do ServiceNow: Digite o nome da instância do ServiceNow ou a URL completa da instância. O nome da instância é usado como o subdomínio da URL da sua instância (instance_name.service-now.com) e também é encontrado na propriedade do sistema instance_name. Por exemplo, dev123 é o nome da instância em dev123.service-now.com. Se inserir a URL completa da instância, tanto http:// quanto https:// são aceitos, mas a conexão é sempre feita usando https.

  • Autenticação: Selecione o tipo de autenticação a usar para a instância do ServiceNow com o usuário autenticado configurado nos pré-requisitos do ServiceNow v2, seja OAuth2.0 (padrão) ou Autenticação básica. Selecionar OAuth2.0 habilita a configuração de ID do cliente e Segredo do cliente.

  • OAuth2.0 requer estes campos:

    • Nome de usuário: Digite o nome de usuário associado ao usuário autenticador.

    • Senha: Digite a senha associada ao usuário autenticador.

    • ID do cliente (OAuth2.0): Digite o ID do cliente associado ao usuário autenticador.

    • Segredo do cliente (OAuth2.0): Digite o segredo do cliente associado ao usuário autenticador.

  • Autenticação básica requer estes campos:

    • Nome de usuário: Digite o nome de usuário associado ao usuário autenticador.

    • Senha: Digite a senha associada ao usuário autenticador.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais:

    • Versão da API: Selecione a versão da API ServiceNow, uma de Mais recente (padrão), V1 ou V2. Mais recente sempre roteia para a versão mais recente da API suportada pelo ServiceNow. Selecionar uma versão específica força o uso da versão do endpoint da API selecionada, removendo ambiguidade de versão. Por exemplo, se V1 for selecionado, as chamadas da API farão referência explícita a /api/now/v1/.

    • Usar configurações de proxy (somente agente privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar configurações de proxy do agente privado.

    • Desativar filtro de acesso: Selecione esta configuração para desabilitar a filtragem da lista de controle de acesso e listar todas as tabelas independentemente das permissões do usuário autenticador para a operação da atividade.

  • Testar: Clique para verificar a conexão usando a configuração especificada. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) 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 organizacional Desabilitar atualização automática do conector.

  • Salvar: Clique para salvar e fechar a configuração de conexão.

  • Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme que deseja descartar as alterações.

  • Excluir: Após 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 que deseja excluir a conexão.

Próximas etapas

Após criar uma conexão ServiceNow v2, 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 do conector.

Estes tipos de atividade estão disponíveis:

  • Consulta: Recupera registros do ServiceNow e destina-se a ser usado como uma fonte em uma operação.

  • Criar: Cria novos registros no ServiceNow e destina-se a ser usado como um destino em uma operação.

  • Atualizar: Atualiza registros existentes no ServiceNow e destina-se a ser usado como um destino em uma operação.

  • Excluir: Exclui registros existentes do ServiceNow e destina-se a ser usado como um destino em uma operação.