Detalles de la conexión de ServiceNow

Propiedades de configuraciones avanzadas

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

Para obtener más información sobre cómo establecer una conexión, consulte Conexión de ServiceNow.

Autenticación

Inicio de sesión único

OAuth

Firewall

Proxy

Registro

Esquema

Almacenamiento en caché

Formato de datos

Misceláneas

Autenticación

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

Esquema de autenticación

El esquema de autorización que se utilizará cuando se deba realizar la autorización del servidor.

Valores posibles

Básico, OAuth, OAuthPassword, OKTA, ADFS, OneLogin, PingFederate

Tipo de datos

cadena

Valor predeterminado

"Básico"

Observaciones

Esta propiedad especifica el tipo de autenticación que se realizará. Los valores posibles son:

• Básica: configure esta opción para utilizar la autenticación básica.
• OAuth: configure esta opción para realizar la autenticación OAuth.
• OAuthPassword: configure esta opción para realizar la autenticación OAuth con la contraseña GrantType.

De manera predeterminada, AuthScheme es Básica. El conector realizará la autenticación OAuth si AuthScheme está configurado en OAuth o OAuthAccessToken está configurada.

Las siguientes opciones están disponibles para SSO:

• OKTA: Configurar para usar una conexión de inicio de sesión único con OKTA como proveedor de identidad.
• ADFS: Configurar para usar una conexión de inicio de sesión único con ADFS como proveedor de identidad.
• OneLogin: Configurar para usar una conexión de inicio de sesión único con OneLogin como proveedor de identidad.
• PingFederate: Configurar para usar una conexión de inicio de sesión único con PingFederate como proveedor de identidad.

URL

La URL base de su instancia de ServiceNow.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Establezca la URL base del sitio de su instancia de ServiceNow. Por ejemplo: https://dev47813.service-now.com/.

Usuario

La cuenta de usuario de ServiceNow utilizada para autenticarse.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

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

Contraseña

La contraseña utilizada para autenticar al usuario.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

El Usuario y Contraseña se utilizan juntas para autenticarse en el servidor.

SSO

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

URL de inicio de sesión SSOL

URL de inicio de sesión del proveedor de identidad.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

URL de inicio de sesión del proveedor de identidad.

Propiedades SSO

Propiedades adicionales necesarias para conectarse al proveedor de identidad en una lista separada por punto y coma.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Propiedades adicionales necesarias para conectarse al proveedor de identidad en una lista separada por punto y coma. se utiliza junto con SSOLoginURL.

La configuración de SSO se analiza con más detalle en Establecer una conexión de CData documentación.

OAuth

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

Iniciar OAuth

Establezca esta propiedad para iniciar el proceso de obtención o actualización del token de acceso OAuth cuando se conecte.

Valores posibles

APAGAR, ACTUALIZAR, ACTUALIZAR

Tipo de datos

cadena

Valor predeterminado

"APAGADO"

Observaciones

Las siguientes opciones están disponibles:

1. OFF: indica que el flujo de OAuth será manejado completamente por el usuario. Se requerirá un OAuthAccessToken para autenticarse.
2. GETANDREFRESH: indica que el flujo de OAuth será manejado completamente por el conector. Si no existe ningún token actualmente, se obtendrá solicitando al usuario a través del navegador. Si existe un token, se actualizará cuando corresponda.
3. REFRESH: indica que el conector solo se encargará de actualizar el OAuthAccessToken. El conector nunca le solicitará al usuario que se autentique a través del navegador. El usuario debe encargarse de obtener el OAuthAccessToken y el OAuthRefreshToken inicialmente.

ID de cliente de OAuth

El ID de cliente asignado cuando registra su aplicación con un servidor de autorización OAuth.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Como parte del registro de una aplicación OAuth, recibirá el valor OAuthClientId, a veces también llamado clave de consumidor, y un secreto de cliente, el OAuthClientSecret.

Secreto del cliente OAuth

El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización OAuth.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId, también llamada clave de consumidor. También recibirá un secreto de cliente, también llamado secreto de consumidor. Establezca el secreto de cliente en la propiedad OAuthClientSecret.

Token de acceso OAuth

El token de acceso para conectarse mediante OAuth.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

La propiedad OAuthAccessToken se utiliza para conectarse mediante OAuth. El OAuthAccessToken se recupera del servidor OAuth como parte del proceso de autenticación. Tiene un tiempo de espera que depende del servidor y se puede reutilizar entre solicitudes.

El token de acceso se utiliza en lugar de su nombre de usuario y contraseña. El token de acceso protege sus credenciales al mantenerlas en el servidor.

Ubicación de la configuración de OAuth

La ubicación del archivo de configuración donde se guardan los valores de OAuth cuando InitiateOAuth se configura en GETANDREFRESH o REFRESH. Alternativamente, esto se puede guardar en la memoria especificando un valor que comience con memory://.

Tipo de datos

cadena

Valor predeterminado

"%APPDATA%\ Proveedor de datos de ServiceNow \OAuthSettings.txt"

Observaciones

Cuando Iniciar OAuth está configurado en GETANDREFRESH o REFRESH, el conector guarda los valores de OAuth para evitar requerir que el usuario ingrese manualmente las propiedades de conexión de OAuth y permitir que las credenciales se compartan entre conexiones o procesos.

