Compartir a través de


Configuración del URI de conexión para el adaptador de SQL

Un URI de conexión es un cadena de conexión que contiene parámetros necesarios para conectarse a SQL Server. Al usar el complemento de servicio Consumir adaptador o el Asistente para agregar metadatos de adaptador en Visual Studio, debe especificar el URI para conectarse a SQL Server para generar los metadatos. Al configurar un puerto de envío o recepción mediante la consola de administración de BizTalk Server, debe especificar el URI para conectarse a SQL Server para realizar operaciones.

Escriba el URI de conexión de Visual Studio.

En Visual Studio, puede especificar el URI de conexión mediante el Complemento de servicio consumir adaptador o el Asistente para agregar metadatos del adaptador.

Usar el complemento de servicio Consumir adaptador

  1. Haga clic con el botón derecho en el proyecto de BizTalk, seleccione Agregar y, a continuación, haga clic en Agregar elementos generados.

  2. En el cuadro de diálogo Agregar elementos generados , haga lo siguiente:

    Use Para hacer esto
    Categorías Haga clic en Consumir servicio de adaptador.
    Templates (Plantillas [C++]) Haga clic en Consumir servicio de adaptador.
  3. Para iniciar el cuadro de diálogo Consumir servicio de adaptador , haga clic en Agregar.

  4. En el cuadro de diálogo Consumir servicio de adaptador , en la lista Seleccionar un enlace , seleccione sqlBinding y, a continuación, haga clic en Configurar.

  5. En el cuadro de diálogo Configurar adaptador , haga clic en la pestaña Seguridad . En la lista Tipo de credencial de cliente , realice una de las siguientes acciones:

    Nota

    Si va a conectarse a SQL Server mediante la autenticación de Windows, el usuario de Windows con el que ha iniciado sesión debe agregarse a SQL Server tal y como se describe en Conexión a SQL Server Uso de la autenticación de Windows con el adaptador de SQL.

    Haga clic en Para hacer esto
    None Conectarse a SQL Server mediante la autenticación de Windows.
    Windows Conectarse a SQL Server mediante la autenticación de Windows.
    Nombre de usuario Especifique un nombre de usuario y una contraseña para conectarse a SQL Server especificando credenciales para un usuario definido en la base de datos de SQL Server. Tenga en cuenta que el nombre de usuario y la contraseña distinguen entre mayúsculas y minúsculas. Nota: Si deja los campos Nombre de usuario y Contraseña en blanco, el adaptador se conecta a SQL Server mediante autenticación de Windows.
  6. Haga clic en la pestaña Propiedades del URI y especifique los valores para distintos parámetros. Para obtener más información sobre el URI de conexión para el adaptador de SQL, consulte Creación del URI de conexión de SQL Server.

  7. Haga clic en la pestaña Propiedades de enlace y especifique valores para las propiedades de enlace, si las hay, que son necesarias antes de generar el esquema. Para obtener más información sobre las propiedades de enlace, vea Leer sobre el adaptador de BizTalk para SQL Server propiedades de enlace del adaptador.

  8. Haga clic en OK.

