Detalles de Conexión de Sage 50 UK¶

Introducción¶

Versión del conector

Esta documentación se basa en la versión 21.0.8257 del conector.

Empezando¶

Compatibilidad con la versión del Sage 50 UK

El conector modela datos en Sage 50 UK 2012 y posteriores como tablas relacionales. Tenga en cuenta que para v28 y posteriores, debe instalar el adaptador Sdata antes de usar el controlador Sage 50 UK. Consulte la documentación de Sage 50 UK para más información.

Establecer una Conexión¶

Conexión a Sage 50 UK¶

El conector se conecta a los datos de Sage 50 UK a través de la API REST de SData incluida en la instalación de Sage 50 UK. SData permite el acceso a conjuntos de datos de empresas locales, así como a conjuntos de datos en unidades de red.

Después de configurar el servicio Sage SData, conéctese con los pasos a continuación, el URL la propiedad debe establecerse en la dirección del conjunto de datos de la empresa deseada. Para obtener la dirección, haga lo siguiente:

1. Si aún no lo ha hecho, abra el software Sage 50 UK.
2. Seleccione Tools > Internet Options.
3. Seleccione el Sdatasettings pestaña.
4. Haga clic en Details junto a la aplicación de software Sage 50 a la que desea conectarse. Se abre una ventana que contiene una lista de nombres de empresas junto con las direcciones de sus conjuntos de datos correspondientes.
5. Configure el URL propiedad al valor en el campo de dirección al lado de la empresa deseada.

Autenticación a Sage 50 UK¶

El User y Password las propiedades deben configurarse con credenciales de usuario válidas de Sage 50 UK. Estos valores son los mismos valores utilizados para iniciar sesión en el software Sage 50 UK. Para autenticarse con el resumen HTTP en el servicio SData, configure AuthScheme digerir. De lo contrario, Básico AuthScheme se utilizará.

Note: Si no se muestra el conjunto de datos al que desea conectarse, es posible que los permisos en la ubicación de la carpeta Sage 50 UK no sean correctos. Si se está conectando a un conjunto de datos en una unidad en red, asegúrese de lo siguiente:

• Está usando rutas UNC a la carpeta en la máquina que está usando como su proveedor de SData.
• Establece los derechos de inicio de sesión del servicio SData para un usuario que tiene todos los derechos sobre el recurso compartido de red o la unidad de mapas.

Inicio del Servicio SData¶

El Jitterbit Connector para Sage 50 UK se conecta a Sage 50 UK a través del servicio Sage SData (que es el conjunto de herramientas web de Sage para conectarse a instancias de Sage) que está integrado en el software Sage 50 UK. SData permite el acceso remoto a las aplicaciones de software de Sage. De manera predeterminada, las instancias de Sage UK 2015 tendrán SData activado y listo para usar.

Puede seguir los pasos a continuación para verificar que el servicio SData se haya iniciado.

1. Si aún no lo ha hecho, abra Sage 50.
2. Vaya a Herramientas > Opciones de Internet. Se muestra la ventana Opciones de Internet.
3. Seleccione la pestaña Configuración de Sdata. Se muestra una lista de las aplicaciones de software de Sage que están disponibles actualmente.
4. Para activar el servicio SData para la aplicación, seleccione la opción Activado.
5. Si el estado del servicio SData no dice "SData se está ejecutando actualmente", haga clic en el botón Avanzado.
6. En el cuadro de diálogo que se muestra, especifique el número de puerto deseado al realizar la conexión y haga clic en el botón Reiniciar.
7. Si el botón Firewall de Windows está habilitado, haga clic en este botón para desbloquear el puerto. Si tiene firewalls adicionales en la máquina, asegúrese de que estén configurados para permitir que se realicen conexiones en el número de puerto especificado.

Una vez que aplique los cambios, podrá establecer una conexión con su software Sage 50 UK.

Habilitación de la Compatibilidad con HTTPS¶

El servicio Sage SData proporciona conexiones seguras y encriptadas a través de HTTPS. La confidencialidad de los datos y la autenticidad del servidor son proporcionados por certificados digitales. Si no tiene un certificado, use IIS para generar un certificado autofirmado.

