PDF-Seiten und Dokumente über eigene UI organisieren

Interne ID: agorum.object.pdf.organize.ui

Mit diesem Knoten organisieren Sie PDF-Dateien über eine eigene Bedienoberfläche, etwa, indem Sie:

• Dokumente trennen
• Dokumente zusammenfügen
• Seiten im selben Dokument oder in ein neues Dokument verschieben
• Seiten im Dokument oder ganze Dokumente um 90 Grad links oder rechtsherum drehen

Verhaltensweise

---

Je nachdem, was Sie mit den PDF-Dateien machen, gelten verschiedene Verhaltensweisen:

Verhaltensweise beim Trennen von PDF-Dateien

Erreicht das System den Knoten im Workflow, prüft es die gesetzten Parameter. Der Knoten verarbeitet die PDF-Dateien, die sich zu diesem Zeitpunkt in der internen Variable sys_acw_attachments befinden. Beim Trennen setzt das System die Metadaten des ursprünglichen Objekts auf alle neu erzeugten PDF-Dateien.

Verhaltensweise beim Zusammenfügen von PDF-Dateien

Erreicht das System den Knoten im Workflow, prüft es die gesetzten Parameter. Der Knoten verarbeitet die PDF-Dateien, die sich zu diesem Zeitpunkt in der internen Variable sys_acw_attachments befinden. Beim Zusammenfügen übernimmt das System die Metadaten der ersten PDF-Datei und setzt die Metadaten auf die zusammengefügte PDF-Datei.

Beispiel

• Objekt1:
  • Kundennummer: 001
  • Kundenname: agorum
• Objekt2:
  • Kundennummer: 002
  • Kundenname: agorum AG
  • Bestellnummer:
• Neues Objekt:
  • Kundennummer: 001
  • Kundenname: agorum

Anwendungsbeispiel

---

Über eine Bedienoberfläche (Knoten UI) sollen Benutzer PDF-Dateien trennen und zusammenfügen können. Dazu existiert in diesem Beispiel der Knoten UI (Name: UITrennenZusammenfuegen) sowie der Knoten PDF-Seiten und Dokumente über eigene UI organisieren (Name: TrennenZusammenfuegen).

Im Knoten UITrennenZusammenfuegen fügen Sie über das Oberflächenscript eine Schaltfläche namens Trennen/Zusammenfügen ein:

{
  type: 'agorum.button',
  name: 'btnSplit',
  text: 'Trennen/Zusammenfügen',
  icon: 'aguila-icon view_module'
},

In der Aktion für den Ausgang split definieren Sie in diesem Knoten ein leave für diese Schaltfläche:

form.on('action', action => {
  switch (action.name) {
    ...
    case 'btnSplit':
      form.fire('leave', 'split');
      break;
   }
});

Klickt der Benutzer in der Bedienoberfläche des Knotens UITrennenZusammenfuegen auf die Schaltfläche Trennen/Zusammenfügen, ruft das System den Knoten TrennenZusammenfuegen auf, und es erscheint eine weitere Bedienoberfläche. Hier kann der Benutzer seine PDF-Dateien organisieren, indem er die Dateien über die Schaltflächen verschiebt, aufteilt oder zusammenfügt.

• Ist der Benutzer mit dem Organisieren der PDF-Dateien fertig, klickt er auf die Schaltfläche Änderungen anwenden. Der nächste Schritt im Workflow folgt, hier im Beispiel der Knoten UIEnde.
• Ein Klick auf Abbrechen führt den Benutzer wieder zur vorherigen Bedienoberfläche (Knoten UITrennenZusammenfuegen) zurück.

Endpoints

---

Standard	Veränderbar?	Weitere Endpoints möglich?
Default (Inlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig
ok (Outlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig
abort (Outlet)

Parameter

---

Parameter	Beschreibung	Beispiel
Name des Schritts	Definiert einen Namen, der im Workflow in den jeweiligen Listen erscheint, etwa im Protokoll (Log).	–
Beschreibung des Schritts	Definiert eine Beschreibung, der im Workflow in den jeweiligen Listen erscheint, etwa im Protokoll (Log).	–
Editier-Optionen: Schaltflächen aktivieren oder deaktivieren	Blendet folgende Schaltflächen an der Oberseite der Benutzereingaben ein oder aus, um PDF-Dateien zu organisieren: Diese Seite entfernen/wiederherstellen Ab hier trennen Mit nächstem Dokument zusammenfügen Zurück verschieben Vorwärts verschieben Dokument zurück verschieben Dokument vorwärts verschieben Dokument um 90 Grad nach links drehen Dokument um 90 Grad nach rechts drehen Der Benutzer kann alle Schaltflächen bearbeiten, die eingeblendet werden.	–
Datenvariable	(optional) Definiert eine Variable, in der sich zusätzliche Daten befinden. Diese Daten enthalten in der Objektnotation pro Eintrag eine UUID und darunter die konkreten Daten für den jeweiligen Anhang, wie es etwa der Knoten metadata.load speichert oder der Knoten metadata.save benötigt, wenn das System die Daten pro Objekt lädt. Ändert sich ein Dokument und dessen UUID, ändert in diesem Objekt auch die UUID. Die alte UUID ist somit nicht mehr vorhanden. Wenn Sie die Variable nicht angeben, zieht das System keine Daten aus dem Workflow, die Funktion ist dann inaktiv.	Datenvariable

Datenvariable

Für generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.

Im Editor

Im Editor geben Sie den Namen der Workflow-Variable an. Das System platziert die Variable automatisch in der Variable des Tokens (token.variables).

dataVariable

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, von der das System den eigentlichen Namen der gewünschten Variable lesen soll.

'token.variables.nameOfDataVariable'