Usar el Asistente para agregar metadatos del adaptador

  1. Haga clic con el botón derecho en el proyecto de BizTalk, seleccione Agregar y, a continuación, haga clic en Agregar elementos generados.

  2. En el cuadro de diálogo Agregar elementos generados , haga lo siguiente:

    Use Para hacer esto
    Categorías Haga clic en Agregar adaptador.
    Templates (Plantillas [C++]) Haga clic en Agregar metadatos del adaptador.
  3. Haga clic en Agregar. Se abre el Asistente para agregar metadatos del adaptador.

  4. En el Asistente para agregar adaptador, seleccione WCF-SQL. Seleccione el equipo en el que se instala BizTalk Server y el nombre de la base de datos de BizTalk.

    Importante

    Si ya tiene un puerto WCF-SQL configurado en BizTalk, seleccione el puerto en la lista Puerto .

  5. Haga clic en Next.

  6. En el cuadro de diálogo Consumir servicio de adaptador , en la lista desplegable Seleccionar un enlace , seleccione sqlBinding y, a continuación, haga clic en Configurar.

  7. En el cuadro de diálogo Configurar adaptador , haga clic en la pestaña Seguridad y, en el cuadro de lista desplegable Tipo de credencial de cliente , realice una de las acciones siguientes:

    Nota

    Si va a conectarse a SQL Server mediante la autenticación de Windows, el usuario de Windows con el que ha iniciado sesión debe agregarse a SQL Server tal y como se describe en Conexión a SQL Server Uso de la autenticación de Windows con el adaptador de SQL.

    Haga clic en Para hacer esto
    None Conectarse a SQL Server mediante la autenticación de Windows.
    Windows Conectarse a SQL Server mediante la autenticación de Windows.
    Nombre de usuario Especifique un nombre de usuario y una contraseña para conectarse a SQL Server especificando credenciales para un usuario definido en la base de datos de SQL Server. Tenga en cuenta que el nombre de usuario y la contraseña distinguen entre mayúsculas y minúsculas. Nota: Si deja los campos Nombre de usuario y Contraseña en blanco, el adaptador se conecta a SQL Server mediante autenticación de Windows.
  8. Haga clic en la pestaña Propiedades del URI y, a continuación, especifique valores para los parámetros de conexión. Para obtener más información sobre el URI de conexión para el adaptador de SQL, consulte Creación del URI de conexión de SQL Server.

  9. Haga clic en la pestaña Propiedades de enlace y, a continuación, especifique valores para las propiedades de enlace, si las hubiera, requeridas por las operaciones de destino. Para obtener más información sobre las propiedades de enlace, vea Leer sobre el adaptador de BizTalk para SQL Server propiedades de enlace del adaptador.

    Nota

    Si seleccionó un puerto de envío WCF-SQL existente, no necesita especificar las propiedades de enlace. Las propiedades de enlace se seleccionan de la configuración del puerto de envío. Sin embargo, puede optar por especificar las propiedades de enlace necesarias en tiempo de diseño, si las hay. En tal caso, los nuevos valores de las propiedades de enlace se usarán en tiempo de diseño al generar los metadatos. Sin embargo, en tiempo de ejecución se aplicarán los valores especificados para las propiedades de enlace en la configuración del puerto de envío.

  10. Haga clic en OK.

Escriba el URI de conexión de la consola de administración de BizTalk Server.

En la consola de administración de BizTalk Server, puede especificar el URI de conexión como parte de la WCF-Custom o una configuración de puerto WCF-SQL.

Escriba el URI de conexión para el puerto de WCF-Custom

  1. Inicie la consola de administración de BizTalk Server.

  2. En el árbol de consola, expanda Grupo de BizTalk, expanda Aplicacionesy, a continuación, expanda la aplicación en la que desea crear un puerto y haga clic en Puertos de envío o Puertos de recepción. En el panel derecho, puede elegir crear un puerto o seleccionar un puerto existente.

  3. En el cuadro de diálogo propiedades del puerto, en la lista desplegable Tipo , seleccione WCF-Custom y, a continuación, haga clic en Configurar.

    Nota

    Para ver el cuadro de diálogo de propiedades de ubicación de un puerto de recepción, haga clic en la pestaña Ubicación de recepción del panel izquierdo del cuadro de diálogo propiedades del puerto y, a continuación, haga clic en Nuevo.

  4. En el cuadro de diálogo Propiedades de transporte personalizadas de WCF , haga clic en la pestaña General .

  5. En el cuadro de texto Dirección (URI), especifique el URI de conexión para conectarse a SQL Server. Para obtener más información sobre el URI de conexión para el adaptador de SQL, consulte Creación del URI de conexión de SQL Server.

  6. En el cuadro de diálogo Propiedades de transporte personalizadas de WCF , haga clic en la pestaña Enlace . En la lista desplegable Tipo de enlace, seleccione sqlBinding.

  7. Si va a crear un puerto de envío, en el cuadro de diálogo Propiedades de transporte personalizadas de WCF , haga clic en la pestaña Credenciales y realice una de las siguientes acciones:

    • Seleccione la opción No usar inicio de sesión único y especifique el nombre de usuario y la contraseña para conectarse a SQL Server. Tenga en cuenta que el nombre de usuario y la contraseña distinguen entre mayúsculas y minúsculas.

      Nota

      Si desea conectarse a SQL Server mediante autenticación de Windows, especifique un nombre de usuario y una contraseña en blanco. Antes de hacerlo, el usuario de Windows con el que ha iniciado sesión debe agregarse a SQL Server tal y como se describe en Conexión a SQL Server Uso de la autenticación de Windows con el adaptador de SQL.

    • Seleccione la opción Usar inicio de sesión único y especifique una aplicación de inicio de sesión único (SSO) de empresa afiliada.

  8. Si va a crear un puerto de recepción, en el cuadro de diálogo Propiedades de transporte personalizadas de WCF , haga clic en la pestaña Otros y realice una de las acciones siguientes:

    • Seleccione la opción Cuenta de usuario y especifique el nombre de usuario y la contraseña para conectarse a SQL Server. Tenga en cuenta que el nombre de usuario y la contraseña distinguen entre mayúsculas y minúsculas.

      Nota

      Si desea conectarse a SQL Server mediante autenticación de Windows, especifique un nombre de usuario y una contraseña en blanco. Antes de hacerlo, el usuario de Windows con el que ha iniciado sesión debe agregarse a SQL Server tal y como se describe en Conexión a SQL Server Uso de la autenticación de Windows con el adaptador de SQL.

    • Seleccione la opción Obtener credenciales de la aplicación afiliada y especifique una aplicación de SSO afiliada.

  9. Haga clic en OK.

