Leer en inglés

Compartir a través de


CreateEx (método)

Crea un nuevo registro con un conjunto de claves únicas y propiedades especificadas.

Sintaxis

CreateEx  
(key1, key2, ..., keyn, interactiveMode, properties)  

Parámetros

Parámetro Descripción
Key in/out parameter Parámetros de clave individual (clave1, clave2, ... claven), que se deben suministrar.

Este conjunto de claves no debe existir en la base de datos del servidor, es decir, deben de ser únicas.

Estas claves corresponden al conjunto de claves CreateEx definido para la interfaz de componentes concreta.
interactiveMode Control de errores.

Cuando se obtiene acceso a las propiedades de una interfaz de componentes, Microsoft BizTalk Adapter para PeopleSoft Enterprise usa las API proporcionadas por PeopleSoft, que leen y escriben campos individuales de la interfaz de componentes; sin embargo, estos cambios no se propagan al servidor PeopleSoft uno a uno. En su lugar, el archivo psjoa.jar (con el que interactúa el adaptador de BizTalk para PeopleSoft Enterprise) empaqueta todos los cambios y envía los cambios al servidor en un paquete.

Si alguna de las actualizaciones individuales produce un error, se devuelve un error genérico, que no ubica el error real. Con el modo interactivo establecido en TRUE, cada actualización de campo se envía al servidor individualmente. Esto tiene un impacto sustancial en el rendimiento, pero proporciona información del error específico si se genera un error en la actualización (por ejemplo, si se usa un valor no válido para configurar un campo).

interactiveMode proporciona el rendimiento máximo y ofrece un informe de errores en el nivel de actualización de campos. Para usar esta característica correctamente, se recomienda realizar llamadas normales con interactiveMode establecido en FALSE. No debe haber ningún impacto en el rendimiento. Si se devuelve un error, se puede recuperar la misma llamada con la marca de interactiveMode establecida en TRUE. Cuando se produce un error en la llamada, el servidor devuelve un mensaje de error más preciso.
properties Estructura que contiene todas las propiedades de la interfaz de componentes. Cuando se llama al CreateEx método , estas propiedades se insertan en el registro creado con las claves especificadas.

Comentarios

En algunas situaciones, es habitual llamar CreateEx() a sin un conjunto de claves explícitas, pero la CreateEx función devuelve las claves. Este comportamiento es compatible con PeopleCode que se desencadena en el servidor. Por ejemplo, para crear un pedido, el cliente puede no conocer cuál es el siguiente número de PO disponible. Mediante la especificación de NEXT como clave de número de PO, la llamada desencadena PeopleCode, que determina el siguiente número de PO disponible. Esta información se debe devolver al cliente que llama con los parámetros de clave de entrada y salida.

Nota

Para que este mecanismo funcione, la clave también debe ser una propiedad en el nivel 0. De lo contrario, se devuelve la clave original.

El método Adaptador de BizTalk para PeopleSoft Enterprise CreateEx() se proporciona si las funciones PeopleSoft Create y Save de la interfaz de componente están habilitadas.

Consulte también

Appendix A: métodos de interfaces de componentes