Auf Englisch lesen

Freigeben über


Get-Methode

Wird zum Abrufen von Eigenschaften basierend auf den Eingabeschlüsselparametern (key1, key2, … keyn) verwendet. Der Ausgabeparameter ist eine Struktur mit den Eigenschaften des Datensatzes, der den Schlüsselparametern entspricht. Wenn die Komponentenschnittstelle nur eine Instanz aufweist (d. h. kein Schlüssel vorhanden ist), enthält die "Get"-Funktion keine Schlüsselparameter. Weitere Informationen finden Sie unter Find-Methode.

Syntax

Get (key1, key2, ... keyn, properties)  
Get (key1, key2, ... keyn, getHistoryItems, properties)  

Parameter

Parameter BESCHREIBUNG
key Eine Gruppe von Parametern, die in der Serverdatenbank vorhanden sein müssen. Andernfalls tritt ein Fehler auf. Diese Schlüssel entsprechen der Gruppe "Get (key1, key2, … keyn)" gemäß der Festlegung für die jeweilige Komponentenschnittstelle.
properties Enthält eine vollständige Struktur der Eigenschaften der Komponentenschnittstelle, die nach Abschluss des Aufrufs zurückgegeben werden.
getHistoryItems Ein boolescher Wert. Wenn die Eigenschaften der Komponentenschnittstelle elemente unterhalb der Ebene 0 (d. h. ein Schlüsselfeld mit dem Namen EFFDT) enthalten, ist der getHistoryItems zusätzliche Parameter erforderlich.

Wenn der Wert wie folgt lautet:

- True: Alle effektiven elemente werden als Sequenz zurückgegeben (die in eine beliebige Ebene eingebettet werden kann). Dies umfasst alle früheren, aktuellen und künftigen EFFDT-Elemente.
- False: Es werden nur die aktuellen und alle zukünftigen gültigen Elemente zurückgegeben. Wenn nachfolgende Aktualisierungsaufrufe für dieselbe instance ausgeführt werden, getHistoryItems sollte auf False festgelegt werden.

Hinweise

Wenn die Eigenschaften der Komponentenschnittstelle effektive veraltete Elemente unter Ebene 0 (d. h. ein Schlüsselfeld mit dem Namen EFFDT) enthalten, ist ein zusätzlicher Parameter erforderlich getHistoryItems. Der Parameter weist den Typ "Boolesch" auf. Wenn der Wert auf "True" festgelegt wurde, werden alle EFFDT-Elemente als Sequenz zurückgegeben (die auf einer beliebigen Stufe eingebettet sein kann). Dazu gehören alle in der Vergangenheit gültigen Elemente, die aktuell gültige Datumsposition sowie alle zukünftigen wirksamen Elemente mit datumswirksamen Datumseinträgen. Wenn der getHistoryItems Parameter auf False festgelegt ist, werden nur die aktuellen und alle zukünftigen wirksamen Elemente zurückgegeben. Wenn nachfolgende Aktualisierungsaufrufe für dieselbe instance ausgeführt werden sollen, sollte auf getHistoryItems False festgelegt werden. Siehe auch UpdateEx-Methode.

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

Get(properties)  

Weitere Informationen zu EFFDT-Elementen finden Sie in der PeopleSoft Enterprise-Dokumentation.

Hinweis

Die BizTalk Adapter for PeopleSoft Enterprise-Methode Get() wird bereitgestellt, wenn die PeopleSoft-Funktion Get in der Komponentenschnittstelle aktiviert ist.

Weitere Informationen

Anhang A: Komponentenschnittstellen-Methoden