Debe desplegar los archivos de que consta su proyecto de nodo
definido por el usuario en el entorno de trabajo
antes de que el nodo definido por el usuario esté listo para ser
utilizado. Puede hacerlo en un entorno de prueba utilizando la perspectiva de desarrollo de plugins en entorno de trabajo
, consulte Habilitación de las posibilidades de ejecución de PDE
.
Utilice la opción Ejecutar >
Ejecutar como > Entorno de trabajo de ejecución para iniciar una
copia nueva del entorno de trabajo que incluya los
nodos adicionales. Para obtener más información acerca de esta perspectiva, consulte PDE Guide.
Puede ver los nodos nuevos de la paleta cuando abra el editor de flujos de mensajes. Para comprobar el nodo nuevo, añádalo a un flujo de mensajes (consulte Añadir un nodo de flujo de mensajes) y despliéguelo como lo hace de manera habitual. Cuando esté conforme con la definición del nodo, añada el nodo nuevo a la paleta de nodos normal del editor de flujo de mensajes
(consulte la sección Distribución de una extensión definida por el usuario).
Hasta que lo haga, los nodos nuevos sólo estarán disponibles en la sesión de entorno de trabajo de prueba.
Cuando
tiene una sesión de entorno de trabajo que incluye el nuevo nodo, puede
desplegar un flujo de mensajes de prueba que contenga el nuevo nodo a un
intermediario. Para poder desplegarlo, en primer lugar debe crear, compilar e instalar el nodo del plugin. Consulte
Instalación de una extensión definida por el usuario en un dominio de intermediarios para obtener más información.
Los siguientes mensajes de depuración
ayudan a entender la ejecución de los nodos y analizadores definidos por
el usuario:
- BIP2233 y BIP2234: un par de
mensajes de rastreo, antes y después de que se invoque una función de
implementación de extensión definida por el usuario. Estos mensajes
informan de los parámetros de entrada y el valor devuelto.
En estos mensajes, una "función de
implementación" puede interpretarse como una función de
implementación en C o un método de implementación de Java.
- BIP3904: un mensaje
de rastreo antes de llamar al método
Java evaluate() de un nodo definido por el usuario.
- BIP3905: un mensaje de
rastreo antes de invocar la función de implementación en C cniEvaluate() (miembro iFpEvaluate de
CNI_VFT) de un nodo definido por el usuario.
- BIP4142: un mensaje de depuración que se utiliza en
el rastreo cuando se invoca una función de utilidad de nodo definido
por el usuario, donde la función de utilidad altera el estado de un
elemento de sintaxis. Esto incluye todas las funciones de utilidad que
empiezan con cniSetElement*, donde * representa todos los
nodos con esa raíz.
- BIP4144 y BIP4145: un par de
mensajes de rastreo de ciertas funciones de implementación que, cuando las
invoca una extensión definida por el usuario, pueden modificar el estado
interno de un objeto de intermediario de mensajes. Los objetos posibles de
intermediario de mensajes incluyen elementos de sintaxis, nodos y
analizadores.
En estos mensajes, una "función de
implementación" puede interpretarse como una función de
implementación en C o un método de implementación de Java.
- BIP4146: un mensaje de depuración que se utiliza en
el rastreo cuando se invoca una función de utilidad de analizador definido por
el usuario, donde la función de utilidad altera el estado de un elemento
de sintaxis. Esto incluye todas las funciones de utilidad que empiezan con
cpiSetElement*, donde * representa todos los nodos con
esa raíz.
Para obtener más información sobre la API de nodo definida
por el usuario en lenguaje C, consulte
API de analizador definido por el usuario en lenguaje C y
API de nodo definido por el usuario en lenguaje C.
- BIP4147: un mensaje de
error de rastreo que aparece cuando una extensión definida por el usuario
pasa un objeto de entrada no válido a una función de API de utilidad de
extensión definida por el usuario.
- BIP4148: un mensaje de error
de rastreo que aparece cuando una extensión definida por el usuario
provoca daños en un objeto de intermediario.
- BIP4149: un mensaje de error que se incluye en el
rastreo cuando una extensión definida por el usuario pasa un puntero de
datos de entrada no válido a una función de API de utilidad de extensión
definida por el usuario.
- BIP4150: un mensaje de error que se incluye en el
rastreo cuando una extensión definida por el usuario pasa datos de entrada
no válidos a una función de API de utilidad de extensión definida por el
usuario.
- BIP4151: un mensaje de
depuración de rastreo que aparece cuando
cniGetAttribute2 o cniGetAttributeName2
establece el código de retorno en un valor inesperado. Los valores esperados son CCI_SUCCESS,
CCI_ATTRIBUTE_UNKNOWN y CCI_BUFFER_TOO_SMALL. Cualquier otro valor es un
valor inesperado.
- BIP4152: un mensaje de
depuración de rastreo que aparece en la situación siguiente:
- cniGetAttribute2 o
cniGetAttributeName2 establece el código de retorno en
CCI_BUFFER_TOO_SMALL.
- Se llama de nuevo a cniGetAttribute2 o
cniGetAttributeName2 con el tamaño correcto de
almacenamiento intermedio, pero el código de retorno se establece en
CCI_BUFFER_TOO_SMALL.
Consulte
Resolución de problemas con extensiones definidas por el usuario para obtener una lista completa de
las funciones de implementación.
Conecte el rastreo de usuario a nivel
de depuración para ver estas entradas de rastreo. Si desea más
información, consulte Utilización del rastreo.