OpenDataSource (método)

Importante

En este artículo es máquina traducido, vea la exención de responsabilidad. Encontrará la versión en inglés de este artículo aquí para su referencia.

Adjunta un origen de datos al documento especificado que se convierte en el documento principal si aún no lo es.

Sintaxis

expresión .OpenDataSource(Name, Format, ConfirmConversions, ReadOnly, LinkToSource, AddToRecentFiles, PasswordDocument, PasswordTemplate, Revert, WritePasswordDocument, WritePasswordTemplate, Connection, SQLStatement, SQLStatement1, OpenExclusive, SubType)

expresión Requerida. Variable que representa un objeto MailMerge.

Parámetros

Name	Necesario/Opcional	Tipo de datos	Descripción (Description)
Name	Obligatorio	String	El nombre de archivo del origen de datos. Se puede especificar un archivo de Microsoft Query (.qry) en lugar de especificar un origen de datos, una cadena de conexión y una cadena de consulta.
Format	Opcional	Variante	El convertidor de archivos que se usa para abrir el documento. Puede ser una de las constantes WdOpenFormat. Para especificar un formato de archivo externo, se usa la propiedad OpenFormat con el objeto FileConverter para determinar el valor que se va a usar con este argumento.
ConfirmConversions	Opcional	Variante	True para mostrar el cuadro de diálogo Convertir archivo si el archivo no está en formato de Microsoft Word.
ReadOnly	Opcional	Variante	True para abrir el origen de datos como de solo lectura.
LinkToSource	Opcional	Variante	True para ejecutar la consulta especificada por Connection y SQLStatement cada vez que se abre el documento principal.
AddToRecentFiles	Opcional	Variante	True para agregar el nombre del archivo a la lista de archivos utilizados recientemente en la parte inferior del menú Archivo.
PasswordDocument	Opcional	Variante	La contraseña que se usa para abrir el origen de datos. (Ver los comentarios abajo).
PasswordTemplate	Opcional	Variante	La contraseña que se usa para abrir la plantilla. (Ver los comentarios abajo).
Revert	Opcional	Variante	Controla lo que ocurre si Name es el nombre de archivo de un documento abierto. True para descartar cualquier cambio no guardado realizado en el documento abierto y volver a abrir el archivo. False para activar el documento abierto.
WritePasswordDocument	Opcional	Variante	La cadena que se usa para guardar cambios en el documento. (Ver los comentarios abajo).
WritePasswordTemplate	Opcional	Variante	La contraseña que se usa para guardar los cambios realizados en la plantilla. (Ver los comentarios abajo).
Connection	Opcional	Variante	Un intervalo dentro del cual se ejecutará la consulta especificada por SQLStatement. (Ver los comentarios abajo).
SQLStatement	Opcional	Variante	Define las opciones de consulta para recuperar datos. (Ver los comentarios abajo).
SQLStatement1	Opcional	Variante	Si la cadena de consulta excede los 255 caracteres, SQLStatement especifica la primera parte de la cadena y SQLStatement1 especifica la segunda parte. (Ver los comentarios abajo).
OpenExclusive	Opcional	Variante	True para abrir en modo exclusivo.
SubType	Opcional	Variante	Puede ser una de las constantes WdMergeSubType.

Observaciones

Para determinar la conexión ODBC y las cadenas de consulta, se deben establecer las opciones de consulta de forma manual y usar la propiedad QueryString para devolver la cadena de conexión. La tabla a continuación incluye algunas de las palabras clave de SQL que se usan habitualmente.

Palabra clave	Descripción (Description)
DSN	El nombre del origen de datos ODBC
UID	El id. de inicio de sesión del usuario
PWD	La contraseña especificada por el usuario
DBQ	El nombre de archivo de la base de datos
FIL	El tipo de archivo

Para indicarle a Word que use el mismo método de conexión utilizado en versiones anteriores de Word (Intercambio dinámico de datos (DDE) para orígenes de datos de Microsoft Office Access y Microsoft Office Excel), se debe usar SubType:=wdMergeSubTypeWord2000.

El modo en que se especifica el intervalo depende del modo en que se recuperan los datos. Por ejemplo:

• Cuando se recuperan datos mediante la conectividad abierta de bases de datos (ODBC), se especifica una cadena de conexión.

• Cuando se recuperan datos desde Excel mediante el intercambio dinámico de datos (DDE), se especifica un rango con nombre.

  Nota de seguridad
  El Intercambio dinámico de datos (DDE) es una tecnología anterior que no es segura. Si es posible, use una alternativa a DDE que sea más segura, como la vinculación e incrustación de objetos (OLE).

• Cuando se recuperan datos desde Access, se especifica la palabra "Tabla" o "Consulta" seguida del nombre de una tabla o consulta.

Nota de seguridad

Evite usar la cuenta predefinida de inicio de sesión del administrador del sistema (SA). Es preferible hacer que los administradores del sistema sean miembros del rol fijo de servidor sysadmin y que usen sus propias cuentas para iniciar sesión. Use SA únicamente cuando no exista otro modo de iniciar sesión. Para evitar el acceso no autorizado mediante la cuenta de inicio de sesión de SA, asigne una contraseña única y segura a esa cuenta.

Nota de seguridad

Cuando sea posible, use la autenticación de Windows (también denominada conexión de confianza), que usa una cuenta de usuario de Windows para conectarse a SQL Server. Cuando un usuario se conecta a través de una cuenta de usuario de Windows, SQL Server usa la información del sistema operativo Windows para validar el nombre de cuenta y la contraseña. Para poder usar la autenticación de Windows, es necesario que un administrador del servidor configure SQL Server para que use este modo de autenticación. Si la autenticación de Windows no está disponible, evite guardar la información de inicio de sesión de los usuarios. Es más seguro que los usuarios escriban su información de inicio de sesión cada vez que inician sesión.

Evite el uso de contraseñas codificadas de forma rígida en las aplicaciones. Si se requiere una contraseña en un procedimiento, solicite la contraseña al usuario, almacénela en una variable y, a continuación, use la variable del código. Para consultar un procedimiento recomendado sobre cómo hacerlo, vea Notas de seguridad para desarrolladores de soluciones de Microsoft Office.

Ejemplo

En este ejemplo, se crea un nuevo documento principal y se adjunta la tabla Pedidos perteneciente a una base de datos de Access denominada "Northwind.mdb".

Dim docNew As Document

Set docNew = Documents.Add

With docNew.MailMerge
    .MainDocumentType = wdFormLetters
    .OpenDataSource _
        Name:="C:\Program Files\Microsoft Office" & _
        "\Office\Samples\Northwind.mdb", _
        LinkToSource:=True, AddToRecentFiles:=False, _
        Connection:="TABLE Orders"
End With

Ejemplo

En este ejemplo se crea un nuevo documento principal y se adjunta la hoja de cálculo de Excel denominada “Names.xls”. El argumento Connection recupera los datos del intervalo llamado "Sales".

Dim docNew As Document

Set docNew = Documents.Add

With docNew.MailMerge
    .MainDocumentType = wdCatalog
    .OpenDataSource Name:="C:\Documents\Names.xls", _
        ReadOnly:=True, _
        Connection:="Sales"
End With

Ejemplo

En este ejemplo se usa la ODBC para adjuntar una base de datos de Access denominada "Northwind.mdb" al documento activo. El argumento SQLStatement selecciona los registros en la tabla Clientes.

Dim strConnection As String

With ActiveDocument.MailMerge
    .MainDocumentType = wdFormLetters
    strConnection = "DSN=MS Access Databases;" _
        & "DBQ=C:\Northwind.mdb;" _
        & "FIL=RedISAM;"
   .OpenDataSource Name:="C:\NorthWind.mdb", _
        Connection:=strConnection, _
        SQLStatement:="SELECT * FROM Customers"
End With

Nota

Declinación de responsabilidades de traducción automática: Este artículo se ha traducido con un sistema informático sin intervención humana. Microsoft ofrece estas traducciones automáticas para que los hablantes de otros idiomas distintos del inglés puedan disfrutar del contenido sobre los productos, los servicios y las tecnologías de Microsoft. Puesto que este artículo se ha traducido con traducción automática, es posible que contenga errores de vocabulario, sintaxis o gramática.