Puede seguir los pasos a continuación para configurar el servicio SData para usar un certificado; el conector validará este certificado con el almacén de confianza del sistema de forma predeterminada. Si generó un certificado autofirmado, puede agregar el certificado a este almacén de certificados o establecer SSLServerCert.

Consulte Características avanzadas para obtener más información sobre cómo configurar el conector para HTTPS.

Cumplimiento de los Requisitos del Certificado¶

El certificado tiene los siguientes requisitos:

• El certificado debe tener una cadena de confianza válida completa.
• El nombre común (CN) del certificado debe coincidir con el nombre de la máquina/dominio donde se ejecuta el servicio SData. Para asegurarse de que el CN sea correcto, genere el certificado autofirmado en la máquina donde se ejecuta Sage 50 SData.
• El certificado debe agregarse al almacén personal de Mi certificado para la cuenta de la máquina local.

Configuración del Servicio SData para TLS/SSL¶

A continuación, puede configurar el servicio SData para utilizar el certificado:

1. Navegue a C:\Program Files (x86)\Common Files\Sage SData y abra Sage.SData.Service.Config.UI.exe.
2. Haga clic en el botón Avanzado. Se muestra la ventana Configuración de SData.
3. Seleccione la opción Habilitar acceso HTTPS y seleccione el puerto deseado.
4. Si tiene cortafuegos en su máquina, asegúrese de que los puertos especificados no estén bloqueados.
5. Haga clic en el botón junto al cuadro Certificado.
6. En el cuadro de diálogo resultante, seleccione el certificado. Si selecciona un certificado y no ve el nombre del certificado en el cuadro de texto Certificado, lo más probable es que se deba a que faltan propiedades extendidas en el certificado. Las propiedades extendidas incluyen huella digital, algoritmo de huella digital, uso de clave y uso de clave mejorado. Use IIS para evitar este problema: IIS completa automáticamente estos campos cuando genera un certificado autofirmado.
7. Haga clic en Aceptar para reiniciar el servidor.
8. Verifique que la opción Habilitar HTTPS esté seleccionada en la ventana de configuración de SData.

Solución de Problemas¶

Si la ventana de configuración de SData se cierra y se vuelve a abrir, pero la opción Habilitar HTTPS no está habilitada, lo más probable es que esto se deba a que el archivo Sage.SData.Service.exe.config no se actualizó correctamente. Siga los pasos a continuación para usar el archivo de configuración alternativo a continuación.

Necesitará la huella digital del certificado. Tenga en cuenta que los datos de la huella digital incluyen espacios. Los datos de la huella digital se pueden obtener utilizando los servicios de Windows. También puede acceder a la huella digital en la ventana de configuración de SData:

1. Si aún no lo ha hecho, abra la aplicación Sage.SData.Service.Config.UI.exe y abra la configuración avanzada.
2. Haga clic en el botón junto al cuadro Certificado.
3. En el cuadro de diálogo de seguridad de Windows, haga clic en "Haga clic aquí para ver las propiedades del certificado". Se muestra la ventana Detalles del certificado.
4. En la pestaña Detalles, copie el valor en el campo Huella digital.

Utilice este valor en el CertificateLookupValue ajuste en el archivo de configuración. Por ejemplo:

<?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>

Notas Importantes¶

Procedimientos Almacenados¶

• Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
• Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas¶

• Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Características Avanzadas¶

Esta sección detalla una selección de características avanzadas del conector Sage 50 UK.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Vistas Definidas por el Usuario¶

El conector Jitterbit para Sage 50 UK le permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Usando un Archivo de Configuración¶

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

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

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

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

Esquema para Vistas Definidas por el Usuario¶

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario¶

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

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

Dando como resultado la consultar efectiva a la fuente:

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

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL¶

Personalización de la Configuración SSL¶

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos¶

El conector Jitterbit para Sage 50 UK modela entidades de Sage 50 UK en tablas y vistas relacionales.

Mesas

Mesas describe las tablas disponibles.

Puntos de vista

Puntos de vista son tablas que no se pueden modificar. Normalmente, los datos de solo lectura se muestran como vistas.

Mesas¶

El conector modela los datos en Sage 50 UK en una lista de tablas que se pueden consultar mediante instrucciones SQL estándar.