Escriba el URI de conexión para el puerto WCF-SQL.

  1. Inicie la consola de administración de BizTalk Server.

  2. Agregue el adaptador WCF-SQL a la consola de administración de BizTalk Server. Para obtener instrucciones, consulte Adición del adaptador de SQL a BizTalk Server Consola de administración.

  3. En el árbol de consola, expanda Grupo de BizTalk, expanda Aplicacionesy, a continuación, expanda la aplicación en la que desea crear un puerto y haga clic en Puertos de envío o Puertos de recepción. En el panel derecho, puede elegir crear un puerto o seleccionar un puerto existente.

  4. En el cuadro de diálogo propiedades del puerto, en la lista desplegable Tipo , seleccione el adaptador WCF-SQL que agregó anteriormente y, a continuación, haga clic en Configurar.

    Nota

    Para ver el cuadro de diálogo de propiedades de ubicación de un puerto de recepción, haga clic en la pestaña Ubicación de recepción del panel izquierdo del cuadro de diálogo propiedades del puerto y, a continuación, haga clic en Nuevo.

  5. En el cuadro de diálogo propiedades de transporte, haga clic en la pestaña General .

  6. Haga clic en el botón Configurar y proporcione valores para los parámetros de conexión. Para obtener más información sobre el URI de conexión para el adaptador de SQL, consulte Creación del URI de conexión de SQL Server.

  7. En el cuadro de diálogo propiedades de transporte, haga clic en la pestaña Enlace y especifique valores para las propiedades de enlace.

    Nota

    Las propiedades de enlace se muestran en función de si está configurando un puerto de envío o un puerto de recepción. Por ejemplo, las propiedades de enlace relacionadas con las notificaciones no están disponibles al configurar un puerto de envío porque las notificaciones son operaciones entrantes y requieren una configuración de puerto de recepción.

  8. Si va a crear un puerto de envío, en el cuadro de diálogo propiedades de transporte, haga clic en la pestaña Credenciales y realice una de las acciones siguientes:

    • Seleccione la opción No usar inicio de sesión único y especifique el nombre de usuario y la contraseña para conectarse a SQL Server. Tenga en cuenta que el nombre de usuario y la contraseña distinguen entre mayúsculas y minúsculas.

      Nota

      Si desea conectarse a SQL Server mediante autenticación de Windows, especifique un nombre de usuario y una contraseña en blanco. Antes de hacerlo, el usuario de Windows con el que ha iniciado sesión debe agregarse a SQL Server tal y como se describe en Conexión a SQL Server Uso de la autenticación de Windows con el adaptador de SQL.

    • Seleccione la opción Usar inicio de sesión único y especifique una aplicación de inicio de sesión único (SSO) de empresa afiliada.

  9. Si va a crear un puerto de recepción, en el cuadro de diálogo propiedades de transporte, haga clic en la pestaña Otros y realice una de las acciones siguientes:

    • Seleccione la opción Cuenta de usuario y especifique el nombre de usuario y la contraseña para conectarse a SQL Server. Tenga en cuenta que el nombre de usuario y la contraseña distinguen entre mayúsculas y minúsculas.

      Nota

      Si desea conectarse a SQL Server mediante autenticación de Windows, especifique un nombre de usuario y una contraseña en blanco. Antes de hacerlo, el usuario de Windows con el que ha iniciado sesión debe agregarse a SQL Server tal y como se describe en Conexión a SQL Server Uso de la autenticación de Windows con el adaptador de SQL.

    • Seleccione la opción Obtener credenciales de la aplicación afiliada y especifique una aplicación de SSO afiliada.

  10. Haga clic en OK.

Consulte también

Bloques de creación para desarrollar aplicaciones de BizTalk con el adaptador de SQL