Cómo TI permite que los TP devuelvan excepciones
TI proporciona un mecanismo de metadatos para devolver excepciones de aplicaciones de servidor de Automation, como las aplicaciones de TI. TI usa este mecanismo para proporcionar al desarrollador del sistema central una manera opcional de devolver información de error del sistema central (también conocida como datos de excepciones) a través de la aplicación normal.
Un programa de transacciones (TP) devuelve información de error como metadatos opcionales que incluye un bloque de excepciones como parte del mensaje de respuesta. El bloque de excepciones contiene información, en un formato estándar, que se puede usar para rellenar una estructura de excepciones de Automation.
Los mensajes de error de TI tienen números en el intervalo 0-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.
Un TP también puede usar este mecanismo para proporcionar información sobre el estado de TP al entorno en tiempo de ejecución de TI. En concreto, un TP puede indicar si el TP:
Está dispuesto a confirmar el trabajo realizado hasta ahora (y desasignar la conversación).
No puede realizar más trabajo en la conversación actual y espera que el cliente prepare y confirme.
Ha encontrado un error que impedirá que confirme la transacción.
Aunque siempre es posible que un TP desasigne la conversación de forma abrupta, las excepciones de TI permiten devolver información detallada sobre el error a la aplicación cliente que realiza la llamada.
TI usa la información contenida en el bloque de excepciones para actualizar la información de estado en el entorno en tiempo de ejecución de TI y (si se solicita) devuelve una excepción a la aplicación cliente.
En la tabla siguiente se muestran los campos de la estructura de excepciones EXCEPINFO.
| Campo | Descripción |
|---|---|
| wCode | Código de error devuelto en el bloque de excepciones. |
| bstrSource | Generado automáticamente por TI en función de la información sobre el objeto del cliente y el TP remoto. |
| bstrDescription | Desde el bloque de excepciones. Esta descripción del error procede del TP remoto. |
| bstrHelpFile | Formado tomando la ruta de acceso de ayuda asociada a la biblioteca de componentes del objeto (en el Registro) y combinándola con un nombre de archivo no completo incluido como información personalizada en la biblioteca de componentes. Esto permite al desarrollador identificar el nombre de archivo del archivo de Ayuda tal como se creó, al tiempo que proporciona al administrador el control final sobre dónde se instala el archivo de Ayuda durante la implementación. |
| dwHelpContext | Desde la excepción. |
| scode | Igual que wCode. |
Es posible que el TP devuelva información de estado sin generar realmente una excepción. Para mantener el código tp del sistema central lo más sencillo posible, los datos de excepción forman parte de los metadatos opcionales y se devuelven en todos los casos, tanto si se produce un error como si no.