Generalmente, consultar tablas de Sage 50 UK es lo mismo que consultar una tabla en una base de datos relacional. A veces hay casos especiales, por ejemplo, incluir una determinada columna en la cláusula WHERE puede ser necesario para obtener datos para ciertas columnas de la tabla. Esto suele ser necesario para situaciones en las que se debe realizar una solicitud separada para cada fila para obtener ciertas columnas. Estos tipos de situaciones están claramente documentados en la parte superior de la página de la tabla vinculada a continuación.

Conector Jitterbit para Mesas Sage 50 UK¶

Materias Primas¶

Cree, actualice y consulte productos básicos (productos y servicios) dentro de las 50 cuentas de Sage UK.

Información Específica de la Tabla¶

La tabla de materias primas le permite seleccionar, insertar y actualizar materias primas (productos y servicios) dentro de un conjunto de datos de empresas de Sage 50 UK.

Seleccionar¶

La tabla Commodities devuelve los productos y servicios para un conjunto de datos de la empresa Sage 50 UK.

SELECT * FROM Commodities WHERE ProductCode LIKE 'ABC%'

Insertar¶

Para crear un nuevo registro de Producto, se requiere el campo Descripción.

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

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Contactos¶

Cree, actualice, elimine y consulte contactos dentro de las cuentas Sage UK 50.

Información Específica de la Tabla¶

La tabla Contactos le permite seleccionar, insertar, actualizar y eliminar contactos dentro de un conjunto de datos de la empresa Sage 50 UK.

Seleccionar¶

La tabla Contactos devuelve los contactos contenidos en un conjunto de datos de empresa de Sage 50 UK.

SELECT * FROM Contacts WHERE TradingAccountReference = 'ABC123'

Insertar¶

Para crear un nuevo registro de contactos, se requieren los campos TradingAccountReference y Type.

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')

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar. Existen requisitos para algunos campos de un registro de contacto:

• Para actualizar una dirección postal existente, se requiere PostalAddressUUID. De lo contrario, si la dirección postal es nula, especifique los detalles y deje el UUID vacío.
• Para actualizar un Phone1 existente, se requiere Phone1UUID. De lo contrario, si Phone1 está vacío, especifique los detalles y deje el UUID vacío.
• Para actualizar un Phone2 existente, se requiere Phone2UUID. De lo contrario, si Phone2 está vacío, especifique los detalles y deje el UUID vacío.
• Para actualizar una dirección de correo existente, se requiere EmailUUID. De lo contrario, si el correo está vacío, especifique los detalles y deje el UUID vacío.

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'

Borrar¶

Eliminar un registro de contacto también eliminará todas las direcciones postales, números de teléfono y correos asociados con el contacto.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Ordenes de Compra¶

Cree, actualice, elimine y consulte pedidos de compra dentro de las 50 cuentas de Sage UK.

Información Específica de la Tabla¶

La tabla de Pedidos de compra le permite seleccionar, insertar, actualizar y eliminar pedidos de compra dentro de un conjunto de datos de empresas de Sage 50 UK.

Seleccionar¶

La tabla de pedidos de compra devuelve los pedidos de compra para un conjunto de datos de la empresa Sage 50 UK.

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

Insertar¶

Para crear un nuevo registro de orden de compra, se requiere el campo TradingAccountUUID.

Los elementos de línea de la orden de compra se especifican a través de un agregado XML dentro de la columna ItemsAgregate. Las columnas que se pueden usar en estos agregados se definen en PurchaseOrderLineItems mesa.

El siguiente ejemplo muestra cómo insertar un nuevo pedido de compra con dos elementos de línea:

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>')

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Al actualizar un registro de orden de compra, se requiere PostalAddressUUID al actualizar una dirección postal. Tenga en cuenta que las líneas de pedido de la orden de compra no se pueden actualizar ni eliminar.

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

Borrar¶

Eliminar un registro de Pedido de compra también eliminará todos los elementos de línea y direcciones postales asociados con el Pedido de compra.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

VentasCréditos¶

Consulta SalesCredits dentro de Sage UK 50 Cuentas.

Información Específica de la Tabla¶

La tabla SalesCredits le permite seleccionar, insertar, actualizar y eliminar créditos de ventas dentro de un conjunto de datos de la empresa Sage 50 UK.

Seleccionar¶

La tabla SalesCredits devuelve los créditos de ventas para un conjunto de datos de la empresa Sage 50 UK.

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

Insertar¶

