CreateEx (método)
Crea un nuevo registro con un conjunto de claves únicas y propiedades especificadas.
CreateEx
(key1, key2, ..., keyn, interactiveMode, properties)
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. |
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.