SaveBo - Businessobjekt speichern

Port: Biz

Beschreibung

Dieser Service erstellt und/oder mutiert die Attribute von Businessobjekt(en) eines BO-Typs. Für die Ausführung des Service kann ein Startpunkt, eine Suchanweisung, ein zu berücksichtigender Index, die Verarbeitungsart, die Ausführungsart, ein Filter und Rückgabe-Attribute angegeben werden. Ab dem Argument 11 können die Wertzuweisungen erfasst werden mit denen das BO-Attribut erstellt oder mutiert werden soll.

Argumente

Nr.
Key
Name
Beschreibung
1
Bo
Businessobjekt
Startparameter 'Businessobjekt' des Service 'SaveBo'.
2
StartKeys
Startpunkt
Startparameter 'Startpunkt' des Service 'SaveBo'. Die einzelnen Indexsegmente werden durch Kommas voneinander getrennt.
3
SearchOperationCd
Suchanweisung
Startparameter 'Suchanweisung' des Service 'SaveBo'. Meistens wird hier die Suchanweisungen 'e'=gleich verwendet.
4
BoIndex
BO-Index
Startparameter 'BO-Index' des Service 'SaveBo'. Defaultindex ist der Objekt-ID-Index.
5
SaveBoProcessingCd
Verarbeitungsart
Startparameter 'Verarbeitungsart' des Service 'SaveBo'. Folgende Varianten sind gebräuchlich: 1=nur mutieren, 2=nur erstellen, 3=mutieren wenn vorhanden, sonst erstellen.
6
FixedSegsOfBoIndex
Fixierte Indexsegmente
Startparameter 'Fixierte Indexsegmente' des Service 'SaveBo'. Anzahl der beim Startpunkt (StartKeys) fixierten Indexsegmente.
7
SaveBoModeCd
Ausführungsart
Der Service kann u.a. im Test-Modus ausgeführt werden. Mit einem Testlauf können Sie sehen, welche Businessobjekte mutiert/erstellt würden. Da alle Überprüfungen wie beim scharfen Durchgang vorgenommen werden, ist es auch möglich, Fehler schon im voraus zu bereinigen. Bei serienmässigem Mutieren (Filter!) empfehlen wir Ihnen sehr, vorher einen Testlauf durchzuführen.
8
WithReport
Protokoll
Startparameter 'Protokoll' des Service 'SaveBo'. Hier kann angegeben werden, ob der Speichervorgang protokolliert werden soll oder nicht.
9
Filter
Filter
Startparameter 'Filter' des Service 'SaveBo'. Selektionsfunktion in Form von einem logischen Ausdruck, z.B. 'Addr.CountrySc = 'CH' and (Addr.LangNo = 3 or Addr.LangNo = 5)'.
10
ResultObject
Rückgabe-Objekt
Startparameter 'Rückgabe-Objekt' des Service 'SaveBo'. Definiert, welche Attribute im Rückgabe-Objekt enthalten sein müssen. Defaultmässig werden BoId, BoNumber und BoName sowie bei eingeschaltetem Protokoll (WithReport) SaveBoStateCd und SaveBoInfo zurückgegeben.
11
SetValAttr
Wertzuweisungsargumente
Diese Felder sind für die Wertzuweisung gedacht. Pro Argument kann eine Zuweisung definiert werden. Die Syntax für eine Adresse zu mutieren lautet beispielsweise 'LastName='Smith'', 'FirstName='John'', 'Keyword=FirstName + ' ' + LastName'.

Rückgabewerte

Nr.
Key
Name
Beschreibung
1
SaveBoStateCd
Verarbeitungsstatus
Rückgabewert 'Verarbeitungsstatus' des Service 'SaveBo'. Pro Speichervorgang wird im Verarbeitungsstatus festgehalten, ob das BO mutiert bzw. erstellt werden konnte(0), ob ein Fehler aufgetreten ist(1) oder ob das BO erstellt aber nicht mutiert werden konnte(2). Der Verarbeitungsstatus ist nur bei eingeschaltetem Protokoll (WithReport) sichtbar.
2
SaveBoInfo
Anmerkung zum Speichervorgang
Rückgabewert 'Anmerkung zum Speichervorgang' des Service 'SaveBo'. Wenn beim Speichern eines Businessobjekts ein Problem auftritt, wird hier die Fehlerursache(n) aufgeführt. Dieses Feld ist nur bei eingeschaltetem Protokoll (WithReport) sichtbar.

Message Keys

Nr.
Key
Name
Beschreibung
1
Message
SaveBo.Ek.Message
SaveBo.Ek.Message