Para crear un nuevo registro de SalesCredits, se requiere el campo TradingAccountUUID.

Los elementos de línea de crédito de ventas se especifican a través de un agregado XML dentro de la columna ItemsAgregate. Las columnas que se pueden usar en estos agregados se definen en SalesCreditLineItems mesa.

El siguiente ejemplo muestra cómo insertar un nuevo pedido de compra con dos elementos de línea:

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>')

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Al actualizar un registro de SalesCredits, se requiere PostalAddress1UUID o PostalAddress2UUID al actualizar la dirección postal respectiva. Tenga en cuenta que las líneas de crédito de ventas no se pueden actualizar ni eliminar.

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

Borrar¶

Eliminar un registro de SalesCredit también eliminará todos los elementos de línea y las direcciones postales asociadas con el SalesCredit.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Facturas de Venta¶

Consultar Facturas de Venta dentro de Sage UK 50 Cuentas.

Información Específica de la Tabla¶

La tabla SalesInvoices le permite seleccionar, insertar, actualizar y eliminar facturas de ventas dentro de un conjunto de datos de la empresa Sage 50 UK.

Seleccionar¶

La tabla SalesInvoices devuelve las facturas de venta de un conjunto de datos de la empresa Sage 50 UK.

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

Insertar¶

Para crear un nuevo registro de facturas de ventas, se requiere el campo TradingAccountUUID.

Los elementos de línea de la factura de ventas se especifican a través de un agregado XML dentro de la columna ItemsAggregate. Las columnas que se pueden usar en estos agregados se definen en SalesInvoiceLineItems tabla.
Nota: Para la columna de texto en SalesInvoiceLineItems, la longitud de la cadena debe ser igual o inferior a 61 caracteres; de lo contrario, el controlador utilizará los primeros 61 caracteres.

El siguiente ejemplo muestra cómo insertar una nueva factura de ventas con dos elementos de línea:

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>')

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Al actualizar un registro de facturas de ventas, se requieren PostalAddress1UUID y PostalAddress2UUID al actualizar una dirección postal (respectivamente). Tenga en cuenta que las partidas de las facturas de ventas no se pueden actualizar ni eliminar.

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

Borrar¶

Al eliminar un registro de Factura de venta, también se eliminarán todos los elementos de línea y las direcciones postales asociadas con la Factura de venta.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Ordenes de Venta¶

Cree, actualice, elimine y consulte pedidos de ventas dentro de las 50 cuentas de Sage UK.

Información Específica de la Tabla¶

La tabla SalesOrders le permite seleccionar, insertar, actualizar y eliminar pedidos de ventas dentro de un conjunto de datos de la empresa Sage 50 UK.

Seleccionar¶

La tabla SalesOrders devuelve los pedidos de venta de un conjunto de datos de la empresa Sage 50 UK.

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

Insertar¶

Para crear un nuevo registro de pedido de venta, se requiere el campo TradingAccountUUID.

Los elementos de línea de órdenes de venta se especifican a través de un agregado XML dentro de la columna ItemsAgregate. Las columnas que se pueden usar en estos agregados se definen en SalesOrderLineItems mesa. Nota: se debe configurar un CommodityUUID al agregar un SalesOrderLineItem, ya que solo se puede hacer referencia a los productos existentes (para crear un nuevo producto, Commodities se puede utilizar la tabla).

El siguiente ejemplo muestra cómo insertar un nuevo pedido de venta con dos elementos de línea:

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>')

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Al actualizar un registro de pedido de venta, se requieren PostalAddress1UUID y PostalAddress2UUID al actualizar la dirección postal respectiva. Tenga en cuenta que las líneas de pedido de ventas no se pueden actualizar ni eliminar.

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

Borrar¶

Eliminar un registro de Pedido de venta también eliminará todos los elementos de línea y direcciones postales asociados con el Pedido de venta.

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

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Cuentas Comerciales¶

Cree, actualice, elimine y consulte cuentas comerciales dentro de las cuentas Sage UK 50.

Información Específica de la Tabla¶

La tabla TradingAccounts le permite seleccionar, insertar y actualizar cuentas comerciales dentro de un conjunto de datos de empresas de Sage 50 UK.

Seleccionar¶

La tabla TradingAccounts devuelve la información de la cuenta comercial para un conjunto de datos de la empresa Sage 50 UK.

