Compartir a través de

Metadatos opcionales

  • Artículo

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.

Nota

Los metadatos no se admiten para la llamada al programa distribuido (DPC).

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 hacia o desde el TP como se indica. Los metadatos ayudan al TP en:

  • Identificar el formato de los metadatos (información de versión).

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

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

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

    El conjunto de metadatos incluye los datos siguientes:

  • 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.

  • Identificador 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 confirmarse.

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

    • Dos enteros cortos que contienen 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 la compatibilidad con formatos de excepción adicionales en el futuro y ayuda a garantizar que los datos recibidos son válidos:

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

    • Marca booleana que indica si el TP está listo para realizar un 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 se cierre.

    • 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, del 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 produce un error en tiempo de ejecución de TI.

    Los metadatos siempre se encuentran al principio del mensaje.

Nota

Los mensajes de error de TI tienen números en el intervalo comprendido entre 0 y 9999. Los números de mensaje de error de metadatos devueltos desde el sistema central pueden estar dentro del mismo intervalo. Para distinguir los mensajes de error de TI de los mensajes de metadatos devueltos del sistema central, TI agrega 10000 al número de mensajes de error de metadatos devueltos desde el sistema central.