Detalles de Conexión de Sage 300

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 Sage 300

El conector aprovecha la API de Sage 300 para habilitar el acceso bidireccional a Sage 300.

Establecer una Conexión

Antes de Autenticar

Sage 300 requiere una configuración inicial para comunicarse a través de la API web de Sage 300. El usuario conectado debe tener acceso API a uno o todos los módulos de la instancia de Sage300. En Sage300 a un usuario se le asigna un grupo de seguridad. Un grupo de seguridad es un conjunto de permisos para cada módulo. Se recomienda que utilice un usuario diferente al ADMIN usuario para acceder a la API. El ADMIN el usuario tiene un par de pasos adicionales para obtener acceso a la API. Siga los pasos a continuación para obtener acceso a la API.

Crear un Usuario

Omita este paso si ya ha creado un nuevo usuario o desea utilizar una cuenta existente.

• Abra la aplicación de escritorio Sage300 que se incluye en la instalación de Sage300. Inicie sesión con el ADMIN cuenta.
• Ir a Administrative Services -> Users
• Complete la información requerida y haga clic en Add

Configuración del Grupo de Seguridad

• Abra la aplicación de escritorio Sage300 que se incluye en la instalación de Sage300. Inicie sesión con el ADMIN cuenta.
• Ir a Administrative Services -> Security Groups
• En el Application encontrarás todos los módulos de Sage300. El Group ID representa el grupo de seguridad que desea modificar. A continuación encontrará una lista de permisos que puede consultar.
• (Opcional) Crear un nuevo Security Group llena la Group ID, Group Description y verifique cualquiera de los permisos, incluido el Sage 300 Web API permiso. Por último, haga clic en Add(por cada aplicación requerida)
• O seleccione uno existente Security Group vas a asignar al Usuario bajo Group ID y comprobar el Sage 300 Web API permiso al final de los permisos (por cada aplicación requerida).

Asignación de un Grupo de Seguridad

• Abra la aplicación de escritorio Sage300 que se incluye en la instalación de Sage300. Inicie sesión con el ADMIN cuenta.
• Ir a Administrative Services -> User Authorization
• Bajo User ID seleccione su nuevo/existente User
• Ahora para cada Application asignar el Group ID que creaste/modificaste
• Una vez realizado el acceso del usuario, asegúrese de que tenga acceso a la API web. Cree una URL para probar el acceso a la API web de Sage 300 de la siguiente manera: **https://{servidor}/Sage300WebApi/**, reemplazando {server} con la URL de su instancia de Sage300.

Conexión a Sage 300

El Jitterbit Connector para Sage 300 se comunica con Sage 300 a través de la API de OData. Puede autenticarse en Sage 300 mediante la autenticación básica.

Conectar Mediante Autenticación Básica

Debe proporcionar valores para las siguientes propiedades para autenticarse correctamente en Sage 300. Tenga en cuenta que el proveedor reutilizará la sesión abierta por Sage 300 utilizando cookies.

Esto significa que sus credenciales se utilizarán solo en la primera solicitud para abrir la sesión. Después de eso, las cookies devueltas por Sage 300 se utilizarán para la autenticación.

• URL: establezca esto en la URL del servidor que aloja Sage 300. Construya una URL para la API web de Sage 300 de la siguiente manera: {protocolo}://{ruta-de-la-aplicación-del-host}/v{versión}/{inquilino}/
  Por ejemplo: http://localhost/Sage300WebApi/v1.0/-/.
• User: establezca esto en el nombre de usuario de su cuenta.
• Password: Establézcalo en la contraseña de su cuenta.

Ajuste Fino del Acceso a los Datos

Ajuste Fino del Acceso a Datos

Puede usar las siguientes propiedades para obtener más control sobre los datos devueltos por Sage 300:

• Company: Especifique la empresa de la que desea obtener datos. Si no se especifica, la primera empresa encontrada en el /Companies se elegirá el extremo.
• Modules: use esta propiedad de conexión para limitar la recuperación de metadatos solo a los módulos deseados. Esto mejorará el rendimiento de los metadatos recuperados.
• IncludeCustomFields: Establézcalo en verdadero para enumerar los campos personalizados como columnas de la tabla.

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 funciones avanzadas del conector Sage 300.

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 300 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 OEInvoices 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

Descripción general

El conector Jitterbit para Sage 300 modela los objetos de Sage 300 como tablas y vistas relacionales. Un objeto Sage 300 tiene relaciones con otros objetos; en las tablas, estas relaciones se expresan a través de claves foráneas.

Características clave

• El conector modela las entidades de Sage 300 como tablas y vistas relacionales, lo que le permite escribir SQL para consultar los datos de Sage 300.
• Procedimientos almacenados* le permiten ejecutar operaciones a Sage 300.
• La conectividad en vivo con estos objetos significa que cualquier cambio en su cuenta de Sage 300 se refleja de inmediato al usar el conector.

Mesas

Las tablas se recuperan dinámicamente de la cuenta Sage 300 autenticada.

Mesas Infantiles

También se recuperan las tablas secundarias, que contienen objetos secundarios de sus padres. Por ejemplo, OEOrders tiene OEOrders_OrderCommentsInstructions y OEOrders_OrderDetails como sus tablas secundarias. Estas tablas se exponen como columnas agregadas al consultar su tabla principal. También tienen referencias al identificador único de su padre.

Puntos de vista

Las vistas de solo lectura se recuperan dinámicamente de la cuenta Sage 300 autenticada.

Procedimientos almacenados

NOTE: Los procedimientos almacenados no se admiten actualmente. Consulte la nota anterior para detalles.

Procedimientos almacenados son interfaces similares a funciones para Sage 300. Procedimientos almacenados* le permiten ejecutar operaciones a Sage 300.

Procesamiento colaborativo de consultas

El conector descarga la mayor parte posible del procesamiento de sentencias SELECT a Sage 300 y luego procesa el resto de la consultar en la memoria. Las limitaciones y los requisitos de la API también se documentan en esta sección.

Ver SupportEnhancedSQL para obtener más información sobre cómo el conector elude las limitaciones de la API con el procesamiento del lado del cliente en memoria.

Las declaraciones SELECT para las tablas principales se admiten principalmente en el lado del servidor. Por ejemplo:

SELECT * FROM APInvoiceBatches WHERE BatchDate='2019-01-09 01:00:00.0'

se ejecutará del lado del servidor.

Nota: Al ejecutar sentencias SELECT en tablas secundarias, todo se procesa del lado del cliente.

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 300

APCreateGLBatch

Información de uso para la operación APCreateGLBatch.rsb.

Aporte

Columnas del Conjunto de Resultados

APCreateRecurringPayableBatch

Información de uso para la operación APCreateRecurringPayableBatch.rsb.

Aporte

Columnas del Conjunto de Resultados

APCreateRetainageDocumentBatch

Información de uso para la operación APCreateRetainageDocumentBatch.rsb.

Aporte

Columnas del Conjunto de Resultados

APDeleteInactiveRecords

Información de uso para la operación APDeleteInactiveRecords.rsb.

Aporte

Columnas del Conjunto de Resultados

APPostFacturas

Información de uso para la operación APPostInvoices.rsb.

Aporte

Columnas del Conjunto de Resultados

APPostPagosYAjustes

Información de uso para la operación APPostPaymentsAndAdjustments.rsb.

Aporte

Columnas del Conjunto de Resultados

ARCreateGLBatch

Información de uso para la operación ARCreateGLBatch.rsb.

Aporte

Columnas del Conjunto de Resultados

ARCrearRecurringCharge

Información de uso para la operación ARCreateRecurringCharge.rsb.

Aporte

Columnas del Conjunto de Resultados

