Conexão ao Concur
Faça o teste e mude para a nova versão do conector agora para manter a conexão ao Concur no Analytics 18. (Lançamento provisório no segundo semestre de 2024)
Ver Mudança para uma nova versão do conector do ACL
Concept Information
O Concur é um serviço de gerenciamento de viagens e despesas com base na nuvem. Use o conector de dados do Concur para importar dados da sua organização residentes no Concur.
Nota
O Analytics oferece o Concur como um conector opcional. Se esse conector não estiver disponível na janela Acesso a dados, é provável que o coletor não tenha sido selecionado durante a instalação. Para obter mais informações, consulte Instale opcionalmente os conectores de dados do Analytics e o mecanismo do Python.
Antes de começar
Credenciais do Concur
Para conectar-se ao Concur, você precisa de:
- Token de acesso do Concur
Se você não tiver um token de acesso do Concur, deve obter:
- Nome do usuário e senha do Concur
- ID do cliente do Concur
- Nome do host do servidor de API do Concur (o padrão é "www.concursolutions.com")
Com essas credenciais, você pode usar a opção Obter token na janela Acesso a Dados para gerar o token de acesso necessário para autenticar a conexão.
Nota
Ao gerar o token, anote a data de vencimento do token. A Concur expira os tokens de autenticação depois de um ano.
Para obter ajuda na coleta dos pré-requisitos de conexão, entre em contato com o administrador do Concur na sua organização. Se o administrador não conseguir ajudá-lo, você ou o administrador deve entrar em contato com o suporte da Concur.
Adquirir um ID do cliente do Concur
Se você não tiver um token de acesso do Concur, você ou o administrador do Concur de sua empresa precisa adquirir um ID do cliente. Você pode usar o ID do cliente para gerar o token de acesso.
O ID do cliente pode ser adquirido na área de administração do Concur Web Services por meio da opção Registrar aplicativo de parceiro.
No Concur Web Services, o ID do cliente é denominado:
- Chave de autorização de aplicativo, ou
- Chave de consumidor
Nota
Se a opção Registrar aplicativo de parceiro não for exibida no Concur Web Services, você ou o administrador do Concur precisa entrar em contato com o suporte da Concur. A sua empresa pode não ter a licença adequada do Concur.
Criar uma conexão do Concur
- No menu principal do Analytics, selecione Importar > Banco de dados e aplicativo.
- Na guia novas conexões, na seção Conectores do ACL, selecione Concur.
Dica
Você pode filtrar a lista de conectores disponíveis inserindo uma cadeia de pesquisa na caixa Filtrar conexões. Os conectores são listados em ordem alfabética.
- No painel Configurações de Conexão de Dados, insira as configurações da conexão e clique em Salvar e conectar na parte inferior do painel.
Você pode aceitar o Nome de conexão padrão ou inserir um novo nome.
A conexão do Concur é salva na guia Conexões existentes. No futuro, você poderá reconectar o Concur usando a conexão salva.
Após estabelecer a conexão, a janela Acesso a Dados abre na Área de preparação e você pode começar a importar dados. Para obter ajuda na importação de dados do Concur, consulte Trabalho com a Janela de Acesso a Dados.
Configurações de conexão
Configurações básicas
| Configuração | Descrição | Exemplo |
|---|---|---|
| Host | O nome do host do servidor do Concur. | https://concursolutions.com |
| ID do cliente OAuth |
O ID do cliente atribuído quando você registra um aplicativo com um servidor de autorização do OAuth. |
|
| Nome de usuário |
A conta de usuário usada para autenticação no Concur. |
|
| Senha |
A senha usada para autenticar o usuário no Concur. |
|
| Token de acesso |
O token de acesso para que usuários autenticados acessem recursos protegidos em serviços do Concur. |
Configurações avançadas
| Configuração | Descrição | Exemplo |
|---|---|---|
| Ativar armazenamento em buffer duplo |
Especifica se o adaptador recupera dados do Concur usando buffers duplicados. No entanto, quando os buffers duplicados estão ativados, o adaptador pode consumir mais memória e recursos. |
|
| Usar HTTPS | Especifica se os endpoints de origem de dados são criptografados usando HTTPS. | |
| Parâmetro de usuário | O valor a ser usado para o parâmetro de consulta usuário na consulta de tabelas com endpoints do grupo de endpoints /api/v3.0/expense. | tudo |
| Usar configurações de proxy do Windows | Especifica se as configurações do proxy de sistema devem ser usadas ou não. Para usar configurações de proxy personalizadas, você deve desativar esta opção. O valor definido para esta opção tem precedência sobre as outras configurações de proxy. | |
| Host do proxy | O nome do host ou o endereço IP de um proxy pelo qual o tráfego HTTP será roteado. | 206.174.193.118 |
| Porta do proxy | A porta TCP onde o proxy ProxyServer é executado. | 80 |
| Usuário do proxy | O nome de usuário usado para autenticar no proxy ProxyServer. | usuário@domínio |
| Senha do proxy | A senha usada para autenticar o usuário do proxy no proxy ProxyServer. |
Dados que podem ser acessados no Concur
A janela Acesso a Dados permite a você acessar um subconjunto dos dados no Concur. Os dados estão disponíveis nas APIs do Concur listadas abaixo.
Nota
Se uma API não estiver listada abaixo, não será possível acessá-la usando a janela Acesso a Dados. Para obter informações sobre os dados disponíveis em cada endpoint, consulte a documentação da API do Concur.
O Concur armazena dados em estruturas que não seguem as regras de tipos e estruturas de dados aplicadas a colunas e tabelas relacionais tradicionais. Portanto, os dados precisam ser mapeados para um formato relacional. Para isso, o conector mapeia os dados do Concur para um formato compatível com ODBC.
| Módulo | Endpoint da API |
|---|---|
| Comum | Listas |
| Itens da lista | |
| Locais | |
| Despesa | Entradas |
| Formulário de despesas | |
| Configuração de grupo de despesas | |
| Itemizações | |
| Despesa rápida | |
| Relatórios | |
| Percepções | Oportunidades |
| Imagem do recebimento | Imagem do recebimento |
| Viagem | Viagens |
Acesso a dados de despesas de vários usuários
Nota
Para acessar dados de despesas de vários usuários, a conta do Concur usada para se conectar ao Concur deve ter as permissões apropriadas.
Se você precisar de ajuda com as permissões da conta do Concur, entre em contato com o administrador da Concur em sua empresa. Se o administrador não conseguir ajudá-lo, você ou o administrador deve entrar em contato com o suporte da Concur.
Você pode acessar os dados do módulo de despesas de várias contas do Concur, configurando o campo opcional Parâmetro de usuário em Opções avançadas como Tudo.
Também é possível inserir nesse campo o nome de usuário de um usuário específico do Concur para exibir dados de despesas de um indivíduo.
