Platzhalter und Accessors

Prev Next

Überblick

Platzhalter und Accessors werden für die Konfiguration von Bausteinen verwendet.


Videotutorial

Eine persönliche Erklärung zur Verwendung von Platzhaltern bzw. Placeholders und ihren Accessors findest du in unserem Videotutorial.



Platzhalter

In den Placeholders sieht du alle Daten, die dem Baustein zur Verfügung stehen. Dies sind Daten, die im Workflow geladen wurden, die aus dem Triggerevent stammen, oder die in vorher verwendeten Bausteinen erzeugt wurden. Diese Daten kannst du in Do-Bausteinen weiterverarbeiten indem du den Platzhalter mit der Maus in das entsprechende Feld ziehst. 

Bei jedem Platzhalter wird ein Icon als Indikator für den jeweiligen Datentyp angezeigt. Platzhalter ohne Datentyp-Symbol sind Container, die wiederum einen oder mehr Platzhalter enthalten.



Accessors

Die Accessors sind Zugriffsmethoden, mit denen du auf Eigenschaften von Datentypen zugreifen kannst. Den Accessors-Dialog öffnest du mit einem Klick auf das Kettensymbol    eines platzierten Platzhalters.


Die folgenden Accessors stehen in saas.do zur Verfügung:

DatentypAccessorBeschreibungOutputBeispiel
AlleExists?Gibt zurück, ob der Datensatz existiertBooleantrue wenn Datensatz existiert
StringLengthGibt die Länge der Zeichenkette zurückInteger17
TrimEntfernt Leerzeichen am Anfang und Ende der Zeichenkette inklusive geschützter LeerzeichenString–
UppercaseZeichenkette in Großbuchstaben umwandelnStringNecara → NECARA
LowercaseZeichenkette in Kleinbuchstaben umwandelnStringNecara → necara
CutSchneidet den String nach X Zeichen abString–
Integer /
Decimal
MoneyGibt den Wert mit zwei Nachkommastellen zurückString12.448 → 12.45
12 → 12.00
RoundRundet den Wert nach X KommastellenString–
DecimalRound downRundet den Wert abInteger12.45 → 12
Round upRundet den Wert aufInteger12.45 → 13
Datetime / DateTimestampGibt Datum und Uhrzeit als Unixzeit zurückInteger1424944800
YearGibt das Jahr zurück Integer2022
MonthGibt den Monat zurückInteger5
DayGibt den Tag zurückInteger12
Day of weekGibt den Tag der Woche zurückInteger0 für Sonntag
1 für Montag
2 für Dienstag
[...]
Day of yearGibt den Tag des Jahres zurückInteger214
Week of yearGibt die Kalenderwoche zurückInteger14
QuarterGibt das Viertel der Kalenderjahres zurückInteger2 für 14:25
Is future?Gibt zurück, ob die Uhrzeit in der Zukunft liegt oder nichtBoolean1 für den 05.03.2067
Format prettyFormatiert Wert als StringStringVergangene Zeitspanne ("2 weeks ago") anstelle eines 2 Wochen alten Datums
ISO 8601Formatiert den Date-Wert als String gemäß ISO 8601String2.09.2022 → 2022-09-12T00:00:00+02:00
Formatiert den Datetime-Wert als String gemäß ISO 8601String 12.09.2022, 09:31 → 2022-09-12T09:31:17+02:00
Datetime / TimeHourGibt die Stunde zurückInteger15
MinuteGibt die Minute zurückInteger44
SekundeGibt die Sekunde zurückInteger59
Format prettyIntegerStringVergangene Zeitspanne ("1 Second / 1 minute / 1 hour / etc. ago") anstelle der konkreten Uhrzeit
Object / CollectionFormat prettyAusgabe als formatierten String mit ZeilenumbruchString"Artikelnummer: 561858\n
Name: Skateboard\n
Kategorie: Sportartikel"

Format as JSONAusgabe als formatierten JSON-StringString"{\"artikelnummer\":561858,
\"name\":\"Skateboard\",
\"kategorie\":\"Sportartikel\"}"
CollectionFirstGibt ersten Datensatz der Collection ausEntspricht Collection–
LastGibt den letzten Datensatz einer Collection ausEntspricht Collection–
LengthGibt Anzahl an Datensätzen in der Collection zurückInteger425
FlattenLiefert eine neue Collection mit den Inhalten aus dem Feld, das 'geflattet' wurde.Entspricht CollectionInput Object:
[{"artikelnummer":748647,
"artikelname":"Stapelturm",
"kategorie":"Spielzeug"},
{"artikelnummer":456745,
"artikelname":"Schneebesen",
"kategorie":"Haushaltswaren"}]

Output Flatten nach Artikelnummer vom Datentyp Integer:
"flatArtikelNr":[748647,456745]
Element at PositionGib einen Datensatz von einer definierten Position wieder, beginnend mit Nummer 1Entspricht Collection–
FileFilenameGibt Dateinamen zurückStringnecara.png
ContentGibt Inhalt der Datei im Zeichenformat zurückString–
Base 64Gibt Inhalt der Datei im Base64-Format zurückString–
ExtensionGibt Dateiendung zurückStringpng
FilesizeGibt Dateigröße in Bytes zurückInteger73920
Filesize prettyFormatiert Dateigröße als StringString72.19 KiB
Public linkStellt Download-Link zur VerfügungStringhttps://demo-app.dev2.saas.do/
file/get/1649668681_OTAhlX3
SzR5lUiswp3lT
Hinweis
Achte bei der Ausgabe stets auf den korrekten Output-Datentyp des Accessors. Der Timestamp beispielsweise ist vom Typ Integer, kann aber in Date oder DateTime umgewandelt werden.
Tipp
In einem Objekt kannst du auf die einzelnen Platzhalter der Datenfelder auch über Access object properties im Accessors-Dialog zugreifen.



Verwandte Themen