En lugar de especificar una ruta de archivo, puede utilizar el almacenamiento en memoria. Las ubicaciones de memoria se especifican mediante un valor que comienza con "memory://" seguido de un identificador único para ese conjunto de credenciales (por ejemplo, memory://user1). El identificador puede ser cualquier cosa que elija, pero debe ser exclusivo del usuario. A diferencia del almacenamiento basado en archivos, donde las credenciales persisten en todas las conexiones, el almacenamiento en memoria carga las credenciales en la memoria estática y las credenciales se comparten entre las conexiones utilizando el mismo identificador durante la vida del proceso. Para persistir las credenciales fuera del proceso actual, debe almacenarlas manualmente antes de cerrar la conexión. Esto le permite configurarlas en la conexión cuando se inicia nuevamente el proceso. Puede recuperar los valores de propiedad de OAuth con una consultar a la tabla del sistema sys_connection_props. Si hay varias conexiones que utilizan las mismas credenciales, las propiedades se leen desde la conexión cerrada anteriormente.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\ ServiceNow Data Provider\OAuthSettings.txt" y %APPDATA% se establece en el directorio de configuración del usuario:

URL de devolución de llamada

La URL de devolución de llamada de OAuth a la que se debe regresar durante la autenticación. Este valor debe coincidir con la URL de devolución de llamada que especifique en la configuración de su aplicación.

Tipo de datos

cadena

Valor predeterminado

http://localhost:33333

Observaciones

Durante el proceso de autenticación, el servidor de autorización OAuth redirecciona al usuario a esta URL. Este valor debe coincidir con la URL de devolución de llamada que especifique en la configuración de su aplicación.

Tipo de concesión de OAuth

El tipo de concesión para el flujo OAuth.

Valores posibles

CÓDIGO, CONTRASEÑA

Tipo de datos

cadena

Valor predeterminado

"CÓDIGO"

Observaciones

El tipo de concesión para el flujo OAuth. Están disponibles las siguientes opciones: CÓDIGO, CONTRASEÑA

Verificador OAuth

El código verificador devuelto desde la URL de autorización OAuth.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

El código de verificación devuelto desde la URL de autorización de OAuth. Se puede utilizar en sistemas en los que no se puede iniciar un navegador, como los sistemas sin interfaz gráfica.

Autenticación en máquinas sin interfaz gráfica

Consulte Establecer una conexión de CData documentación para obtener el valor OAuthVerifier.

Establezca OAuthSettingsLocation junto con OAuthVerifier. Cuando se conecta, el conector intercambia OAuthVerifier por los tokens de autenticación de OAuth y los guarda, cifrados, en el archivo especificado. Establezca InitiateOAuth para automatizar el intercambio con GETANDREFRESH.

Una vez que se haya generado el archivo de configuración de OAuth, puede eliminar OAuthVerifier de las propiedades de conexión y conectarse con OAuthSettingsLocation establecido.

Para actualizar automáticamente los valores del token OAuth, configure OAuthSettingsLocation y además configure InitiateOAuth para ACTUALIZAR.

Token de actualización de OAuth

El token de actualización de OAuth para el token de acceso de OAuth correspondiente.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

La propiedad OAuthRefreshToken se utiliza para actualizar el OAuthAccessToken al utilizar la autenticación OAuth.

OAuth expira en

La duración en segundos del token de acceso OAuth.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Empareje con OAuthTokenTimestamp para determinar cuándo caducará el AccessToken.

Marca de tiempo de OAuthToken

La marca de tiempo de la época Unix en milisegundos en la que se creó el token de acceso actual.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Empareje con OAuthExpiresIn para determinar cuándo caducará el AccessToken.

SSL

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

Certificado de servidor SSL

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

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Si se utiliza una conexión TLS/SSL, esta propiedad se puede utilizar para especificar el certificado TLS/SSL que se aceptará del servidor. Cualquier otro certificado que no sea de confianza para la máquina será rechazado.

Esta propiedad puede adoptar 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).

Utilice '*' para indicar que se aceptan todos los certificados. Tenga en cuenta que esto no se recomienda debido a cuestiones de seguridad.

Firewall

Esta sección proporciona una lista completa de las propiedades de Firewall que puedes configurar.

Tipo de cortafuegos

El protocolo utilizado por un firewall basado en proxy.

Valores posibles

NINGUNO, TÚNEL, CALCETINES4, CALCETINES5

Tipo de datos

cadena

Valor predeterminado

"NINGUNO"

Observaciones

Esta propiedad especifica el protocolo que utilizará el conector para canalizar el tráfico a través de FirewallServer proxy. Tenga en cuenta que, de forma predeterminada, el conector se conecta al proxy del sistema; para deshabilitar este comportamiento y conectarse a uno de los siguientes tipos de proxy, configure ProxyAutoDetect a falso.

Para conectarse a servidores proxy HTTP, utilice ProxyServer y ProxyPort. Para autenticarse en servidores proxy HTTP, utilice ProxyAuthScheme, UsuarioProxy, y Contraseña de proxy.

Servidor de cortafuegos

El nombre o la dirección IP de un firewall basado en proxy.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Esta propiedad especifica la dirección IP, el nombre DNS o el nombre de alojar de un proxy que permite atravesar un firewall. El protocolo se especifica mediante FirewallType: Utilice FirewallServer con esta propiedad para conectarse a través de SOCKS o hacer un túnel. Utilice ProxyServer para conectarse a un proxy HTTP.

Tenga en cuenta que el conector utiliza el proxy del sistema de forma predeterminada. Para utilizar un proxy diferente, configure ProxyAutoDetect a falso.

Puerto de cortafuegos

El puerto TCP para un firewall basado en proxy.

Tipo de datos

int

Valor predeterminado

0

Observaciones

Esto especifica el puerto TCP para un proxy que permite atravesar un firewall. Utilice FirewallServer para especificar el nombre o la dirección IP. Especifique el protocolo con FirewallType.

Usuario de Firewall

El nombre de usuario que se utilizará para autenticarse con un firewall basado en proxy.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

El FirewallUser y la FirewallPassword Las propiedades se utilizan para autenticarse contra el proxy especificado en FirewallServer y Puerto de cortafuegos, siguiendo el método de autenticación especificado en FirewallType.

Contraseña del cortafuegos

Una contraseña utilizada para autenticarse en un firewall basado en proxy.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Esta propiedad se pasa al proxy especificado por FirewallServer y Puerto de cortafuegos, siguiendo el método de autenticación especificado por FirewallType.

Apoderado

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

Detección automática de proxy

Cuando esta propiedad de conexión se establece en verdadero, el proveedor verifica la configuración de proxy de su sistema para ver si existen configuraciones de servidor proxy existentes (no es necesario proporcionar manualmente los detalles del servidor proxy). Establezca en falso si desea configurar manualmente el proveedor para que se conecte a un servidor proxy específico.

Tipo de datos

bool

Valor predeterminado

FALSO

Observaciones

Esta propiedad de conexión tiene prioridad sobre otras configuraciones de proxy, por lo que deberá establecer ProxyAutoDetect en falso para poder usar configuraciones de proxy personalizadas.

Cuando esta propiedad se establece en verdadero, el proxy que se utilizará se determina comprobando estas ubicaciones, en este orden. Si no se puede determinar el proxy en un lugar, el controlador comprueba el siguiente.

