Detalhes da Conexão Sage Intacct

Introdução

Versão do conector

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

Começando

Suporte à versão Sage Intacct

O Conector Jitterbit para Sage Intacct se conecta com a API de serviços da Web Sage Intacct.

Estabelecendo uma Conexão

Conectando-se ao Sage Intacct

Para conectar-se aos Serviços da Web, primeiro você precisa habilitar a assinatura dos Serviços da Web. Navegar para Company > Admin Tab > Subscriptions e habilitar Web Services.

A Intacct também recomenda a criação de um usuário somente para serviços da Web, o que pode ser feito navegando para Company > Admin Tab, e clicando no + assine ao lado Web Services users.

Você pode estabelecer uma conexão com o Sage Intacct usando as credenciais incorporadas ou com suas próprias credenciais.

Autenticação no Sage Intacct

Para autenticar, defina CompanyID E definir User e Password às credenciais que você usa para fazer logon no Sage Intacct. Além disso, você precisará definir seu próprio SenderID e SenderPassword, ou use as credenciais incorporadas no Jitterbit Connector for Sage Intacct.

Autenticar com as Credenciais Incorporadas

O conector possui credenciais de serviços da Web incorporadas que serão usadas ao ler dados do Intacct.

Você pode se conectar usando credenciais incorporadas da seguinte maneira:

• Certifique-se de have not especificou um SenderID ou SenderPassword.
• No painel do Web Services, navegue até Company > Company Info > Security tab.
• Adicione "" às suas autorizações de Web Services. Isso diferencia maiúsculas de minúsculas. Isso pode ser feito navegando para Company -> Company Info (Configuration -> Company in new UI) -> Security -> Web Services Authorizations / Edit.

Observação: Ao contrário do uso de credenciais personalizadas, as credenciais incorporadas são read-only.

Conecte-se Usando Credenciais Personalizadas

Você pode usar suas próprias credenciais de serviços da Web para gravar dados no Intacct. Defina o seguinte para se conectar aos dados:

• SenderID: Defina isso para o ID do remetente dos serviços da Web atribuído a você pelo Sage Intacct.
• SenderPassword: Defina isso como sua senha de serviços da Web registrada.

Autenticação com Okta

Colocou o AuthScheme para Okta. As seguintes propriedades de conexão são usadas para se conectar ao Okta:

• User: Defina isso para o usuário Okta.
• Password: Defina como senha Okta para o usuário.
• SSOLoginURL: Defina isso para a URL de login usada pelo provedor SSO.

A seguir SSOProperties são necessários para autenticar no Okta:

• IntacctUserID: Configure este valor para o ID do usuário Intacct que é mapeado para o usuário Okta que você configurou na propriedade de conexão do usuário.
• APIToken (opcional): defina como o API Token que o cliente criou a partir da organização Okta. Ele deve ser usado ao autenticar um usuário por meio de um aplicativo ou proxy confiável que substitui o contexto de solicitação do cliente Okta.

A seguir está um exemplo de string de conexão: AuthScheme= Okta; SSOLoginURL='https://example.okta.com/home/appType/0bg4ivz6cJRZgCz5d6/46'; Usuário=oktaUserName; Senha=oktaSenha; SSOProperties='IntacctUserID=intacct_user';

Acesso a Dados de Ajuste Fino

Acesso a Dados de Ajuste Fino

Você pode usar as seguintes propriedades para obter mais controle sobre os dados retornados do Sage Intacct:

• LocationsID: Para conectar-se a uma empresa filha compartilhada, especifique seu ID de locais.
• ClientID: Para se conectar a uma empresa filha distribuída, especifique seu id de cliente.

LocationsID e ClientID não pode ser especificado ao mesmo tempo.

Nova API Sage Intacct

O suporte para a nova API Sage Intacct foi adicionado.

A nova API adiciona suporte para filtragem do lado do servidor, ORDERBY, deslocamento e funções agregadas, incluindo contagem, média, mínimo, máximo e soma.

Habilite este suporte definindo UseLegacy para False.

