Platzhalter und Accessors
    • Dunkel
      Licht

    Platzhalter und Accessors

    • Dunkel
      Licht

    Article Summary

    Ü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


    What's Next