6. Makro-Tags für Corbit

In der folgenden Liste finden Sie die Makro-Tags, die im gesamten Corbit-Setup verfügbar sind. Wenn Sie ein Makro auswählen, wird die detailliertere Beschreibung dieses Makros angezeigt.

Einige Makro-Tags sind nur in bestimmten Feldern im Setup verfügbar. Die Beschreibung der Makro-Tags informiert Sie über solche Einschränkungen. Wenn im Beschreibungsfeld keine spezielle Verwendung angegeben ist, kann das Makro-Tag in allen Makrofeldern verwendet werden.

Makroliste
%, EMAIL_SENT IMAGE_WIDTH REPLACE_ALL
ASSET_ID ASSET ASSET_LIST ASSET_XML
ASSET_CATALOG_ID BASE64_DECODE CLIPPING_PATH_LIST DATE_CHANGE
%% EMAIL_SUBJECT INDEX SFN
EMAIL_TO SET_BUCKET SEPARATE SEPARATE_BY_ROW
ACTION_NAME EXIF INDEX_OF SOURCE_FILE_EXISTS
APP F IPTC SOURCE_FOLDER_FILE_COUNT
BASE64 FILE_CONTENT LAST_INDEX_OF SOURCE_NAME
BASE64_FROM_FILE FILE_DIMENSION LENGTH WORKFLOW_BUCKET
BUCKET FILE_DIMENSION_H LOWER WORKFLOW_NAME
BUCKET_FILE_COUNT FILE_DIMENSION_W MATH STRIP
BUCKET_FILE_NAME_LIST FILE_EXISTS META SUBSTRING
BUCKET_LIST FILE_PAGE_COUNT MOD SXML
BUCKET_LIST_REMOVE_DUPLICATES FILE_PARENT_PATH MOD_TIME TRIM
CASE FILE_PATH MP3_ALBUM UPPER
CHAR FILL MP3_ARTIST UUID
D FILTER_NAME MP3_COMMENT XMP
DATE_COMPARE FOLDER_FILE_COUNT MP3_GENRE XPATH
DUPLICATE_FILE_EXTRA FOLDER_SIZE MP3_TITLE XPATHEL
E FOR_EACH_IN_LIST MP3_TRACK XPATHLIST
EMAIL_BODY FORMAT_DATE MP3_TRACKCOUNT ZIPF
EMAIL_RECEIVED FREE_INDEX MP3_YEAR SYSTEM_BUCKET
EMAIL_SENDER_ADDRESS HTML_ENCODE NR DATE_CHANGE  
EMAIL_SENDER_NAME IMAGE_HEIGHT PF JSON  
REMOVE_BOM SFN2 URL_ENCODE XPATHLISTEL  
CSV_PARSE_ROWS CSV_PARSE_COLS SEPROWNUM SEPCOLNUM  
SEPVALUE SEPHEADER SEPROWVALUE_BY_COL SEPROWVALUE_BY_HEADER  
Makros

%,

Spezielles Makro, das ein einzelnes Komma-Zeichen zurückgibt.

%%

Spezielles Makro, das ein einzelnes %-Zeichen zurückgibt.

%ACTION_NAME%

Der Name der Aktion im aktuellen Kontext, in dem das Makro ausgewertet wird.

%ASSET_ID%

Dieses Makro gibt eine Portfolio Asset-ID zurück. Die zurückgegebene ID stammt aus dem aktuellen Asset im Handling Scope, siehe Abschnitt Assets im Scope für weitere Details.

%ASSET[<key>]%

Dadurch wird das Feld mit dem Namen Key aus dem aktuellen Asset im Handling Scope ermittelt, siehe Abschnitt Assets im Scope für weitere Details.
Wenn z. B. das Feld Dateiname gewünscht wird, sollte das Makro %ASSET[Dateiname]% verwendet werden. Der Schlüssel unterscheidet Groß- und Kleinschreibung.

%ASSET_LIST[<key>,<delimiter>]%

Dieses Makro ähnelt dem obigen ASSET-Makro. Der Unterschied besteht darin, dass das Makro ASSET_LIST verwendet wird, wenn der Wert des Feldschlüssels mehrere Werte haben kann, z. B. das Bereichstichwort
. Das Begrenzungszeichen ist die Zeichenfolge, die verwendet wird, um die Werte zu trennen und den Ergebnistext zu erstellen.