1. El controlador realiza una búsqueda desde las propiedades de JVM (http.proxy, https.proxy, SocksProxy, etc.).
2. En el caso de que las propiedades de la JVM no existan, el controlador realiza una búsqueda en java.home/lib/net.properties.
3. En el caso de que java.net.useSystemProxies se establezca como verdadero, el controlador realiza una búsqueda en SystemProxy.
4. En Windows, la configuración del proxy se lee desde las Opciones de Internet en el registro, específicamente la clave de registro HKCU\SOFTWARE\Microsoft\ Windows\CurrentVersion\Internet Settings. En Windows 10 y versiones posteriores, esto corresponde a la Configuración de proxy que se encuentra en la Configuración de Windows.

Tenga en cuenta que estas configuraciones se aplican únicamente al usuario actual de la máquina. Si está ejecutando una aplicación como servicio, el controlador no leerá las configuraciones de su propio usuario. En su lugar, deberá proporcionar manualmente las configuraciones de proxy en las propiedades de conexión del controlador.

Para conectarse a un proxy HTTP, consulte ProxyServer. Para otros servidores proxy, como SOCKS o tunelización, consulte FirewallType.

Servidor proxy

El nombre de host o la dirección IP del servidor proxy a través del cual desea enrutar el tráfico HTTP.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

El nombre de host o la dirección IP de un proxy a través del cual enrutar el tráfico HTTP. El controlador puede utilizar los tipos de autenticación HTTP, Windows (NTLM) o Kerberos para autenticarse en un proxy HTTP.

Si necesita conectarse a través de un proxy SOCKS o tunelizar la conexión, consulte FirewallType.

De forma predeterminada, el controlador utiliza el proxy del sistema. Si necesita utilizar otro proxy, configure ProxyAutoDetect a falso.

Puerto proxy

El puerto TCP en el que se ejecuta el servidor proxy (especificado en la propiedad de conexión ProxyServer).

Tipo de datos

int

Valor predeterminado

80

Observaciones

El puerto en el que se ejecuta el proxy HTTP a través del cual desea redirigir el tráfico HTTP. Especifique el proxy HTTP en ProxyServer. Para otros tipos de proxy, consulte FirewallType.

Esquema de autenticación de proxy

El método de autenticación que utiliza el proveedor al autenticarse en el servidor proxy especificado en la propiedad de conexión ProxyServer.

Valores posibles

BÁSICO, RESUMEN, NINGUNO, NEGOCIAR, NTLM, PROPIETARIO

Tipo de datos

cadena

Valor predeterminado

"BÁSICO"

Observaciones

Este valor especifica el tipo de autenticación que se utilizará para autenticarse en el proxy HTTP especificado por ProxyServer y ProxyPort.

Tenga en cuenta que el conector utilizará la configuración de proxy del sistema de manera predeterminada, sin necesidad de realizar ninguna configuración adicional; si desea conectarse a otro proxy, deberá configurar ProxyAutoDetect a falso, además de ProxyServer y ProxyPort. Para autenticarse, configure ProxyAuthScheme y configure ProxyUser y Contraseña de proxy, si es necesario.

El tipo de autenticación puede ser uno de los siguientes:

• BÁSICO: El conector realiza la autenticación HTTP BÁSICA.
• DIGEST: El conector realiza la autenticación HTTP DIGEST.
• NEGOCIAR: El conector recupera un token NTLM o Kerberos según el protocolo aplicable para la autenticación.
• PROPIETARIO: El conector no genera un token NTLM o Kerberos. Debe proporcionar este token en el encabezado de autorización de la solicitud HTTP.

Si necesita utilizar otro tipo de autenticación, como la autenticación SOCKS 5, consulte FirewallType.

Usuario proxy

El nombre de usuario de una cuenta de usuario registrada en el servidor proxy especificado en la propiedad de conexión ProxyServer.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

El ProxyUser y la ProxyPassword se utilizan para conectarse y autenticarse contra el proxy HTTP especificado en ProxyServer.

Puede seleccionar uno de los tipos de autenticación disponibles en ProxyAuthScheme. Si utiliza la autenticación HTTP, configure esta propiedad con el nombre de usuario de un usuario reconocido por el proxy HTTP. Si utiliza la autenticación Kerberos o de Windows, configure esta propiedad con un nombre de usuario en uno de los siguientes formatos:

user@domain
domain\user

Contraseña de proxy

La contraseña asociada con el usuario especificado en la propiedad de conexión ProxyUser.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Esta propiedad se utiliza para autenticarse en un servidor proxy HTTP compatible con NTLM (Windows), Kerberos o autenticación HTTP. Para especificar el proxy HTTP, puede configurar ProxyServer y ProxyPort. Para especificar el tipo de autenticación, configure ProxyAuthScheme.

Si está utilizando la autenticación HTTP, configure adicionalmente ProxyUser y ProxyPassword para el proxy HTTP.

Si está utilizando la autenticación NTLM, configure ProxyUser y ProxyPassword a tu contraseña de Windows. También es posible que necesites estos datos para completar la autenticación Kerberos.

Para la autenticación o tunelización SOCKS 5, consulte FirewallType.

De manera predeterminada, el conector utiliza el proxy del sistema. Si desea conectarse a otro proxy, configure ProxyAutoDetect a falso.

Tipo de SSL de proxy

El tipo de SSL que se utilizará al conectarse al proxy ProxyServer.

Valores posibles

AUTO, SIEMPRE, NUNCA, TÚNEL

Tipo de datos

cadena

Valor predeterminado

"AUTOMÁTICO"

Observaciones

Esta propiedad determina cuándo se debe utilizar SSL para la conexión a un proxy HTTP especificado por ProxyServer. Este valor puede ser AUTO, SIEMPRE, NUNCA o TÚNEL. Los valores aplicables son los siguientes:

• AUTO: Configuración predeterminada. Si la URL es una URL HTTPS, el controlador utilizará la opción TUNNEL. Si la URL es una URL HTTP, el componente utilizará la opción NEVER.
• SIEMPRE: La conexión siempre está habilitada para SSL.
• NUNCA: La conexión no está habilitada para SSL.
• TÚNEL: La conexión se realiza a través de un proxy de tunelización. El servidor proxy abre una conexión con el alojar remoto y el tráfico fluye de ida y vuelta a través del proxy.

Excepciones de proxy

Una lista separada por punto y coma de direcciones IP o nombres de host de destino que están exentos de conectarse a través del servidor proxy.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

El Servidor Proxy se utiliza para todas las direcciones, excepto las direcciones definidas en esta propiedad. Utilice punto y coma para separar las entradas.

