Auf Englisch lesen

Freigeben über


UpdateEx-Methode

Dient zum Aktualisieren von Eigenschaften basierend auf den Eingabeschlüsselparametern (key1, key2, … keyn). UpdateExWenn Sie verwenden, können Sie keine Elemente in einer Sammlung löschen. Das Löschen wird durch eine separate Methode ermöglicht. Weitere Informationen finden Sie unter DeleteOnly-Methode.

Syntax

UpdateEx (key1, key2, ... keyn, correctionMode, interactiveMode,  
    properties)  

Parameter

Parameter BESCHREIBUNG
key Ein Satz von Parametern, die in der Serverdatenbank vorhanden sein müssen, sonst tritt ein Fehler auf. Diese Schlüssel entsprechen der Sammlung von Abrufschlüsseln, die für die betreffende Komponentenschnittstelle definiert wurde.
correctionMode Ein Kennzeichen, das einen Wahrheitswert darstellt. Wenn dieser Wert auf Wahr festgelegt ist, können Komponentenschnittstellen mit Elementen mit einem Stichtag (EFFDT-Wert) geändert werden, indem entweder die Feldwerte aktualisiert oder neue Elemente in eine Auflistung eingefügt werden. Insbesondere können Elemente geändert werden, die EFFDT vor dem aktuellen Stichtag aufweisen. Wenn dieses Kennzeichen nicht auf WAHR festgelegt ist, führen Änderungen an diesen Elementen zu einem Fehler, der vom PeopleSoft-Server zurückgegeben wird.

Das correctionMode Argument wird nur für die Komponentenschnittstellen verfügbar gemacht, die elemente mit effektivem Datum enthalten. Andernfalls wird es nicht als Teil des Arguments angezeigt.

Sie sollten es vermeiden, in einer Produktionsumgebung auf TRUE festzulegen correctionMode . (Dies ist auch die Empfehlung von PeopleSoft.) Ereignisse, die bereits aufgetreten sind, wie durch den vergangenen EFFDT-Schlüssel bestimmt, sollten nicht geändert werden. Dadurch ist die Erstellung eines Überwachungspfads möglich. Durch das correctionMode Flag in UpdateEx kann dieser Sicherheitsmechanismus umgangen werden. Es wird empfohlen, Ereignisse in der Vergangenheit durch Festlegen eines Felds in dem Element zu deaktivieren und das aktualisierte Element hinzuzufügen (statt es zu löschen).
interactiveMode Ein zur Fehlerbehandlung verwendetes Kennzeichen.

Beim Zugriff auf Eigenschaften in einer Komponentenschnittstelle verwendet der BizTalk-Adapter für PeopleSoft Enterprise von PeopleSoft bereitgestellte APIs, die einzelne Felder in der Komponentenschnittstelle lesen und schreiben. Diese Änderungen werden jedoch nicht einzeln an den PeopleSoft-Server weitergegeben. Stattdessen fasst psjoa.jar (die Datei, mit der der BizTalk-Adapter für PeopleSoft Enterprise interagiert) alle Änderungen in einem Paket zusammen und sendet die Änderungen in diesem Paket an den Server. Tritt bei einer dieser individuellen Aktualisierungen ein Fehler auf, wird ein systemeigener Fehler zurückgegeben, der nicht auf den tatsächlichen Fehler verweist. Wenn der interaktive Modus auf WAHR festgelegt ist, wird jede Feldaktualisierung einzeln an den Server gesendet. Dies wirkt sich zwar erheblich auf die Leistung aus, stellt jedoch bei einem Aktualisierungsfehler genaue Fehlerinformationen zur Verfügung (z. B., ob ein ungültiger Wert für das Festlegen eines Felds verwendet wird).

Bietet interactiveMode maximale Leistung und Fehlerberichterstattung auf Feldupdateebene. Um dieses Feature ordnungsgemäß zu verwenden, empfiehlt es sich, normale Aufrufe mit interactiveMode false zu tätigen. Auf diese Weise sollte die Leistung nicht beeinträchtigt werden. Wenn ein Fehler zurückgegeben wird, kann derselbe Aufruf wiederholt werden, wobei das interactiveMode Flag auf TRUE festgelegt ist. Wenn nun ein Aufruffehler auftritt, gibt der Server eine genauere Fehlermeldung zurück.

Hinweise

Wenn Sie diese Funktion aufrufen, werden die Eigenschaften des Datensatzes, die den Schlüsseln entsprechen, durch die Eingabeparametereigenschaften ersetzt. Alle Auflistungen mit den ursprünglichen Datensätzen werden gelöscht und durch diejenigen im Eingabeparameter ersetzt. Die Größen dieser Auflistungen müssen nicht übereinstimmen, da die Prozedur darin UpdateEx besteht, alle vorhandenen Sammlungselemente zu löschen und dann die angegebenen einzufügen.

Wenn die Eigenschaften der Komponentenschnittstelle EFFDT-Elemente enthalten, muss der Eigenschaftenparameter alle künftigen EFFDT-Elemente enthalten, da die ursprüngliche Liste ersetzt wird. Auf diese Weise wird der Mechanismus für das Hinzufügen und Löschen künftiger EFFDT-Elemente bereitgestellt. Wenn die Eigenschaften jedoch auch EFFDT-Elemente aus der Vergangenheit enthalten, wird ein Fehler zurückgegeben, weil solche Elemente nicht geändert werden können. Wenn das aktuelle EFFDT-Element auch enthalten ist, wird es ignoriert. Dadurch kann der Client mit dem getHistoryItems auf False festgelegten Parameter aufrufen Get() und alle zukünftigen effektiv datierten Elemente ändern oder neue zukünftige effektive Elemente hinzufügen und die Struktur als Parameter für die UpdateEx() Funktion übergeben.

Wenn die Komponentenschnittstelle keinen Schlüssel aufweist, wie in dem Fall, in dem nur eine instance vorhanden sein kann, hat die UpdateEx() Methode folgendes Format:

UpdateEx(correctionMode, interactiveMode, properties)  

Hinweis

Die BizTalk Adapter for PeopleSoft Enterprise-Methode UpdateEx() wird bereitgestellt, wenn peopleSoft Get und Save die Funktionen in der Komponentenschnittstelle aktiviert sind.

Weitere Informationen

Anhang A: Komponentenschnittstellen-Methoden