Compartir a través de

Cómo configurar un puerto de envío SMTP

  • Artículo

Un puerto de envío de SMTP se puede configurar mediante programación o mediante la consola de administración de BizTalk Server.

Cómo configurar un puerto de envío de SMTP mediante programación

El adaptador de SMTP almacena la información de configuración en la base de datos de administración de BizTalk (a la que también se conoce como base de datos de configuración). La información de configuración se almacena en la bolsa de propiedades XML personalizada. Durante la inicialización del adaptador de SMTP y durante su tiempo de ejecución, el servidor pasa la configuración al adaptador del modo siguiente:

  • Para el controlador de envío SMTP, la información de configuración pasa al adaptador llamando al método Load de la interfaz IPersistPropertyBag .

  • Para los adaptadores de envío de SMTP, la información de configuración se pasa al adaptador como un conjunto de propiedades en un contexto de mensaje. El espacio de nombres de SMTP agrupa estas propiedades.

    El modelo de objetos del Explorador de BizTalk expone la interfaz de configuración del adaptador ITransportInfo para los puertos de envío, que contiene la propiedad de lectura y escritura de Transport. Esta propiedad acepta la bolsa de propiedades de configuración del puerto de envío SMTP como una cadena XML de par nombre/valor. Tenga en cuenta que para establecer esta propiedad en el modelo de objetos del Explorador de BizTalk, primero debe establecerse en la propiedad Address de la interfaz ITransportInfo .

    No es necesario establecer la propiedad TransportTypeData de la interfaz ITransportInfo . Si no se establece, el puerto de envío SMTP utiliza valores predeterminados para el controlador de envío de SMTP. Las propiedades específicas del puerto de envío SMTP se definen en el esquema de propiedades del adaptador de envío SMTP, bts_smtp_properties.xsd.

    Si no define propiedades que dupliquen las propiedades de configuración del controlador de envío, se utilizan las propiedades de configuración para el controlador. Si no define las propiedades necesarias, se utilizan valores predeterminados. Si no define los valores predeterminados, el controlador de envío de SMTP registra un error en el registro de sucesos y mueve el mensaje al adaptador de copia de seguridad.

    Se pueden establecer estas propiedades mediante programación en un contexto de mensaje. Se pueden establecer estas propiedades en una programación de orquestación de BizTalk Server o en un componente de canalización personalizado. Las reglas siguientes se aplican cuando se utilizan estas propiedades:

  • Si la propiedad se establece en una orquestación o en un componente de canalización personalizado en una canalización de recepción, entonces:

    • Si se envía el mensaje al puerto de envío estático, el valor de la propiedad se sobrescribirá con el valor configurado para el puerto de envío.

    • Si se envía el mensaje a un puerto de envío dinámico, el valor de la propiedad no se sobrescribirá.

  • Si la propiedad se establece en un componente de canalización personalizado en una canalización de envío, entonces:

    • El valor no se sobrescribirá independientemente de que el mensaje se envíe a un puerto de envío estático o dinámico.

    En la siguiente tabla se enumeran las propiedades de configuración que se pueden definir en el modelo de objetos del Explorador de BizTalk para la ubicación de envío de SMTP.

Nombre de propiedad Tipo Descripción Restricciones Comentarios
SMTPHost xs:string Servidor SMTP que se usa para enviar mensajes. Longitud máxima: 256 Valor predeterminado: Vacío.

El valor predeterminado indica que el puerto de envío SMTP utilizará los valores de configuración para el controlador.
From xs:string Dirección de correo electrónico que coloca el puerto de envío SMTP en el encabezado SMTP From . Longitud máxima: 256 Valor predeterminado: Vacío.

El valor predeterminado indica que el puerto de envío SMTP utilizará los valores de configuración para el controlador.
CC xs:string Dirección de correo electrónico a la que se enviará una copia del mensaje. Longitud máxima: 1024 Valor predeterminado: Vacío

Puede enumerar varias direcciones de correo electrónico.
Subject xs:string Asunto de los mensajes. Longitud mínima: 0

Longitud máxima: 256		 Valor predeterminado: %MessageID%.
SMTPAuthenticate xs:int Tipo de autenticación que se va utilizar None Valores válidos:

- 0 - Sin autenticación
- 1- Autenticación básica
- 2 - Cuenta de proceso (NTLM)

El valor predeterminado indica que el puerto de envío SMTP utilizará los valores de configuración para el controlador. Para aplicar el valor predeterminado, omita esta propiedad de la bolsa de propiedades cuando establezca la propiedad TransportTypeData.
UserName xs:string Nombre de usuario que se utiliza para la autenticación con el servidor SMTP. Longitud mínima: 0

Longitud máxima: 256		 Valor predeterminado: Vacío

Requiere un valor si SMTPAuthenticate es igual a 1 (autenticación básica).
Contraseña xs:string Contraseña de usuario para la autenticación con el servidor SMTP. Longitud mínima: 0

Longitud máxima: 256		 Valor predeterminado: Vacío