Tenga en cuenta que el conector utiliza la configuración de proxy del sistema de forma predeterminada, sin necesidad de realizar ninguna configuración adicional; si desea configurar explícitamente las excepciones de proxy para esta conexión, debe configurar ProxyAutoDetect = falso y configure ProxyServer y ProxyPort. Para autenticarse, configure ProxyAuthScheme y configure ProxyUser y Contraseña de proxy, si es necesario.

Registro

Esta sección proporciona una lista completa de las propiedades de registro que puede configurar en la cadena de conexión para este proveedor.

Archivo de registro

Una ruta de archivo que designa el nombre y la ubicación del archivo de registro.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Una vez que se configura esta propiedad, el controlador completará el archivo de registro a medida que realice diversas tareas, como cuando se realiza la autenticación o se ejecutan consultas. Si el archivo especificado aún no existe, se creará.

Las cadenas de conexión y la información de la versión también se registran, aunque las propiedades de conexión que contienen información confidencial se enmascaran automáticamente.

Si se proporciona una ruta de archivo relativa, la ubicación del archivo de registro se resolverá en función de la ruta que se encuentre en Ubicación propiedad de conexión.

Para tener más control sobre lo que se escribe en el archivo de registro, puede ajustar el Verbosity propiedad.

El contenido del registro se clasifica en varios módulos. Puede mostrar u ocultar módulos individuales mediante LogModules propiedad.

Para editar el tamaño máximo de un único archivo de registro antes de crear uno nuevo, consulte MaxLogFileSize.

Si desea poner un límite a la cantidad de archivos de registro generados, utilice MaxLogFileCount.

Registro de Java

También se admite el registro de Java. Para habilitar el registro de Java, configure Archivo de registro en:

Logfile=JAVALOG://myloggername

Como en el ejemplo anterior, JAVALOG:// es un prefijo obligatorio para utilizar el registro de Java, y deberá sustituirlo por su propio Logger.

Luego se llama al método getLogger del Logger proporcionado, utilizando el valor proporcionado para crear la instancia del Logger. Si ya existe una instancia de registro, hará referencia a la instancia existente.

Cuando el registro de Java está habilitado, el Verbosity ahora corresponderán a niveles de registro específicos.

Verbosidad

El nivel de detalle que determina la cantidad de detalles incluidos en el archivo de registro.

Tipo de datos

cadena

Valor predeterminado

"1"

Observaciones

El nivel de verbosidad determina la cantidad de detalles que el controlador informa al Archivo de registro documentación.

Módulos de registro

Módulos principales que se incluirán en el archivo de registro.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Solo los módulos especificados (separados por ';') se incluirán en el archivo de registro. De manera predeterminada, se incluyen todos los módulos.

Consulte Registro de CData documentación para obtener una descripción general.

Tamaño máximo del archivo de registro

Una cadena que especifica el tamaño máximo en bytes de un archivo de registro (por ejemplo, 10 MB).

Tipo de datos

cadena

Valor predeterminado

"100 MB"

Observaciones

Cuando se alcanza el límite, se crea un nuevo registro en la misma carpeta con la fecha y la hora adjuntas al final. El límite predeterminado es de 100 MB. Los valores inferiores a 100 kB utilizarán 100 kB como valor.

Ajuste la cantidad máxima de archivos de registro generados con MaxLogFileCount.

Número máximo de archivos de registro

Una cadena que especifica el número máximo de archivos de registro.

Tipo de datos

int

Valor predeterminado

-1

Observaciones

Cuando se alcanza el límite, se crea un nuevo registro en la misma carpeta con la fecha y la hora adjuntas al final y se elimina el archivo de registro más antiguo.

El valor mínimo admitido es 2. Un valor de 0 o un valor negativo indica que no hay límite en el recuento.

Ajuste el tamaño máximo de los archivos de registro generados con MaxLogFileSize.

Esquema

Esta sección proporciona una lista completa de las 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

cadena

Valor predeterminado

"%APPDATA%\ Proveedor de datos de ServiceNow \Esquema"

Observaciones

Ruta de acceso 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 a la ubicación del ejecutable. La propiedad Ubicación 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%\ ServiceNow Data Provider\Schema" y %APPDATA% se establece 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

cadena

Valor predeterminado

""

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.

Tablas

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

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Enumerar 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 desea trabajar y, de lo contrario, habría demasiadas con las que trabajar.

Especifique las tablas que desea en una lista separada por comas. Cada tabla debe ser un identificador SQL válido con caracteres especiales que se escapen mediante corchetes, comillas dobles o comillas invertidas. 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, para evitar ambigüedades entre las tablas que existen en varios catálogos o esquemas.

Vistas

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

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Enumerar las vistas de algunas bases de datos puede resultar 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 desea trabajar y, de lo contrario, habría demasiadas con las que trabajar.

Especifique las vistas que desea en una lista separada por comas. Cada vista debe ser un identificador SQL válido con caracteres especiales que se escapen mediante corchetes, comillas dobles o comillas simples invertidas. 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, para evitar ambigüedades entre las tablas que existen en varios catálogos o esquemas.

Incluir vistas de bases de datos

Controla si se deben exponer o no las vistas de la base de datos.

Tipo de datos

bool

Valor predeterminado

FALSO

Observaciones

Controla si se deben exponer o no las vistas de la base de datos. Si es verdadero, el conector enviará varias llamadas de metadatos adicionales para obtener los metadatos de las vistas de la base de datos.

Incluir tablas del sistema

Controla si se deben exponer o no las tablas del sistema.

Tipo de datos

bool

Valor predeterminado

verdadero

Observaciones

Controla si se deben exponer o no las tablas del sistema. Por lo general, solo los usuarios con rol de administrador tienen acceso a estas tablas. Si se establece esta propiedad en falso, se obligará a que no se incluyan en las llamadas de metadatos.

Almacenamiento en caché

Esta sección proporciona una lista completa de las propiedades de almacenamiento en caché que puede configurar.

Caché automático

Almacena automáticamente en caché los resultados de las consultas SELECT en una base de datos de caché especificada por CacheLocation o por CacheConnection y CacheProvider.

Tipo de datos

bool

Valor predeterminado

FALSO

Observaciones

Cuando AutoCache es verdadero, el conector mantiene automáticamente un caché de los datos de su tabla en la base de datos que elija. De manera predeterminada, el conector actualiza el caché de manera incremental y recupera solo los cambios desde la última consultar SELECT ejecutada si el tiempo transcurrido desde la última ejecución ha excedido la CacheTolerance. Una vez actualizada la memoria caché, la consultar se ejecuta contra los datos almacenados en caché.

