Metadatos opcionales

Como desarrollador, puede elegir que el entorno en tiempo de ejecución del Integrador de transacciones (TI) envíe y reciba metadatos hacia y desde el programa de transacciones del sistema central (TP) y puede elegir el contenido de esos metadatos.

Puede enviar o recibir:

• No hay metadatos.

• Solo el nombre del método como metadatos.

• Todos los metadatos, incluido el nombre del método.

  El entorno en tiempo de ejecución de TI envía o recibe metadatos a o desde el TP tal como se indica. Los metadatos ayudan al TP en:

• Identificación del formato de los metadatos (información de versión).

• Identificar el nombre del método utilizado para invocar el TP.

• Informe de información detallada del error al cliente.

  Los metadatos no son visibles para el cliente de Automation. Los metadatos se entregan al TP del host como parte del mensaje de solicitud enviado al TP (o se reciben del TP como parte del mensaje de respuesta recibido del TP).

  El conjunto de metadatos incluye los siguientes datos:

• Versión en tiempo de ejecución de TI.

  Cadena de caracteres, como "Microsoft TI versión 1.0.0", que identifica de forma única la versión del entorno en tiempo de ejecución de TI que generó la solicitud.

• Nombre del método (cadena de 32 caracteres) invocado por el código de la aplicación cliente.

• ID de bloque de metadatos.

  GUID, en formato de caracteres, que identifica de forma única este bloque de datos de excepción. El GUID admite la capacidad de tener formatos de excepción adicionales en el futuro y ayuda a garantizar que los datos recibidos sean válidos.

• Variables sin usos asignados hasta la fecha (reservada):

  • Marca booleana que indica si el TP está listo para comprometerse.

  • Marca booleana que indica si el TP está listo para realizar trabajo adicional.

  • Dos enteros cortos para contener partes del número de versión del entorno en tiempo de ejecución de TI, un entero corto para contener el número de versión principal y el otro para contener el número de versión secundaria.

• Bloque de excepciones (solo se usa en respuestas).

  GUID, en formato binario, que identifica de forma única este bloque de datos de excepción. El GUID permite admitir formatos de excepción adicionales en el futuro y ayuda a garantizar que los datos recibidos sean válidos:

  • Marca booleana que indica si el TP está listo para realizar un commit.

  • Marca booleana que indica si el TP está listo para realizar trabajo adicional.

  • Marca booleana que indica si se debe devolver una excepción a la aplicación cliente. Si se establece, esta marca también hace que la transacción salga.

  • Entero de 16 bits que identifica el error (vea la nota más adelante en este tema). Puede asignar este valor, junto con el mensaje de 256 caracteres que describe el error, desde el servidor para que se devuelva el valor asignado cuando se produce un error en tiempo de ejecución de TI.

  • Entero de 32 bits que identifica el identificador de contexto en el archivo de ayuda de TP (si existe).

  • Mensaje de 256 caracteres que describe el error. Puede asignar este valor, junto con el entero de 16 bits que identifica el error del servidor, de modo que se devuelva el valor asignado cuando se produzca un error en tiempo de ejecución de TI.

  Los metadatos siempre se encuentran al principio del mensaje.