SELECT * FROM TradingAccounts

Insertar¶

Para crear un nuevo registro de cuenta comercial, los campos Nombre y CustomerSupplierFlag son obligatorios.

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')

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

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

Borrar¶

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

Nota: Cuando se vinculan recursos adicionales a la cuenta, el registro no se elimina. Sin embargo, la API de Sage aún devolverá una respuesta OK, lo que indica que el registro se eliminó. El mensaje de error real se puede ver al intentar eliminar la cuenta dentro del propio software.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Puntos de Vista¶

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Sage 50 UK¶

Cuentas Bancarias¶

Consultar cuentas bancarias dentro de Sage UK 50 Accounts.

Información Específica de la Tabla¶

Seleccionar¶

La tabla BankAccounts devuelve las cuentas bancarias de un conjunto de datos de empresa de Sage 50 UK.

SELECT * FROM BankAccounts

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Cuentas Financieras¶

Consultar cuentas financieras dentro de Sage UK 50 Accounts.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Interacciones¶

Interacciones de consultas dentro de las 50 cuentas de Sage UK.

Información Específica de la Tabla¶

Seleccionar¶

La tabla Interacciones devuelve la información de interacción del cliente para un conjunto de datos de la empresa Sage 50 UK.

SELECT * FROM Interactions

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Precios¶

Consulte los precios dentro de las cuentas Sage UK 50.

Información Específica de la Tabla¶

Seleccionar¶

La tabla Precios devuelve la información de precios de productos y servicios para un conjunto de datos de la empresa Sage 50 UK.

SELECT * FROM Prices WHERE Price < 10.00

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Proyectos¶

Proyectos de consulta dentro de Sage UK 50 Cuentas.

Información Específica de la Tabla¶

Seleccionar¶

La tabla Proyectos devuelve información del proyecto para un conjunto de datos de la empresa Sage 50 UK.

SELECT * FROM Projects

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

CompraOrdenEntregas¶

Consulte las entregas de pedidos de compra dentro de las 50 cuentas de Sage UK.

Información Específica de la Tabla¶

Seleccionar¶

La tabla PurchaseOrderDeliveries devuelve información de entrega de órdenes de compra para un conjunto de datos de la empresa Sage 50 UK.

SELECT * FROM PurchaseOrderDeliveries

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

CompraOrdenDeliveryLineItems¶

Consulte los elementos de línea de entrega de pedido de compra dentro de las 50 cuentas de Sage UK.

Información Específica de la Tabla¶

Seleccionar¶

La tabla PurchaseOrderDeliveryLineItems devuelve información de elementos de línea de entrega de órdenes de compra para un conjunto de datos de empresa de Sage 50 UK.

SELECT * FROM PurchaseOrderDeliveryLineItems WHERE GoodsReceivedNumber = '123'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Elementos de Línea de Pedido de Compra¶

Consulta las líneas de pedido de compra en las cuentas de Sage UK 50.

Información Específica de la Tabla¶

Seleccionar¶

La tabla PurchaseOrderLineItems devuelve información de elementos de línea de pedidos de compra para un conjunto de datos de empresa de Sage 50 UK.

SELECT * FROM PurchaseOrderLineItems WHERE PurchaseOrderNumber = 'PO123'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Ingresos¶

Consultar recibos dentro de las cuentas Sage UK 50.

Información Específica de la Tabla¶

Seleccionar¶

La tabla Recibos devuelve la información de recibo para un conjunto de datos de empresa de Sage 50 UK.

SELECT * FROM Receipts

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

SalesCreditLineItems¶

Consulta SalesCreditLineItems dentro de Sage UK 50 Cuentas.

Información Específica de la Tabla¶

Seleccionar¶

La tabla SalesCreditLineItems devuelve información de elementos de línea de crédito de ventas para un conjunto de datos de empresa de Sage 50 UK.

SELECT * FROM SalesCreditLineItems WHERE CreditNumber = 'CR123'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Elementos de Línea de Factura de Ventas¶

Consulta SalesInvoiceLineItems dentro de Sage UK 50 Cuentas.

Información Específica de la Tabla¶

Seleccionar¶

La tabla SalesInvoiceLineItems devuelve información de partidas de facturas de ventas para un conjunto de datos de empresa de Sage 50 UK.