Beispiel: Wenn wir ein Asset mit dem Feld Stichwörter auf Apfel und Banane gesetzt haben, würde das Makro %ASSET_LIST[Keywords,#]% zu Apfel#Banane führen.

%ASSET_XML%

Dieses Makro gibt eine XML-Struktur für das aktuelle Asset im Bearbeitungsumfang zurück, siehe Abschnitt Assets im Umfang für weitere Details.
Die XML-Ausgabe wird folgende Struktur haben:

 

<asset id==“[id]“ [field name]=“[value]“ ...> <

[Feldname]>[Wert]</

[Feldname]>

<[Feldname]-Liste> <[Feldname]>[Wert]</[Feldname]>

</[Feldname]-Liste>

....

</asset>

 

Jeder Schlüssel in der Kühlstelle, der vom Typ boolean,datetime,decimal,number oder url ist, befindet sich zusammen mit der Asset-ID in der Parameterliste des Root Asset.
Felder vom Typ geojson, geopoint, picture, string oder textblocks haben ihre eigenen Tags (der Tag-Name ist der Feldname).
Andere Felder, die mehrere Werte haben können, werden in ihren eigenen Tags hinzugefügt, die als Feldname mit einer hinzugefügten'-Liste' benannt sind.
Dieses Tag enthält dann alle separaten Werte in Tags, die als Feldname benannt sind.

Zum Beispiel, wenn ein Asset das Bereichstichwort mit den Werten Apfel und Banane hat, wäre die Ausgabe

 

<asset=“12345“...>

<Keywords-list>

<Keywords>Apfel</Keywords>

<Keywords>Banane</Keywords>

</Keywords-list>

...

</asset>

Aus diesem ASSET_XML-Makro kann XPATH-Makro verwendet werden, um bestimmte Werte abzurufen.

%ASSET_CATALOG_ID%

Gibt die Katalog-ID zurück, die zum aktuellen Portfolio-Asset gehört. Dieses Makro ist nur dann sinnvoll, wenn ein solches Asset im aktuellen Geltungsbereich vorhanden ist.
Das ist im Geltungsbereich verfügbar, wenn Sie z.B. eine Portfolio-Quelle haben oder wenn Sie eine "für-jedes-Asset“- Aktion haben.

%APP[<key>]%

Dieses Makro ist hauptsächlich für den internen Gebrauch gedacht.

Im Container der laufenden Anwendung, Servlet oder Applet befinden sich einige interne Parameter, die mit diesem Makro aufgerufen werden können. Der Parameterschlüssel ist für jeden Container unterschiedlich.

%BASE64[<Text>, <Optionale Kodierung>]%

Dies wird einen Text nehmen und daraus einen Base64-kodierten Text machen. Die optionale Kodierung kann verwendet werden, wenn der Quelltext in einem bestimmten Format vorliegt.

%BASE64_DECODE[<text>]%

Dieses Makro ist das Gegenstück zu BASE64. Das Makro verarbeitet einen BASE64-kodierten Text und dekodiert ihn.
Ein Beispiel: Die Verwendung von %BASE64_DECODE[%BASE64[this is a text]%]% liefert das Ergebnis "das ist ein Text", (Zuerst wird er als BASE64 kodiert und dann dekodiert.

%BASE64_FROM_FILE[<Pfad>]%

Dies wird eine Datei nehmen und eine Base64-kodierte Zeichenkette aus dem Inhalt erzeugen. Das Pfadargument ist der vollständige Pfad zur zu kodierenden Datei.

%BUCKET[<key>]%

Ruft einen Wert aus dem Bereich des Objekts ab (d. h. des Objekts, das gerade bearbeitet wird). Dies kann z. B. in einer Aktion nützlich sein, um einen Wert von einer anderen Aktion zu erhalten, die vor der aktuellen Aktion aufgerufen wurde.

Die <Taste> ist der Schlüssel, den die vorhergehende Aktion verwendet hat, um den Wert in den Bereich zu legen. Sehen Sie in der Dokumentation für verschiedene Aktionen nach, um zu sehen, was diese in den Container tun.

Beachten Sie, dass der Workflow selbst auch einige Werte in diesen Bereich stellt, bevor eine Aktion ausgeführt wird.

Beachten Sie, dass sich dieser Bereich von dem Workflow-Bereich unterscheidet, der mit dem Makro %Workflow_BUCKET[...]% verwendet werden kann.

Lesen Sie mehr über die verschiedenen Bereiche in Kapitel 2.

%BUCKET_FILE_COUNT[<key>,<onlyFiles>]%

Dies gibt die Anzahl der Dateien zurück, die im Objektbereich mit der Taste <key> vorhanden sind. Wenn <onlyFiles> gleich 'True' ist, dann werden nur die Dateien gezählt, bei 'False', werden Dateien und Ordner gezählt. Der Wert im Bereich muss eine Liste von Dateien sein (siehe verschiedene Aktionen für weitere Informationen, was diese in den Bereich legen).

%BUCKET_FILE_NAME_LIST[<key>,<onlyFiles>]%

Dies gibt die Namen der Dateien zurück, die im Objektbereich mit der Taste <key> vorhanden sind. Wenn <onlyFiles> gleich 'True' ist, dann werden nur die Namen der Dateien angezeigt, bei 'False', werden die Namen der Dateien und Ordner angezeigt. Der Wert im Bereich muss eine Liste von Dateien sein (siehe verschiedene Aktionen für weitere Informationen, was diese in den Bereich legen).

Die zurückgegebene Liste ist eine durch Komma getrennte Liste von Dateinamen.

%BUCKET_LIST[<key>,<delimiter>]%

Dies ist ein Makro, das eine Liste zu einem einzelnen String mit einem bestimmten Trennzeichen verbindet.

Dieses Makro nimmt einen Bereichswert, betrachtet diesen Wert als eine Liste von Elementen (z. B. aus dem speziellen -Listenbereichsschlüssel, der in der Datenbankaktion erstellt wurde) und verbindet diese Elemente mit dem angegebenen Trennzeichen.

Beispiel: Wenn die Bereichsschlüssel Papierliste eine Ergebnisliste aus der Datenbank-Aktion und die folgenden Elemente enthält: Nachrichten, Sport, Werbung. Die Verwendung des Makros %BUCKET_LIST[paper-list,#]% führt zu folgendem String: news#sports#ads

PS! Wenn ein Komma (,) als Trennzeichen gewünscht wird, muss dem Komma ein Prozentzeichen (%,) vorangestellt werden.

%BUCKET_LIST_REMOVE_DUPLICATES[<key>]%

Dieses Makro arbeitet auf einer Bereichs-Liste (z. B. ein Wert aus einem Database call). Das Makro gibt nichts zurück, es entfernt nur alle doppelten Einträge im angegebenen Bereichswert.

Beispiel: Wenn die Bereichsschlüssel Papierliste eine Ergebnisliste aus der Datenbank-Aktion und die folgenden Elemente enthält: Nachrichten, Sport, Neuigkeiten, Werbung. Wenn Sie das Makro %BUCKET_LIST_REMOVE_DUPLCIATES[paper-list]% verwenden, werden die Elemente im Bereich geändert, was zu den folgenden Elementen führt: Nachrichten, Sport, Werbung

%CASE[<exp>,<t>,<f>]%

Dieses Makro wertet eine Bedingung aus und gibt je nach Ergebnis der Bedingung unterschiedliche Werte zurück.

Der Parameter <exp>, der ausgewertet wird, muss ein gültiger Ausdruck sein, siehe unten.

Wenn der Ausdruck als wahr ausgewertet wird, wird der <t> Text (der andere Makros enthalten kann) analysiert und zurückgegeben. Wenn der Ausdruck falsch ist, wird der <f> Text analysiert und zurückgegeben.

Der Ausdruck <exp> muss einen der folgenden mathematischen Ausdrücke enthalten (das erste Auftreten wird genommen)

Ausdruck Bedeutung Beschreibung
< kleiner als Dieser Ausdruck ist nur gültig, wenn die linke und rechte Komponente Zahlen sind.
<= kleiner oder gleich Dieser Ausdruck ist nur gültig, wenn die linke und rechte Komponente Zahlen sind.
> größer als Dieser Ausdruck ist nur gültig, wenn die linke und rechte Komponente Zahlen sind.
>= größer oder gleich Dieser Ausdruck ist nur gültig, wenn die linke und rechte Komponente Zahlen sind.
== Gleich Prüft, ob die linke und rechte Komponente gleichwertig sind.
<> ungleich Prüft, ob sich die linke und rechte Komponente unterscheiden.

%CHAR[<no>]%

Gibt das Zeichen mit der Unicode-Dezimalzahl <no> zurück.

%CLIPPING_PATH_LIST[<path>,<bucket>]%

Der Pfad kann leer sein, dann wird die aktuelle Datei als Quelle verwendet, ansonsten wird der Pfad als Quelle für die zu analysierende Datei verwendet.
Bucket gibt an, welcher Bucket-Wert gesetzt werden soll. Die Bucket-Werte sind eine Liste (wobei Sie als Beispiel später %BUCKET_LIST...% verwenden können) mit den Namen aller Clipping-Pfade, die eine Bilddatei enthält.

%CSV_PARSE_ROWS[<text>,<handling>]%

%CSV_PARSE_ROWS[<firstRowHeader>,<text>,<handling>]%

Dieses Makro ist ähnlich wie %SEPARATE_BY_ROW[...]%, erwartet aber CSV-strukturierten Text, der mit Anführungszeichen usw. umgehen kann.


Parameter:
firstRowHeader Dieser Wert sollte "true" sein, wenn die erste Zeile des Textes als Überschrift verwendet werden soll.
Die Überschriftswerte können in anderen Makros in der Behandlung verwendet werden, zum Beispiel %SEPHEADER%.Wenn dieser Parameter nicht angegeben wird, ist der Standardwert true.
text Der Quelltext, der in Zeilen aufgeteilt wird
handling So wird jede Zeile des CSV-Textes behandelt werden. Normalerweise wird das Makro %CSV_PARSE_COLS[...]% Teil der Behandlung sein.

%CSV_PARSE_COLS[<text>,<handling>]%

Dieses Makro wird verwendet, um eine einzelne Zeile eines CSV-formatierten Textes zu trennen. Dieses Makro wird normalerweise innerhalb des Behandlungsparameters des Makros %CSV_PARSE_ROWS[...]% verwendet.


Parameter:
text Der Quelltext, der in einzelne Spaltenwerte getrennt wird
handling So wird jede Spalte des CSV-Textes behandelt werden.

%D%

%D[<format>]%

%D[+<d>,<format>]%

%D[-<d>,<format>]%

Einfache Form

In der einfachen Form wird das aktuelle Datum im Format yyyy-MM-dd zurückgegeben.

Variante [<format>]

Wenn <format> angegeben ist, wird das Ergebnis im angegebenen Format ausgegeben. Das Format kann Sonderzeichen wie Punkt (.), Komma (,) enthalten (Achtung! Wenn ein Komma als Trennzeichen verwendet werden soll, muss es mit einem '%' um korrekt behandelt zu werden) und einem Bindestrich (-) maskiert werden. Die folgenden Zeichen zeigen, wie man ein bestimmtes Format erhält. Die Anzahl der einzelnen Zeichen entscheidet über den Ergebnis-Datumstring, z. B. im Jahr 2006, yyyy würde im Jahr 2006 resultieren, yy gibt 06 an.

Zeichen formatieren Beschreibung
y Das Jahr
M Der Monat im Jahr
w Die Woche im Jahr
W Die Woche im Monat
D Der Tag im Jahr
d Der Tag im Monat
E Wochentag als Text
a AM/PM
H Stunden (0-23)
k Stunden (1-24)
K Stunden am/pm (0-11)
h Stunden am/pm (1-12)
m Minuten
s Sekunden
S Millisekunde

Variant [+<d>,<format>] oder [-<d>,<format>]

Wenn der erste Parameter mit einem Plus- oder Minuszeichen beginnt, wird die angegebene <d> Anzahl der Tage ab dem aktuellen Datum vor der Berechnung des Ergebnisses addiert bzw. subtrahiert. Das <Format> ist wie oben beschrieben.

%DATE_CHANGE[<source date>, <source format>, <unit>, <amount>, <output format>]%

Dieses Makro wird ein Datum/eine Uhrzeit verwenden, addieren (oder subtrahieren, wenn eine negative Zahl verwendet wird) und das neue Datum/die neue Uhrzeit zurückgeben.

sourcedate (Quelldatum) ist das Datum/die Uhrzeit der Eingabe
sourceformat ist das Format, in dem das Quelldatum angegeben wird.
unit (Einheit) gibt eine der folgenden Einheiten an (Tag, Stunde, Minute, Sekunde) und ist dann die zu ändernde Einheit.
amount (Menge) gibt an, wie viele einer bestimmten unit addiert werden sollen (oder subtrahiert, wenn eine negative Zahl verwendet wird)
outputformat (Ausgabeformat) gibt das gewünschte Endformat der Zeitausgabe an.

Beispiel: %DATE_CHANGE[2022-05-04,yyyy-MM-dd,day,7,ww]% gibt die Wochennummer zurück, wenn 7 Tage zum Datum 2022-05-04 hinzugefügt werden, das Ergebnis wäre also "19".

%DATE_COMPARE[<date1>, <date1 format>, <date2>, <date2 format>]%

Dieses Makro vergleicht zwei Datumsangaben und gibt die Differenz in Sekunden zurück.

Die Parameter date1 und date2 sind Zeichenketten, die Datumsangaben repräsentieren. Jeder von ihnen sollte dem Format date1 und date2 entsprechen (siehe Makro %D% für weitere Informationen über die Formate).

Der Rückgabewert ist die Differenz zwischen den beiden Datumsangaben in Sekunden. Wenn die Datumsangaben gleich sind, wird 0 zurückgegeben. Wenn date1 vor date2 liegt, wird eine negative Zahl zurückgegeben.

%DUPLICATE_FILE_EXTRA[<text>]%

Dieses Makro wird nur bei Aktionen verwendet, bei denen eine Zieldatei erstellt wird. Dieses Makro hat keine Wirkung, wenn die erstellte Datei nicht existiert. Wenn die zu erzeugende Datei existiert, bestimmt dieses Makro, wie ein neuer Name erstellt wird. Beachten Sie, dass das Spezialmakro %FREE_INDEX% im Textparameter dieses Makros verwendet werden kann.

In den meisten Fällen, in denen dieses Makro verwendet werden kann, gibt es im Setup ein Kontrollkästchen, mit dem die Datei überschrieben werden kann. Dieses Ankreuzfeld hat keine Wirkung, wenn dieses Makro in der Aktion verwendet wird.

Dieses Makro ersetzt das Setup in Corbit Version 5 und älter, bei dem der Benutzer ein Präfix angeben kann, das dem Dateinamen hinzugefügt werden soll, wenn die Ergebnisdatei existiert. Mit diesem Makro kann der Dateiname auf mehr als nur ein Präfix geändert werden.

PS! Dieses Makro kann derzeit nicht in der FTP-Sendeaktion verwendet werden!

 

Beispiel 1

Wenn wir einen Workflow eingerichtet haben, bei dem eine Quelldatei erkannt und in einen Zielordner verschoben wird und eine Datei mit diesem Namen bereits im Zielordner vorhanden ist, können wir das Kontrollkästchen in der Verschiebeaktion verwenden, um die Zieldatei mit unserer neu gefundenen Datei zu überschreiben.

Wenn wir beide Dateien im Zielordner behalten wollen, müssen wir den Namen für diese neue Datei ändern. Nehmen wir an, wir möchten der neuen Datei ein Rauten-Zeichen (#) und eine laufende Nummer hinzufügen. Dann müssten wir das Namensänderungsfeld in der Verschiebe-Aktion verwenden und den folgenden Wert eingeben:

%F%%DUPLICATE_FILE_EXTRA[#%FREE_INDEX%]%%E%

Im obigen Beispiel ist der fettgedruckte Text das Magic, das hinzugefügt wird, wenn es sich bei der Datei um eine doppelte Datei handelt. Ohne das Duplikat-Makro würde der Dateiname %F%%E%, d. h. wie der ursprüngliche Dateiname, lauten.

Wenn wir im Falle von Duplikaten (wobei X die erste verfügbare Nummer ist) die Zeichenkette 'Version X' vor dem Dateinamen haben, können wir im Namensänderungsfeld Folgendes verwenden:

%DUPLICATE_FILE_EXTRA[version %FREE_INDEX%]%%F%%E%

 

%E%

Beachten Sie, dass dieses Makro nur in dem Kontext nützlich ist, in dem eine Datei referenziert wird.

File name-Suffix (inklusive Punkt), falls vorhanden. Wenn die Datei kein Suffix hat, ist ein leerer String das Ergebnis.

%EMAIL_BODY%

%EMAIL_BODY[<mime>]%

Einfache Form

Wenn es sich bei dem zu behandelnden Objekt um eine E-Mail handelt, wird der Text der E-Mail zurückgegeben. Enthält die E-Mail mehr als einen Textkörper, wird der zurückgegebene Text primär der reine Textkörper sein, zweitens wird der HTML-kodierte Textkörper zurückgegeben.

Variante[<mime>]

Damit wird primär der E-Mail-Text im speziellen Mime-Format <mime> zurückgegeben. Wenn die E-Mail keinen Textkörper im angegebenen Mime-Format enthält, wird ein leerer String zurückgegeben. Beispiel für Mime-Typen: text/plain oder text/html

%EMAIL_RECEIVED%

%EMAIL_RECEIVED[<format>]%

%EMAIL_RECEIVED[+<d>,<format>]%

%EMAIL_RECEIVED[-<d>,<format>]%

Wenn es sich bei dem zu bearbeitenden Objekt um eine E-Mail handelt, wird das Empfangsdatum der E-Mail zurückgegeben.

Dieses Makro arbeitet als Datumsmakro %D% mit allen Varianten von Parametern.

%EMAIL_SENDER_ADDRESS%

Wenn es sich bei dem zu behandelnden Objekt um eine E-Mail handelt, wird die E-Mail-Adresse des Absenders zurückgegeben.

%EMAIL_SENDER_NAME%

Wenn es sich bei dem zu behandelnden Objekt um eine E-Mail handelt, wird der vollständige Name des Absenders zurückgegeben.

%EMAIL_SENT%

%EMAIL_SENT[<format>]%

%EMAIL_SENT[+<d>,<format>]%

%EMAIL_SENT[-<d>,<format>]%

Wenn es sich bei dem zu bearbeitenden Objekt um eine E-Mail handelt, wird das Versanddatum der E-Mail zurückgegeben.

Dieses Makro arbeitet als Datumsmakro %D% mit allen Varianten von Parametern.

%EMAIL_SUBJECT%

Wenn es sich bei dem zu behandelnden Objekt um eine E-Mail handelt, wird der Betrefftext der E-Mail zurückgegeben.

%EMAIL_TO%

Ähnlich wie das Makro EMAIL_SENDER_ADDRESS (das die Adresse abruft, von der eine E-Mail gesendet wurde).
EMAIL_TO gibt die Adresse zurück, an die die aktuelle E-Mail gesendet wird. Wenn die E-Mail an mehrere Empfänger gesendet wird, werden alle Adressen mit einem Komma dazwischen empfangen.

%EXIF[<no>]%

Wenn es sich bei dem zu behandelnden Objekt um ein Bild mit EXIF-Informationen handelt, wird die EXIF-Information aus dem EXIF-Feld Nummer <no> zurückgegeben.

%F%

%F[<s>,<e>]%

%F[O,<ch>]%

%F[O,<ch>,<no>,<l>]%

%F[OI,<index>,<no>,<l>]%

Beachten Sie, dass dieses Makro nur in dem Kontext nützlich ist, in dem eine Datei referenziert wird.

Einfache Form
Der Dateinamenstamm (d. h. der Dateiname ohne Dateinamensendung und zugehöriger Punkt).

Variante [<s>,<e>]

Teil des Dateinamenstammes. Beginnen Sie bei Index <s> (das erste Zeichen hat Index 1) und enden Sie bei Index <e>. Wenn <s> nicht angegeben ist, wird 1 verwendet. Fehlt <e>, wird der letzte Zeichenindex verwendet. Beachten Sie, dass die Kommazeichen vorhanden sein müssen, auch wenn entweder <s> oder <e> weggelassen wird.

Variante[O,<ch]>

Der erste Parameter ist der Buchstabe 'O'. Dies gibt einen Teil des Dateinamensstammes ab dem ersten Zeichen an und nimmt alle Zeichen vor dem ersten Auftreten von <ch>. Wenn <ch> nicht im Dateinamen gefunden wird, ist das Ergebnis das gleiche wie %F%.

Variante [O,<ch>,<no>,<l>]

Der erste Parameter ist der Buchstabe 'O'. Dies ergibt einen Teil des Dateinamenstammes, der beim ersten Auftreten von <ch> beginnt. Dann schieben Sie <no> Schritte (ein Minuszeichen kann vor <no> gehen, um rückwärts zu gehen). Dies ist nun die Startposition und <l> Anzahl der Zeichen werden gelesen. Wenn <l> fehlt, wird der Rest des Dateinamenstammes gelesen. Beachten Sie, dass das letzte Kommazeichen vorhanden sein muss, auch wenn <l> weggelassen wird.

Variante [OI,<index>,<no>,<l>]

Der erste Parameter sind die Buchstaben 'O' und 'I'. Dies ergibt einen Teil des Dateinamensstammes beginnend mit dem Zeichen <index> (erstes Zeichen ist Index 1, wenn das letzte Zeichen gewünscht wird, dann verwenden Sie -1). Dann werden <no> (Anzahl) Schritte unternommen (Minuszeichen kann vorangestellt werden <no> um rückwärts zu gehen). Dies ist der Anfang und von hier aus wird <l> Anzahl der Zeichen gelesen. Wenn <l> fehlt, wird der Rest des Dateinamenstammes gelesen. Beachten Sie, dass das letzte Kommazeichen vorhanden sein muss, auch wenn <l> weggelassen wird.

%FILE_CONTENT%
%FILE_CONTENT[<file>,<format>,<start>,<end>]%

Lesen der Datei mit Pfad <Datei> (der Pfad ist abhängig von der Umgebung, aus der dieses Makro aufgerufen wird) und liefert den Inhalt der Datei im gewählten Textformat <Format>.

Wenn das Format weggelassen wird, wird als Standardformat „UTF-8“ verwendet. Beachten Sie, dass das Komma vorhanden sein muss, auch wenn <format> weggelassen wird.

Optional können die Parameter <start> und <end> verwendet werden. Diese zeigen den Start- und Endort an, um einen Teil des Dateiinhalts zu erhalten. Die Start- und Endparameter sind die Byteposition. Der erste Speicherort in der Datei ist Null (0).

Das einfache Makro ohne Parameter liefert den Inhalt der Datei, die sich gerade im Bereich des Makros befindet.

Bei der Verwendung von Parametern kann der Parameter <file> leer sein, in diesem Fall wird die aktuell im Umfang befindliche Datei verwendet, z. B. %FILE_CONTENT[,ISO-8859-1]%

%FILE_DIMENSION[decimals=0, pdfBox]%

Beachten Sie, dass dieses Makro nur in dem Kontext nützlich ist, in dem eine Datei vorhanden ist.

Damit erhalten Sie die Abmessungen der Datei in mm. Der Rückgabewert ist die Breite, gefolgt von einem ' x '(Leerzeichen, x und dann ein weiteres Leerzeichen), gefolgt vom Höhenwert.

Der erste Parameter ist die Anzahl der zu verwendenden Dezimalstellen, wenn dieser Parameter fehlt, wird der Standardwert auf Null (0) Dezimalstellen gesetzt.

Der zweite Parameter ist nur dann sinnvoll, wenn es sich bei der Datei um eine PDF-Datei handelt. Dies ist dann die PDF-Box, die Sie für die Bemaßung verwenden können. Wenn dies weggelassen wird, ist die Standard-Reihenfolge trimBox, mediaBox, cropBox, bleedBox, artBox.

Für weitere Informationen wird auf die Makros FILE_DIMENSION_W und FILE_DIMENSION_H verwiesen.

%FILE_DIMENSION_H[decimals=0, pdfBox]%

Dieses Makro ist ähnlich wie FILE_DIMENSION, liefert aber nur den Höhenwert.

%FILE_DIMENSION_W[decimals=0, pdfBox]%

Dieses Makro ist ähnlich wie FILE_DIMENSION, liefert aber nur den Breitenwert.

%FILE_EXISTS[<path>]%

Prüft, ob eine bestimmte Datei (mit dem Pfad <path>) existiert. Dies gibt „true“ zurück, wenn die Datei existiert, andernfalls „false“. Der angegebene Pfad muss auf dem Corbit-Server vorhanden sein. Siehe auch %SOURCE_FILE_EXISTS[...]%.

%FILE_PAGE_COUNT%

%FILE_PAGE_COUNT[<path to file>]%

Gibt die Anzahl der Seiten in der Datei zurück. Das Standardmakro ohne Parameter überprüft die aktuelle Datei im Kontext. Wenn der Parameter vorhanden ist, wird dies als Pfad zur zu prüfenden Datei genommen.

Nur PDF-Dateien werden mit ihrer tatsächlichen Seitenzahl berechnet, andere Dateien geben 1 zurück.

%FILE_PARENT_PATH%

Beachten Sie, dass dieses Makro nur in dem Kontext nützlich ist, in dem eine Datei referenziert wird.

Der Pfad des übergeordneten Ordners der aktuellen Datei.

%FILE_PATH%

Beachten Sie, dass dieses Makro nur in dem Kontext nützlich ist, in dem eine Datei referenziert wird.

Der vollständige Pfad zur aktuellen Datei.

%FILL[<start | end>,<text>,<filler>, <max length>]%

Dadurch wird der <Text> mit einem bestimmten <Füller> gefüllt. Der erste Parameter ist entweder Anfang oder Ende, je nachdem, ob die Füllung dem Text vorangestellt oder angehängt werden soll. Der Parameter max length

gibt die maximale Anzahl der Zeichen an, die das Ergebnis haben wird.

Beispiel) Bei Verwendung von %FILL [start,12345,0,10]% ergibt 0000012345

%FILTER_NAME%

Der Name des Filters im aktuellen Kontext, in dem das Makro ausgewertet wird.

%FOLDER_FILE_COUNT[<path>]%

Dieses Makro überprüft einen bestimmten Ordner (Disk-Ordner, der auf dem Corbit-Server verfügbar ist), zählt alle Dateien in diesem Ordner und gibt die Anzahl zurück.

Das Ergebnis ist die Anzahl der nicht versteckten Dateien (mit Ausnahme von Ordnern), die sich direkt im Ordner befinden.

%FOLDER_SIZE[<path>]%

Dieses Makro überprüft einen bestimmten Ordner (Disk-Ordner, der auf dem Corbit-Server verfügbar ist), zählt die Bytes aller Dateien, einschließlich Unterordner, und gibt die Anzahl zurück.

Das Ergebnis ist die Byteanzahl der nicht versteckten Dateien (einschließlich Unterordner), die sich im Ordner befinden.

%FOR_EACH_IN_LIST[key,tmpKey,macro]%

Dieses Makro wirkt auf jedes Element in einer Bereichsliste.

Der Schlüsselparameter ist der Bereichsschlüssel, der aktuell eine Liste von Werten enthält (z. B. aus einer Datenbanksuche).

Der Parameter tmpKey kann ein beliebiger Wert sein und wird verwendet, um jeden Eintrag in der Bereichsliste zu platzieren, um das auszuführen, was im Makro-Parameter eingestellt ist. Stellen Sie sicher, dass Sie einen eindeutigen Wert für den Parameter tmpKey verwenden.

Der letzte Parameter, macro, kann ein beliebiger Makro- oder ein statischer Text sein. Jeder Eintrag in der Bereichsliste wird auf das Ergebnis dieses Makroparameters gesetzt.

Beispiel:

Wir gehen davon aus, dass wir eine Datenbanksuche haben, bei der wir eine Liste von Werten in der Bereichs-Key dbResult-list gespeichert haben. Lassen Sie uns weiter davon ausgehen, dass die Werte in dieser Liste eine Reihe von Datumsangaben im Format yyyy-MM-dd sind und wir wollen dieses Format auf jedes Element in der Liste in das neue Format dd/MM/yyyy ändern.

Bei der Verwendung dieses Makros müssen wir sicherstellen, dass der temporäre Schlüssel, den wir spezifizieren, eindeutig ist, oder wir können einen aktuellen Bereichsschlüssel auf einen Fehlerwert setzen. In diesem Fall verwenden wir die Bezeichnung tmpValue.

Das resultierende Makro ist (der letzte Parameter, das Makro, ist zur Verdeutlichung fett gedruckt)

%FOR_EACH_IN_LIST[dbResult-Liste,tmpValue,%FORMAT_DATE[%BUCKET[tmpValue]%,yyyy-MM-dd,dd/MM/yyyy]%]%

 

%FORMAT_DATE[<text>,<from>,<to>]%

Dieses Makro wird verwendet, um einen Text von einem Datumsformat in ein anderes zu konvertieren. Für die verschiedenen Musterzeichen, siehe das Makro %D%.

Der <text> ist das Quelldatum, das im Format <from> angegeben ist. Das Ergebnis ist das gleiche Datum, das im Format <to> angegeben ist.

%FREE_INDEX%

Dieses Makro ist ein spezielles Makro, das nur innerhalb des Makros %DUPLICATE_FILE_EXTRA[...]% verwendet wird.

Dieses Makro gibt den ersten freien Index in einem Szenario mit doppelten Dateien zurück.

%HTML_ENCODE[<text>]%

Gibt einen HTML-formatierten Text zurück, der auf dem <text> basiert. Entitäten wie z. B. ä werden anstelle von ä und so weiter verwendet.

%IMAGE_HEIGHT[<format>]%

Gibt die Bildhöhe der aktuell bearbeiteten Bilddatei zurück (falls vorhanden). Der Format-Parameter ist optional und kann entweder mm oder px sein, was zu der in Millimetern und Pixeln angegebenen Bildhöhe führt. Wenn der Formatparameter nicht vorhanden ist (mit %IMAGE_HEIGHT%), wird die Höhe in Pixeln zurückgegeben.

%IMAGE_WIDTH[<format>]%

Gibt die Bildbreite der aktuell bearbeiteten Bilddatei zurück (falls vorhanden). Der Format-Parameter ist optional und kann entweder mm oder px sein, was zu der in Millimetern und Pixeln angegebenen Bildbreite führt. Wenn der Formatparameter nicht vorhanden ist (mit %IMAGE_WIDTH%), wird die Breite in Pixeln zurückgegeben.

%INDEX%

Spezielles Makro, das bei der PDF-Split-Aktion verwendet wird, bei der der aktuelle Index des gesplitteten PDFs z. B. für den resultierenden Dateinamen verwendet werden kann.

%INDEX_OF[<s>,<t>,<start>]%

Der Text <s> wird durchsucht und der Index des ersten Auftretens von <t> zurückgegeben. Der Index ist nullbasiert, d. h., wenn <s> mit <t> beginnt, ist der zurückgegebene Index „0“. Wenn das <t> nicht in <s> gefunden wird, wird -1 zurückgegeben.

Sowohl <s> als auch <t> können selbst Makrotext enthalten.

Wenn der optionale Parameter <start> vorhanden ist, ist dies der Start-Index im Text, von dem aus die Suche gestartet wird. Ein Auftreten von <t> vor diesem Index wird nicht gezählt. Der <start> Index ist nullbasiert, d. h. das erste Zeichen in <s> hat den Index 0 (null).

%IPTC[<no>]%

Wenn es sich bei dem zu behandelnden Objekt um ein Bild mit IPTC-Informationen handelt, werden die IPTC-Informationen zurückgegeben, die in der IPTC field-Nummer <no> gefunden wurden.

PS: Dies wird nur von den regulären IPTC-Informationen gelesen, nicht von den XMP-Informationen. Für XMP-Daten können Sie das XMP-Makro verwenden.

%LAST_INDEX_OF[<s>,<t>,<start>]%

Der Text <s> wird durchsucht und der Index des letzten Auftretens von <t> zurückgegeben. Der Index ist nullbasiert, d. h., wenn <s> mit <t> beginnt, ist der zurückgegebene Index „0“. Wenn das <t> nicht in <s> gefunden wird, wird -1 zurückgegeben.

Sowohl <s> als auch <t> können selbst Makrotext enthalten.

Wenn der optionale Parameter <start> vorhanden ist, ist dies der Index im Text, von dem aus die Suche gestartet wird (vom Ende aus gesehen). Ein Auftreten von <t> nach diesem Index wird nicht gezählt. Der <start> Index ist nullbasiert, d. h. das erste Zeichen in <s> hat den Index 0 (null).

%LENGTH[<text>]%

Gibt die Länge des <Textes> zurück. Die Anzahl der Zeichen in <text> wird gezählt und zurückgegeben.

Dieses Makro kann sehr nützlich sein, z. B. in einem Ausdruck, siehe Makro CASE für weitere Informationen.

%LOWER[<text>]%

Der Rückgabewert ist <text>, wobei jedes Zeichen im Rückgabewert in Kleinbuchstaben angegeben ist.

%MATH[<math command>, <leftExpression>, <rightExpression>, <decimals>]%

Dies ruft den mathematischen Ausdruck <math command> für <leftExpression> und <rightExpression> auf. Die zurückgegebene Zahl hat die maximale Dezimalzahl, die im Parameter <decimals> angegeben ist. Die <leftExpression> und <rightExpression> können Zahlen enthalten (möglicherweise aus anderen Makros).

Der Parameter <decimals> ist optional. Wenn <decimals> weggelassen wird, sollte auch das letzte Komma weggelassen werden.

Der <math command> kann einer der folgenden sein;

Math command Beschreibung
+ Fügt <leftExpression> mit <rightExpression> hinzu, z. B. %MATH[+, 12, 3]% gibt '15' zurück.
- Subtrahiert <leftExpression> mit <rightExpression>, z. B. %MATH[-, 12, 3]% gibt '9' zurück.
* Multipliziert <leftExpression> und <rightExpression>, z. B. %MATH[*, 12, 3]% gibt '36' zurück.
/ Dividiert <leftExpression> durch <rightExpression>, z. B. %MATH[+, 12, 3]% gibt '4' zurück.

%META[<id>]%

Dieses Makro wird derzeit nicht in Corbit verwendet.

%MOD%

%MOD[<format>]%

%MOD[+<d>,<format>]%

%MOD[-<d>,<format>]%

Beachten Sie, dass dieses Makro nur in dem Kontext nützlich ist, in dem eine Datei referenziert wird.

Das Makro gibt die Änderungszeit für die aktuell referenzierte Datei zurück. Die Varianten für das Makro folgen dem D-Makro, wo weitere Informationen zu den verschiedenen Parametern zu finden sind.

%MOD_TIME%

%MOD_TIME[<path>]%

Ruft die Änderungszeit einer Datei in Millisekunden ab.

Die Standardversion erhält die Änderungszeit aus der aktuellen Datei im Umfang. Die Alternative ist, einen Dateipfad als Parameter zu übergeben, der die Änderungszeit der Datei ermittelt.

%MP3_ALBUM%

Wenn das zu behandelnde Objekt ID3-Tags enthält, wird der Wert aus dem Album-Tag zurückgegeben.

%MP3_ARTIST%

Wenn das zu bearbeitende Objekt ID3-Tags enthält, wird der Wert aus dem Künstler-Tag zurückgegeben.

%MP3_COMMENT%

Wenn das zu behandelnde Objekt ID3-Tags enthält, wird der Wert aus dem Kommentar-Tag zurückgegeben.

%MP3_GENRE%

Wenn das zu behandelnde Objekt ID3-Tags enthält, wird der Wert aus dem Genre-Tag zurückgegeben.

%MP3_TITLE%

Wenn das zu behandelnde Objekt ID3-Tags enthält, wird der Wert aus dem Titel-Tag zurückgegeben.

%MP3_TRACK%

Wenn das zu behandelnde Objekt ID3-Tags enthält, wird der Wert aus dem Spur-Tag zurückgegeben.

%MP3_TRACKCOUNT%

Wenn das zu behandelnde Objekt ID3-Tags enthält, wird der Wert aus dem Spurzahl-Tag zurückgegeben.

%MP3_YEAR%

Wenn das zu behandelnde Objekt ID3-Tags enthält, wird der Wert aus dem Jahr-Tag zurückgegeben.

%NR[<text>]%

Der zurückgegebene Wert ist <text>, wobei jeder Wagenrücklauf und jeder Zeilenvorschub entfernt wird. Der Wagenrücklauf wird durch ein Leerzeichen ersetzt, wenn vor dem Wagenrücklauf kein Leerzeichen vorhanden ist. Das bedeutet, dass selbst bei mehreren Zeilenumbrüchen, die im Originaltext unmittelbar aufeinander folgen, diese nur durch maximal ein Leerzeichen ersetzt werden.

%PF%

Beachten Sie, dass dieses Makro nur in dem Kontext nützlich ist, in dem eine einzelne Datei referenziert wird.

Dieses Makro ähnelt dem F-Makro, aber der Name wird aus dem übergeordneten Ordner übernommen. Alle Varianten des Makros, die auf das F-Makro anwendbar sind, stehen auch für dieses Makro zur Verfügung.

%REPLACE_ALL[<s>,<source>,<target>]%

Gibt eine modifizierte Version von <s> zurück, in der alle Vorkommen von <source> durch <target> ersetzt werden.

Regulärer Ausdruck

<source> ist ein regulärer Ausdruck, also verwenden Sie dieses Makro mit Vorsicht. Stellen Sie sicher, dass Sie mit regulären Ausdrücken in Java vertraut
sind, bevor Sie dieses Makro verwenden.

%SET_BUCKET[<key>,<value>]%

%SET_BUCKET[<type>,<key>,<value>]%

type kann "Objekt", "Workflow" oder "System" sein ("Objekt" ist Standard, d.h. die Makrovariante ohne type bedeutet, dass Objekt als Typ verwendet wird).
key ist der Schlüssel, und Wert ist der Wert. Dieses Makro setzt dann einen Bucket-Wert (ähnlich wie eine Bucket-Aktion)

%SEPARATE[<name>,<text>,<delimiter(s)>,<handling>]%

Dieses Makro trennt einen Quelltext (die Quelle muss mit einem oder mehreren Trennzeichen strukturiert sein).
Parameter:

name Der Name ist nützlich, wenn mehrere Trennungen ineinander verarbeitet werden, da der Name ein Identifikator für diesen speziellen Trennungsprozess ist. Siehe andere Trennmakros, bei denen der Name als Parameter verwendet werden kann, z. B. %SEPROWNUM[Name]%
text Der Quelltext, der getrennt wird
delimiter(s) Ein oder mehrere (falls mehrere, durch Kommas getrennt) Trennzeichen, die zur Trennung des Textes verwendet werden.
handling So wird jeder einzelne getrennte Wert behandelt werden.

%SEPARATE_BY_ROW[<firstRowHeader>,<name>,<text>,<delimiter(s)>,<handling>]%

Sehr ähnlich wie %SEPARATE[...]%, aber dieses Makro funktioniert mit mehreren Zeilen. Jede Behandlung erfolgt für jede Zeile und Spalte, und es können Makros wie %SEPROWNUM% verwendet werden.


Parameter:
firstRowHeader Dieser Wert sollte "true" sein, wenn die erste Zeile des Textes als Überschriftszeile verwendet werden soll. Die Überschriftswerte können in anderen Makros in der Behandlung verwendet werden, zum Beispiel %SEPHEADER%
name Der Name ist nützlich, wenn mehrere Trennungen ineinander verarbeitet werden, da der Name ein Identifikator für diesen speziellen Trennungsprozess ist. Siehe andere Trennmakros, bei denen der Name als Parameter verwendet werden kann, z. B. %SEPROWNUM[Name]%/td>
text Der Quelltext der getrennt wird
delimiter(s) Ein oder mehrere (falls mehrere, durch Kommas getrennt) Trennzeichen, die zur Trennung des Textes verwendet werden.
handling So wird jeder einzelne getrennte Wert behandelt werden.

%SEPROWNUM%
%SEPROWNUM[<name>]%

Dieses Makro gibt die aktuelle Zeilennummer zurück (die erste Zeile hat die Zeilennummer 1).
Das ist nur sinnvoll, wenn es im Rahmen der Behandlung von %SEPARATE_BY_ROW[...]% oder %CSV_PARSE_ROWS[...]% vorhanden ist.
Wenn die Trennmakros verschachtelt sind, kann der Parameter name verwendet werden, um die Daten aus der spezifisch benannten Trennung zu erhalten.

%SEPCOLNUM%
%SEPCOLNUM[<name>]%

Dieses Makro gibt die aktuelle Spaltennummer zurück (die erste Spalte hat die Spaltennummer 1).
Dies ist nur sinnvoll, wenn es im Rahmen der Bearbeitung von %SEPARATE_BY_ROW[...]% oder %CSV_PARSE_ROWS[...]% vorhanden ist.
Wenn die Trennmakros verschachtelt sind, kann der Parameter name verwendet werden, um die Daten aus der spezifisch benannten Trennung zu erhalten

%SEPVALUE%
%SEPVALUE[<name>]%

Dieses Makro gibt den aktuellen Wert im Bereich... zurück Dies ist nur sinnvoll, wenn es im Rahmen der Bearbeitung von %SEPARATE_BY_ROW[...]% oder %CSV_PARSE_ROWS[...]% vorhanden ist.
Wenn die Trennmakros verschachtelt sind, kann der Parameter name verwendet werden, um die Daten aus der spezifisch benannten Trennung zu erhalten.

%SEPHEADER%

%SEPHEADER[<column index>]%

%SEPHEADER[<name>,<column index>]%

Dieses Makro gibt einen Überschriftswert zurück (den Namen der Überschrift, wenn Überschriften vorhanden sind). Wenn Sie das Makro ohne Parameter verwenden, wird der Wert der aktuellen Spaltenüberschrift zurückgegeben.
Wenn der Parameter column index (Spaltenindex) vorhanden ist, wird die Überschrift für diese bestimmte Spalte (die Spalten sind von 1 an nummeriert) zurückgegeben.
Wenn die Trennmakros verschachtelt sind, kann der Parameter name verwendet werden, um die Daten aus der spezifisch benannten Trennung zu erhalten.

%SEPROWVALUE_BY_COL[<column index>]%

%SEPROWVALUE_BY_COL[<name>,<column index>]%

Dieses Makro ist ähnlich wie %SEPVALUE[...]%, aber dieses Makro gibt den Wert eines beliebigen Spaltenindexes in der aktuellen Zeile zurück. Dieses Makro kann nützlich sein, wenn die Behandlung der aktuellen Spalte von einem anderen Wert in derselben Zeile abhängig ist.


Parameter:
column index Der Index der Spalte, deren Wert gesucht wird. Der Spaltenindex beginnt bei 1.
name Der Name ist nützlich, wenn dieses Makro innerhalb verschachtelter SEPARATE-Makros verwendet wird. In einer solchen Umgebung ist der Name eine Kennung für die Trennungszeile, für die der Wert gesucht wird.

%SEPROWVALUE_BY_HEADER[<header>]%

%SEPROWVALUE_BY_HEADER[<name>,<header>]%

Dieses Makro ist ähnlich wie %SEPVALUE[...]%, aber dieses Makro gibt den Wert einer beliebigen Überschrift in der aktuellen Zeile zurück. Dieses Makro kann nützlich sein, wenn die Bearbeitung der aktuellen Spalte von einem anderen Wert in derselben Zeile abhängig ist.


Parameters:
header Der Name der Überschrift der Spalte, deren Wert gesucht wird.
name Der Name ist nützlich, wenn dieses Makro innerhalb verschachtelter SEPARATE-Makros verwendet wird. In einer solchen Umgebung ist der Name eine Kennung für die Trennungszeile, für die der Wert gesucht wird.

%SFN[<text>]%

Safe File Name - Dies gibt den <text> zurück, wobei alle Vorkommen der folgenden Zeichen durch Unterstrich (_) ersetzt werden;

Zeichen Name des Zeichens
? Fragezeichen
" Doppelte Anführungszeichen
! Ausrufezeichen
& Kaufmännisches Und
/ Schrägstrich
\ Rückwärtsschrägstrich
: Doppelpunkt
. Punkt. Nur wenn der Name mit einem Punkt beginnt, wird auch dieser Punkt ersetzt, andere Punkte innerhalb des Dateinamens werden nicht ersetzt.

%SOURCE_FILE_EXISTS[<path>]%

Mit diesem Makro kann überprüft werden, ob eine bestimmte Datei existiert. Das Makro verwendet die spezifische Quelle im Bereich des Makros, um die Datei zu finden. Wenn es sich bei dieser Quelle um eine FTP-Quelle handelt, wird der FTP-Server auf die gewünschte Datei überprüft.

Im Vergleich zum Makro %DATEI_VORHANDEN[...]% kann dieses Makro auch in einem FTP-Quellkontext verwendet werden, um zu überprüfen, ob eine bestimmte Datei auf dem FTP-Server existiert.

%SOURCE_FOLDER_FILE_COUNT[<path>]%

Dieses Makro überprüft einen bestimmten Ordner, der sich auf der Quelle befindet, zählt alle Dateien in diesem Ordner und gibt die Anzahl zurück.

Das Ergebnis ist die Anzahl der nicht versteckten Dateien (mit Ausnahme von Ordnern), die sich direkt im Ordner befinden. Das Makro verwendet die spezifische Quelle im Bereich des Makros, um die Datei zu finden. Wenn es sich bei dieser Quelle um eine FTP-Quelle handelt, wird der FTP-Server auf die gewünschte Datei überprüft.

Im Vergleich zum Makro %ANZAHL_DATEIEN_ORDNER[...]% kann dieses Makro auch in einem FTP-Quellkontext verwendet werden, um die Anzahl vom FTP-Server zu erhalten.

%SOURCE_NAME%

Der Name der Quelle, die die aufrufende Quelle des Objekts im aktuellen Kontext ist, in dem das Makro ausgewertet wird.

%Workflow_BUCKET[<key>]%

Ruft einen Wert aus dem Bereich des aktuellen Workflow ab. Der Workflow-Bereich ist ein statischer Bereich, der Informationen enthält, die im Workflow verbleiben, solange der Workflow existiert. Dieser Bereich unterscheidet sich von dem Objektbereich, der mit dem Makro %BUCKET[...]% verwendet wird.

Lesen Sie mehr über die verschiedenen Bereiche in Kapitel 2.

%Workflow_NAME%

Der Name des Workflows im aktuellen Kontext, in dem das Makro ausgewertet wird.

%STRIP[<text>]%

Spezielles Makro, das alle Zeichen außer denjenigen in der Liste unten durch einen Unterstrich (_)

ersetzt, wobei die Zeichen unverändert bleiben:

. (Punkt)

- (Bindestrich)

_ (Unterstrich)

0-9 (Zahlen)

a-z

(Zeichen a bis z) A-Z (Zeichen A bis Z)

%SUBSTRING[<s>,<start>,<end>]%

Gibt einen Teil des Quell-Strings <s> zurück. Der Anteil wird vom Index <Start> (eingeschlossen) genommen und endet am Index <Ende> (nicht eingeschlossen). Wenn <end> fehlt, wird der Rest der Zeichenkette von Anfang an übernommen. Wenn <start> fehlt, wird die Teilzeichenkette von Anfang an übernommen. Die Indizes sind nullbasiert, d. h. das erste Zeichen in <s> hat die Nummer 0.

Beachten Sie, dass, wenn <start> und/oder <end> weggelassen wird, die Kommas immer noch vorhanden sein müssen.

%SXML[<text>]%

Gibt eine modifizierte Version von <text> zurück. Der Rückgabewert ist darauf spezialisiert, in XML-Dokumente zu passen, in denen Zeichen durch Entitäten ersetzt werden, z. B. wird 'å' durch ersetzt 'å' . Zeichen mit einer UTF-Zeichennummer von mehr als 128 werden durch die Entität '&#<no>;' ersetzt, wobei <no> den UTF-Wert des Zeichens repräsentiert.

Der String <text> kann Makros enthalten.

%TRIM[<text>]%

Das Ergebnis dieses Makros ist der Textparameter ohne Leerzeichen vor und nach dem eigentlichen Text. Leerzeichen, die entfernt werden, umfassen Leerzeichen, Tabulatoren, Wagenrücklauf und Zeilenvorschub.

%UPPER[<text>]%

Der Rückgabewert ist <text>, wobei jedes Zeichen im Rückgabewert in Großbuchstaben angegeben ist.

%UUID%

Der zurückgegebene Wert ist eine eindeutige ID.

%XMP[<xmpID>]%
%XMP[<xmpID>, filePath]%

Die XMP-Daten aus der Datei werden gelesen und der Wert aus der angegebenen xmpID zurückgegeben.

Die xmpID ist ein Identifikator, der für jede XMP-Datei eindeutig ist. Die Bezeichner der standardmäßigen XMP-Datenfelder können als Tooltip in den speziellen XMP-Popupmenüs, die im Setup verfügbar sind, angesehen werden. Benutzerdefinierte XMP-Daten haben einen eigenen Identifikator, der bei der Erstellung festgelegt wird und vom Benutzer ausgewählt wird. Die xmpID ist das XMP-Präfix, gefolgt von einem Doppelpunkt und dem Namen des Eigenschaftsfelds, z. B. tiff:Compression

Der zurückgegebene Wert ist immer eine String-Darstellung, auch wenn der Wert ein Datum oder ein anderes Objekt sein kann.

Wenn kein Dateipfad-Parameter angegeben wird, wird die Datei gelesen, die sich gerade im Umfang des Makros befindet, andernfalls die Datei, die durch den Dateipfad angegeben wird.

%XPATH[string, xpath expression,prefix=URI,prefix=URI,...]%

Dieses Makro berechnet einen XPath-Ausdruck aus dem angegebenen String (XML-Format). Das zurückgegebene Ergebnis ist ein String, der das Ergebnis des XPath-Ausdrucks darstellt.

Der Parameter-string ist der XML-String, auf dem der XPath-Ausdruck berechnet wird.

Nur die Parameter string und xpath expression sind obligatorisch, der Rest der Parameter ist optional und falls vorhanden, sollten sie alle die folgende Struktur haben: prefix=URI. Diese Parameter werden verwendet, um Namensbereich im XML-String zu identifizieren, das Präfix ist das Namensbereich-Präfix und der URI ist der Namensbereich-URI. Beispielsweise hätte der IPTC-Core-Namensbereich den folgenden Wert: Iptc4xmpCore=http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/

Weitere Informationen über gültige XPath Ausdrücke finden Sie unterhttp://docs.oracle.com/javase/tutorial/jaxp/xslt/xpath.html

%XPATHEL[string, xpath expression,prefix=URI,prefix=URI,...]%

Ähnelt sehr dem XPATH-Makro. Das Ergebnis dieses XPath-Ausdrucks wird als Knotenwert genommen und das Ergebnis ist dieser Knoten als XML im Vergleich zum XPATH-Makro, das das Ergebnis zu einem String-Wert zwingt.

Die Parameter sind die gleichen wie beim XPATH-Makro.

Weitere Informationen über gültige XPath Ausdrücke finden Sie unterhttp://docs.oracle.com/javase/tutorial/jaxp/xslt/xpath.html

%XPATHLIST[string, xpath expression, bucket key, prefix=URI,prefix=URI,...]%

Dieses Makro berechnet einen XPath-Ausdruck aus dem angegebenen String (XML-Format). Das zurückgegebene Ergebnis ist eine Liste von Werten und wird mit dem angegebenen Schlüssel im aktuellen Bereich gespeichert.

Der Parameter-string ist der XML-String, auf dem der XPath-Ausdruck berechnet wird.

Nur die Parameter string und bucket key sind obligatorisch, der Rest der Parameter ist optional und falls vorhanden, sollten sie alle die folgende Struktur haben: prefix=URI. Diese Parameter werden verwendet, um Namensbereich im XML-String zu identifizieren, das Präfix ist das Namensbereich-Präfix und der URI ist der Namensbereich-URI. Beispielsweise hätte der IPTC-Core-Namensbereich den folgenden Wert: Iptc4xmpCore=http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/

Die Liste, die in den Bereichs-Key gestellt wird, kann in anderen speziellen Makros verwendet werden, z. B. %BUCKET_LIST[...]%.

Weitere Informationen über gültige XPath Ausdrücke finden Sie unterhttp://docs.oracle.com/javase/tutorial/jaxp/xslt/xpath.html

%ZIPF%

Beachten Sie, dass dieses Makro nur in dem Kontext nützlich ist, in dem eine Zip-Datei referenziert wird.

Dieses Makro ähnelt dem F-Makro, aber der Name wird aus der ZIP-Datei übernommen (z. B. in der Entpackungsaktion, bei der %F% den Namen der entpackten Datei angibt, während %ZIPF% den ursprünglichen Namen der gezippten Datei angibt). Alle Varianten des Makros, die auf das F-Makro anwendbar sind, stehen auch für dieses Makro zur Verfügung.

%SYSTEM_BUCKET[key]%

Dies wird den Wert aus dem Systembereich mit dem Namen 'key' erhalten.

%DATE_CHANGE[date,format,unit,amount,resultFormat]%

Datum: Originaldatum / -uhrzeit, z. B. 2017-12-13
Format: Das Format, das 'date' hat, wie yyyy-MM-dd, siehe% D% für alle Formateinheiten
: Eines derFolgenden: Tag', 'Stunde', 'Minute' oder 'Sekunde''
Betrag: Anzahl der 'Einheit', die addiert oder abgezogen werden soll
Ergebnisformat: Das gewünschte Format für das Enddatum / die Endzeit
ex% DATE_CHANGE [2017-12-13, yyyy-MM-dd, day, 11, dd / MM-yyyy]% will give '24 / 12-2017 '

%JSON[json,wanted]%

Analysiert einen Json-Text, um eine Eigenschaft zu erhalten. Json: Ein gewünschter json-formatierter Text: Die gewünschte Eigenschaft aus dem Json

%REMOVE_BOM[text]%

Dadurch wird jedes Byte Order Mark (BOM)-Zeichen aus dem Parameter "Text" entfernt.

%SFN2[text,replacement]%

Ersetzt den Parameter 'text' durch 'replacement', wenn es ein Zeichen gibt, das für einen Dateinamen nicht geeignet ist. Folgende Zeichen werden entfernt:
Alle Zeichen mit ASCII-Code <32
char 34 (")
char 38 (& )
char 39 (')
char 42 (* )
char 47 (/)
char 58 (: )
char 59 (; )
char 60 (<)
char 62 (>)
char 63 (?)
char 92 (\)
char 124 (|)
und jedes Zeichen zwischen 57344 und 63743
char 65533 (Unicode-Ersatzzeichen)
+ jedes andere Zeichen, das undefiniert ist

Beachten Sie, dass, wenn die Ersetzung fehlt, die Standardersetzung leer ist (z. B. werden die unzulässigen Zeichen entfernt werden und kein Ersatzzeichen haben).

%URL_ENCODE[text]%

Übersetzt 'Text' in das Format application/x-wwww-form-urlencoded. Alle '+'-Zeichen werden ebenfalls in '%20' kodiert.

%XPATHLISTEL[string, xpath expression,bucketKey,prefix=URI,prefix=URI,...]%

Ähnelt XPATHLIST sehr. Das Ergebnis bucketKey wird mit einer Liste statt mit Text gefüllt. Somit ist die Verwendung von Listenmakros nach diesem Makro möglich, z. B. BUCKET_LIST.