Emisor del Mensaje: Contexto

El emisor puede requerir información de contexto para definir información adicional que necesita el sistema para enviar exitosamente los mensajes de salida. Abra Admin > Integración > Emisor de Mensaje y navegue a la página Contexto.

Descripción de Página

Defina el Tipo de Contexto y el Valor de Contexto, que contienen parámetros para emisores cuando se requiere más información. Consulte a continuación para ver algunos valores de contexto soportados para distintos tipos de emisores.

Contexto de Emisor de Correo Electrónico

El servicio de negocio que envía mensajes de correo electrónico en tiempo real utiliza el emisor de correo electrónico.

El emisor de un correo electrónico debe apuntar a la Clase de Mensaje RTHTTPSNDR. Además, se deben definir los siguientes registros de contexto para los remitentes de este tipo.

Tipo de Contexto Descripción
Nombre de Host SMTP El nombre del host del servidor SMTP.
Nombre de Usuario de SMTP La ID de usuario usada para acceder al servidor SMTP.
Contraseña de SMTP La contraseña usada para acceder al servidor SMTP.
Tiempo de Espera de Respuesta La cantidad de tiempo que el sistema debe esperar para obtener una respuesta en tiempo real.

Emisor HTTP

Un emisor de HTTP envía mensajes a un servidor HTTP mediante el protocolo HTTP. Los emisores de HTTP deben hacer referencia a una Clase de Mensaje de RTHTTPSNDR, RTJSONSNDR o SOAPSNDR.

Se requieren diversos parámetros para establecer una sesión con el servidor HTTP de destino. Especifique estos parámetros mediante la definición de una recopilación de valores de contexto para el emisor. Con el producto se proporciona un juego de tipos de contexto relacionados con variables HTTP. La siguiente sección describe tipos de contexto y, donde corresponde, indica los valores válidos.

Antes de definir el emisor de HTTP, necesita descubrir cómo el servidor HTTP en el otro lado espera recibir la solicitud y en particular, contestar las siguientes preguntas:

  • ¿Cuál es la dirección del servidor HTTP?
  • ¿Usa el servidor HTTP un método POST o GET HTTP?
  • Si el servidor utiliza POST, ¿cómo se transmite el contenido del mensaje? ¿Usa un HTTP FORM o transmite los datos en el cuerpo de un mensaje XML?
Tipo de Contexto Descripción Valores
HTTP URL1 a URL9

Se usa para crear el URL del servidor HTTP de destino.

Dado que el URL puede ser largo y complejo, puede dividirlo en pequeñas partes, cada una definida por un registro de contexto separado. El URL completo se crea concatenando los valores en URL1 a URL9.

Puede usar variables de sustitución cuando ingresa valores para las partes del URL. Tenga en cuenta que la cadena de sustitución @XMLMSG@ se puede usar para llamadas GET si se aplicó un XSL para convertir el mensaje en parámetros HTTP GET. Resulta útil si la Pantalla HTTP no es aplicable al tipo de mensaje.

Consulte Soporte para URLs dinámicas para conocer la configuración necesaria para soportar URLs dinámicas cuando se envía un mensaje de salida.

Método HTTP El método HTTP se usa para enviar el mensaje.
Nota: La clase de mensaje de emisor de SOAP SOAPSNDR solo soporta el método POST.
POST o GET
Método de Transporte HTTP Especifica el tipo de mensaje. Puede enviar el mensaje o enviar y esperar una respuesta. Send o sendReceive
Datos de Pantalla HTTP

Se utiliza cuando el mensaje tiene el formato de una Pantalla HTML (Content-Type: application/x-www-form-urlencoded).

Este contexto especifica los parámetros (datos) de la pantalla que se deben transmitir en el mensaje HTTP. Debido a que una pantalla puede tener múltiples parámetros, debe agregar un registro de contexto para cada parámetro de pantalla.