SELECT * FROM SalesInvoiceLineItems WHERE InvoiceNumber = 'INV123'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

VentasOrdenEntregas¶

Consulta SalesOrderDeliveries dentro de Sage UK 50 Cuentas.

Información Específica de la Tabla¶

Seleccionar¶

La tabla SalesOrderDeliveries devuelve información de entrega de pedidos de ventas para un conjunto de datos de la empresa Sage 50 UK.

SELECT * FROM SalesOrderDeliveries

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

VentasOrdenEntregaLineItems¶

Consulta SalesOrderDeliveryLineItems dentro de Sage UK 50 Cuentas.

Información Específica de la Tabla¶

Seleccionar¶

La tabla SalesOrderDeliveryLineItems devuelve información de elementos de línea de entrega de pedidos de ventas para un conjunto de datos de empresa de Sage 50 UK.

SELECT * FROM SalesOrderDeliveryLineItems WHERE GoodsDespatchedNumber = '987'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

SalesOrderLineItems¶

Consulte SalesOrderLineItems dentro de las 50 cuentas de Sage UK.

Información Específica de la Tabla¶

Seleccionar¶

La tabla SalesOrderLineItems devuelve información de elementos de línea de pedidos de ventas para un conjunto de datos de empresa de Sage 50 UK.

SELECT * FROM SalesOrderLineItems WHERE SalesOrderNumber = 'SO123'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

TaxCodes¶

Consulte los códigos de impuestos dentro de las cuentas Sage UK 50.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actividades Comerciales¶

Consulta TradingActivities dentro de Sage UK 50 Cuentas.

Información Específica de la Tabla¶

Seleccionar¶

La tabla TradingActivities devuelve la información de la actividad comercial de un conjunto de datos de la empresa Sage 50 UK.

SELECT * FROM TradingActivities

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Procedimientos Almacenados¶

Procedimientos almacenados* están disponibles para complementar los datos disponibles del Modelo de datos. Puede ser necesario actualizar los datos disponibles desde una vista usando un procedimiento almacenado* porque los datos no proporcionan actualizaciones bidireccionales directas, similares a tablas. En estas situaciones, la recuperación de los datos se realiza utilizando la vista o tabla adecuada, mientras que la actualización se realiza llamando a un procedimiento almacenado. Procedimientos almacenados* toman una lista de parámetros y devuelven un conjunto de datos que contiene la colección de tuplas que constituyen la respuesta.

Conector Jitterbit para Procedimientos Almacenados de Sage 50 UK¶

CalcularPrecio¶

Calcula el precio en función de una cuenta comercial y un producto proporcionado.

Aporte¶

Columnas del Conjunto de Resultados¶

Tablas del Sistema¶

Puede consultar las tablas del sistema que se describen en esta sección para acceder a la información del esquema, la información sobre la funcionalidad del origen de datos y las estadísticas de operación lote.

Tablas de Esquema¶

Las siguientes tablas devuelven metadatos de la base de datos para Sage 50 UK:

• sys_catalogs: enumera las bases de datos disponibles.
• sys_schemas: enumera los esquemas disponibles.
• sys_tablas: enumera las tablas y vistas disponibles.
• sys_tablecolumns: Describe las columnas de las tablas y vistas disponibles.
• procedimientos_sys: describe los procedimientos almacenados disponibles.
• parámetros_procedimiento_sys: Describe procedimiento almacenado* parámetros.
• sys_keycolumns: describe las claves principal y externa.
• índices_sys: Describe los índices disponibles.

Tablas de Fuentes de Datos¶

Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:

• sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
• sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.

Tablas de Información de Consultas¶

La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos:

• identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.

Sys_catalogs¶

Enumera las bases de datos disponibles.

La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:

SELECT * FROM sys_catalogs

Columnas¶

Sys_schemas¶

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas

Columnas¶

Sys_tables¶

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables

Columnas¶

Sys_tablecolumns¶

Describe las columnas de las tablas y vistas disponibles.

La siguiente consultar devuelve las columnas y los tipos de datos de la tabla TradingAccounts:

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

Columnas¶

Sys_procedimientos¶

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures

Columnas¶

Sys_procedureparameters¶

Describe procedimiento almacenado* parámetros.

La siguiente consultar devuelve información sobre todos los parámetros de entrada para el procedimiento almacenado SelectEntries:

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