Requiere un valor si SMTPAuthenticate es igual a 1 (autenticación básica).
ReadReceipt xs:boolean Solicita una confirmación de lectura para los mensajes desde este puerto de envío. None Valor predeterminado: False
DeliveryReceipt xs:boolean Solicita una notificación de entrega para los mensajes desde este puerto de envío. None Valor predeterminado: False
EmailBodyText xs:string Especifica el texto que se utilizará para el cuerpo del correo electrónico que se va a enviar. Longitud máxima: 64 kb Valor predeterminado: Vacío
EmailBodyTextCharset xs:string Especifique el juego de caracteres que se va a usar para codificar el cuerpo del correo electrónico que se envía cuando se usa la opción EmailBodyText . El adaptador SMTP convertirá EmailBodyText en el juego de caracteres especificado por EmailBodyTextCharset. None Valor predeterminado: Ninguno. Debe establecer el valor de forma explícita (por ejemplo, UTF-8).

Si no establece un valor, puede que aparezca el mensaje de error que se muestra al final de este tema.
EmailBodyFile xs:string Especifica que se utilice el contenido de un archivo para el cuerpo del correo electrónico que se va a enviar y la ruta de acceso completa de dicho archivo. Esta ruta debe estar a disposición del host para el adaptador de SMTP en tiempo de ejecución. Longitud máxima de la ruta de acceso: 256 caracteres Valor predeterminado: Vacío
EmailBodyFileCharset xs:string Especifique el juego de caracteres que se va a usar para codificar el cuerpo del correo electrónico que se envía si se establece la propiedad EmailBodyFile . El adaptador de SMTP no realizará ninguna conversión en el archivo; el archivo ya se debe haber codificado en este juego de caracteres. Si el archivo tiene una marca de orden de bytes (BOM), el adaptador de SMTP la quitará. None Valor predeterminado: UTF-8 (65001)
Datos adjuntos xs:string Especifica que se adjuntarán archivos al mensaje de correo electrónico y la ruta completa de esos archivos. Las rutas especificadas deben estar a disposición del host para el adaptador de SMTP en tiempo de ejecución. Longitud máxima de la ruta de acceso: 256 caracteres Valor predeterminado: Vacío
MessagePartsAttachments xs:int Especifica cómo se adjuntan las partes del mensaje de BizTalk al mensaje de correo electrónico. None Valores válidos:

- 0 : no se usarán elementos de mensaje de BizTalk como datos adjuntos.
- 1- La parte del cuerpo del mensaje de BizTalk se envía como datos adjuntos de correo electrónico. En este caso, se deben especificar las propiedades EmailBodyFile o EmailBodyText . Si no se especifica ninguna de estas propiedades, la parte del cuerpo del mensaje de BizTalk se envía como cuerpo del mensaje de correo electrónico en lugar de como datos adjuntos.
- 2 - Todas las partes se envían como datos adjuntos. Sin embargo, si no se especifica EmailBodyText o EmailBodyFile , la parte del cuerpo del mensaje de BizTalk se envía como el cuerpo del correo electrónico y otras partes se envían como datos adjuntos.

Valor predeterminado: 0
ReplyBy xs:dateTime Rellena el campo encabezado Reply-By en el mensaje saliente con el valor especificado. No se puede establecer esta propiedad en la página de propiedades de puerto de envío. Esta propiedad se puede establecer en una canalización u orquestación. Valor predeterminado: Vacío

En el siguiente código se muestra el formato de la cadena XML que se utiliza para establecer estas propiedades:

<CustomProps>  
   <DeliveryReceipt vt="11">-1</DeliveryReceipt  
   <SMTPHost vt="8">sfdsadf</SMTPHost>  
   <Subject vt="8">Some subject</Subject>  
   <From vt="8">username@domain.com</From>  
   <SMTPAuthenticate vt="19">2</SMTPAuthenticate>  
   <ReadReceipt vt="11">-1</ReadReceipt>  
</CustomProps>

Cómo configurar un puerto de envío SMTP con la consola de administración de BizTalk Server

Se pueden establecer variables de adaptador de puerto de envío SMTP en la consola de administración de BizTalk Server. Si no se establecen propiedades para el puerto de envío, se utilizan los valores predeterminados del controlador de envío establecidos en la consola de administración de BizTalk Server.

Para configurar un puerto de envío SMTP con la consola de administración de BizTalk Server, siga este procedimiento.

