Sage 50 UK¶

Introdução¶

Versão do conector

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

Começando¶

Suporte à versão Sage 50 UK

O conector modela dados no Sage 50 UK 2012 e acima como tabelas relacionais. Observe que para v28 e posterior, você deve instalar o adaptador Sdata antes de usar o driver Sage 50 UK. Consulte a documentação do Sage 50 UK Para maiores informações.

Estabelecendo uma Conexão¶

Ligar ao Sage 50 UK¶

O conector liga-se aos dados do Sage 50 UK através da API SData REST incluída na instalação do Sage 50 UK. O SData permite acesso a conjuntos de dados locais da empresa, bem como conjuntos de dados em unidades de rede.

Depois de configurar o serviço Sage SData, conecte-se com as etapas abaixo, o URL a propriedade deve ser configurada para o endereço do conjunto de dados da empresa desejada. Para obter o endereço, faça o seguinte:

1. Se ainda não o fez, abra o software Sage 50 UK.
2. Selecione Tools > Internet Options.
3. Selecione o Sdatasettings aba.
4. Clique em Details ao lado do aplicativo de software Sage 50 ao qual você deseja se conectar. Uma janela é aberta contendo uma lista de nomes de empresas junto com os endereços de seus conjuntos de dados correspondentes.
5. Defina o URLpropriedade ao valor no campo endereço ao lado da empresa desejada.

Autenticação no Sage 50 UK¶

O User e Password as propriedades devem ser definidas para credenciais de usuário válidas do Sage 50 UK. Esses valores são os mesmos usados para fazer login no software Sage 50 UK. Para autenticar com resumo HTTP para o serviço SData, defina AuthScheme digerir. Caso contrário, Básico AuthScheme será usado.

Note: Se o conjunto de dados ao qual você deseja se conectar não for exibido, as permissões no local da pasta Sage 50 UK podem não estar corretas. Se você estiver se conectando a um conjunto de dados em uma unidade de rede, certifique-se de:

• Você está usando caminhos UNC para a pasta na máquina que está usando como seu provedor SData.
• Você define os direitos de login do serviço SData para um usuário que tenha direitos totais sobre o compartilhamento de rede ou unidade de mapa.

Iniciando o Serviço SData¶

O Jitterbit Connector for Sage 50 UK conecta-se ao Sage 50 UK por meio do serviço Sage SData (que é o kit de ferramentas da Web da Sage para conectar-se a instâncias do Sage) integrado ao software Sage 50 UK. O SData permite o acesso remoto aos aplicativos de software Sage. Por padrão, as instâncias do Sage UK 2015 terão o SData ativado e pronto para uso.

Você pode seguir as etapas abaixo para verificar se o serviço SData foi iniciado.

1. Se ainda não o fez, abra o Sage 50.
2. Navegue até Ferramentas > Opções de Internet. A janela Opções da Internet é exibida.
3. Selecione a aba Sdatasettings. É exibida uma lista de aplicativos de software Sage que estão disponíveis no momento.
4. Para ativar o serviço SData para o aplicativo, selecione a opção Ativar.
5. Se o status do serviço SData não exibir "SData está sendo executado no momento", clique no botão Avançado.
6. Na caixa de diálogo exibida, especifique o número da porta desejada ao fazer a conexão e clique no botão Reiniciar.
7. Se o botão Firewall do Windows estiver ativado, clique neste botão para desbloquear a porta. Se você tiver quaisquer firewalls adicionais na máquina, verifique se eles estão configurados para permitir que as conexões sejam feitas no número de porta especificado.

Depois de aplicar as alterações, você pode estabelecer uma conexão com o software Sage 50 UK.

Ativando o Suporte HTTPS¶

O serviço Sage SData fornece conexões seguras e criptografadas via HTTPS. A confidencialidade dos dados e a autenticidade do servidor são asseguradas por certificados digitais. Se você não tiver um certificado, use o IIS para gerar um certificado autoassinado.

Você pode seguir as etapas abaixo para configurar o serviço SData para usar um certificado; o conector validará esse certificado no armazenamento confiável do sistema por padrão. Se você gerou um certificado autoassinado, pode adicionar o certificado a este armazenamento de certificados ou definir SSLServerCert.

Consulte Recursos avançados para obter mais informações sobre como configurar o conector para HTTPS.

Cumprindo os Requisitos do Certificado¶

O certificado tem os seguintes requisitos:

• O certificado deve ter uma cadeia de confiança totalmente válida.
• O nome comum (CN) do certificado deve corresponder ao nome da máquina/domínio em que o serviço SData está sendo executado. Para garantir que o CN está correto, gere o certificado autoassinado na máquina onde o Sage 50 SData está sendo executado.
• O certificado deve ser adicionado ao armazenamento pessoal de certificados Meus para a conta da Máquina Local.

Configurando o Serviço SData para TLS/SSL¶

Você pode então configurar o serviço SData para usar o certificado:

