sol.common.ix.functions.Move

Verschiebt ein ELO-Dokument in einen anderen Ordner – per Pfad, relativer Pfadangabe oder dynamisch ermittelter Ziel-ID aus einem MAP-Feld.

📖 Herstellerdokumentation

---

Parameter

Parameter	Typ	Pflicht	Beschreibung
objId	string	❌	GUID oder numerische ID des Dokuments – entfällt im WF-Kontext
path	string	❌	Zielpfad mit ¶ als Trennzeichen – unterstützt Handlebars
relative	boolean	❌	true – Pfad wird relativ zum aktuellen Ablageort aufgelöst
targetIdFromMap	string	❌	Name eines MAP-Felds das die Ziel-ID enthält (z. B. aus vorherigem Set-Schritt)
refOldParentId	boolean	❌	true – hinterlässt eine Referenz im ursprünglichen Elternordner
useTemplating	boolean	❌	Handlebars in path aktivieren – Standard: false

---

Beispiele

Dokument in Userbox verschieben (Ziel-ID aus MAP)

Da Move keine Unterpfade unterhalb einer Userbox unterstützt, wird die Ziel-ID in einem vorgelagerten Set-Schritt per OKEY-Suche ermittelt und in einem MAP-Feld zwischengespeichert.

Schritt 1 – Userbox-Pfad in MAP vorbereiten (sol.common.ix.functions.Set):

{
  "entries": [{
    "type": "MAP",
    "key": "USERBOXPATH",
    "value": "OKEY:ELOUSERID={{sord.objKeys.POST_ANWENDERID}}",
    "useTemplating": true
  }]
}

Schritt 2 – Dokument in die Userbox verschieben (sol.common.ix.functions.Move):

{
  "targetIdFromMap": "USERBOXPATH"
}

---

In Unterordner relativ zum aktuellen Ort verschieben

Legt das Dokument in einen Unterordner Posteingang/YYYY/MM/DD relativ zum aktuellen Ablageordner ab. Der Ordner wird automatisch erstellt wenn er nicht existiert.

{
  "path": "¶Posteingang¶{{formatDate 'YYYY¶MM¶DD' sord.IDateIso}}",
  "relative": true,
  "useTemplating": true
}

---

Verschieben und Referenz im Ausgangsordner hinterlassen

Verschiebt das Dokument in den Abteilungsposteingang und hinterlässt im ursprünglichen Ordner eine Referenz.

{
  "path": "¶Posteingang¶{{sord.objKeys.POST_ABTEILUNG}}¶{{formatDate 'YYYY¶MM¶DD' sord.IDateIso}}",
  "refOldParentId": true,
  "useTemplating": true
}

---

Vollständiger Workflow: Dokument in Benutzerordner-Unterordner ablegen

Typisches Muster wenn ein Dokument in den persönlichen Posteingang eines Anwenders verschoben werden soll – da Userboxen keine direkte Unterpfad-Navigation unterstützen, sind zwei Move-Schritte nötig:

Schritt	Funktion	Beschreibung
1	Set	Userbox-Pfad per OKEY-Suche in MAP schreiben
2	Move	Dokument in die Userbox verschieben (targetIdFromMap)
3	Move	In Unterordner verschieben (path + relative: true)
4	Move	An endgültigen Ort + Referenz im Ausgangsordner (refOldParentId: true)

---

Hinweise

• ¶ ist das ELO-Pfadtrennzeichen (entspricht / im Dateisystem)
• relative: true eignet sich um Unterordnerstrukturen unterhalb des aktuellen Ablageorts zu erstellen ohne den absoluten Pfad kennen zu müssen
• targetIdFromMap benötigt einen vorgelagerten Set-Schritt der die ID ins MAP-Feld schreibt
• refOldParentId: true ist nützlich wenn das Dokument im ursprünglichen Kontext noch auffindbar bleiben soll
• Wird typischerweise aus onExitNode eines Workflow-Nodes aufgerufen – dann ist objId nicht nötig