Conexão Coupa no Jitterbit Studio
Introdução
Uma conexão Coupa, criada usando o conector Coupa, estabelece acesso à Coupa. Após configurar uma conexão, você pode criar instâncias de atividades Coupa associadas a essa conexão para usar como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).
Nota
Este conector suporta a política organizacional Enable Re-authentication on Change. Se habilitada, uma alteração no Host Name ou Client ID nesta conexão exige que os usuários reinsiram a API Key ou Client Secret (dependendo do Authentication Type selecionado) da conexão.
Criar ou editar uma conexão Coupa
Uma nova conexão Coupa é criada usando o conector Coupa de um destes locais:
- A aba Project endpoints and connectors da paleta do componente de design (consulte Design component palette).
- A página Global Endpoints (consulte Criar um endpoint global em Global Endpoints).
Uma conexão Coupa existente pode ser editada destes locais:
- A aba Project endpoints and connectors da paleta do componente de design (consulte Design component palette).
- A aba Components do painel do projeto (consulte Component actions menu em Project pane Components tab).
- A página Global Endpoints (consulte Editar um endpoint global em Global Endpoints).
Configurar uma conexão Coupa
Cada elemento da interface do usuário da tela de configuração da conexão Coupa é 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 um menu listando as variáveis existentes para escolher.
-
Connection name: Digite um nome para identificar a conexão. O nome deve ser único para cada conexão Coupa e não deve conter barras
/ou dois-pontos:. Este nome também é usado para identificar o endpoint Coupa, que se refere tanto a uma conexão específica quanto às suas atividades. -
Host name: Digite a URL do host Coupa, no formato
https://<instance_name>.<host_name>.com. -
Authentication type: Selecione o tipo de autenticação, X-COUPA-API-KEY (Deprecated) ou OAuth 2.0.
-
X-COUPA-API-KEY (Deprecated): Quando selecionado, o campo API key fica visível:
-
API key: Digite a chave de API para a instância Coupa.
Aviso
A partir da versão Coupa R35 (janeiro de 2023), as chaves de API Coupa foram descontinuadas e não são mais suportadas para autenticação. Se usadas, um erro
Forbidden (403)é esperado.
-
-
OAuth 2.0: Quando selecionado, os seguintes campos ficam visíveis:
-
Client ID: Digite o ID do cliente para a instância Coupa.
-
Client secret: Digite o segredo do cliente para a instância Coupa.
-
-
-
Tipo de concessão: A opção Client Credentials é preenchida automaticamente como o tipo de concessão.
-
Escopo: Insira uma lista de escopos separados por espaço que o aplicativo exige.
-
Usar configurações de proxy (apenas agente privado): Ao usar um agente privado, essa configuração pode ser selecionada para usar configurações de proxy do agente privado.
-
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 pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector oferece suporte à suspensão do 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 se 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 se deseja excluir a conexão.
Próximas etapas
Depois que uma conexão do Coupa é criada, 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 destinos (para consumir dados em uma operação).
As ações de menu de uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.
Estes tipos de atividade estão disponíveis: