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¶