Basis-Services

Service GetBo - Business Objekt holen

Hinweis
Hinweis
Eine vollständige Beschreibung der BIZ-Services finden Sie hier: BIZ-Services Übersicht

Port: Biz

Beschreibung

Mit dem Service 'GetBo' können Business-Objekte gemäss einem gewünschten Index und nach definierbaren Suchkriterien geholt werden.

Argumente

Nr.
Key
Name
Beschreibung
1
Bo
Business-Objekt-Typ-Auswahl
Business-Objekt-Typ-Auswahl
2
StartKeys
Startpunkt
Startparameter 'Startpunkt' für Service 'GetBo'. Die einzelnen Indexsegmente werden durch Kommas voneinander getrennt.
3
SearchOperationCd
Suchanweisung
Startparameter 'Suchanweisung' für Service 'GetBo'. Folgende Suchanweisungen werden am häufigsten verwendet: 'e'=gleich, 'n'=nächste, 'p'=vorangehende, 'f'=erste und 'l'=letzte Datensätze.
4
BoIndex
Index
Startparameter 'Index' für Service 'GetBo'. Defaultindex ist der Objekt-ID-Index.
5
NumberOfBos
Anzahl Datensätze
Startparameter 'Anzahl Datensätze' für Service 'GetBo'. Maximale erwünschte Anzahl von Business-Objekten.
6
FixedSegsOfBoIndex
Fixierte Segmente
Startparameter 'Fixierte Indexsegmente' für Service 'GetBo'. Anzahl der beim Startpunkt (StartKeys) fixierten Indexsegmente.
7
Filter
Filter
Startparameter 'Filter' für Service 'GetBo'. Selektionsfunktion in Form von einem logischen Ausdruck. Beispiel: Addr.CountrySc = 'CH' and (Addr.LangNo = 3 or Addr.LangNo = 5)
8
ResultObject
Rückgabe-Objekt
Startparameter 'Rückgabe-Objekt' für Service 'GetBo'. Definiert, welche Attribute im Rückgabe-Objekt enthalten sein müssen. Defaultmässig werden BoId, BoNumber und BoName zurückgegeben.
9
VirtualAttr
Virtuelle Attribute
Sie können eigene Attribute definieren, die sich aus BO-Attributen und/oder fixem Text zusammensetzen. Wenn Sie beispielsweise bei den Adressen 'Vorname Name' als ein Feld wollen, können Sie hier 'MyName=LastName + ' ' + FirstName' eingeben. Die Id (hier MyName) ist frei definierbar, sollte jedoch mit einem Grossbuchstaben beginnen.

Rückgabewerte

keine

Message Keys

Nr.
Key
Name
Beschreibung
1
NotFound
Keine Daten gefunden
Meldungsschlüssel 'Keine Daten gefunden' des Service 'GetBo'.
2
NoNext
Tabellenende
Mitteilungsschlüssel 'Tabellenende' für Service 'GetBo'. Der zurückgegebene BO-Bereich beinhaltet den letzten Datensatz, das Tabellenende wurde erreicht.
3
NoPrev
Tabellenanfang
Der zurückgegebene BO-Bereich beinhaltet den ersten Datensatz, der Tabellen-Anfang wurde erreicht.
4
NoBoth
Tabelle komplett
Mitteilungsschlüssel 'Tabelle komplett' für Service 'GetBo'. Falls dieses Flag gesetzt ist, umfasst der zurückgegebenen BO-Bereich die ganze Tabelle. Achtung: bei der Suchoperation 'e' (gleich) wird dieses Flag nicht gesetzt.

Zusatzinformationen

Suchanweisung

e = gleich
eif = gleich, wenn gefunden
n = nächste
ne = nächste ab hier (wird auch für Redo und List verwendet)
npe = nächste, auffüllen
nep = nächste ab hier, auffüllen
p = vorangehende
pe = vorangehende ab hier
pne = vorangehende, auffüllen
pen = vorangehende ab hier, auffüllen
f = erste
l = letzte

Filter

Filter in Form eines logischen Ausdrucks.
Beispiel: SalDoc.Nr=15544 and SalDoc.Nr=244585 (SalDocItem.ArtNo='A15.00' or SalDocItem.ArtNo='B177.65')
Logische Operatoren:
and = UND
or = ODER
= vergleich
<> ungleich, nicht
> grösser
>= grösser gleich
< kleiner
<= kleiner gleich

Sprachabhängige Attribute

Ist ein Attribut mehrsprachig, so kann dessen Inhalt mit <Attributname>@@<Sprachnummer> ausgelesen werden.
Beispiel: ArtDimVariant.Name@@1

Beispiel

Die gelieferte Menge ab einer Position der Auftragsbestätigung holen.
«XSER(getSalDocItem:GetBo)»
«XSER(getSalDocItem:addArg=SalDocItem)»
«XSER(getSalDocItem:addArg=«AP-DOKINR»,«AP-INR»)»
«XSER(getSalDocItem:addArg=e)»
«XSER(getSalDocItem:addArg=4)»
«XSER(getSalDocItem:addArg=1)»
«XSER(getSalDocItem:addArg=2)»
«XSER(getSalDocItem:addArg=)»
«XSER(getSalDocItem:addArg=SalDocItem.QtyDeliverd)»
«nXSER(getSalDocItem:execute>getSalDocItemRes)\A»

# Gelieferte menge ausgeben
«XRES(getSalDocItemRes:SalDocItem.QtyDeliverd)»