Configuración de la base de datos de almacenamiento en caché

Cuando AutoCache es verdadero, el conector almacena en caché un caché simple basado en archivos. Puede configurar su ubicación o almacenar en caché una base de datos diferente con las siguientes propiedades:

• CacheLocation: especifica la ruta al almacén de archivos.
• CacheDriver y Conexión de caché: Especifica un controlador para una base de datos y la cadena de conexión.

Ver también

• Tolerancia de caché: Esta propiedad controla la tolerancia para los datos obsoletos en la memoria caché.
• CacheMetadata: Esta propiedad reduce la cantidad de metadatos que atraviesan la red al conservar los esquemas de tabla recuperados de los metadatos de ServiceNow. De esta forma, los metadatos solo deben recuperarse una vez en lugar de cada conexión.
• Almacenamiento en caché de datos explícito: CData proporciona más ejemplos del uso de AutoCache en Sin conexión modo.
• Declaraciones CACHE: CData detalla cómo puede utilizar la declaración CACHE para persistir cualquier consultar SELECT, así como administrar el caché; por ejemplo, actualizando esquemas.

Controlador de caché

El controlador de base de datos que se utilizará para almacenar en caché los datos.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Puede almacenar en caché cualquier base de datos para la que tenga un controlador JDBC, incluidos los controladores JDBC.

La base de datos de caché se determina en función de CacheDriver y CacheConnection propiedades. CacheDriver es el nombre de la clase del controlador JDBC que desea utilizar para almacenar en caché los datos.

Tenga en cuenta que también debe agregar el archivo JAR CacheDriver a la ruta de clase.

Los siguientes ejemplos muestran cómo almacenar en caché varias bases de datos importantes. Consulte CacheConnection para obtener más información sobre la sintaxis de URL de JDBC y las propiedades de conexión típicas.

Derby y Java DB

El controlador simplifica la configuración de Derby. Java DB es la distribución Oracle de Derby. El archivo JAR se incluye en el JDK. Puede encontrar el archivo JAR, derby.jar, en la subcarpeta db de la instalación del JDK. En la mayoría de los escenarios de almacenamiento en caché, solo necesita especificar lo siguiente, después de agregar derby.jar a la ruta de clase:

jdbc:servicenow:CacheDriver=org.apache.derby.jdbc.EmbeddedDriver;CacheConnection='jdbc:derby:sample';InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;User=MyUser;Password=MyPassword;Url=https://MyInstance12345.service-now.com/;

Para personalizar la URL JDBC de Derby, utilice CacheDriver y CacheConnection. Por ejemplo, para almacenar en caché una base de datos en memoria, utilice una URL JDBC como la siguiente:

jdbc:servicenow:CacheDriver=org.apache.derby.jdbc.EmbeddedDriver;CacheConnection='jdbc:derby:memory';InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;User=MyUser;Password=MyPassword;Url=https://MyInstance12345.service-now.com/;

SQLite

La siguiente es una URL JDBC para el controlador JDBC de SQLite:

jdbc:servicenow:CacheDriver=org.sqlite.JDBC;CacheConnection='jdbc:sqlite:C:/Temp/sqlite.db';InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;User=MyUser;Password=MyPassword;Url=https://MyInstance12345.service-now.com/;

MySQL

La siguiente es una URL JDBC para el controlador JDBC incluido para MySQL:

jdbc:servicenow:Cache Driver=cdata.jdbc.mysql.MySQLDriver;Cache Connection='jdbc:mysql:Server=localhost;Port=3306;Database=cache;User=root;Password=123456';InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;User=MyUser;Password=MyPassword;Url=https://MyInstance12345.service-now.com/;

SQL Server

La siguiente URL de JDBC utiliza el controlador JDBC de Microsoft para SQL Server:

jdbc:servicenow:Cache Driver=com.microsoft.sqlserver.jdbc.SQLServerDriver;Cache Connection='jdbc:sqlserver://localhost\sqlexpress:7437;user=sa;password=123456;databaseName=Cache';InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;User=MyUser;Password=MyPassword;Url=https://MyInstance12345.service-now.com/;

Oracle

La siguiente es una URL JDBC para Oracle Thin Client:

jdbc:servicenow:Cache Driver=oracle.jdbc.OracleDriver;CacheConnection='jdbc:oracle:thin:scott/tiger@localhost:1521:orcldb';InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;User=MyUser;Password=MyPassword;Url=https://MyInstance12345.service-now.com/;

NOTA: Si utiliza una versión de Oracle anterior a 9i, el controlador de caché será oracle.jdbc. controlador.OracleDriver.

PostgreSQL

La siguiente URL de JDBC utiliza el controlador JDBC oficial de PostgreSQL:

jdbc:servicenow:CacheDriver=cdata.jdbc.postgresql.PostgreSQLDriver;CacheConnection='jdbc:postgresql:User=postgres;Password=admin;Database=postgres;Server=localhost;Port=5432;';InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;User=MyUser;Password=MyPassword;Url=https://MyInstance12345.service-now.com/;

Conexión de caché

La cadena de conexión para la base de datos de caché. Esta propiedad siempre se utiliza junto con CacheProvider. Si se configuran ambas propiedades, se anulará el valor establecido para CacheLocation para almacenar datos en caché.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

La base de datos de caché se determina en función de CacheDriver y CacheConnection. Ambas propiedades son necesarias para utilizar la base de datos de caché. A continuación, se pueden encontrar ejemplos de configuraciones comunes de la base de datos de caché. Para obtener más información sobre cómo configurar el controlador de la base de datos de caché, consulte CacheDriver.

La cadena de conexión especificada en la propiedad CacheConnection se pasa directamente al CacheDriver subyacente). Consulte la documentación del controlador JDBC específico para obtener más información sobre las propiedades disponibles. Asegúrese de incluir el controlador JDBC en la ruta de clase de su aplicación.

Derby y Java DB

El controlador simplifica el almacenamiento en caché en Derby, y solo requiere que configure CacheLocation para realizar una conexión básica.

Como alternativa, puede configurar la conexión a Derby manualmente usando CacheDriver y CacheConnection. La siguiente es la sintaxis de URL de Derby JDBC:

jdbc:derby:[subsubprotocol:][nombreDeBaseDeDatos][;attribute=value[;attribute=value] ... ]

Por ejemplo, para almacenar en caché una base de datos en memoria, utilice lo siguiente:

jdbc:derby:memory

SQLite