Columnas¶

Sys_keycolumns¶

Describe las claves primarias y foráneas. La siguiente consultar recupera la clave principal de la tabla TradingAccounts:

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

Columnas¶

Sys_foreignkeys¶

Describe las claves foráneas. La siguiente consultar recupera todas las claves foráneas que hacen referencia a otras tablas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Columnas¶

Sys_indexes¶

Describe los índices disponibles. Al filtrar en los índices, puede escribir consultas más selectivas con tiempos de respuesta de consultar más rápidos.

La siguiente consultar recupera todos los índices que no son claves principales:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Columnas¶

Sys_connection_props¶

Devuelve información sobre las propiedades de conexión disponibles y las establecidas en la cadena de conexión.

Al consultar esta tabla, se debe usar la cadena de conexión de configuración:

jdbc:cdata:sage50uk:config:

Esta cadena de conexión le permite consultar esta tabla sin una conexión válida.

La siguiente consultar recupera todas las propiedades de conexión que se han establecido en la cadena de conexión o se han establecido a través de un valor predeterminado:

SELECT * FROM sys_connection_props WHERE Value <> ''

Columnas¶

Sys_sqlinfo¶

Describe el procesamiento de consultar SELECT que el conector puede descargar al origen de datos.

Procesamiento Colaborativo de Consultas¶

Al trabajar con fuentes de datos que no admiten SQL-92, puede consultar la vista sys_sqlinfo para determinar las capacidades de consultar de las APIs subyacentes, expresadas en sintaxis SQL. El conector descarga la mayor cantidad posible del procesamiento de sentencias SELECT al servidor y luego procesa el resto de la consultar en la memoria.

Descubrimiento de las Capacidades SELECT de la Fuente de Datos¶

A continuación se muestra un conjunto de datos de ejemplo de las capacidades de SQL. El siguiente conjunto de resultados indica la funcionalidad SELECT que el conector puede descargar en el origen de datos o en el lado del cliente del proceso. Su fuente de datos puede admitir sintaxis SQL adicional. Algunos aspectos de la funcionalidad SELECT se devuelven en una lista separada por comas si es compatible; de lo contrario, la columna contiene NO.

La siguiente consultar recupera los operadores que se pueden usar en la cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Tenga en cuenta que las tablas individuales pueden tener diferentes limitaciones o requisitos en la cláusula WHERE; consulte el Modelo de datos para obtener más información.

Columnas¶

Sys_identidad¶

Devuelve información sobre los intentos de modificación.

La siguiente consultar recupera los Id. de las filas modificadas en una operación lote:

SELECT * FROM sys_identity

Columnas¶

Propiedades de Configuraciones Avanzadas¶

Las propiedades de configuraciones avanzadas son las diversas opciones que se pueden utilizar para establecer una conexión. Esta sección proporciona una lista completa de las opciones que puede configurar. Haga clic en los enlaces para obtener más detalles.

Autenticación

SSL

Esquema

Misceláneas

Autenticación¶

Esta sección proporciona una lista completa de las propiedades de autenticación que puede configurar.

AuthScheme¶

El esquema utilizado para la autenticación. Las entradas aceptadas son Básico, Resumen o Ninguno.

Valores Posibles¶

Basic, Digest, None

Tipo de Datos¶

string

Valor por Defecto¶

"Basic"

Observaciones¶

Junto con Contraseña y Usuario, este campo se utiliza para autenticarse en el servicio de cuentas Sage 50 UK. Básico es la opción predeterminada.

• Básico: Establezca esto para usar la autenticación HTTP básica.
• Digest: configure esto para usar la autenticación HTTP Digest.

URL¶

URL del servicio SData de Sage 50 UK. Por ejemplo, http://MySite:5493/sdata/accounts50/GCRM/MyDatasetId/.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

URL del servicio SData de Sage 50 UK. Por ejemplo, http://MySite:5493/sdata/accounts50/GCRM/MyDatasetId/.

La URL se puede obtener directamente desde su software Sage 50 UK Accounts navegando a Herramientas > Opciones de Internet > Configuración de SData > Detalles (junto a cuentas Sage 50 UK). A continuación, se puede copiar la dirección para el conjunto de datos de la empresa deseado.

Usuario¶

