Detalles de Conexión de ServiceNow¶

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.

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

Autenticación

SSO

OAuth

| Propiedad | Descripción | |----------------------------------------------------------------- ------------------------------------------------------------------ -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------| | Iniciar OAuth | Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte. | | IdClienteOAuth | El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth. | | OAuthClientSecret | El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth. | | OAuthAccessToken | El token de acceso para conectarse mediante OAuth. | | Ubicación de configuración de OAuth | La ubicación del archivo de configuración donde se guardan los valores de OAuth cuando InitiateOAuth se establece en GETANDREFRESH o REFRESH. Alternativamente, esto se puede mantener en la memoria especificando un valor que comience con memory://. | | URL de devolución de llamada | La URL de devolución de llamada de OAuth a la que volver cuando se autentica. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación. | | OAuthGrantType | El tipo de concesión para el flujo de OAuth. | | OAuthVerificador | El código verificador devuelto desde la URL de autorización de OAuth. | | OAuthRefreshToken | El token de actualización de OAuth para el token de acceso de OAuth correspondiente. | | OAuthExpiresIn | La vida útil en segundos del AccessToken de OAuth. | | OAuthTokenTimestamp | La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual. |

SSL

Firewall

Apoderado

Esquema

Almacenamiento en caché

Misceláneas

Autenticación¶

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

AuthScheme¶

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

Valores Posibles¶

Automático, Básico, OAuth, OKTA, ADFS, OneLogin, PingFederate

Tipo de Datos¶

cadena

Valor por Defecto¶

"Auto"

Observaciones¶

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

• Automático: permite que el conector decida automáticamente en función de las otras propiedades de conexión que haya establecido.
• Básico: configure esto para usar la autenticación BÁSICA.
• OAuth: configure esto para realizar la autenticación OAuth.

De forma predeterminada, AuthScheme es Auto y si se establecen las propiedades Usuario y Contraseña, el conector intentará la autenticación básica.

El conector realizará la autenticación OAuth si AuthScheme se establece en OAuth o OAuthAccessToken se establece la propiedad.

Las siguientes opciones están disponibles para SSO:

• OKTA: configurado para usar una conexión de inicio de sesión único con OKTA como proveedor de identificación.
• ADFS: configure para usar una conexión de inicio de sesión único con ADFS como proveedor de identificación.
• OneLogin: configurado para usar una conexión de inicio de sesión único con OneLogin como proveedor de identificación.
• PingFederate: configurado 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 por Defecto¶

""

Observaciones¶

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

Usuario¶

La cuenta de usuario de ServiceNow utilizada para la autenticación.

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

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

Contraseña¶

La contraseña utilizada para autenticar al usuario.

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

El usuario y Contraseña se usan juntos para autenticarse con el servidor.

Inicio de Sesión Único¶

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

SSOloginURL¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

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

Propiedades de SSO¶

Se requieren propiedades adicionales para conectarse al proveedor de identidad en una lista separada por punto y coma.

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

Se requieren propiedades adicionales para conectarse al proveedor de identidad en una lista separada por punto y coma. se usa junto con SSOLOginURL.

La configuración de SSO se trata con más detalle en Establecimiento de una conexión.

OAuth¶

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

| Propiedad | Descripción | |----------------------------------------------------------------- ------------------------------------------------------------------ -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------| | Iniciar OAuth | Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte. | | IdClienteOAuth | El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth. | | OAuthClientSecret | El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth. | | OAuthAccessToken | El token de acceso para conectarse mediante OAuth. | | Ubicación de configuración de OAuth | La ubicación del archivo de configuración donde se guardan los valores de OAuth cuando InitiateOAuth se establece en GETANDREFRESH o REFRESH. Alternativamente, esto se puede mantener en la memoria especificando un valor que comience con memory://. | | URL de devolución de llamada | La URL de devolución de llamada de OAuth a la que volver cuando se autentica. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación. | | OAuthGrantType | El tipo de concesión para el flujo de OAuth. | | OAuthVerificador | El código verificador devuelto desde la URL de autorización de OAuth. | | OAuthRefreshToken | El token de actualización de OAuth para el token de acceso de OAuth correspondiente. | | OAuthExpiresIn | La vida útil en segundos del AccessToken de OAuth. | | OAuthTokenTimestamp | La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual. |

