KISS Makroaktionen in CMS
- 1 Definition “Makro”
- 2 Artikel Makro (articleMacro)
- 3 Artikel Makro Aktionen
- 4 Beispiele komplette Makro:
- 5 Beispiele Makro-Aktionen (alphabetisch sortiert)
- 5.1 Autor
- 5.2 Aufgaben
- 5.3 Datumsformate
- 5.4 Assets
- 5.5 Beschreibung
- 5.6 Dynamische Attribute setzen
- 5.7 Hinweis
- 5.8 Kanäle
- 5.9 Komponenten
- 5.10 Notiz
- 5.11 Fertig bis
- 5.12 Name
- 5.13 Orte
- 5.14 Personen
- 5.15 Ressorts
- 5.16 Speichern
- 5.17 Stichwörter
Definition “Makro”
Ein Makro ist eine Sammlung von Aktionen die sich auf ein bestimmtes CMS Objekt (zB einen Artikel, eine News, ein Thema oä.) beziehen.
Parameter | Anmerkung |
|---|---|
type: string → “articleMacro“, “themeMacro“ initAction: InitAction actions: Action[] |
initAction: (Quelle des Makros). actions: Aktionen, passend zum type des Makros |
Artikel Makro (articleMacro)
Das Artikelmakro ist eine Sammlung von einer oder mehrerer Aktionen auf einem bestimmten - oder einem neuen Artikel.
Parameter | Anmerkung |
|---|---|
initAction: InitAction
| initAction: (Quelle des Makros).
|
actions: ArticleAction[] | actions: Artikel Aktionen |
Artikel Makro Aktionen
type und mit * gekennzeichnete Parameter sind erforderlich
Aktion Typ | Funktion | type | Parameter | Beispiel | Anmerkungen |
|---|---|---|---|---|---|
SetDescriptionArticleAction | Beschreibung setzen | setDescription | value: string |
| |
|
|
|
|
|
|
SetDynAttribArticleAction | dynamisches Attribut setzen | setDynAttrib | key: string * value: string | Key und gewünschter Wert des Dynattributes. Datum dynamische Attribs haben als value ein Datum in folgenden Format: value : “
Boolean dynamische Attribs haben als value: value : “true” oder “false”
Tag-Felder dynamische Attribs haben als value: value : "[\"Konfig-Key1\", \"Konfig-Key2\"]”
Combobox-Felder dynamische Attribs haben als value: value: “Konfig-Key“
| |
|
|
|
|
|
|
SetPlanningHintArticleAction | Planungshinweis setzen | setPlanningHint | value: string | https://hup-company.atlassian.net/wiki/spaces/PSCx/pages/464060743/KISS+Makroaktionen+in+CMS#Hinweis |
|
|
|
|
|
|
|
AddExportPointsArticleAction | Exportkanäle hinzufügen | addExportPoints | values: string[] * | Liste von Exportkanalnamen | |
RemoveExportPointsArticleAction | Exportkanäle entfernen | removeExportPoints | |||
SetExportPointsArticleAction | ExportKanäle setzen | setExportPoints | |||
|
|
|
|
|
|
AddContentPartArticleAction | Contentpart hinzufügen | addContentPart | name: string * value: string (legacy) structuredValue: Json-Objekt exportPoints: List<String> |
structuredValue hat eine höhere Priorität | |
RemoveContentPartArticleAction | Contentpart entfernen | removeContentPart | name: string * scope: string * | scope: “ALL“, “FIRST“, “EMPTY”
| |
SetContentPartValueArticleAction | Wert in Contentpart setzen | setContentPartValue | name: string * value: string * scope: string * | scope: “ALL“, “FIRST“, “EMPTY” | |
MoveAllContentPartsArticleAction | ContentParts verschieben | moveContentParts | name: string * position: string * | position: “BEGINNING”, “END” | |
RemoveAllContentPartsArticleAction | Alle ContentParts löschen | removeAllContentParts |
|
|
|
RemoveAllEmptyContentPartsArticleAction | Leere ContentParts löschen | removeAllEmptyContentParts |
|
| |
AddAssetContentPartWithIdArticleAction | Asset ContentPart hinzufügen | addAssetContentPartWithId | assetId: string * name: string * source: string sourceType: string text: string title: string copyArticleMasterDataToAsset: boolean type: string exportPoints: List<String> | name = Komponente-Name (z.B. “picture”) In Smartbar Oberfläche kann man die folgenden Metadaten selber setzten: text, source, sourceType. Dafür musst man die Eigenschaft in der Textfeld so schreiben wie es in Browser angezeigt wird (Klein- und Großschreibung egal). z.B.: - Text: Beispiel Text - Quelle: Beispiel Quelle - Quellentyp: Beispiel Quellentyp
die Eigenschaft “copyArticleMasterDataToAsset” übernimmt die Metadaten des Artikels (Orte, Stichwörte und Autor) falls sie leer sind. Standardmäßig ist der Wert auf true gesetzt.
Um Exportkanäle zu setzen muss der Oberfläche Name des Kanals in eine Liste eingeben. Für Kein Kanal muss entweder eine Leere Liste eingegeben werden oder “#blocked”. Für alle Kanäle muss der Kanal “#all” eingetragen werden. | |
|
|
|
|
|
|
SetCompleteUntilArticleAction | setzt das “Fertig bis” Feldwert | setCompleteUntil | value: Date * | Formate:
| |
|
|
|
|
|
|
SetNameArticleAction | setzt der Artikelname | setName | value: string * |
| |
|
|
|
|
|
|
SetAuthorArticleAction | setzt der Autor | setAuthor | value: string * |
| |
|
|
|
|
|
|
AddLocationsArticleAction | fügt neue Orte hinzu | addLocations | values: string[] *
|
| |
RemoveLocationsArticleAction | löscht bestehende Orte | removeLocations |
| ||
SetLocationsArticleAction | ersetzt alle bestehende Orte mit die neuen | setLocations |
| ||
|
|
|
|
|
|
AddPersonsArticleAction | fügt neue Personen hinzu | addPersons | values: { firstName: string, lastName: string }[] * | jeder “value” ist ein JSON Objekt (eine Person mit “firstName” und “lastName”) | |
RemovePersonsArticleAction | löscht bestehende Personen | removePersons | |||
SetPersonsArticleAction | ersetzt alle bestehende Personen mit die neuen | setPersons | |||
|
|
|
|
|
|
AddDepartmentsArticleAction | fügt neue Ressorts hinzu | addDepartments | values: string[] * |
| |
RemoveDepartmentsArticleAction | löscht bestehende Ressorts | removeDepartments |
| ||
SetDepartmentsArticleAction | ersetzt alle bestehende Ressorts mit die neuen | setDepartments |
| ||
|
|
|
|
|
|
SaveArticleAction | speichert den Artikel | saveArticle |
|
| |
|
|
|
|
|
|
AddTagsArticleAction | fügt neue Stichwörter hinzu | addTags | values: string[] * |
| |
RemoveTagsArticleAction | löscht bestehende Stichwörter | removeTags |
| ||
SetTagsArticleAction | ersetzt alle bestehende Stichwörter mit die neuen | setTags |
| ||
|
|
|
|
|
|
CreateTaskArticleAction | erstellt eine neue Aufgabe und fügt diese einem Artikel hinzu | createTask | instruction: Instruction | Anmerkungen:
| |
|
|
|
|
|
|
AddNoteArticleAction | fügt einen Text an den Beginn einer Notiz für den im Makro aktiven Artikel ein | addNote | value: text | Whitespace am Ende des Text wird entfernt und es werden zwei Zeilenumbrüche eingefügt. |
Beispiele komplette Makro:
Einzelne Makro: Beispiel einzelne Makro
Mehreren Makros: Beispiel mehreren Makros
Beispiele Makro-Aktionen (alphabetisch sortiert)
Autor
Autor setzen
{
"value": "Thomas Müller",
"type": "setAuthor"
}
Aufgaben
Aufgabe zu einem Artikel erstellen
{
"type": "createTask",
"instruction": {
"type": "TEXT",
"amount": 10,
"textAmountUnit": "MZ",
"assigneeUserName": "xyz",
"hint": "der Hinweis",
"dateTime": "2025-10-28"
}
"humanReadableValue": "Aufgabe für xyz. Menge:10 MZ. Typ: Text."
}Datumsformate
yyyy-MM-dd'T'HH:mm:ss.SSSX
yyyy-MM-dd'T'HH:mm:ss.SSS
EEE, dd MMM yyyy HH:mm:ss zzz