El valor de un parámetro de pantalla toma la forma de x=y donde x es el nombre del parámetro de pantalla e y es su valor.

Si y contiene la cadena @XMLMSG@ (sensible a mayúsculas y minúsculas), esta cadena se reemplaza por el contenido del mensaje XML de respuesta de servicio. La cadena @XMLMSG@ se puede usar en los Datos de Pantalla HTTP o el URL de HTTP, pero no en ambos.

Si se define un registro de contexto de este tipo para un emisor, éste último usa el formato de mensaje Pantalla HTML para enviar el mensaje incluso si @XMLMSG@ no se especifica en uno de los registros de contexto.

Si no se define para un emisor un registro de contexto de este tipo, el XML se envía con Content-Type: text/plain. Cuando se usa POST, éste se coloca en el cuerpo del mensaje HTTP.

Se requiere siempre que se usa el método GET. Si utiliza el método GET y no especifica un registro de contexto de Datos de Pantalla, no se transfiere ningún mensaje al servidor HTTP.

Puede usar variables de sustitución cuando ingresa valores para las partes Datos de Pantalla.

Usuario de Conexión HTTP El servidor HTTP puede requerir autenticación. Agregue un registro de contexto de este tipo para especificar el usuario de conexión que se usará.
Contraseña de Conexión HTTP El servidor HTTP puede requerir autenticación. Agregue un registro de contexto de este tipo para especificar la contraseña de conexión que se usará.
Encabezado HTTP

A veces el servidor HTTP en el otro lado puede requerir la adición de cabeceras HTTP al mensaje.

Para cada cabecera HTTP que se tiene que especificar, debe agregar un registro de contexto con un valor que tiene el siguiente formato x:y donde x es el nombre de la cabecera e y es el valor para la cabecera

Tiempo de Espera de HTTP Indica la cantidad de tiempo que se debe esperar para que se establezca una conexión con el sistema remoto.
Codificación de Carácter Indica si el mensaje se debe codificar. El emisor agregará a la cabecera de tipo de contenido del HTTP la cadena ;charset=x, donde x es el valor de este contexto y, al enviar el mensaje, se codificarán los datos en esa codificación. UTF-8 o UTF-16
Tiempo de Espera de Respuesta La cantidad de tiempo que el sistema debe esperar para obtener que el sistema remoto envíe una respuesta.
Tipo de Seguridad de Emisor Indica el tipo de seguridad deseada que se aplicará. (Tenga en cuenta que los tipos de seguridad adicionales solo se aplican al Emisor SOAP. Consulte a continuación para obtener más información). BASIC (HTTP Básico), TEXT (texto sin formato de Señal de Nombre de Usuario), DIGEST: Resumen de Señal de Nombre de Usuario, OWSM: Seguridad de OAuth mediante OWSM, OAUTH: Seguridad de OAuth.
Juego de Políticas de OWSM

Se aplica solo si Tipo de Seguridad de Emisor es OWSM. Define el juego de políticas que se aplicarán.

Ingrese un valor válido para el Juego de Políticas de consulta extensible (F1-SetOfPolicies). El producto proporciona el valor F1-OAUTH que se puede usar aquí.
Tipo de Otorgamiento de OAuth

Se aplica solamente si Tipo de Seguridad de Emisor es OAUTH. Define el método de especificación de OAuth necesario para adquirir una señal de acceso.

client_​credentials
URL de Señal de Acceso de OAuth

Se usa para crear el URL del servidor de autorización de destino. Puede utilizar variables de sustitución para crear el URL.

ID de Cliente de OAuth

El identificador generado para la aplicación actual en el servidor de autorización del sistema externo.

Secreto de Cliente de OAuth

El secreto emparejado con la ID de Cliente de OAuth proporcionado por el servidor de autorización del sistema externo.

Conjunto de Claves de OAuth