ARCreateRetainageDocumentBatch

Información de uso para la operación ARCreateRetainageDocumentBatch.rsb.

Aporte

Columnas del Conjunto de Resultados

ARPostFacturas

Información de uso para la operación ARPostInvoices.rsb.

Aporte

Columnas del Conjunto de Resultados

ARPostReceiptsAndAdjustments

Información de uso para la operación ARPostReceiptsAndAdjustments.rsb.

Aporte

Columnas del Conjunto de Resultados

ARPostReembolsos

Información de uso para la operación ARPostRefunds.rsb.

Aporte

Columnas del Conjunto de Resultados

CrearEsquema

Crea un archivo de esquema para la tabla o vista especificada.

Aporte

Columnas del Conjunto de Resultados

GLPostJournal

Información de uso para la operación GLPostJournal.rsb.

Aporte

Columnas del Conjunto de Resultados

ICCreateGLBatch

Información de uso para la operación ICCreateGLBatch.rsb.

Aporte

Columnas del Conjunto de Resultados

ICDayEndProcessing

Información de uso para la operación ICDayEndProcessing.rsb.

Aporte

Columnas del Conjunto de Resultados

POCreateBatch

Información de uso para la operación POCreateBatch.rsb.

Aporte

Columnas del Conjunto de Resultados

PODayEndProcessing

Información de uso para la operación PODayEndProcessing.rsb.

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 300:

• 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 OEInvoices:

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

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 APCreateGLBatch:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='APCreateGLBatch' 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 OEInvoices:

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

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:sage300: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

Conexión

SSL

Esquema

Misceláneas

Autenticación

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

URL

Establezca la URL en el extremo HTTP o HTTPS de su sistema Sage 300. Por ejemplo, http://localhost/Sage300WebApi/v1.0/-/.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Establezca la URL en el extremo HTTP o HTTPS de su sistema Sage 300 una URL para la API web de Sage 300 de la siguiente manera: {protocol}://{host-application-path}/v{version}/{tenant}/ Por ejemplo, http://localhost/Sage300WebApi/v1.0/-/.

Usuario

La cuenta de usuario de Sage 300 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 300.

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.

Conexión

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

Compañía

Determina la empresa.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Especifique la empresa de la que desea obtener datos. Si no se especifica, se elegirá la primera empresa que se encuentre en el extremo /Empresas.

Módulos

Lista de módulos separados por comas.

Tipo de Datos

string

Valor por Defecto

"\*"

Observaciones

Lista de módulos separados por comas. (Use esta propiedad de conexión para tener acceso solo a los módulos deseados. Esto mejorará el rendimiento de los metadatos recuperados). Opciones: AP (Cuenta por pagar), AR (Cuenta por cobrar), BK (Bancos), CS (Servicios comunes), GL (Libro mayor), IC (Control de inventario), OE (Entrada de pedidos), PO (Órdenes de compra), TX (Seguimiento de impuestos)

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%\\\Sage300 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%\\Sage300 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.

Incluir Campos Personalizados

Determina si los campos personalizados deben incluirse como columnas de la tabla o no.

Tipo de Datos

bool

Valor por Defecto

false

Observaciones

Para recuperar sus valores, puede establecer IncludeCustomFields=true como propiedad de conexión. Al hacerlo, aparecerá una lista de los campos personalizados creados como columnas de la tabla.

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

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, "*=*".

FilaExploraciónProfundidad

El número máximo de filas para escanear para buscar las columnas disponibles en una tabla.

Tipo de Datos

int

Valor por Defecto

100

Observaciones

Las columnas de una tabla deben determinarse escaneando las filas de la tabla. Este valor determina el número máximo de filas que se escanearán.

Establecer un valor alto puede disminuir el rendimiento. Establecer un valor bajo puede evitar que el tipo de datos se determine correctamente, especialmente cuando hay datos nulos.

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.