Para configurar variables para un puerto de envío SMTP

  1. En la consola de administración de BizTalk Server, cree un puerto de envío nuevo o haga doble clic en un puerto de envío existente para modificarlo. Para obtener más información, vea Cómo crear un puerto de envío. Configure todas las opciones de puerto de envío y especifique SMTP para la opción Tipo en la sección Transporte de la pestaña General .

  2. En la pestaña General , en la sección Transporte , junto a Tipo, haga clic en Configurar.

  3. En el cuadro de diálogo Propiedades de transporte SMTP , en la pestaña General , haga lo siguiente:

    Use Para hacer esto
    To Necesario. Especificar la dirección de correo electrónico a la que desea enviar mensajes.

    Puede especificar más de una dirección de correo electrónico.

    Longitud máxima: 256

    Para obtener más información sobre esta propiedad, vea Restricciones en la propiedad SMTP To.
    CC Especificar la dirección de correo electrónico a la que desea enviar una copia del mensaje.

    Puede especificar más de una dirección de correo electrónico.

    Longitud máxima: 1024
    Subject Especifica el encabezado de asunto del mensaje.

    Longitud mínima: 0

    Longitud máxima: 256
    Notificación Especificar el tipo de notificación de entrega. Puede seleccionar uno o ambos tipos de entrega. Los tipos de notificación de entrega son:

    - Recibo de lectura. Se envía un mensaje de correo electrónico de confirmación al leer el mensaje.
    - Recibo de entrega. Se envía un mensaje de correo electrónico de confirmación al entregar el mensaje.

  4. En el cuadro de diálogo Propiedades de transporte SMTP , en la pestaña Redactar , haga lo siguiente:

    Use Para hacer esto
    Parte del cuerpo del mensaje de BizTalk Especificar que se utilice la parte del cuerpo del mensaje de BizTalk para el cuerpo del correo electrónico que se está enviando.
    Text Especifica el texto que se utilizará para el cuerpo del correo electrónico que se va a enviar. Una vez seleccionada la opción Texto , puede escribir el texto del cuerpo del correo electrónico en el cuadro de texto.

    Longitud máxima: 64 Kb
    Conjunto de caracteres del texto - Especifique el juego de caracteres que se va a usar para codificar el cuerpo del correo electrónico que se va a enviar. Esta opción solo está disponible si está seleccionada la opción Texto .
    - Valor predeterminado: UTF-8 (65001)
    Archivo Especificar que se utilice el contenido de un archivo para el cuerpo del correo electrónico que se está enviando y especificar la ruta de acceso a dicho archivo. Una vez seleccionada la opción Archivo , puede hacer clic en el botón De puntos suspensivos (...) para ir al archivo.

    Longitud máxima de la ruta de acceso: 256 caracteres Nota: Se recomienda especificar una ruta de acceso en un recurso compartido de archivos al que se pueda acceder desde todos los servidores de BizTalk del grupo de BizTalk Server que se usará en producción.
    Conjunto de caracteres del archivo Especificar la codificación del juego de caracteres del archivo que se envía. Nota: El adaptador SMTP no aplica la codificación especificada al archivo. Esta opción se utiliza exclusivamente para especificar cómo se codifica el archivo que se envía.

    Esta opción solo está disponible si está seleccionada la opción Archivo .

    Valor predeterminado: UTF-8 (65001)

  5. En el cuadro de diálogo Propiedades de transporte SMTP , en la pestaña Datos adjuntos , haga lo siguiente:

    Use Para hacer esto
    Partes restantes del mensaje de BizTalk Especifica la forma de adjuntar partes del mensaje de BizTalk al mensaje de correo electrónico.

    Opciones:

    - No adjuntar elementos
    - Adjuntar solo parte del cuerpo
    - Adjuntar todas las partes

    Valor predeterminado: no adjuntar elementos.
    Add (Agregar) Especificar un archivo o los archivos que se adjuntarán al mensaje de correo electrónico. Después de hacer clic en Agregar , puede examinar para seleccionar un archivo y agregarlo a la lista de archivos que se van a adjuntar.

    Longitud máxima de la ruta de acceso: 256 caracteres Nota: Se recomienda especificar una ruta de acceso en un recurso compartido de archivos al que se pueda acceder desde todos los servidores de BizTalk del grupo de BizTalk Server que se usará en producción.
    Remove Quitar el archivo seleccionado de la lista de archivos que se van a adjuntar al mensaje de correo electrónico.

  6. En el cuadro de diálogo Propiedades de transporte SMTP , en la pestaña Invalidación del controlador , haga lo siguiente:

    Use Para hacer esto
    Nombre del servidor SMTP Especifica el nombre del servidor SMTP que se utilizará al enviar mensajes.

    Longitud máxima: 256 Nota: El URI de un puerto de envío o ubicación de recepción no puede superar los 256 caracteres.
    De (dirección de correo electrónico) Especifique la dirección de correo electrónico que se va a colocar en el encabezado SMTP From .

    Longitud máxima: 256
    Tipo de autenticación Especifica el tipo de autenticación que se utilizará con el servidor SMTP.

    Opciones:

    - (Valor predeterminado)
    - Sin autenticación
    - Autenticación básica
    - Cuenta de proceso (NTLM)

    El valor predeterminado indica que el puerto de envío SMTP utilizará los valores de configuración especificados en el controlador de envío.
    Nombre de usuario Especifica el nombre de usuario que se utilizará para la autenticación en el servidor SMTP.

    Esta propiedad requiere un valor si el tipo de autenticación es autenticación básica.

    Longitud mínima: 0

    Longitud máxima: 256
    Contraseña Especifica la contraseña que se utilizará para la autenticación en el servidor SMTP.

    Esta propiedad requiere un valor si el tipo de autenticación es autenticación básica.

    Longitud mínima: 0

    Longitud máxima: 256

  7. Haga clic en Aceptar y en Aceptar de nuevo para guardar la configuración.

Consulte también

Configuración del adaptador de SMTP