Creación de mensajes de proceso (Biblioteca SAP - Interfase PP - PI-PCS: Enlace de sistemas de control de procesos)

Creación de mensajes de proceso

Para el upload de mensajes de proceso del sistema de control al sistema R/3, utilice el método CreateMultiple (Crear mensajes de proceso) del business object de SAP ProcessMessagePI.

Autorizaciones necesarias

Objeto de autorización	Campo	Valor
C_MESS_WRK	Centro	Centro del mensaje de proceso
	Actividad	01 (Crear mensaje de proceso)

Transferencia de datos de mensaje

Puede transferir los datos de los mensajes de proceso a los parámetros siguientes:

Parámetro de tabla	Descripción	Número de entradas
ProcMessHeader	Importar: Datos de cabecera de mensajes de proceso	1 / mensaje
ProcMessCharac	Importar: Características de mensaje de proceso	1 / característica
ProcMessTextlines	Importar: Textos explicativos de características de mensaje	Al menos 1 / característica de texto explicativo

Tabla ProcMessHeader

Campo	Formato	Longitud	Descripción
PROC_MESS_ID_ TMP	NUM	18	Clave provisional de un mensaje de proceso; cualquier número único dentro de la llamada de método o en la tabla
PLANT	CAR	04	Centro del mensaje de proceso
PROC_MESS_ CATEGORY	CAR	08	Clase de mensaje de proceso
TEST_FLAG	CAR	01	Indicador: Mensaje de prueba, es decir, se crean mensajes en R/3 y se verifican los errores que no hacen referencia al receptor. Sin embargo, no se envían
SENDER_NAME	CAR	32	Remitente de mensaje de proceso; esta información sirve como documentación

Tabla ProcMessCharac

Campo	Formato	Longitud	Descripción
PROC_MESS_ID_ TMP	NUM	18	Clave de mensaje de proceso provisional (véase tabla ProcMessHeader)
NAME_CHAR	CAR	30	Nombre de la característica de mensaje tal como se ha definido en el Customizing de R/3
CHAR_VALUE	CAR	30	Valor de la característica; para el ámbito de valores permitido, véase el Customizing de R/3
DATA_TYPE	CAR	04	Formato del valor de la característica tal como se ha definido en el Customizing de R/3

Otras notas acerca de los campos de tabla

Para obtener información sobre las opciones de características y valores de la característica, véase el Customizing de R/3 de la Coordinación de procesos. Para ello, seleccione Definir características de mensajes de proceso.
Los valores de característica (campo CHAR_VALUE) no se verifican durante la llamada de método. Los valores erróneos pueden causar, sin embargo, errores durante el tratamiento de los mensajes. En caso necesario, verifique los valores ejecutando el método GetHelpvalues (Leer valores permitidos de una característica) del business object de SAP ProcessCharactrstcPI.
Según el formato de la característica (campo DATA_TYPE), deberá visualizar los valores de característica como se indica a continuación:

Formato	Visualización de valor de la característica
CAR	Como un string
NUM	<Mantisa>E<exponente> <Mantisa> consta de un símbolo aritmético (+/, -), un carácter antes del signo de decimales, un signo de decimales (,/.) y hasta 15 dígitos decimales. Sin embargo, si utiliza muchos dígitos decimales, pueden producirse errores de redondeo en función de la plataforma. <Exponente> consta del símbolo aritmético y de hasta dos dígitos decimales.
FECHA	ddmmaaaa
HORA	hhmmss

Tabla ProcMessTextlines

Campo	Formato	Longitud	Descripción
PROC_MESS_ID_ TMP	NUM	18	Clave de mensaje de proceso provisional (véase tabla ProcMessHeader)
NAME_CHAR	CAR	30	Nombre de la característica de mensaje (véase tabla ProcMessCharac)
TDFORMAT	CAR	02	Clave de formato de la línea de texto
TDLINE	CAR	132	Línea de texto

Devolución de claves de característica

El sistema R/3 devuelve las claves de los mensajes de proceso creados en el parámetro siguiente:

Parámetro de tabla	Descripción	Número de entradas
ProcessMessageNew	Exportar: Claves de los mensajes de proceso creados	1 / mensaje

Tabla ProcessMessageNew

Campo	Formato	Longitud	Descripción
PROC_MESS_ID_ TMP	NUM	18	Clave de mensaje de proceso provisional (véase parámetro ProcMessHeader)
PROC_MESS_ID	NUM	18	Clave de mensaje de proceso final

Mensajes del sistema

El sistema R/3 devuelve los mensajes de sistema que pueden aparecer durante la llamada de método en los siguientes parámetros:

Parámetro de tabla	Descripción
ProcMessHeaderReturn	Exportar: Código de retorno y mensajes de sistema relativos a la cabecera de mensaje
ProcMessCharacReturn	Exportar: Código de retorno y mensajes de sistema relativos a las características de mensaje
Return	Exportar: Mensajes de sistema relativos a la llamada de método

Códigos de retorno de la cabecera de mensaje

En el campo RETURN_CODE de ProcMessHeaderReturn, pueden aparecer los valores siguientes: El mensaje de proceso se crea únicamente si el código de retorno es 00.

Código de retorno	Significado
00	Mensaje procesado correctamente.
01	El centro no existe (campo PLANT del parámetro ProcMessHeader)
02	La clase de mensaje no se ha creado en el centro (campo PROC_MESS_CATEGORY del parámetro ProcMessHeader)
03	Indicador de prueba no válido (campo TEST_FLAG del parámetro ProcMessHeaderI)
04	No tiene autorización para crear mensajes de proceso en el centro especificado
99	El mensaje no ha podido procesarse debido a un error en los datos de característica (véase el parámetro ProcMessCharacReturn para más detalles)