A nova API também suporta a exibição de atributos relacionados a objetos usando IncludeRelatedAttributes.

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 Sage Intacct.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visualizaçõ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 Sage Intacct 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 visualização.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a visualização.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Customer 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

Jitterbit Connector for Sage Intacct modela entidades Sage Intacct em tabelas relacionais.

As definições de tabela são recuperadas dinamicamente. Quaisquer alterações feitas, como adicionar uma nova tabela ou adicionar novas colunas ou alterar o tipo de dados de uma coluna, serão refletidas imediatamente quando você se conectar usando o conector.

Por padrão, apenas a lista das tabelas abaixo oferece suporte à instrução GETDELETED. Você pode adicionar suporte à instrução GETDELETED para outras tabelas por meio do GetdeletedTables propriedade de conexão, simplesmente especificando a lista separada por vírgulas das tabelas e suas colunas de chave correspondentes.

A lista de tabelas padrão que suportam a instrução GETDELETED são: Contact, Department, Glacctgrppurpose, Glbatch, Apaccountlabel, Apadjustment, Appymt, Apbill, Aradjustment, Arinvoice, Podocumentparams, Warehouse, Obspctcompleted, Task, Timesheet, Contractitempricelist, Contractdetail.

As mesas e Visualizações listados na documentação são exemplos do que você pode ter acesso em sua conta Intacct.

Observe que existem várias tabelas que possuem chaves primárias separadas necessárias para INSERT e DELETE. Essas tabelas (e suas chaves primárias compostas) estão listadas abaixo:

Processamento de consulta colaborativa

O conector transfere o máximo possível do processamento da instrução SELECT para o Sage Intacct e, em seguida, processa o restante da consultar na memória. As limitações e requisitos da API também estão documentados nesta seção.

Ver SupportEnhancedSQL para obter mais informações sobre como o conector contorna as limitações da API com processamento na memória do lado do cliente.

Tabelas

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

Geralmente, consultar tabelas do Sage Intacct é 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 Sage Intacct

AcctLabelTaxGroup

Recupera os dados do relatório AcctLabelTaxGroup.

Colunas

AcctRange

Recupera os dados do relatório AcctRange.

Colunas

Registro de Atividade

Recupera os dados do relatório ActivityLog.

Colunas

Corredor

Recupera os dados do relatório do Corredor.

Colunas

Alocação

Recupera os dados do relatório de Alocação.

Colunas

APAccountLabel

Recupera os dados do relatório APAccountLabel.

Colunas

AAjuste

Recupera os dados do relatório APAdjustment.

Colunas

APBill

Recupera os dados do relatório APBill.

Colunas

APBillBatch

Recupera os dados do relatório APBillBatch.

Colunas

APPymt

Recupera os dados do relatório APPymt.

Colunas

APRecurBill

Recupera os dados do relatório APRecurBill.

Colunas

APTerm

Recupera os dados do relatório APTerm.

Colunas

ARAccountLabel

Recupera os dados do relatório ARAccountLabel.

Colunas

AR Ajuste

Recupera os dados do relatório ARAdjustment.

Colunas

ARInvoice

Recupera os dados do relatório ARInvoice.

Colunas

ARInvoiceBatch

Recupera os dados do relatório ARInvoiceBatch.

Colunas

ARPaymentBatch

Recupera os dados do relatório ARPaymentBatch.

Colunas

ARTerm

Recupera os dados do relatório ARTerm.

Colunas

Participante

Recupera os dados do relatório do Participante.

Colunas

Contato de Cobrança

Recupera os dados do relatório Billing_Contact.

Colunas

Lixeira

Recupera os dados do relatório Bin.

Colunas

BudgetHeader

Recupera os dados do relatório BudgetHeader.

Colunas

Conta Corrente

Recupera os dados do relatório CheckingAccount.

Colunas

Aula

Recupera os dados do relatório de classe.

Colunas

Comentários

Recupera os dados do relatório de comentários.

Colunas

Contato

Recupera os dados do relatório de contato.

Colunas

Contrato

Uma coleção de itens de contrato.

Colunas

Cartão de Crédito

Recupera os dados do relatório CreditCard.

Colunas

Cliente

Recupera os dados do relatório do cliente.

Colunas