Detalhes Exact Online¶

Introdução¶

Versão do conector

Esta documentação é baseada na versão 21.0.8257 do conector.

Começando¶

Suporte Exact Online

O Jitterbit Connector for Exact Online se conecta com a API REST.

Estabelecendo uma Conexão¶

Autenticar Via Autenticação OAuth¶

Você pode se conectar depois de definir as propriedades de conexão necessárias para suas credenciais de usuário e obter os tokens de acesso necessários usando uma ferramenta como o Postman.

• Division: Definido para a divisão da administração do Exact Online.
• Region: Defina a região do serviço Exact Online ao qual você deseja se conectar.

Consulte Usando autenticação OAuth para obter detalhes do fluxo de autenticação OAuth.

Usando Autenticação OAuth¶

OAuth requer o uso de tokens de acesso obtidos com Postman ou ferramenta similar. A autenticação OAuth é suportada conforme descrito em Conexão em Configurar conexões OAuth.

Anotações Importantes¶

Procedimentos Armazenados¶

• Os recursos de procedimentos armazenados descritos nesta documentação não são suportados no momento.
• Como os procedimentos armazenados não são suportados atualmente, qualquer recurso dependente de procedimentos armazenados também não é suportado atualmente.

Arquivos de Configuração e Seus Caminhos¶

• Todas as referências para adicionar arquivos de configuração e seus caminhos referem-se a arquivos e locais no Harmony Agente onde o conector está instalado. Esses caminhos devem ser ajustados conforme apropriado, dependendo do agente e do sistema operacional. Se vários agentes forem usados em um grupo de agentes, arquivos idênticos serão necessários em cada agente.

Características Avançadas¶

Esta seção detalha uma seleção de recursos avançados do conector Exact Online.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visões definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Configuração SSL

Use Configuração SSL para ajustar como o conector lida com as negociações de certificado TLS/SSL. Você pode escolher entre vários formatos de certificado; Veja o SSLServerCert propriedade em "Opções de cadeia de conexão" para obter mais informações.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Visualizações Definidas pelo Usuário¶

O Jitterbit Connector for Exact Online permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

• Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
• declarações DDL.

Definindo Visualizações Usando um Arquivo de Configuração¶

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma exibição.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a exibição.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Accounts WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Exibições Definidas pelo Usuário¶

As visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com Exibições Definidas pelo Usuário¶

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Resultando na consultar efetiva à fonte:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões muito mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Configuração SSL¶

Personalizando a Configuração SSL¶

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema.

Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis para fazê-lo.

Modelo de Dados¶

O Jitterbit Connector for Exact Online modela entidades da Exact Online API como tabelas relacionais e procedimentos armazenados. O Jitterbit Connector for Exact Online recupera dinamicamente as definições da tabela. Quando você se conecta, o conector obtém a lista de tabelas e os metadados das tabelas chamando os serviços Web apropriados.

Mesas

Tabelas permitem o acesso aos dados da fonte de dados.

Procedimentos armazenados

NOTE: Procedimentos armazenados não são suportados atualmente. Veja a nota para detalhes.

Procedimentos armazenados são interfaces semelhantes a funções para o Exact Online. Eles podem ser usados para pesquisar, atualizar e modificar informações no Exact Online.

Tabelas¶

O conector modela os dados no Exact Online em uma lista de tabelas que podem ser consultadas usando instruções SQL padrão.

Geralmente, consultar tabelas Exact Online é o mesmo que consultar uma tabela em um banco de dados relacional. Às vezes, há casos especiais, por exemplo, incluir uma determinada coluna na cláusula WHERE pode ser necessário para obter dados para determinadas colunas na tabela. Isso geralmente é necessário para situações em que uma solicitação separada deve ser feita para cada linha para obter determinadas colunas. Esses tipos de situações estão claramente documentados na parte superior da página da tabela vinculada abaixo.

Conector Jitterbit para Tabelas Exact Online¶

AceitarCotação¶

Informações de uso para a operação AcceptQuotation.rsd.

Colunas¶

Contas EnvolvidasContas¶

Informações de uso para a operação AccountInvolvedAccounts.rsd.

Colunas¶

Proprietários de Conta¶

Informações de uso para a operação AccountOwners.rsd.

Colunas¶

Contas¶

Informações de uso para a operação Accounts.rsd.

Colunas¶

Endereços¶

Informações de uso para a operação Addresses.rsd.

Colunas¶

Contas Bancárias¶

Informações de uso para a operação BankAccounts.rsd.

Colunas¶

BancoEntradas¶

Informações de uso para a operação BankEntries.rsd.

Colunas¶

BankEntryLines¶

Informações de uso para a operação BankEntryLines.rsd.

Colunas¶

PorProdutoRecibos¶

Informações de uso para a operação ByProductReceipts.rsd.

Colunas¶

ByProductReversals¶

Informações de uso para a operação ByProductReversals.rsd.

Colunas¶

Entradas de Dinheiro¶

Informações de uso para a operação CashEntries.rsd.

Colunas¶

CashEntryLines¶

Informações de uso para a operação CashEntryLines.rsd.

Colunas¶

Notas de Comunicação¶

Informações de uso para a operação CommunicationNotes.rsd.

Colunas¶

Reclamações¶

Informações de uso para a operação Complaints.rsd.

Colunas¶

Contatos¶

Informações de uso para a operação Contacts.rsd.

Colunas¶

Centros de Custo¶

Informações de uso para a operação Costcenters.rsd.

Colunas¶

CustoTransações¶

Informações de uso para a operação CostTransactions.rsd.

Colunas¶

Coadjuvantes¶

Informações de uso para a operação Costunits.rsd.

Colunas¶

Métodos de Depreciação¶

Informações de uso para a operação DepreciationMethods.rsd.

Colunas¶

Mandatos de Débito Direto¶

Informações de uso para a operação DirectDebitMandates.rsd.

Colunas¶

Anexos de Documentos¶

Informações de uso para a operação DocumentAttachments.rsd.

Colunas¶

Pastas de Documentos¶

Informações de uso para a operação DocumentFolders.rsd.

Colunas¶

Documentos¶

Informações de uso para a operação Documents.rsd.

Colunas¶

DocumentTypeFolders¶

Informações de uso para a operação DocumentTypeFolders.rsd.

Colunas¶

Eventos¶

Informações de uso para a operação Events.rsd.

Colunas¶

Taxas de Câmbio¶

Informações de uso para a operação ExchangeRates.rsd.

Colunas¶

GeneralJournalEntries¶

Informações de uso para a operação GeneralJournalEntries.rsd.

Colunas¶

GeneralJournalEntryLines¶

Informações de uso para a operação GeneralJournalEntryLines.rsd.

Colunas¶

GLAcontas¶

Informações de uso para a operação GLAccounts.rsd.

Colunas¶

MercadoriasEntregas¶

Informações de uso para a operação GoodsDeliveries.rsd.

Colunas¶

MercadoriasLinhas de Entrega¶

Informações de uso para a operação GoodsDeliveryLines.rsd.

Colunas¶

Linhas de Recebimento de Mercadorias¶

Informações de uso para a operação GoodsReceiptLines.rsd.

Colunas¶

Recibos de Mercadorias¶

Informações de uso para a operação GoodsReceipts.rsd.

Colunas¶