UpdateEx (método)
Se usa para actualizar propiedades basándose en los parámetros de clave de entrada (clave1, clave2, … claven). Cuando se usa UpdateEx
, no se pueden eliminar elementos de una colección. Un método independiente facilita la eliminación. Para obtener más información, vea DeleteOnly (método).
UpdateEx (key1, key2, ... keyn, correctionMode, interactiveMode,
properties)
Parámetro | Descripción |
---|---|
key |
Conjunto de parámetros que debe existir en la base de datos del servidor; de lo contrario se produce un error. Estas claves corresponden al conjunto de Obtener claves definido para la interfaz de componentes concreta. |
correctionMode |
Una marca booleana. Si se establece en verdadero, permite las modificaciones a las interfaces de componentes con elementos con fecha de vigencia actualizando los valores de los campos o bien insertando nuevos elementos en una recopilación. Específicamente, permite la modificación de los elementos que tienen EFFDT anterior a la fecha de vigencia actual. Sin esta marca establecida en TRUE, cualquier modificación a estos elementos origina la devolución de un error desde el servidor PeopleSoft. El correctionMode argumento solo se expone para las interfaces de componentes que contienen elementos con fecha efectiva. En caso contrario, no se muestra como parte del argumento.Debe evitar establecer en correctionMode TRUE en un entorno de producción. (Esta es también la recomendación de PeopleSoft). Los eventos que ya se han producido según lo determinado por la clave EFFDT anterior no se deben modificar. Esto permite la creación de una pista de auditoría. La correctionMode marca en UpdateEx permite omitir este mecanismo de seguridad. La práctica recomendada es que los eventos del pasado se desactiven configurando un campo en el elemento y agregando (y no eliminando) el elemento actualizado. |
interactiveMode |
Marca usada para el tratamiento de errores. Al obtener acceso a las propiedades de una interfaz de componentes, el adaptador de BizTalk para PeopleSoft Enterprise usa API proporcionadas por PeopleSoft que leen y escriben en los campos individuales de la interfaz de componente; no obstante, estos cambios no se propagan al servidor de PeopleSoft de uno en uno. En su lugar, psjoa.jar (con el que el adaptador de BizTalk para PeopleSoft Enterprise interactúa) empaqueta todos los cambios en un único paquete y los envía al servidor. 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 un rendimiento máximo y proporciona informes de errores en el nivel de actualización de campo. Para usar esta característica correctamente, se recomienda realizar llamadas normales con interactiveMode establecida en FALSE. No debe haber ningún impacto en el rendimiento. Si se devuelve un error, se puede reintentar la misma llamada con la interactiveMode marca establecida en TRUE. Cuando se produce un error en la llamada, el servidor devuelve un mensaje de error más preciso. |
Cuando se llama a esta función, las propiedades del registro correspondientes a las claves se reemplazan por las propiedades del parámetro de entrada. Todas las recopilaciones con los registros originales se eliminan o reemplazan por las del parámetro de entrada. Los tamaños de estas colecciones no tienen que coincidir porque el procedimiento que UpdateEx
contiene es eliminar todos los elementos de colección existentes y, a continuación, insertar los especificados.
Si las propiedades de la interfaz de componentes contiene elementos con fecha de vigencia, el parámetro de propiedades debe contener todos los elementos con fecha de vigencia futura, pues se sustituye la lista original. Esto proporciona el mecanismo necesario para agregar y eliminar elementos con fecha de vigencia futura; no obstante, si las propiedades también contienen elementos con fecha de vigencia pasada, se devolverá un error, pues los elementos con fecha de vigencia pasada no se pueden modificar. Si también se incluye el elemento con fecha de vigencia actual, se omite. Esto permite al cliente llamar Get()
a con el getHistoryItems
parámetro establecido en False, modificar los elementos con fecha efectiva futura o agregar nuevos elementos con fecha efectiva futura y pasar la estructura como parámetro para la UpdateEx()
función.
Si la interfaz del componente no tiene una clave, como en el caso de que solo pueda existir una instancia, el UpdateEx()
método tiene el formato :
UpdateEx(correctionMode, interactiveMode, properties)
Nota
El método Adaptador de BizTalk para PeopleSoft Enterprise UpdateEx()
se proporciona si se habilitan las funciones PeopleSoft y Save
PeopleSoft Get
en la interfaz de componente.