Para almacenar en caché SQLite, puede utilizar el controlador JDBC de SQLite. La siguiente es la sintaxis de la URL de JDBC:

jdbc:sqlite:dataSource

• Origen de datos: la ruta a un archivo de base de datos SQLite. O bien, utilice un valor de :memory almacenar en caché en la memoria.

MySQL

La instalación incluye el controlador JDBC para MySQL. A continuación, se muestra un ejemplo de URL de JDBC:

jdbc:mysql:User=root;Password=root;Server=localhost;Port=3306;Database=cache

Las siguientes son propiedades de conexión típicas:

• Servidor: La dirección IP o el nombre de dominio del servidor al que desea conectarse.
• Puerto: El puerto en el que se ejecuta el servidor.
• Usuario: El nombre de usuario proporcionado para la autenticación en la base de datos.
• Contraseña: La contraseña proporcionada para la autenticación en la base de datos.
• Base de datos: El nombre de la base de datos.

SQL Server

La URL de JDBC para Microsoft JDBC Driver para SQL Server tiene la siguiente sintaxis:

jdbc:sqlserver://[serverName[\instance][: puerto]][;database=databaseName][;propiedad=valor[;propiedad=valor] ... ]

Por ejemplo:

jdbc:sqlserver://localhost\sqlexpress:1433;integratedSecurity=true

Las siguientes son propiedades de conexión típicas de SQL Server:

• Servidor: el nombre o la dirección de red del equipo que ejecuta SQL Server. Para conectarse a una instancia con nombre en lugar de a la instancia predeterminada, se puede utilizar esta propiedad para especificar el nombre del alojar y la instancia, separados por una barra invertida.

• Puerto: el puerto en el que se ejecuta SQL Server.

• Base de datos: el nombre de la base de datos de SQL Server.

• Seguridad integrada: configure esta opción como verdadera para usar la cuenta de Windows actual para la autenticación. Configure esta opción como falsa si está configurando el usuario y la contraseña en la conexión.

  Para utilizar la seguridad integrada, también deberá agregar sqljdbc_auth.dll a una carpeta en la ruta del sistema de Windows. Este archivo se encuentra en la subcarpeta auth de la instalación del controlador JDBC de Microsoft para SQL Server. El valor de bits del ensamblado debe coincidir con el valor de bits de su JVM.

• ID de usuario: el nombre de usuario proporcionado para la autenticación con SQL Server. Esta propiedad solo es necesaria si no utiliza seguridad integrada.

• Contraseña: la contraseña proporcionada para la autenticación con SQL Server. Esta propiedad solo es necesaria si no utiliza seguridad integrada.

Oracle

La siguiente es la sintaxis de URL JDBC convencional para el controlador Oracle JDBC Thin:

jdbc:oracle:thin:[userId/password]@[//]host[[:port][:sí]]

Por ejemplo:

jdbc:oracle:thin:scott/tiger@myhost:1521:orcl

Las siguientes son propiedades de conexión típicas:

• Origen de datos: el descriptor de conexión que identifica la base de datos Oracle. Puede ser un descriptor de conexión TNS, un nombre de Oracle Net Services que se resuelve en un descriptor de conexión o, a partir de la versión 11g, un nombre de Easy Connect (el nombre de alojar del servidor Oracle con un puerto y un nombre de servicio opcionales).

• Contraseña: La contraseña proporcionada para la autenticación con la base de datos Oracle.

• Id. de usuario: el ID de usuario proporcionado para la autenticación con la base de datos de Oracle.

PostgreSQL

La siguiente es la sintaxis de URL JDBC para el controlador JDBC oficial de PostgreSQL:

jdbc:postgresql:[//[host[:port]]/]database[[?option=value][[&opción=valor][&option=value] ... ]]

Por ejemplo, la siguiente cadena de conexión se conecta a una base de datos en el alojar predeterminado (localhost) y el puerto (5432):

jdbc:postgresql:postgres

Las siguientes son propiedades de conexión típicas:

• Host: La dirección del servidor que aloja la base de datos PostgreSQL.
• Puerto: El puerto utilizado para conectarse al servidor que aloja la base de datos PostgreSQL.
• Base de datos: El nombre de la base de datos.
• Nombre de usuario: el ID de usuario proporcionado para la autenticación con la base de datos PostgreSQL. Puede especificarlo en la URL de JDBC con el parámetro "usuario".
• Contraseña: La contraseña proporcionada para la autenticación con la base de datos PostgreSQL.

Ubicación de caché

Especifica la ruta a la memoria caché cuando se almacena en caché un archivo.

Tipo de datos

cadena

Valor predeterminado

"%APPDATA%\ Proveedor de datos de ServiceNow "

Observaciones

CacheLocation es una caché simple basada en archivos. El conector utiliza Java DB, la distribución de Oracle de la base de datos Derby. Para almacenar en caché Java DB, deberá agregar el archivo JAR de Java DB a la ruta de clase. El archivo JAR, derby.jar, se envía en el JDK y se encuentra en la subcarpeta db de la instalación del JDK.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\ ServiceNow Data Provider" y %APPDATA% se establece en el directorio de configuración del usuario:

Ver también

• Caché automático: Establecido para crear y mantener implícitamente un caché para su uso posterior sin conexión.
• CacheMetadata: Establezca para conservar el catálogo de ServiceNow en CacheLocation.

Tolerancia de caché

La tolerancia para datos obsoletos en la memoria caché especificada en segundos cuando se utiliza AutoCache.

Tipo de datos

int

Valor predeterminado

600

Observaciones

La tolerancia para datos obsoletos en la memoria caché especificada en segundos. Esto solo se aplica cuando AutoCache. El conector comprueba con la fuente de datos si hay registros más nuevos después de que haya expirado el intervalo de tolerancia. De lo contrario, devuelve los datos directamente desde la memoria caché.

Fuera de línea

Utilice el modo sin conexión para obtener los datos de la memoria caché en lugar de la fuente en vivo.

Tipo de datos

bool

Valor predeterminado

FALSO

Observaciones

Cuando Offline es verdadero, todas las consultas se ejecutan en la memoria caché en lugar de en la fuente de datos en vivo. En este modo, no se permiten ciertas consultas como INSERT, UPDATE, DELETE y CACHE.

Metadatos de caché

Esta propiedad determina si se deben almacenar o no en caché los metadatos de la tabla en un almacén de archivos.

Tipo de datos

bool

Valor predeterminado

FALSO

Observaciones

A medida que ejecuta consultas con esta propiedad establecida, los metadatos de la tabla en el catálogo de ServiceNow se almacenan en caché en el almacén de archivos especificado por CacheLocation si se configura o, en caso contrario, el directorio de inicio del usuario. Los metadatos de una tabla se recuperarán solo una vez, cuando se consulte la tabla por primera vez.

Cuándo utilizar CacheMetadata

El conector conserva automáticamente los metadatos en la memoria durante hasta dos horas cuando descubre por primera vez los metadatos de una tabla o vista y, por lo tanto, CacheMetadata generalmente no es necesario. CacheMetadata resulta útil cuando las operaciones de metadatos son costosas, como cuando trabaja con grandes cantidades de metadatos o cuando tiene muchas conexiones de corta duración.

Cuándo no utilizar CacheMetadata

• Cuando se trabaja con metadatos volátiles: los metadatos de una tabla solo se recuperan la primera vez que se realiza la conexión a la tabla. Para seleccionar columnas nuevas, modificadas o eliminadas, deberá eliminar y reconstruir la caché de metadatos. Por lo tanto, es mejor confiar en el almacenamiento en caché en memoria para los casos en los que los metadatos cambian con frecuencia.
• Cuando se almacena en caché una base de datos: CacheMetadata solo se puede utilizar con CacheLocation. Si está almacenando en caché otra base de datos con CacheDriver y Conexión de caché propiedades, utilice AutoCache para almacenar en caché de forma implícita. O bien, utilice Declaraciones REPLICATE o Declaraciones CACHE para almacenar en caché explícitamente.

Formato de datos

Esta sección proporciona una lista completa de las propiedades de formato de datos que puede configurar en la cadena de conexión para este proveedor.

Introducir valores vacíos como nulos

Indica si se deben leer los valores vacíos como vacíos o como nulos.

Tipo de datos

bool

Valor predeterminado

FALSO

Observaciones

Indica si se deben leer los valores vacíos como vacíos o como nulos.

Misceláneas

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

Tamaño del lote

El tamaño máximo de cada operación lote a enviar.

Tipo de datos

int

Valor predeterminado

0

Observaciones

Cuando BatchSize se establece en un valor mayor que 0, la operación lote dividirá todo el lote en lotes separados de tamaño BatchSize. Los lotes divididos se enviarán al servidor de forma individual. Esto es útil cuando el servidor tiene limitaciones en el tamaño de la solicitud que se puede enviar.

Si se establece BatchSize en 0, se enviará el lote completo según lo especificado.

Tiempo de vida de la conexión

La duración máxima de una conexión en segundos. Una vez transcurrido el tiempo, se elimina el objeto de conexión.

Tipo de datos

int

Valor predeterminado

0

Observaciones

La duración máxima de una conexión en segundos. Una vez transcurrido el tiempo, se elimina el objeto de conexión. El valor predeterminado es 0, lo que indica que no hay límite para la duración de la conexión.

ConectarOnOpen

Esta propiedad especifica si debe conectarse a ServiceNow cuando se abre la conexión.

Tipo de datos

bool

Valor predeterminado

FALSO

Observaciones

Cuando se establece como verdadero, se establecerá una conexión con ServiceNow cuando se abra la conexión. Esta propiedad habilita la función Probar conexión disponible en varias herramientas de base de datos.

Esta función actúa como un comando NOOP ya que se utiliza para verificar que se pueda realizar una conexión a ServiceNow y no se mantiene nada de esta conexión inicial.

Establecer esta propiedad como falsa puede proporcionar mejoras de rendimiento (dependiendo de la cantidad de veces que se abre una conexión).

Valor de visualización

En función de este valor, el proveedor recupera el valor de visualización o el valor real de la base de datos.

Valores posibles

VERDADERO, FALSO, TODO

Tipo de datos

cadena

Valor predeterminado

"FALSO"

Observaciones

Nota: Si decide establecer esta propiedad de conexión en "VERDADERO", entonces todos los campos devueltos serán del tipo "Cadena" debido a las limitaciones de la API.

• VERDADERO: devuelve valores de visualización para todos los campos.
• FALSO: devuelve valores reales de la base de datos.
• ALL: devuelve los valores reales y los valores mostrados.

NombreDeColumnaValorMostrar

Patrón para mostrar los nombres de las columnas cuando la propiedad DisplayValue está establecida en ALL.

Tipo de datos

cadena

Valor predeterminado

"{0}_valor_visualización"

Observaciones

La propiedad acepta un valor similar a un patrón que se utiliza para dar formato a los nombres de las columnas cuando DisplayValue=ALL. '{0}' sirve como marcador de posición para los nombres de las columnas.

Aplicar valores de columna

Controla si se recuperan y verifican los valores disponibles para un elemento al ejecutar instrucciones INSERT o UPDATE.

Tipo de datos

bool

Valor predeterminado

FALSO

Observaciones

Controla si se recuperan y comprueban los valores disponibles para un elemento al ejecutar las instrucciones INSERT o UPDATE. Si el valor no es una opción válida, se generará un error. Los elementos (columnas) en ServiceNow podrían estar limitados a un conjunto de valores válidos (opciones en una lista). Por ejemplo, un elemento 'Tipo de problema' solo podría tener valores válidos como 'Error', 'Mejora' o 'Documentación'. Si se crea un registro con un valor no válido, ServiceNow descartará el valor y asignará un valor predeterminado para el registro. Si se establece esta propiedad en 'true', se recuperarán las opciones disponibles de antemano y se comprobará si los valores insertados forman parte de la lista de valores válidos cuando sea posible. Tenga en cuenta que los valores de visualización distinguen entre mayúsculas y minúsculas. Esta propiedad respeta la propiedad de conexión DisplayValue.

Excluir enlace de referencia

En función de este valor, se suprimirá o no la información adicional proporcionada para los campos de referencia.

Tipo de datos

bool

Valor predeterminado

FALSO

Observaciones

En función de este valor, se suprimirá o no la información adicional proporcionada para los campos de referencia.

Obtener metadatos de columnas

Indica la preferencia del usuario respecto de cuándo y cómo el proveedor debe obtener los metadatos de las columnas.

Valores posibles

Al iniciar, al usar

Tipo de datos

cadena

Valor predeterminado

"En uso"

Observaciones

Las configuraciones disponibles son las siguientes:

• OnStart: el conector ejecutará las llamadas de metadatos para descubrir y almacenar en caché todas las columnas de cada tabla, antes de ejecutar la primera instrucción.
• OnUse: el conector ejecutará las llamadas de metadatos específicas de la tabla la primera vez que se haga referencia a la tabla, siempre que los metadatos de la tabla no estén ya almacenados en caché.

Máximo de filas

Limita la cantidad de filas que se devuelven cuando no se utiliza ninguna agregación ni GROUP BY en la consultar. Esto tiene prioridad sobre las cláusulas LIMIT.

Tipo de datos

int

Valor predeterminado

-1

Observaciones

Limita la cantidad de filas que se devuelven cuando no se utiliza ninguna agregación ni GROUP BY en la consultar. Esto tiene prioridad sobre las cláusulas LIMIT.

Otro

Estas propiedades ocultas se utilizan únicamente en casos de uso específicos.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

Las propiedades que se enumeran a continuación están disponibles para casos de uso específicos. Los casos de uso y la funcionalidad del conector normal no deberían requerir estas propiedades.

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

Configuración de almacenamiento en caché

Integración y formato

Tamaño de página

El número máximo de resultados que se devolverán por página desde ServiceNow.

Tipo de datos

int

Valor predeterminado

5000

Observaciones

La propiedad Pagesize afecta la cantidad máxima de resultados que se devuelven por página desde ServiceNow. Si bien la fuente de datos optimiza el tamaño de página predeterminado para la mayoría de los casos de uso, es posible que deba ajustar este valor según el objeto o extremo de servicio específico que esté consultando. Aumentar el tamaño de página puede mejorar el rendimiento, pero también podría generar un mayor consumo de memoria por página.

Tiempo de espera inactivo de la piscina

El tiempo de inactividad permitido para una conexión antes de que se cierre.

Tipo de datos

int

Valor predeterminado

60

Observaciones

El tiempo de inactividad permitido que una conexión puede permanecer en el grupo hasta que se cierre. El valor predeterminado es 60 segundos.

Tamaño máximo de la piscina

El número máximo de conexiones en el pool.

Tipo de datos

int

Valor predeterminado

100

Observaciones

La cantidad máxima de conexiones en el grupo. El valor predeterminado es 100. Para deshabilitar esta propiedad, establezca el valor de la propiedad en 0 o menos.

Tamaño mínimo de la piscina

El número mínimo de conexiones en el pool.

Tipo de datos

int

Valor predeterminado

1

Observaciones

La cantidad mínima de conexiones en el grupo. El valor predeterminado es 1.

Tiempo de espera de la piscina

El máximo de segundos que se debe esperar para que haya una conexión disponible.

Tipo de datos

int

Valor predeterminado

60

Observaciones

El tiempo máximo de espera para que una conexión esté disponible. Si una nueva solicitud de conexión espera una conexión disponible y excede este tiempo, se genera un error. De manera predeterminada, las nuevas solicitudes esperan una eternidad a que haya una conexión disponible.

Pseudocolumnas

Especifique un conjunto de pseudocolumnas para exponer como columnas.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

El valor de esta configuración de conexión tiene el formato "Tabla1=Columna1;Tabla1=Columna2;Tabla2=Columna3".

Puede utilizar el carácter "*" para incluir todas las tablas y todas las columnas; por ejemplo, "*=*".

Sólo lectura

Puede utilizar esta propiedad para imponer acceso de solo lectura a ServiceNow desde el proveedor.

Tipo de datos

bool

Valor predeterminado

FALSO

Observaciones

Si esta propiedad se establece como verdadera, el conector solo permitirá consultas SELECT. Las consultas INSERT, UPDATE, DELETE y de procedimientos almacenados generarán un error.

RTK

La clave de tiempo de ejecución utilizada para la concesión de licencias.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

La propiedad RTK se puede utilizar para otorgar licencia a una compilación. Consulta el archivo de licencia incluido para ver cómo configurar esta propiedad. La clave de tiempo de ejecución solo está disponible si compraste una licencia OEM.

Mostrar descripciones

Controla si las descripciones de columnas y tablas se devuelven a través de los extremos de API sys_documentation y sys_db_object.

Valores posibles

NINGUNO, EtiquetasDeTabla, EtiquetasDeColumna, EtiquetasDeTablaYColumna, ComentariosDeColumna

Tipo de datos

cadena

Valor predeterminado

"NINGUNO"

Observaciones

Nota: De manera predeterminada, está configurado en NONE y no se muestran las descripciones de las tablas y sus respectivas columnas. Se ejecutarán llamadas API adicionales si esta propiedad se configura en un valor distinto de NONE. Establezca el valor de esta propiedad en TableLabels si desea recuperar las etiquetas (nombres para mostrar) de cada tabla desde el extremo de la API sys_db_object. Establezca el valor de esta propiedad en ColumnLabels si desea recuperar las etiquetas (nombres para mostrar) de cada columna desde el extremo de la API sys_documentation. Establezca el valor de esta propiedad en TableAndColumnLabels si desea recuperar las etiquetas (nombres para mostrar) de cada tabla y sus respectivas columnas desde los extremos de API sys_db_object y sys_documentation. Establezca el valor de esta propiedad en ColumnComments si desea recuperar los comentarios de cada columna desde el extremo de la API sys_dictionary.

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 predeterminado

60

Observaciones

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

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

Uso de agrupación de conexiones

Esta propiedad permite la agrupación de conexiones.

Tipo de datos

bool

Valor predeterminado

FALSO

Observaciones

Esta propiedad habilita la agrupación de conexiones. El valor predeterminado es falso. Consulte Agrupación de conexiones de CData página para obtener información sobre el uso de grupos de conexiones.

UsarDisplayTableNames

Valor booleano que determina si se deben utilizar los nombres para mostrar de la tabla en lugar de los nombres de la API.

Tipo de datos

bool

Valor predeterminado

FALSO

Observaciones

De forma predeterminada, las tablas se exponen utilizando los nombres de tabla internos.

Si esta propiedad se establece como verdadera, el proveedor expondrá las tablas utilizando los nombres para mostrar de la GUI de ServiceNow.

Vistas definidas por el usuario

Valor booleano que determina si se deben utilizar los nombres para mostrar de la tabla en lugar de los nombres de la API.

Tipo de datos

cadena

Valor predeterminado

""

Observaciones

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

También puede tener varias definiciones de vista y controlarlas mediante la propiedad de conexión UserDefinedViews. Cuando utiliza esta propiedad, el controlador 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 secundario, llamado consultar, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

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

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

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

Tenga en cuenta que la ruta especificada no está entre comillas.