Tabla ProcMessHeaderReturn

Campo	Formato	Longitud	Descripción
PROC_MESS_ID_ TMP	NUM	18	Clave de mensaje de proceso provisional (véase parámetro ProcMessHeader)
RETURN_CODE	NUM	02	Código de retorno
TYPE	CAR	01	Tipo de mensaje de sistema: S (Éxito) E (Error) W (Mensaje de advertencia) I (Mensaje informativo)
ID	CAR	20	Clase de mensajes
NUMBER	NUM	03	Número de mensaje de sistema
MESSAGE	CAR	220	Texto del mensaje
LOG_NO	CAR	20	Log de aplicación: Número de log
LOG_MSG_NO	NUM	06	Log de aplicación: Número de mensaje de serie
MESSAGE_V1	CAR	50	Variable de mensaje de sistema
MESSAGE_V2	CAR	50	Variable de mensaje de sistema
MESSAGE_V3	CAR	50	Variable de mensaje de sistema
MESSAGE_V4	CAR	50	Variable de mensaje de sistema

Códigos de retorno y características de mensaje

En el campo RETURN_CODE del parámetro ProcMessCharacReturn, pueden aparecer los valores siguientes: El mensaje de proceso se crea únicamente si el código de retorno es 00.

Código de retorno	Significado
00	No se han detectado errores durante la verificación de la característica
01	La característica no se ha creado (Campo NAME_CAR del parámetro ProcMessCharac)
02	Formato de característica no válido (campo DATA_TYPE del parámetro ProcMessCharac)
03	La tabla ProcMessTextlines no contiene el texto explicativo de la característica
04	No se ha asignado ningún valor a la característica (Campo CHAR_VALUE del parámetro ProcMessCharac)
05	La característica no es exclusiva dentro del mensaje (campo NAME_CAR del parámetro ProcMessCharac)

Tabla ProcMessHeaderReturn

Campo	Formato	Longitud	Descripción
PROC_MESS_ID_ TMP	NUM	18	Clave de mensaje de proceso provisional (véase parámetro ProcMessHeader)
NAME_CHAR	CAR	30	Nombre de la característica de mensaje (véase tabla ProcMessCharac)
RETURN_CODE	NUM	02	Código de retorno
TYPE	CAR	01	Tipo de mensaje de sistema: S (Éxito) E (Error) W (Mensaje de advertencia) I (Mensaje informativo)
ID	CAR	20	Clase de mensajes
NUMBER	NUM	03	Número de mensaje de sistema
MESSAGE	CAR	220	Texto del mensaje
LOG_NO	CAR	20	Log de aplicación: Número de log
LOG_MSG_NO	NUM	06	Log de aplicación: Número de mensaje de serie
MESSAGE_V1	CAR	50	Variable de mensaje de sistema
MESSAGE_V2	CAR	50	Variable de mensaje de sistema
MESSAGE_V3	CAR	50	Variable de mensaje de sistema
MESSAGE_V4	CAR	50	Variable de mensaje de sistema

Mensajes de sistema relativos a la llamada de método

En el parámetro Return pueden aparecer los mensajes de sistema siguientes:

Tipo	ID	Número	Mensaje de sistema sobre la autorización
E	CB	050	No tiene autorización para crear mensajes
E	CB	060	No tiene autorización para crear mensajes en el centro &

Tipo	ID	Número	Mensajes de sistema sobre la cabecera de mensaje
E	CB1	303	Se han producido errores durante la creación del mensaje (véase el parámetro ProcMessHeaderReturn)
E	CB1	200	El centro & no existe (introduzca un centro válido)
E	CB1	201	La clase de mensaje de proceso &1 no está definida en el centro &2
E	CB1	202	Introduzca un indicador de prueba válido
E	CB	201	Imposible seguir procesando (póngase en contacto con el responsable del sistema)
E	CB1	206	Imposible crear el mensaje
S	CB1	308	Mensaje(s) creado(s) correctamente

Tipo	ID	Número	Mensaje de sistema sobre características de mensaje
E	CB1	304	Se han producido errores en las características durante la creación del mensaje (véase el parámetro ProcMessHeaderReturn)
E	CB	023	No existe ninguna característica con el número interno &
E	CB1	207	La característica & no se ha creado en el sistema
E	CB1	204	Verifique el formato de característica
E	CB1	301	Error al convertir el valor al formato &1
E	CB1	205	Introduzca un texto explicativo para la característica &
E	CB1	302	No se ha asignado ningún valor a la característica de mensaje &
E	CB1	2ß3	La característica & se ha asignado al mensaje más de una vez

Parámetro Return / Estructura BAPIRET2

Campo	Formato	Longitud	Descripción
TYPE	CAR	01	Tipo de mensaje de sistema: S (Éxito) E (Error) W (Mensaje de advertencia) I (Mensaje informativo)
ID	CAR	20	Clase de mensajes
NUMBER	NUM	03	Número de mensaje de sistema
MESSAGE	CAR	220	Texto del mensaje
LOG_NO	CAR	20	Log de aplicación: Número de log
LOG_MSG_NO	NUM	06	Log de aplicación: Número de mensaje de serie
MESSAGE_V1	CAR	50	Variable de mensaje de sistema
MESSAGE_V2	CAR	50	Variable de mensaje de sistema
MESSAGE_V3	CAR	50	Variable de mensaje de sistema
MESSAGE_V4	CAR	50	Variable de mensaje de sistema
PARAMETER	CAR	32	Nombre de parámetro
ROW	INT4	10	Línea del parámetro
FIELD	CAR	30	Campo del parámetro
SYSTEM	CAR	10	Sistema (sistema lógico) del que proviene el mensaje