1. Navegue até C:\Program Files (x86)\Common Files\Sage SData e abra Sage.SData.Service.Config.UI.exe.
2. Clique no botão Avançado. A janela Configuração SData é exibida.
3. Selecione a opção Ativar acesso HTTPS e selecione a porta desejada.
4. Se você tiver algum firewall em sua máquina, certifique-se de que as portas especificadas não estejam bloqueadas.
5. Clique no botão ao lado da caixa Certificado.
6. Na caixa de diálogo resultante, selecione o certificado. Se você selecionar um certificado e não vir o nome do certificado preenchido na caixa de texto Certificado, isso provavelmente se deve à falta de propriedades estendidas no certificado. As propriedades estendidas incluem impressão digital, algoritmo de impressão digital, uso de chave e uso de chave aprimorado. Use o IIS para evitar esse problema: o IIS preenche automaticamente esses campos ao gerar um certificado autoassinado.
7. Clique em OK para reiniciar o servidor.
8. Verifique se a opção Ativar HTTPS está selecionada na janela de configuração do SData.

Solução de Problemas¶

Se a janela de configuração do SData for fechada e reaberta, mas a opção Habilitar HTTPS não estiver habilitada, isso provavelmente é causado pelo fato de o arquivo Sage.SData.Service.exe.config não estar sendo atualizado corretamente. Siga as etapas abaixo para usar o arquivo de configuração alternativo abaixo.

Você precisará da impressão digital do certificado. Observe que os dados de impressão digital incluem espaços. Os dados de impressão digital podem ser obtidos usando os serviços do Windows. Você também pode acessar a impressão digital na janela de configuração do SData:

1. Se ainda não o fez, abra o aplicativo Sage.SData.Service.Config.UI.exe e abra as configurações avançadas.
2. Clique no botão ao lado da caixa Certificado.
3. Na caixa de diálogo de segurança do Windows, clique em "Clique aqui para ver as propriedades do certificado". A janela Detalhes do certificado é exibida.
4. Na aba Details, copie o valor no campo Thumbprint.

Use este valor no CertificateLookupValue configuração no arquivo de configuração. Por exemplo:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
<section name="Sage.SData.Service.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
<section name="Sage.Integration.Server.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
<section name="Sage.Common.Syndication.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
</sectionGroup>
</configSections>
<applicationSettings>
<Sage.SData.Service.Properties.Settings>
<setting name="DigestTimeout" serializeAs="String">
<value>12000000000</value>
</setting>
<setting name="EnableBasicAuthentication" serializeAs="String">
<value>True</value>
</setting>
<setting name="WebAppPath" serializeAs="String">
<value />
</setting>
<setting name="EnableSSL" serializeAs="String">
<value>True</value>
</setting>
<setting name="Port" serializeAs="String">
<value>443</value>
</setting>
</Sage.SData.Service.Properties.Settings>
<Sage.Integration.Server.Properties.Settings>
<setting name="EnableBroadcast" serializeAs="String">
<value>False</value>
</setting>
</Sage.Integration.Server.Properties.Settings>
<Sage.Common.Syndication.Properties.Settings>
<setting name="IPAddress" serializeAs="String">
<value />
</setting>
<setting name="Server" serializeAs="String">
<value>sdata</value>
</setting>
<setting name="EnableSSLPort" serializeAs="String">
<value>True</value>
</setting>
<setting name="Port" serializeAs="String">
<value>5493</value>
</setting>
<setting name="SettingsProviderType" serializeAs="String">
<value>Sage.Common.Syndication.ConfigurationSyndicationSettings, Sage.Common.Syndication</value>
</setting>
<setting name="PathPrefix" serializeAs="String">
<value />
</setting>
<setting name="DoNotUseRegistry" serializeAs="String">
<value>False</value>
</setting>
<setting name="EnableStandardPort" serializeAs="String">
<value>True</value>
</setting>
<setting name="SSLPort" serializeAs="String">
<value>5494</value>
</setting>
<setting name="CertificateLookupValue" serializeAs="String">
<value>ENTER YOUR CERTIFICATE THUMBPRINT HERE</value>
</setting>
<setting name="CertificateLookupType" serializeAs="String">
<value>Thumbprint</value>
</setting>
</Sage.Common.Syndication.Properties.Settings>
</applicationSettings>
</configuration>

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 50 UK.

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 para Sage 50 UK 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 exibição.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM TradingAccounts 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 Sage 50 UK modela entidades do Sage 50 UK em tabelas e exibições relacionais.

Mesas

Tabelas descreve as tabelas disponíveis.

Visualizações

Visualizações são tabelas que não podem ser modificadas. Normalmente, os dados somente leitura são mostrados como exibições.

Tabelas¶

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

Geralmente, consultar tabelas do Sage 50 UK é 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 50 UK¶

Commodities¶

Crie, atualize e consulte mercadorias (produtos e serviços) nas contas Sage UK 50.

Informações Específicas da Tabela¶

A tabela Commodities permite selecionar, inserir e atualizar Commodities (Produtos e Serviços) dentro de um conjunto de dados da empresa Sage 50 UK.

Selecione¶

A tabela Commodities retorna os produtos e serviços para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM Commodities WHERE ProductCode LIKE 'ABC%'

Inserir¶

Para criar um novo registro de Mercadoria, o campo Descrição é obrigatório.

INSERT INTO Commodities (ProductCode, Description, SupplierReference, CatalogueNumber, WebDescription, Cost)
VALUES ('MNP', 'MyNewProduct', 'UNI001', 'U143', 'My Web Description', 5.49)

Atualizar¶

Qualquer campo que não seja somente leitura pode ser atualizado.

UPDATE Commodities SET Description ='My New Description' WHERE CommodityUUID='8c47b43a-7115-7419-9679-7c72586e67d1'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Contatos¶

Crie, atualize, exclua e consulte contatos nas contas Sage UK 50.

Informações Específicas da Tabela¶