Define el conjunto de claves que se utiliza para almacenar la ID de Cliente de OAuth y el secreto proporcionados por el servidor de autorización del sistema externo. Si se especifica un conjunto de claves, no se permiten las entradas de contexto de ID de Cliente de OAuth ni las de Secreto de Cliente de OAuth.

Alcance de API de REST de OAuth

El nivel de autorización otorgado por el punto final.

Detalles de Solicitud de Señal de Oauth en Cuerpo de Mensaje

Por defecto, la solicitud de señal de autorización incluye la información de ID y Secreto de Cliente en el encabezado del mensaje. Este tipo de contexto se puede usar para indicar que la información debe enviarse en el cuerpo de la solicitud.

Defina esta opción en "Y" para enviar la información de ID y Secreto de Cliente en el cuerpo de la solicitud de señal de autorización.

Emisor de HTTP en Tiempo Real

El siguiente tipo de contexto solo es aplicable a emisores con la clase de mensaje RTHTTPSNDR.

Tipo de Contexto Descripción
Tipo de Contenido Complete un valor aquí para sustituir el atributo Content-Type en el encabezado HTTP, que se fija por defecto en text/xml.

Emisor de SOAP

En emisor de SOAP es un emisor de HTTP que agrega soporte automáticamente para el formato SOAP. Para este tipo de emisor (clase de mensaje de SOAPSNDR), además de los valores de contexto mencionados anteriormente, se pueden proporcionar los siguientes ingresos de contexto.

Tipo de Contexto Descripción Valores
URI de Espacio de Nombres de Mensaje Se usa para indicar un espacio de nombres específico para incluir en los mensajes de este emisor. Tenga en cuenta que este valor se usa solo cuando el enlace de Mensaje externo a este emisor está configurado con una opción de Espacio de Nombres de Configurado en Emisor.
Registro de Hora de Inserción de SOAP Indica si se debe agregar un registro de hora. El valor por defecto es "N". Y o N
Demora de Expiración de SOAP (en segundos) Indica una demora de expiración que se agregará al registro de hora. El valor por defecto es 60.
Tipo de Seguridad de Emisor Se soportan tipos de seguridad adicionales para emisores SOAP en integraciones de terceros específicas. CIM: Usa un espacio de nombres adecuado y agrega información de seguridad en el encabezado SOAP específico de Landis+Gyr, MS_​V30: Usa un espacio de nombres adecuado y agrega información de seguridad en el encabezado SOAP específico de MultiSpeak v3.0, MS_​V41R: Usa un espacio de nombres adecuado y agrega información de seguridad en el encabezado SOAP específico de MultiSpeak v4.1. ITRON: Usa información de seguridad de encabezado SOAP adecuada en el encabezado SOAP específico de Itron.
Nota: Consulte Cómo Agregar Parámetros de Cabecera de SOAP al Tiempo de Ejecución para obtener información sobre cómo incluir de forma dinámica los parámetros de Cabecera de SOAP cuando envíe un mensaje.

Emisor de JMS

Un emisor de JMS es aquel que envía mensajes a una cola de JMS o un tema de JMS. Los emisores de JMS deben hacer referencia a una Clase de Mensaje de RTJMSQSNDR o RTJMSTSNDR, respectivamente.

Los siguientes parámetros se usan para conectarse al recurso de JMS.

Tipo de Contexto Descripción Valores
Tipo de Mensaje de JMS (Bytes(Y)/Texto(N)) Indica si los datos se envían como mensaje de bytes o mensaje de texto. Y o N
Nombre de Usuario de JMS Ingrese el nombre de usuario para conectarse al recurso de JMS.
Contraseña de Usuario de JMS Ingrese la contraseña para conectarse al recurso de JMS.
Encabezado de JMS

Si se requieren los valores del encabezado de JMS para el mensaje, use este tipo de contexto.

Para cada encabezado de JMS que se tiene que especificar, agregue un registro de contexto con un valor que tenga el siguiente formato x:y donde x es el nombre del encabezado e y es el valor.