Ir para o conteúdo

Conexão ServiceNow v2 (Beta) no Jitterbit Studio

Introdução

Uma conexão ServiceNow v2 (Beta), criada usando o conector ServiceNow v2 (Beta), estabelece acesso ao ServiceNow. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades ServiceNow v2 (Beta) associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Nota

Para acesso beta e para fornecer feedback, entre em contato com a Equipe de Produto Jitterbit.

Importante

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

Este conector também suporta a política de organização Habilitar Reautenticação em Caso de Alteração. Se habilitado, uma alteração no Nome de usuário, ID do cliente ou instância do ServiceNow nesta conexão requer que os usuários reentrem a Senha e o Segredo do cliente (OAuth2.0) para a conexão.

Criar ou editar uma conexão ServiceNow v2 (Beta)

Uma nova conexão ServiceNow v2 (Beta) é criada usando o conector ServiceNow v2 (Beta) a partir de uma dessas localizações:

Uma conexão ServiceNow v2 (Beta) existente pode ser editada a partir dessas localizações:

Configurar uma conexão ServiceNow v2 (Beta)

Cada elemento da interface do usuário da tela de configuração da conexão ServiceNow v2 (Beta) é 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 aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão ServiceNow v2 (Beta) e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint ServiceNow v2 (Beta), que se refere tanto a uma conexão específica quanto às suas atividades.

  • Instância ServiceNow: Insira o nome da instância ServiceNow ou a URL completa da instância. O nome da instância é usado como o subdomínio da sua URL de instância (instance_name.service-now.com) e também é encontrado na propriedade de sistema instance_name. Por exemplo, dev123 é o nome da instância em dev123.service-now.com. Se estiver inserindo 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 ser usado para o usuário autenticador da instância ServiceNow configurado nos pré-requisitos do ServiceNow v2 (Beta), seja OAuth2.0 (padrão) ou Basic Auth. Selecionar OAuth2.0 habilita a configuração de Client ID e Client secret.

    • OAuth2.0 requer estes campos:

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

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

      • Client ID (OAuth2.0): Insira o client ID associado ao usuário autenticador.

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

    • Autenticação Básica requer os seguintes campos:

      • Nome de usuário: Insira o nome de usuário associado ao usuário autenticado.

      • Senha: Insira a senha associada ao usuário autenticado.

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

    • Versão da API: Selecione a versão da API do ServiceNow, uma das opções Mais recente (padrão), V1 ou V2. Mais recente sempre direciona 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 a 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 (Apenas Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar as configurações de proxy do agente privado.

    • Desativar Filtro de Acesso: Selecione esta configuração para desativar o filtro de lista de controle de acesso e listar todas as tabelas, independentemente das permissões do usuário autenticado 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 a suspensão do download da versão mais recente do conector usando a política organizacional Desativar Atualização Automática do Conector.

  • Salvar Alterações: Clique para salvar e fechar a configuração da 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 pede para confirmar que você 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximos passos

Após a criação de uma conexão ServiceNow v2 (Beta), você coloca 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 alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, veja Menus de ações em Conceitos básicos do Conector.

Estes tipos de atividade estão disponíveis:

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

  • Criar: Cria novos registros no ServiceNow e é destinado a ser usado como um alvo em uma operação.

  • Atualizar: Atualiza registros existentes no ServiceNow e é destinado a ser usado como um alvo em uma operação.

  • Excluir: Exclui registros existentes do ServiceNow e é destinado a ser usado como um alvo em uma operação.