Ir para o conteúdo

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:

Uma conexão Coupa existente pode ser editada destes locais:

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:

  • 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:

  • Consulta: Consulta dados de objetos no Coupa e deve ser usada como fonte em uma operação.

  • Criar: Cria dados de objetos no Coupa e deve ser usada como destino em uma operação.

  • Atualizar: Atualiza dados de objetos no Coupa e deve ser usada como destino em uma operação.