La cuenta de usuario de Sage 50 UK utilizada para la autenticación.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Junto con Contraseña, este campo se utiliza para autenticarse en el servidor Sage 50 UK.

Contraseña¶

La contraseña utilizada para autenticar al usuario.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El usuario y Password se usan juntos para autenticarse con el servidor.

SSL¶

Esta sección proporciona una lista completa de las propiedades SSL que puede configurar.

SSLServerCert¶

El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Si usa una conexión TLS/SSL, esta propiedad se puede usar para especificar el certificado TLS/SSL que se aceptará del servidor. Se rechaza cualquier otro certificado que no sea de confianza para la máquina.

Esta propiedad puede tomar las siguientes formas:

Si no se especifica, se acepta cualquier certificado en el que confíe la máquina.

La máquina valida los certificados como confiables según el almacén de confianza del sistema. El almacén de confianza utilizado es el valor 'javax.net.ssl.trustStore' especificado para el sistema. Si no se especifica ningún valor para esta propiedad, se utiliza el almacén de confianza predeterminado de Java (por ejemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar que acepta todos los certificados. Tenga en cuenta que esto no se recomienda debido a problemas de seguridad.

Esquema¶

Esta sección proporciona una lista completa de propiedades de esquema que puede configurar.

Ubicación¶

Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.

Tipo de Datos¶

string

Valor por Defecto¶

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

Observaciones¶

La ruta a un directorio que contiene los archivos de esquema para el conector (archivos .rsd para tablas y vistas, archivos .rsb para procedimientos almacenados). La ubicación de la carpeta puede ser una ruta relativa desde la ubicación del ejecutable. El Location La propiedad solo es necesaria si desea personalizar las definiciones (por ejemplo, cambiar el nombre de una columna, ignorar una columna, etc.) o ampliar el modelo de datos con nuevas tablas, vistas o procedimientos almacenados.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\\Sage50UK Data Provider\Schema" con %APPDATA% estando configurado en el directorio de configuración del usuario:

Esquemas Navegables¶

Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Enumerar los esquemas de las bases de datos puede resultar costoso. Proporcionar una lista de esquemas en la cadena de conexión mejora el rendimiento.

Mesas¶

Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA,TablaB,TablaC.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Listar las tablas de algunas bases de datos puede resultar costoso. Proporcionar una lista de tablas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las tablas que desea en una lista separada por comas. Cada tabla debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Puntos de Vista¶

Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA,VistaB,VistaC.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Listar las vistas de algunas bases de datos puede ser costoso. Proporcionar una lista de vistas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las vistas que desee en una lista separada por comas. Cada vista debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Misceláneas¶

Esta sección proporciona una lista completa de propiedades misceláneas que puede configurar.

Filas Máximas¶

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Tipo de Datos¶

int

Valor por Defecto¶

-1

Observaciones¶

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Otro¶

Estas propiedades ocultas se usan solo en casos de uso específicos.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Las propiedades enumeradas a continuación están disponibles para casos de uso específicos. Los casos de uso y la funcionalidad normales del controlador no deberían requerir estas propiedades.

Especifique varias propiedades en una lista separada por punto y coma.

Integración y Formateo¶

Tamaño de Página¶

El número máximo de resultados a devolver por página de Sage 50 UK.

Tipo de Datos¶

int

Valor por Defecto¶

1000

Observaciones¶

El Pagesize la propiedad afecta el número máximo de resultados a devolver por página de Sage 50 UK. Establecer un valor más alto puede resultar en un mejor rendimiento a costa de memoria adicional asignada por página consumida.

Pseudocolumnas¶

Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Esta configuración es particularmente útil en Entity Framework, que no le permite establecer un valor para una pseudocolumna a menos que sea una columna de tabla. El valor de esta configuración de conexión tiene el formato "Tabla1=Columna1, Tabla1=Columna2, Tabla2=Columna3". Puede usar el carácter "*" para incluir todas las tablas y todas las columnas; por ejemplo, "*=*".

Se Acabó el Tiempo¶

El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Tipo de Datos¶

int

Valor por Defecto¶

60

Observaciones¶

Si Timeout = 0, las operaciones no expiran. Las operaciones se ejecutan hasta que se completan correctamente o hasta que encuentran una condición de error.

Si Timeout caduca y la operación aún no se ha completado, el conector genera una excepción.