A tabela de contatos permite que você selecione, insira, atualize e exclua contatos em um conjunto de dados da empresa Sage 50 UK.

Selecione¶

A tabela Contacts retorna os contatos contidos em um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM Contacts WHERE TradingAccountReference = 'ABC123'

Inserir¶

Para criar um novo registro de Contatos, os campos TradingAccountReference e Type são obrigatórios.

INSERT INTO Contacts (Title, FirstName, MiddleName, FamilyName, Suffix, TradingAccountReference, Type, PostalAddressAddress1, PostalAddressTownCity, PostalAddressStateRegion, PostalAddressZipPostCode, PostalAddressType, PostalAddressDescription, Phone1Text, Phone1Type, Phone2Text, Phone2Type, EmailAddress)
VALUES (True, 'Dr.', 'INSERT', 'ME', 'NOW', 'Jr.', 'CNTCTEST', 'Customer Delivery Contact', '123 Main St', 'Durham', 'NC', '12345', 'Shipping', 'NEW Description', '123-456-7890', 'Business Phone', '555-666-7777', 'Fax', 'test@cdata.com')

Atualizar¶

Qualquer campo que não seja somente leitura pode ser atualizado. Existem requisitos para alguns campos de um registro de contato:

• Para atualizar um endereço postal existente, PostalAddressUUID é necessário. Caso contrário, se o endereço postal for nulo, especifique os detalhes e deixe o UUID vazio.
• Para atualizar um Phone1 existente, Phone1UUID é necessário. Caso contrário, se Phone1 estiver vazio, especifique os detalhes e deixe o UUID vazio.
• Para atualizar um Phone2 existente, Phone2UUID é necessário. Caso contrário, se Phone2 estiver vazio, especifique os detalhes e deixe o UUID vazio.
• Para atualizar um endereço e-mail existente, EmailUUID é necessário. Caso contrário, se e-mail estiver vazio, especifique os detalhes e deixe o UUID vazio.

UPDATE Contacts SET EmailAddress='test@server.com', Phone1Text='999-999-9999'
WHERE ContactUUID='96df2e1e-72c6-4b52-b39a-eeb42c840f87' AND Phone1UUID='bd621624-f78e-4dec-abf3-b8b94d8fe7a3' AND EmailUUID='a3f6ff1b-a80b-4019-ae5e-b1fa1bb4044d'

Excluir¶

A exclusão de um registro de contato também excluirá todos os endereços postais, números de telefone e e-mails associados ao contato.

DELETE FROM Contacts WHERE ContactUUID='96df2e1e-72c6-4b52-b39a-eeb42c840f87'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Ordens de Compra¶

Crie, atualize, exclua e consulte ordens de compra nas contas Sage UK 50.

Informações Específicas da Tabela¶

A tabela PurchaseOrders permite selecionar, inserir, atualizar e excluir ordens de compra em um conjunto de dados da empresa Sage 50 UK.

Selecione¶

A tabela PurchaseOrders retorna as ordens de compra para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM PurchaseOrders WHERE Date >= '1/1/2015' AND Date < '2/1/2015'

Inserir¶

Para criar um novo registro PurchaseOrder, o campo TradingAccountUUID é obrigatório.

Os itens de linha da ordem de compra são especificados por meio de um agregado XML na coluna ItemsAggregate. As colunas que podem ser usadas nesses agregados são definidas em PurchaseOrderLineItems mesa.

O exemplo a seguir demonstra como inserir um novo PurchaseOrder com dois itens de linha:

INSERT INTO PurchaseOrders (TradingAccountUUID, DeliveryDate, PostalAddressName, PostalAddressType, PostalAddressAddress1, PostalAddressTownCity, PostalAddressStateRegion, ItemsAggregate)
VALUES ('b83c940f-9d2b-4a35-bf42-28bbe07ef994', '05/05/2015', 'Purchase Order Billing Address', 'Billing', '123 Main St', 'Chapel Hill', 'NC', 
'<PurchaseOrderLineItems>
<Row><CommodityUUID>0a47b43d-7115-4863-9689-1a53666e67c8</CommodityUUID><Quantity>1</Quantity><ActualPrice>1.99</ActualPrice></Row>
<Row><CommodityUUID>586df2bb-7702-4228-b464-e8d509148547</CommodityUUID><Quantity>4</Quantity><ActualPrice>4.99</ActualPrice></Row>
</PurchaseOrderLineItems>')

Atualizar¶

Qualquer campo que não seja somente leitura pode ser atualizado.

Ao atualizar um registro PurchaseOrder, PostalAddressUUID é necessário ao atualizar um endereço postal. Observe que os itens de linha da ordem de compra não podem ser atualizados nem excluídos.

UPDATE PurchaseOrders SET PostalAddressZipPostCode='12345'
WHERE PurchaseOrderUUID='1b47b43a-7115-4863-9679-1a78636e67c1' AND PostalAddressUUID='28915e09-b2a1-47e1-b193-741b32ba8ba0'

Excluir¶

A exclusão de um registro PurchaseOrder também excluirá todos os itens de linha e endereços postais associados ao PurchaseOrder.

DELETE FROM PurchaseOrders WHERE PurchaseOrderUUID='1b47b43a-7115-4863-9679-1a78636e67c1'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Créditos de Vendas¶

Consulta SalesCredits nas contas Sage UK 50.

Informações Específicas da Tabela¶

A tabela SalesCredits permite selecionar, inserir, atualizar e excluir créditos de vendas em um conjunto de dados da empresa Sage 50 UK.

Selecione¶

A tabela SalesCredits retorna os créditos de vendas para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM SalesCredits WHERE Date >= '1/1/2015' AND Date < '2/1/2015'

Inserir¶

Para criar um novo registro SalesCredits, o campo TradingAccountUUID é obrigatório.

Os itens de linha de crédito de vendas são especificados por meio de um agregado XML na coluna ItemsAggregate. As colunas que podem ser usadas nesses agregados são definidas no SalesCreditLineItems mesa.

O exemplo a seguir demonstra como inserir um novo PurchaseOrder com dois itens de linha:

INSERT INTO SalesCredits (TradingAccountUUID, Type,  PostalAddress1Name, PostalAddress1Type, PostalAddress1Address1, PostalAddress1TownCity, PostalAddress1StateRegion, PostalAddress2Name, PostalAddress2Type, PostalAddress2Address1, PostalAddress2TownCity, PostalAddress2StateRegion, ItemsAggregate)
VALUES ('b83c940f-9d2b-4a35-bf42-28bbe07ef994', 'Product Credit Note',  'Sales Order Delivery Address', 'Shipping', '123 Main St', 'Chapel Hill', 'NC', 'Sales Order Billing Address', 'Billing', '987 Center Road', 'Chapel Hill', 'NC', 
'<SalesCreditLineItems>
<Row><CommodityUUID>03ecf74f-0f08-4667-8a59-07e6338a8b32</CommodityUUID><Quantity>1</Quantity><ActualPrice>2.99</ActualPrice></Row>
<Row><CommodityUUID>0a47b43d-7115-4863-9689-1a53666e67c8</CommodityUUID><Quantity>2</Quantity><ActualPrice>3.99</ActualPrice></Row>
</SalesCreditLineItems>')

Atualizar¶

Qualquer campo que não seja somente leitura pode ser atualizado.

Ao atualizar um registro SalesCredits, PostalAddress1UUID ou PostalAddress2UUID são necessários ao atualizar o respectivo endereço postal. Observe que os itens de linha de crédito de vendas não podem ser atualizados nem excluídos.

UPDATE SalesCredits SET PostalAddress2ZipPostCode='12345'
WHERE SalesCreditUUID='392235af-f45a-4c43-a275-897130e4fdc4' AND PostalAddress2UUID='28915e09-b2a1-47e1-b193-741b32ba8ba0'

Excluir¶

A exclusão de um registro SalesCredit também excluirá todos os itens de linha e endereços postais associados ao SalesCredit.

DELETE FROM SalesCredits WHERE SalesCreditUUID='392235af-f45a-4c43-a275-897130e4fdc4'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Facturas de Vendas¶

Consultar faturas de vendas nas contas Sage UK 50.

Informações Específicas da Tabela¶

A tabela SalesInvoices permite selecionar, inserir, atualizar e excluir faturas de vendas em um conjunto de dados da empresa Sage 50 UK.

Selecione¶

A tabela SalesInvoices retorna as faturas de vendas para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM SalesInvoices WHERE Date >= '1/1/2015' AND Date < '2/1/2015'

Inserir¶

Para criar um novo registro SalesInvoices, o campo TradingAccountUUID é obrigatório.

Os itens de linha da fatura de vendas são especificados por meio de um agregado XML na coluna ItemsAggregate. As colunas que podem ser usadas nesses agregados são definidas em SalesInvoiceLineItems tabela.
Observação: Para coluna de texto em SalesInvoiceLineItems, o comprimento da string deve ser igual ou inferior a 61 caracteres, caso contrário, o driver usará os primeiros 61 caracteres.

O exemplo a seguir demonstra como inserir um novo SalesInvoice com dois itens de linha:

INSERT INTO SalesInvoices (TradingAccountUUID, Type, PostalAddress1Name, PostalAddress1Type, PostalAddress1Address1, PostalAddress1TownCity, PostalAddress1StateRegion, PostalAddress2Name, PostalAddress2Type, PostalAddress2Address1, PostalAddress2TownCity, PostalAddress2StateRegion, ItemsAggregate)
VALUES ('b83c940f-9d2b-4a35-bf42-28bbe07ef994', 'Product Invoice', 'Sales Order Delivery Address', 'Shipping', '123 Main St', 'Chapel Hill', 'NC', 'Sales Order Billing Address', 'Billing', '987 Center Road', 'Chapel Hill', 'NC', '<SalesInvoiceLineItems> <Row><CommodityUUID>03ecf74f-0f08-4667-8a59-07e6338a8b32</CommodityUUID><Quantity>2</Quantity><ActualPrice>2.99</ActualPrice></Row> <Row><CommodityUUID>0a47b43d-7115-4863-9689-1a53666e67c8</CommodityUUID><Quantity>1</Quantity><ActualPrice>4.99</ActualPrice></Row>
</SalesInvoiceLineItems>')

Atualizar¶

Qualquer campo que não seja somente leitura pode ser atualizado.

Ao atualizar um registro SalesInvoices, PostalAddress1UUID e PostalAddress2UUID são necessários ao atualizar um endereço postal (respectivamente). Observe que os itens de linha da fatura de venda não podem ser atualizados nem excluídos.

UPDATE SalesInvoices SET PostalAddress2ZipPostCode='12345'
WHERE SalesInvoiceUUID='392235af-f45a-4c43-a275-897130e4fdc4' AND PostalAddress2UUID='28915e09-b2a1-47e1-b193-741b32ba8ba0'

Excluir¶

Excluir um registro SalesInvoice também excluirá todos os itens de linha e endereços postais associados ao SalesInvoice.

DELETE FROM SalesInvoices WHERE SalesInvoiceUUID='392235af-f45a-4c43-a275-897130e4fdc4'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Ordens de Venda¶

Crie, atualize, exclua e consulte pedidos de vendas nas contas Sage UK 50.

Informações Específicas da Tabela¶

A tabela SalesOrders permite selecionar, inserir, atualizar e excluir pedidos de vendas em um conjunto de dados da empresa Sage 50 UK.

Selecione¶

A tabela SalesOrders retorna os pedidos de vendas para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM SalesOrders WHERE Date >= '1/1/2015' AND Date < '2/1/2015'

Inserir¶

Para criar um novo registro SalesOrder, o campo TradingAccountUUID é obrigatório.

Os itens de linha do pedido de vendas são especificados por meio de um agregado XML na coluna ItemsAggregate. As colunas que podem ser usadas nesses agregados são definidas no SalesOrderLineItems mesa. Observação: um CommodityUUID deve ser definido ao adicionar um SalesOrderLineItem, pois apenas os Commodities existentes podem ser referenciados (para criar um novo Commodity, o Commodities tabela pode ser usada).

O exemplo a seguir demonstra como inserir um novo SalesOrder com dois itens de linha:

INSERT INTO SalesOrders (TradingAccountUUID, DueDate, PostalAddress1Name, PostalAddress1Type, PostalAddress1Address1, PostalAddress1TownCity, PostalAddress1StateRegion, ItemsAggregate)
VALUES ('b83c940f-9d2b-4a35-bf42-28bbe07ef994', True, '05/05/2015', 'Sales Order Delivery Address', 'Shipping', '123 Main St', 'Chapel Hill', 'NC', 
'<SalesOrderLineItems>
<Row><CommodityUUID>0a47b43d-7115-4863-9689-1a53666e67c8</CommodityUUID><Quantity>1</Quantity><ActualPrice>1.99</ActualPrice></Row>
<Row><CommodityUUID>586df2bb-7702-4228-b464-e8d509148547</CommodityUUID><Quantity>4</Quantity><ActualPrice>4.99</ActualPrice></Row>
</SalesOrderLineItems>')

Atualizar¶

Qualquer campo que não seja somente leitura pode ser atualizado.

Ao atualizar um registro SalesOrder, PostalAddress1UUID e PostalAddress2UUID são necessários ao atualizar o respectivo endereço postal. Observe que os itens de linha do pedido de venda não podem ser atualizados nem excluídos.

UPDATE SalesOrders SET PostalAddress1ZipPostCode='12345'
WHERE SalesOrderUUID='957af245-4678-4ca9-904a-162dcce87e5b' AND PostalAddress1UUID='28915e09-b2a1-47e1-b193-741b32ba8ba0'

Excluir¶

Excluir um registro de SalesOrder também excluirá todos os itens de linha e endereços postais associados ao SalesOrder.

DELETE FROM SalesOrders WHERE SalesOrderUUID='957af245-4678-4ca9-904a-162dcce87e5b'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Contas de Negociação¶

Crie, atualize, exclua e consulte contas de negociação nas contas Sage UK 50.

Informações Específicas da Tabela¶

A tabela TradingAccounts permite selecionar, inserir e atualizar contas de negociação em um conjunto de dados da empresa Sage 50 UK.

Selecione¶

A tabela TradingAccounts retorna as informações da conta de negociação para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM TradingAccounts

Inserir¶

Para criar um novo registro de Conta de Negociação, os campos Name e CustomerSupplierFlag são obrigatórios.

INSERT INTO TradingAccounts (Name, CustomerSupplierFlag, OpenedDate, Website, FinanceBalance, FinanceLimit, Analysis1, Analysis2, Analysis3)
VALUES ('My Trading Account', 'Customer', '05/10/2015', 'www.cdata.com', 100.00, 1000.00, 'Trade', 'Jenkins', 'National')

Atualizar¶

Qualquer campo que não seja somente leitura pode ser atualizado.

UPDATE TradingAccounts SET Analysis3='International' WHERE TradingAccountUUID='90c7afb4-ad34-41a2-b71d-ef49cc489872'

Excluir¶

DELETE FROM TradingAccounts WHERE TradingAccountUUID='90c7afb4-ad34-41a2-b71d-ef49cc489872'

Observação: quando recursos adicionais estão vinculados à conta, o registro não é excluído. No entanto, a API do Sage ainda retornará uma resposta OK, sinalizando que o registro foi excluído. A mensagem de erro real pode ser visualizada ao tentar excluir a conta no próprio software.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Visualizações¶

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto. Para saber mais sobre tabelas e procedimentos armazenados, navegue até as entradas correspondentes neste documento de ajuda.

Conector Jitterbit para Visualizações do Sage 50 UK¶

Contas Bancárias¶

Consulte contas bancárias no Sage UK 50 Accounts.

Informações Específicas da Tabela¶

Selecione¶

A tabela BankAccounts retorna as contas bancárias para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM BankAccounts

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Contas Financeiras¶

Consultar contas financeiras no Sage UK 50 Accounts.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Interações¶

Interações de consulta nas contas Sage UK 50.

Informações Específicas da Tabela¶

Selecione¶

A tabela Interações retorna as informações de interação do cliente para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM Interactions

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Preços¶

Consultar Preços nas Contas Sage UK 50.

Informações Específicas da Tabela¶

Selecione¶

A tabela Preços retorna as informações de preços de produtos e serviços para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM Prices WHERE Price < 10.00

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Projetos¶

Projetos de consulta dentro de contas Sage UK 50.

Informações Específicas da Tabela¶

Selecione¶

A tabela Projetos retorna informações do projeto para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM Projects

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Pedido de CompraEntregas¶

Consultar Pedidos de CompraEntregas nas Contas Sage UK 50.

Informações Específicas da Tabela¶

Selecione¶

A tabela PurchaseOrderDeliveries retorna informações de entrega de ordem de compra para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM PurchaseOrderDeliveries

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

PurchaseOrderDeliveryLineItems¶

Consulta PurchaseOrderDeliveryLineItems nas contas Sage UK 50.

Informações Específicas da Tabela¶

Selecione¶

A tabela PurchaseOrderDeliveryLineItems retorna informações de item de linha de entrega de ordem de compra para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM PurchaseOrderDeliveryLineItems WHERE GoodsReceivedNumber = '123'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

PurchaseOrderLineItems¶

Consulta PurchaseOrderLines nas contas Sage UK 50.

Informações Específicas da Tabela¶

Selecione¶

A tabela PurchaseOrderLineItems retorna informações de item de linha de ordem de compra para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM PurchaseOrderLineItems WHERE PurchaseOrderNumber = 'PO123'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Recibos¶

Consultar recibos nas contas Sage UK 50.

Informações Específicas da Tabela¶

Selecione¶

A tabela Recibos retorna as informações de recebimento para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM Receipts

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

SalesCreditLineItems¶

Consultar SalesCreditLineItems nas contas Sage UK 50.

Informações Específicas da Tabela¶

Selecione¶

A tabela SalesCreditLineItems retorna informações de itens de linha de crédito de vendas para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM SalesCreditLineItems WHERE CreditNumber = 'CR123'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

SalesInvoiceLineItems¶

Consulta SalesInvoiceLineItems dentro de Sage UK 50 Accounts.

Informações Específicas da Tabela¶

Selecione¶

A tabela SalesInvoiceLineItems retorna informações do item de linha da fatura de vendas para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM SalesInvoiceLineItems WHERE InvoiceNumber = 'INV123'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Pedidos de Vendasentregas¶

Consulta SalesOrderDeliveries em Sage UK 50 Accounts.

Informações Específicas da Tabela¶

Selecione¶

A tabela SalesOrderDeliveries retorna informações de entrega de pedidos de vendas para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM SalesOrderDeliveries

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

SalesOrderDeliveryLineItems¶

Consulta SalesOrderDeliveryLineItems em contas Sage UK 50.

Informações Específicas da Tabela¶

Selecione¶

A tabela SalesOrderDeliveryLineItems retorna informações de item de linha de entrega de ordem de venda para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM SalesOrderDeliveryLineItems WHERE GoodsDespatchedNumber = '987'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

SalesOrderLineItems¶

Consultar SalesOrderLineItems nas contas Sage UK 50.

Informações Específicas da Tabela¶

Selecione¶

A tabela SalesOrderLineItems retorna informações do item de linha do pedido de vendas para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM SalesOrderLineItems WHERE SalesOrderNumber = 'SO123'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Códigos de Impostos¶

Consulte os códigos fiscais nas contas Sage UK 50.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Atividades de Negociação¶

Consultar atividades de negociação nas contas Sage UK 50.

Informações Específicas da Tabela¶

Selecione¶

A tabela TradingActivities retorna as informações da atividade comercial para um conjunto de dados da empresa Sage 50 UK.

SELECT * FROM TradingActivities

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Procedimentos Armazenados¶

Procedimentos armazenados* estão disponíveis para complementar os dados disponíveis no Modelo de Dados. Pode ser necessário atualizar os dados disponíveis em uma exibição usando um procedimento armazenado* porque os dados não fornecem atualizações bidirecionais diretas, semelhantes a tabelas. Nessas situações, a recuperação dos dados é feita usando a visualização ou tabela apropriada, enquanto a atualização é feita chamando um procedimento armazenado. Procedimentos armazenados* pega uma lista de parâmetros e retorna um conjunto de dados que contém a coleção de tuplas que constituem a resposta.

Conector Jitterbit para Sage 50 UK Stored Procedures¶

ComputePrice¶

Calcula o preço com base em uma conta de negociação e uma mercadoria fornecida.

Entrada¶

Colunas do Conjunto de Resultados¶

Tabelas do Sistema¶

Você pode consultar as tabelas do sistema descritas nesta seção para acessar informações de esquema, informações sobre a funcionalidade da fonte de dados e estatísticas de operação em lote.

Tabelas de Esquema¶

As tabelas a seguir retornam os metadados do banco de dados para Sage 50 UK:

• sys_catalogs: Lista os bancos de dados disponíveis.
• sys_schemas: Lista os esquemas disponíveis.
• sys_tables: Lista as tabelas e exibições disponíveis.
• sys_tablecolumns: Descreve as colunas das tabelas e exibições disponíveis.
• sys_procedures: Descreve os procedimentos armazenados disponíveis.
• sys_procedureparameters: Descreve procedimento armazenado* parâmetros.
• sys_keycolumns: Descreve as chaves primárias e estrangeiras.
• sys_indexes: Descreve os índices disponíveis.

Tabelas de Fonte de Dados¶

As tabelas a seguir retornam informações sobre como se conectar e consultar a fonte de dados:

• sys_connection_props: Retorna informações sobre as propriedades de conexão disponíveis.
• sys_sqlinfo: Descreve as consultas SELECT que o conector pode descarregar para a fonte de dados.

Consultar Tabelas de Informações¶

A tabela a seguir retorna estatísticas de consultar para consultas de modificação de dados:

• sys_identity: Retorna informações sobre operações em lote ou atualizações únicas.

Sys_catalogs¶

Lista os bancos de dados disponíveis.

A consultar a seguir recupera todos os bancos de dados determinados pela string de conexão:

SELECT * FROM sys_catalogs

Colunas¶

Sys_schemas¶

Lista os esquemas disponíveis.

A consultar a seguir recupera todos os esquemas disponíveis:

SELECT * FROM sys_schemas

Colunas¶

Sys_tables¶

Lista as tabelas disponíveis.

A consultar a seguir recupera as tabelas e exibições disponíveis:

SELECT * FROM sys_tables

Colunas¶

Sys_tablecolumns¶

Descreve as colunas das tabelas e exibições disponíveis.

A consultar a seguir retorna as colunas e tipos de dados para a tabela TradingAccounts:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='TradingAccounts' 

Colunas¶

Sys_procedures¶

Lista os procedimentos armazenados disponíveis.

A consultar a seguir recupera os procedimentos armazenados disponíveis:

SELECT * FROM sys_procedures

Colunas¶

Sys_procedureparameters¶

Descreve procedimento armazenado* parâmetros.

A consultar a seguir retorna informações sobre todos os parâmetros de entrada para o procedimento armazenado SelectEntries:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SelectEntries' AND Direction=1 OR Direction=2

Colunas¶

Sys_keycolumns¶

Descreve as chaves primárias e estrangeiras. A consultar a seguir recupera a chave primária da tabela TradingAccounts:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='TradingAccounts'

Colunas¶

Sys_foreignkeys¶

Descreve as chaves estrangeiras. A consultar a seguir recupera todas as chaves estrangeiras que se referem a outras tabelas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Colunas¶

Sys_indexes¶

Descreve os índices disponíveis. Ao filtrar por índices, você pode escrever consultas mais seletivas com tempos de resposta de consultar mais rápidos.

A consultar a seguir recupera todos os índices que não são chaves primárias:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Colunas¶

Sys_connection_props¶

Retorna informações sobre as propriedades de conexão disponíveis e as definidas na string de conexão.

Ao consultar esta tabela, a string de conexão de configuração deve ser usada:

jdbc:cdata:sage50uk:config:

Esta string de conexão permite que você consultar esta tabela sem uma conexão válida.

A consultar a seguir recupera todas as propriedades de conexão que foram definidas na string de conexão ou definidas por meio de um valor padrão:

SELECT * FROM sys_connection_props WHERE Value <> ''

Colunas¶

Sys_sqlinfo¶

Descreve o processamento da consultar SELECT que o conector pode transferir para a fonte de dados.

Processamento de Consultas Colaborativas¶

Ao trabalhar com fontes de dados que não suportam SQL-92, você pode consultar a exibição sys_sqlinfo para determinar os recursos de consultar das APIs subjacentes, expressas na sintaxe SQL. O conector transfere o máximo possível do processamento da instrução SELECT para o servidor e, em seguida, processa o restante da consultar na memória.

Descobrindo os Recursos SELECT da Fonte de Dados¶

Abaixo está um exemplo de conjunto de dados de recursos SQL. O conjunto de resultados a seguir indica a funcionalidade SELECT que o conector pode descarregar para a fonte de dados ou processar o lado do cliente. Sua fonte de dados pode suportar sintaxe SQL adicional. Alguns aspectos da funcionalidade SELECT são retornados em uma lista separada por vírgulas, se suportados; caso contrário, a coluna contém NO.

A consultar a seguir recupera os operadores que podem ser usados na cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Observe que tabelas individuais podem ter diferentes limitações ou requisitos na cláusula WHERE; consulte o Modelo de Dados para obter mais informações.

Colunas¶

Sys_identity¶

Retorna informações sobre tentativas de modificação.

A consultar a seguir recupera os IDs das linhas modificadas em uma operação em lote:

SELECT * FROM sys_identity

Colunas¶

Propriedades de Configurações Avançadas¶

As propriedades de configurações avançadas são as várias opções que podem ser usadas para estabelecer uma conexão. Esta seção fornece uma lista completa das opções que você pode configurar. Clique nos links para mais detalhes.

Autenticação

SSL

Esquema

Diversos

Autenticação¶

Esta seção fornece uma lista completa de propriedades de autenticação que você pode configurar.

AuthScheme¶

O esquema usado para autenticação. As entradas aceitas são Basic, Digest ou None.

Valores Possíveis¶

Basic, Digest, None

Tipo de Dados¶

string

Valor Padrão¶

"Basic"

Observações¶

Juntamente com Senha e Usuário, este campo é usado para autenticação no serviço Sage 50 UK Accounts. Básico é a opção padrão.

• Básico: Defina para usar a autenticação HTTP básica.
• Digest: Defina para usar a autenticação HTTP Digest.

URL¶

URL para o serviço Sage 50 UK SData. Por exemplo, http://MySite:5493/sdata/accounts50/GCRM/MyDatasetId/.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

URL para o serviço Sage 50 UK SData. Por exemplo, http://MySite:5493/sdata/accounts50/GCRM/MyDatasetId/.

O URL pode ser obtido diretamente no software Sage 50 UK Accounts, navegando para Ferramentas > Opções da Internet > Configurações SData > Detalhes (ao lado de Sage 50 UK Accounts). O endereço pode então ser copiado para o conjunto de dados da empresa desejado.

Do Utilizador¶

A conta de usuário do Sage 50 UK usada para autenticação.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Juntamente com Senha, este campo é usado para autenticação no servidor Sage 50 UK.

Senha¶

A senha usada para autenticar o usuário.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

O usuário e Password são usados juntos para autenticar com o servidor.

SSL¶

Esta seção fornece uma lista completa de propriedades SSL que você pode configurar.

SSLServerCert¶

O certificado a ser aceito do servidor ao conectar usando TLS/SSL.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Se estiver usando uma conexão TLS/SSL, esta propriedade pode ser usada para especificar o certificado TLS/SSL a ser aceito do servidor. Qualquer outro certificado que não seja confiável para a máquina é rejeitado.

Esta propriedade pode assumir as seguintes formas:

Se não for especificado, qualquer certificado confiável pela máquina será aceito.

Os certificados são validados como confiáveis pela máquina com base no armazenamento confiável do sistema. O armazenamento confiável usado é o valor 'javax.net.ssl.trustStore' especificado para o sistema. Se nenhum valor for especificado para esta propriedade, o armazenamento confiável padrão do Java será usado (por exemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar a aceitação de todos os certificados. Observe que isso não é recomendado devido a questões de segurança.

Esquema¶

Esta seção fornece uma lista completa de propriedades de esquema que você pode configurar.

Localização¶

Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados.

Tipo de Dados¶

string

Valor Padrão¶

"%APPDATA%\\\Sage50UK Data Provider\\Schema"

Observações¶

O caminho para um diretório que contém os arquivos de esquema para o conector (arquivos .rsd para tabelas e exibições, arquivos .rsb para procedimentos armazenados). A localização da pasta pode ser um caminho relativo a partir da localização do executável. O Location a propriedade só é necessária se você quiser personalizar definições (por exemplo, alterar um nome de coluna, ignorar uma coluna e assim por diante) ou estender o modelo de dados com novas tabelas, exibições ou procedimentos armazenados.

Se não for especificado, o local padrão é "%APPDATA%\\Sage50UK Data Provider\Schema" com %APPDATA% sendo definido para o diretório de configuração do usuário:

Esquemas Navegáveis¶

Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Listar os esquemas de bancos de dados pode ser caro. Fornecer uma lista de esquemas na string de conexão melhora o desempenho.

Tabelas¶

Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tabelas=TabelaA,TabelaB,TabelaC.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Listar as tabelas de alguns bancos de dados pode ser caro. Fornecer uma lista de tabelas na string de conexão melhora o desempenho do conector.

Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitos para trabalhar.

Especifique as tabelas que deseja em uma lista separada por vírgulas. Cada tabela deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.

Visualizações¶

Restringe as visualizações relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA,ViewB,ViewC.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Listar as exibições de alguns bancos de dados pode ser caro. Fornecer uma lista de exibições na string de conexão melhora o desempenho do conector.

Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitos para trabalhar.

Especifique as exibições desejadas em uma lista separada por vírgulas. Cada exibição deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.

Diversos¶

Esta seção fornece uma lista completa de diversas propriedades que você pode configurar.

MaxRows¶

Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.

Tipo de Dados¶

int

Valor Padrão¶

-1

Observações¶

Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.

Outro¶

Essas propriedades ocultas são usadas apenas em casos de uso específicos.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

As propriedades listadas abaixo estão disponíveis para casos de uso específicos. Os casos de uso e a funcionalidade normais do driver não devem exigir essas propriedades.

Especifique várias propriedades em uma lista separada por ponto e vírgula.

Integração e Formatação¶

Tamanho da Página¶

O número máximo de resultados a serem retornados por página do Sage 50 UK.

Tipo de Dados¶

int

Valor Padrão¶

1000

Observações¶

O Pagesize a propriedade afeta o número máximo de resultados a serem retornados por página do Sage 50 UK. Definir um valor mais alto pode resultar em melhor desempenho ao custo de memória adicional alocada por página consumida.

Pseudocolunas¶

Esta propriedade indica se deve ou não incluir pseudocolunas como colunas na tabela.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Essa configuração é particularmente útil no Entity Framework, que não permite definir um valor para uma pseudocoluna, a menos que seja uma coluna de tabela. O valor dessa configuração de conexão está no formato "Table1=Column1, Table1=Column2, Table2=Column3". Você pode usar o caractere "*" para incluir todas as tabelas e todas as colunas; por exemplo, "*=*".

Tempo Esgotado¶

O valor em segundos até que o erro de timeout seja lançado, cancelando a operação.

Tipo de Dados¶

int

Valor Padrão¶

60

Observações¶

Se Timeout = 0, as operações não expiram. As operações são executadas até serem concluídas com êxito ou até encontrarem uma condição de erro.

Se Timeout expira e a operação ainda não está concluída, o conector lança uma exceção.