Iniciar OAuth¶

Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.

Valores Posibles¶

APAGADO, GETANDREFRESH, REFRESH

Tipo de Datos¶

cadena

Valor por Defecto¶

"APAGADO"

Observaciones¶

Las siguientes opciones están disponibles:

1. DESACTIVADO: indica que el flujo de OAuth será manejado en su totalidad por el usuario. Se requerirá un OAuthAccessToken para la autenticación.
2. GETANDREFRESH: indica que el conector manejará todo el flujo de OAuth. Si actualmente no existe ningún token, se obtendrá solicitándolo 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 pedirá al usuario que se autentique a través del navegador. El usuario debe manejar la obtención de OAuthAccessToken y OAuthRefreshToken inicialmente.

OAuthClientId¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

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.

OAuthClientSecretOAuthClientSecret¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

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

Token de Acceso de OAuth¶

El token de acceso para conectarse mediante OAuth.

Tipo de Datos¶

cadena

Valor por Defecto¶

""

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 dependiente 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 manteniéndolas en el servidor.

Configuración de OAuthUbicación¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

"%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 que el usuario ingrese manualmente las propiedades de conexión de OAuth y permitir que las credenciales se compartan entre conexiones o procesos.

Como alternativa a especificar una ruta de archivo, se puede usar el almacenamiento en memoria. Las ubicaciones de memoria se especifican mediante un valor que comienza con "memoria://" seguido de un identificador único para ese conjunto de credenciales (por ejemplo, memoria://usuario1). El identificador puede ser cualquier cosa que elija, pero debe ser único para el usuario. A diferencia del almacenamiento basado en archivos, debe almacenar manualmente las credenciales al cerrar la conexión con el almacenamiento en memoria para poder configurarlas en la conexión cuando el proceso se inicie nuevamente. Los valores de propiedad de OAuth se pueden recuperar con una consultar a la tabla del sistema sys_connection_props. Si hay varias conexiones que usan las mismas credenciales, las propiedades deben leerse desde la última conexión que se cerró.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\ ServiceNow Data Provider\OAuthSettings.txt" con %APPDATA% configurado 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 volver cuando se autentica. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.

Tipo de Datos¶

cadena

Valor por Defecto¶

http://localhost:33333

Observaciones¶

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

OAuthGrantType¶

El tipo de concesión para el flujo de OAuth.

Valores Posibles¶

CÓDIGO, CONTRASEÑA

Tipo de Datos¶

cadena

Valor por Defecto¶

"CONTRASEÑA"

Observaciones¶

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

OAuthVerifier¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

El código verificador devuelto desde la URL de autorización de OAuth. Esto se puede usar en sistemas en los que no se puede iniciar un navegador, como los sistemas sin cabeza.

Autenticación en Máquinas Sin Cabeza¶

Consulte Establecimiento de una conexión para obtener el valor de OAuthVerifier.

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

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 colocar.

Para actualizar automáticamente los valores del token de OAuth, establezca OAuthSettingsLocation y además configure InitiateOAuth refrescar.

OAuthRefreshToken¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

La propiedad OAuthRefreshToken se usa para actualizar el OAuthAccessToken al usar la autenticación OAuth.

OAuthExpiresIn¶

La vida útil en segundos del AccessToken de OAuth.

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

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

OAuthTokenTimestamp¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

Emparéjese con OAuthExpiresIn para determinar cuándo expirará AccessToken.

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¶

cadena

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.

Firewall¶

Esta sección proporciona una lista completa de las propiedades del Firewall que puede 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 por Defecto¶

"NINGUNO"

Observaciones¶

Esta propiedad especifica el protocolo que utilizará el conector para canalizar el tráfico a través del FirewallServer apoderado. 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, establezca ProxyAutoDetect a falso.

Para conectarse a servidores proxy HTTP, utilice ProxyServer y PuertoProxy. Para autenticarse en servidores proxy HTTP, use ProxyAuthScheme, Usuario proxy, y Contraseña de proxy.

CortafuegosServidor¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

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: use FirewallServer con esta propiedad para conectarse a través de SOCKS o hacer túneles. Usar Servidor Proxy para conectarse a un proxy HTTP.

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

CortafuegosPuerto¶

El puerto TCP para un firewall basado en proxy.

Tipo de Datos¶

En t

Valor por Defecto¶

0

Observaciones¶

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

Usuario de Cortafuegos¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

Usuario del cortafuegos y Contraseña del cortafuegos se utilizan para autenticarse contra el proxy especificado en FirewallServer y Puerto del cortafuegos, siguiendo el método de autenticación especificado en FirewallType.

Firewall Contraseña¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

Esta propiedad se pasa al proxy especificado por FirewallServer y Puerto del 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.

Autodetección de Proxy¶

Esto indica si usar la configuración del proxy del sistema o no. Esto tiene prioridad sobre otras configuraciones de proxy, por lo que deberá configurar ProxyAutoDetect en FALSO para usar configuraciones de proxy personalizadas.

Tipo de Datos¶

bool

Valor por Defecto¶

FALSO

Observaciones¶

Esto tiene prioridad sobre otras configuraciones de proxy, por lo que deberá configurar ProxyAutoDetect en FALSO para usar configuraciones de proxy personalizadas. NOTA: Cuando esta propiedad se establece en True, el proxy utilizado se determina de la siguiente manera:

• Se realiza una búsqueda desde las propiedades de la JVM (http.proxy, https.proxy, socksProxy, etc.).
• En el caso de que no existan las propiedades de la JVM, se realiza una búsqueda desde java.home/lib/net.properties.
• En el caso de que java.net.useSystemProxies se establezca en True, se realiza una búsqueda desde SystemProxy.
• Solo en Windows, se intenta recuperar estas propiedades desde Opciones de Internet en el registro.

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

Servidor Proxy¶

El nombre de host o la dirección IP de un proxy para enrutar el tráfico HTTP.

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

El nombre de host o la dirección IP de un proxy para enrutar el tráfico HTTP. El conector puede usar 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 canalizar la conexión, consulte FirewallType.

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

Puerto Proxy¶

El puerto TCP en el que se ejecuta el proxy ProxyServer.

Tipo de Datos¶

En t

Valor por Defecto¶

80

Observaciones¶

El puerto en el que se ejecuta el proxy HTTP al que desea redirigir el tráfico HTTP. Especifique el proxy HTTP en ProxyServer. Para otros tipos de proxy, consulte FirewallType.

ProxyAuthSchemeProxyAuthScheme¶

El tipo de autenticación que se usará para autenticarse en el proxy ProxyServer.

Valores Posibles¶

BÁSICO, COMPENDIO, NINGUNO, NEGOCIACIÓN, NTLM, PROPIETARIO

Tipo de Datos¶

cadena

Valor por Defecto¶

"BÁSICO"

Observaciones¶

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

Tenga en cuenta que el conector utilizará la configuración de proxy del sistema de forma predeterminada, sin necesidad de configuración adicional; si desea conectarse a otro proxy, deberá configurar ProxyAutoDetect a falso, además de ProxyServer y PuertoProxy. 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:

• BASIC: El conector realiza la autenticación HTTP BASIC.
• 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.
• PROPIEDAD: 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¶

Un nombre de usuario que se usará para autenticarse en el proxy ProxyServer.

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

Usuario de proxy y Contraseña de proxy 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 está utilizando la autenticación HTTP, establezca esto en el nombre de usuario de un usuario reconocido por el proxy HTTP. Si utiliza la autenticación de Windows o Kerberos, establezca esta propiedad en un nombre de usuario en uno de los siguientes formatos:

user@domain
domain\user

Contraseña de Proxy¶

Una contraseña que se usará para autenticarse en el proxy ProxyServer.

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

Esta propiedad se utiliza para autenticarse en un servidor proxy HTTP que admita la autenticación NTLM (Windows), Kerberos o HTTP. Para especificar el proxy HTTP, puede establecer ProxyServer y PuertoProxy. Para especificar el tipo de autenticación, configure ProxyAuthScheme.

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

Si utiliza la autenticación NTLM, establezca Usuario proxy y ProxyPassword a su contraseña de Windows. Es posible que también los necesite para completar la autenticación de Kerberos.

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

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

ProxySSLTipo¶

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

Valores Posibles¶

AUTO, SIEMPRE, NUNCA, TÚNEL

Tipo de Datos¶

cadena

Valor por Defecto¶

"AUTO"

Observaciones¶

Esta propiedad determina cuándo usar 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:

ProxyExceptions¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

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

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

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¶

cadena

Valor por Defecto¶

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

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. 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" con %APPDATA% 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¶

cadena

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¶

cadena

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¶

cadena

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.

Incluir Vistas de Base de Datos¶

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

Tipo de Datos¶

bool

Valor por Defecto¶

FALSO

Observaciones¶

Controla si 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 exponer las tablas del sistema o no.

Tipo de Datos¶

bool

Valor por Defecto¶

verdadero

Observaciones¶

Controla si exponer las tablas del sistema o no. Por lo general, solo los usuarios con funciones de administrador tienen acceso a estas tablas. Establecer esta propiedad en falso hará 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 por Defecto¶

FALSO

Observaciones¶

Cuando AutoCache = verdadero, el conector mantiene automáticamente un caché de los datos de su tabla en la base de datos de su elección. De forma predeterminada, el conector actualiza la caché de forma incremental, recuperando solo los cambios desde que se ejecutó la última consultar SELECT si el tiempo transcurrido desde la última ejecución ha superado la Tolerancia de caché. Una vez que se actualiza la memoria caché, la consultar se ejecuta en los datos almacenados en la memoria caché.

Configuración de la Base de Datos de Almacenamiento en Caché¶

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

• Ubicación de caché: especifica la ruta al almacén de archivos.
• CacheDriver y ConexiónCaché: 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 de los datos obsoletos en la memoria caché.
• CachéMetadatos: esta propiedad reduce la cantidad de metadatos que cruzan la red mediante esquemas de tablas persistentes recuperados de los metadatos de ServiceNow. Los metadatos deben recuperarse solo una vez en lugar de cada conexión.
• Replicar sentencias: cuando ejecuta una instrucción SELECT con AutoCache = true, el conector llama internamente a la instrucción REPLICATE. La declaración REPLICATE permite actualizaciones incrementales en lugar de descartar primero la tabla almacenada en caché.
• Almacenamiento de datos en caché de forma explícita: Esta sección proporciona más ejemplos del uso de AutoCache en Sin conexión modo.
• Declaraciones CACHE: puede usar la declaración CACHE para conservar cualquier consultar SELECT, así como administrar el caché; por ejemplo, actualizar esquemas.

CacheDriver¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

Puede almacenar en caché en 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 de controlador JDBC que desea usar para almacenar datos en caché.

Tenga en cuenta que también debe agregar el archivo JAR CacheDriver al classpath.

Los siguientes ejemplos muestran cómo almacenar en caché en 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 Base de Datos Java¶

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

jdbc:servicenow:CacheLocation='c:/Temp/cachedir';InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;User=MyUser;Password=MyPassword;Url=https://MyInstance12345.service-now.com/;

Para personalizar la URL de Derby JDBC, use CacheDriver y CacheConnection. Por ejemplo, para almacenar en caché en una base de datos en memoria, use una URL de 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 de JDBC para el controlador SQLite JDBC:

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 de JDBC para el controlador JDBC para MySQL incluido:

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 de 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 usa 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/;

CacheConnection¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

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

La cadena de conexión especificada en la propiedad CacheConnection se pasa directamente al CacheDriver. 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 el classpath de su aplicación.

Derby y Base de Datos Java¶

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

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

jdbc:derby:[subsubprotocol:][nombre de la base de datos][;attribute=value[;attribute=value] ... ]

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

jdbc:derby:memory

SQLite¶

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

jdbc:sqlite:dataSource

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

MySQL¶

La instalación incluye el controlador JDBC para MySQL. El siguiente es 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 el controlador JDBC de Microsoft 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 típicas de conexión de SQL Server:

• Servidor: el nombre o la dirección de red de la computadora que ejecuta SQL Server. Para conectarse a una instancia con nombre en lugar de la instancia predeterminada, esta propiedad se puede usar para especificar el nombre de 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: establezca esta opción en verdadero para usar la cuenta actual de Windows para la autenticación. Establezca esta opción en falso si está configurando el usuario y la contraseña en la conexión.

  Para usar 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 la seguridad integrada.

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

Oracle¶

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

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

Por ejemplo:

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

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

• Fuente de datos: el descriptor de conexión que identifica la base de datos de Oracle. Puede ser un descriptor de conexión TNS, un nombre de Oracle Net Services que se resuelva en un descriptor de conexión o, después de la versión 11g, un nombre de Easy Connect (el nombre de alojar del servidor de 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 de Oracle.

• ID de usuario: la ID de usuario proporcionada para la autenticación con la base de datos de Oracle.

PostgreSQL¶

La siguiente es la sintaxis de URL de 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 especificar esto 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.

CacheLocation¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

"%APPDATA%\ Proveedor de datos de ServiceNow "

Observaciones¶

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

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

Ver También¶

• Autocaché: configurado para crear y mantener implícitamente un caché para su uso posterior sin conexión.
• CachéMetadatos: configurado para persistir el catálogo de ServiceNow en CacheLocation.

CacheTolerance¶

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

Tipo de Datos¶

En t

Valor por Defecto¶

600

Observaciones¶

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

Desconectado¶

Use el modo fuera de línea para obtener los datos del caché en lugar de la fuente en vivo.

Tipo de Datos¶

bool

Valor por Defecto¶

FALSO

Observaciones¶

Cuando Fuera de línea = verdadero, todas las consultas se ejecutan en la caché en lugar de la fuente de datos en vivo. En este modo, ciertas consultas como INSERTAR, ACTUALIZAR, ELIMINAR y CACHE no están permitidas.

CacheMetadata¶

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

Tipo de Datos¶

bool

Valor por Defecto¶

FALSO

Observaciones¶

A medida que ejecuta consultas con este conjunto de propiedades, 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 está configurado o el directorio de inicio del usuario de lo contrario. Los metadatos de una tabla se recuperarán solo una vez, cuando se consulta la tabla por primera vez.

Cuándo Usar CacheMetadata¶

El conector conserva automáticamente los metadatos en la memoria 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 se vuelve ú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 Usar CacheMetadata¶

• Cuando 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 memoria caché de metadatos. Por lo tanto, es mejor confiar en el almacenamiento en memoria caché en los casos en que los metadatos cambian con frecuencia.
• Cuando está almacenando en caché en una base de datos: CacheMetadata solo se puede usar con CacheLocation. Si está almacenando en caché en otra base de datos con CacheDriver y ConexiónCaché propiedades, utilice AutoCache para almacenar en caché implícitamente. O bien, use Replicar declaraciones o Declaraciones CACHE para almacenar en caché explícitamente.

Misceláneas¶

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

Tamaño del Lote¶

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

Tipo de Datos¶

En t

Valor por Defecto¶

0

Observaciones¶

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

Establecer BatchSize en 0 enviará el lote completo como se especifica.

ConexiónLifeTime¶

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

Tipo de Datos¶

En t

Valor por Defecto¶

0

Observaciones¶

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

Conectar al Abrir¶

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

Tipo de Datos¶

bool

Valor por Defecto¶

FALSO

Observaciones¶

Cuando se establece en 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 bases de datos.

Esta característica actúa como un comando NOOP, ya que se usa para verificar que se puede establecer una conexión con ServiceNow y no se mantiene nada de esta conexión inicial.

Establecer esta propiedad en falso puede proporcionar mejoras de rendimiento (según la cantidad de veces que se abre una conexión).

Mostrar Valor¶

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 por Defecto¶

"FALSO"

Observaciones¶

Nota: Si decide establecer esta propiedad de conexión en "verdadero", 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.
• TODOS: devuelve valores reales y de visualización.

Excluir Enlace de Referencia¶

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

Tipo de Datos¶

bool

Valor por Defecto¶

FALSO

Observaciones¶

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

ObtenerColumnasMetadatos¶

Indica la preferencia del usuario en cuanto a 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 por Defecto¶

"Al inicio"

Observaciones¶

Los ajustes disponibles son los 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 declaración.
• OnUse: el conector ejecutará las llamadas de metadatos específicos 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é.

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¶

En t

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¶

cadena

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 conector 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 Formateo¶

Tamaño de Página¶

El número máximo de resultados a devolver por página de ServiceNow.

Tipo de Datos¶

En t

Valor por Defecto¶

5000

Observaciones¶

La propiedad Pagesize afecta la cantidad máxima de resultados que se devolverán por página desde ServiceNow. Establecer un valor más alto puede resultar en un mejor rendimiento a costa de memoria adicional consumida por página consumida.

PoolIdleTimeout¶

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

Tipo de Datos¶

En t

Valor por Defecto¶

60

Observaciones¶

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

PoolMaxSize¶

Las conexiones máximas en el grupo.

Tipo de Datos¶

En t

Valor por Defecto¶

100

Observaciones¶

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

PoolMinSize¶

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

Tipo de Datos¶

En t

Valor por Defecto¶

1

Observaciones¶

El número mínimo de conexiones en el grupo. El valor predeterminado es 1.

PiscinaEsperarTiempo¶

Los segundos máximos de espera para una conexión disponible.

Tipo de Datos¶

En t

Valor por Defecto¶

60

Observaciones¶

Los segundos máximos de espera para que una conexión esté disponible. Si una nueva solicitud de conexión está esperando una conexión disponible y excede este tiempo, se genera un error. De forma predeterminada, las nuevas solicitudes esperan para siempre una conexión disponible.

Pseudocolumnas¶

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

Tipo de Datos¶

cadena

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

Solo Lectura¶

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

Tipo de Datos¶

bool

Valor por Defecto¶

FALSO

Observaciones¶

Si esta propiedad se establece en true, el conector solo permitirá consultas SELECT. INSERTAR, ACTUALIZAR, ELIMINAR y procedimiento almacenado* las consultas generarán un error.

RTK¶

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

Tipo de Datos¶

cadena

Valor por Defecto¶

""

Observaciones¶

La propiedad RTK puede usarse para licenciar una compilación. Consulte el archivo de licencia incluido para ver cómo configurar esta propiedad. La clave de tiempo de ejecución solo está disponible si compró una licencia OEM.

Mostrar Descripciones¶

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

Valores Posibles¶

NINGUNO, TableLabels, ColumnLabels, TableAndColumnLabels, ColumnComments

Tipo de Datos¶

cadena

Valor por Defecto¶

"NINGUNO"

Observaciones¶

Nota: De forma predeterminada, se establece en NINGUNO y no se muestran las descripciones de las tablas y sus respectivas columnas. Se ejecutarán llamadas API adicionales si esta propiedad se establece en un valor distinto de NINGUNO. 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 la 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.

SupportEnhancedSQL¶

Esta propiedad mejora la funcionalidad de SQL más allá de lo que se puede admitir a través de la API directamente, al habilitar el procesamiento del lado del cliente en la memoria.

Tipo de Datos¶

bool

Valor por Defecto¶

verdadero

Observaciones¶

Cuando SupportEnhancedSQL = true, el conector descarga la mayor parte posible del procesamiento de la declaración SELECT a ServiceNow y luego procesa el resto de la consultar en la memoria. De esta forma, el conector puede ejecutar predicados, uniones y agregaciones no admitidos.

Cuando SupportEnhancedSQL = false, el conector limita la ejecución de SQL a lo que admite la API de ServiceNow.

Ejecución de Predicados¶

El conector determina cuáles de las cláusulas son compatibles con la fuente de datos y luego las envía a la fuente para obtener el superconjunto de filas más pequeño que satisfaga la consultar. Luego filtra el resto de las filas localmente. La operación de filtro se transmite, lo que permite que el conector filtre de manera efectiva incluso conjuntos de datos muy grandes.

Ejecución de Uniones¶

El conector utiliza varias técnicas para unirse en la memoria. El conector compensa la utilización de la memoria frente al requisito de leer la misma tabla más de una vez.

Ejecución de Agregados¶

El conector recupera todas las filas necesarias para procesar la agregación en la memoria.

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¶

En t

Valor por Defecto¶

60

Observaciones¶

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

Si el Tiempo de espera caduca y la operación aún no se completa, el conector genera una excepción.

UseConnectionPooling¶

Esta propiedad habilita la agrupación de conexiones.

Tipo de Datos¶

bool

Valor por Defecto¶

FALSO

Observaciones¶

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

UseDisplayTableNames¶

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

Tipo de Datos¶

bool

Valor por Defecto¶

FALSO

Observaciones¶

De forma predeterminada, las tablas se exponen mediante los nombres de tablas internas.

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