Cadena de conexión

Cadena de conexión

Cadena de conexión. Una cadena que define los parámetros de la base de datos en el siguiente formato: <Nombre de opción>=<valor>.

Nombre de opción es el nombre de la opción.
Valor es su valor.

Las opciones se separan por punto y coma (“;”).
Si un valor contiene espacios, enciérrelo entre comillas dobles (“).
El conjunto de opciones disponibles depende del modo de la base de datos: archivo o cliente/servidor.

Parámetros comunes

Parámetros para el modo de base de datos de archivo

Parámetros para el modo de base de datos de servidor

Las siguientes opciones están disponibles para todas las bases de datos:

Usr. Nombre de usuario.
Pwd. Contraseña.
LicDstr. Permitir adquirir licencias de cliente a través del servidor de 1C:Enterprise (Y|N). 

Y. Adquirir una licencia de cliente desde el servidor de 1C:Enterprise. Si la aplicación de cliente no ha adquirido una licencia de software o hardware de una llave local o de red HASP, intenta adquirir una licencia de cliente desde el servidor de 1C:Enterprise. 
N. No adquirir una licencia de cliente desde el servidor de 1C:Enterprise. 
El valor predeterminado es N.

disstt. Desactivar el reconocimiento local de voz en la aplicación de cliente (Y|N). Si el parámetro no se especifica, se permite el reconocimiento de voz. Esto afecta la disponibilidad del reconocimiento de voz al crear una base de datos de servidor y desactiva el reconocimiento de voz al conectarse a una base de datos de archivo, incluida la conexión desde un servidor web o mediante una conexión COM.

Y. No se permite el reconocimiento de voz. 
N. Se permite el reconocimiento de voz. 
El valor predeterminado es N.

Zn. Establecer separadores.

ZN=<Atributo común 1>,<Atributo común 2>,…,<Atributo común N>

<Atributo común> = [<+>|<->]<valor de atributo común>

[<+>|<->] especifica el uso del atributo: “+” (predeterminado) significa que se utiliza el atributo, “” significa que no se utiliza el atributo.

Si un separador no se utiliza, el valor debe ir precedido de -. Si el primer carácter del valor del separador es + o , reemplácelo por ++ o — respectivamente.

<valor de atributo común>. Valor de atributo común. Si el valor del separador incluye una coma, reemplácela por dos comas. Si falta el valor del separador pero se requiere este separador, use el carácter + en su lugar. 

Los separadores están separados por comas. 

Ejemplo:

“Zn=-PrimerSeparador,+,—TercerSeparador” significa:

El primer separador está desactivado, su valor es “PrimerSeparador”.

El segundo separador está habilitado, su valor es una cadena vacía.

El tercer separador está desactivado, su valor es “-TercerSeparador”.

prmod. Iniciar 1C:Enterprise en modo de sesión privilegiada, que está disponible para usuarios autenticados con privilegios de administrador. Se agrega un registro que indica que se establece o no se puede establecer el modo de sesión privilegiada al registro de eventos. prmod=1 establece el modo privilegiado.

Las siguientes opciones están disponibles para bases de datos de archivo:

File. El nombre del directorio donde se encuentra el archivo de la base de datos.
Locale. El idioma (país) utilizado para abrir o crear la base de datos. Esta lista de valores disponibles es idéntica a la lista de valores disponibles del parámetro <FormatString> del método Format(). Esta opción no es obligatoria. Si no se especifica, se utilizan las configuraciones regionales de la base de datos en su lugar.
DBFormat. Formato de la base de datos. Los valores disponibles son 8.2.14 y 8.3.8. El valor predeterminado es 8.2.14.
DBPageSize. Tamaño de página de la base de datos, en bytes. Los valores disponibles son 4096 (o 4k), 8192 (o 8k), 16384 (o 16k), 32768 (o 32k), y 65536 (o 64k). El valor predeterminado es 4k.

Las siguientes opciones están disponibles para bases de datos de cliente/servidor:

Srvr. El nombre del servidor de 1C:Enterprise en el siguiente formato: [<protocolo>://]<dirección>[:<puerto>], donde:

  • <protocolo> es opcional, el único valor admitido es TCP.
  • <dirección> es el nombre del servidor o la dirección IP en formato IPv4 o IPv6.
  • <puerto> es opcional, el puerto del administrador de clúster principal, el valor predeterminado es 1541.

Ejemplo:

  • server (se especifica el nombre del servidor, los otros parámetros tienen los valores predeterminados)
  • tcp://server:1641 (se especifica el protocolo, el nombre del servidor y el puerto)
  • 127.0.0.1:1541 (se especifica la dirección IP del servidor en formato IPv4 y el puerto del servidor)
  • [fe10::c47b:90b7:fa32:a2fa%12] (se especifica la dirección IP del servidor en formato IPv6, los otros parámetros tienen los valores predeterminados)

Para garantizar el funcionamiento ininterrumpido de las aplicaciones de cliente, puede especificar varias direcciones de clúster. Para hacer esto:

  • Puede utilizar una lista de direcciones de clúster separadas por comas como valor para la opción Srvr.
  • En el cuadro de diálogo para agregar una base de datos en una aplicación de cliente, puede especificar una lista de direcciones de clúster separadas por comas en el campo Clúster del servidor 1C:Enterprise .

Ref. El nombre de la base de datos en el servidor de 1C:Enterprise.
DBMS. El tipo de servidor de base de datos, uno de los siguientes:

MSSQLServer,
PostgreSQL,
IBMDB2,
OracleDatabase

DBSrvr. El nombre del servidor de base de datos.
DB. El nombre de la base de datos en el servidor de base de datos.
DBUID. El nombre de usuario del servidor de base de datos.
DBPwd. La contraseña del usuario del servidor de base de datos. Si no se establece la contraseña del usuario del servidor de base de datos, puede omitir esta opción.
SQLYOffs. El desplazamiento de fecha utilizado para almacenar fechas en Microsoft SQL Server. Puede variar de 0 a 2000. Esta opción no es obligatoria. Si se omite, el valor se establece en 0.
Locale. El idioma (país), igual que en el modo de archivo.
CrSQLDB. Crear una base de datos si no existe. Los valores disponibles son: Y (crear una base de datos) y N (no crear una base de datos). El valor predeterminado es N.
SchJobDn. Denegar la ejecución de trabajos programados en la base de datos creada. Los valores disponibles son Y y N. El valor predeterminado es N.
SUsr. El nombre del administrador del clúster donde se creará la imagen inicial. Especifique esta opción si el clúster tiene administradores especificados y la autenticación del sistema operativo no está disponible o no es conveniente para ellos.
SPwd. La contraseña del administrador del clúster.

Una cadena de conexión se especifica en el cuadro de diálogo de inicio de 1C:Enterprise, debajo de la lista de bases de datos. Se puede especificar en la opción de línea de comandos para la selección del modo CREATEINFOBASE, como parámetro del método CreateInitialImage().