News der novaCapta

Der wiederholte Bereich – Nintex für Fortgeschrittene

Neben den Formatierungsmöglichkeiten bietet Nintex eine Vielzahl nützlicher Funktionen zur Erstellung von Formularen in SharePoint. Eine Funktion davon ist der “Wiederholte Bereich” (Repeating Section).

Mit diesem Steuerelement lassen sich mehrere Steuerelemente zusammenfassen und, wie der Name schon vermuten lässt, wiederholt anzeigen und ausfüllen.

Wofür braucht man sowas?

Im SharePoint-Standard begegnen man häufig dem Problem, mehrere gleichartige Datensätze erfassen zu wollen. Im Standard ist das nur bedingt lösbar. Nehmen wir an, wir wollen eine Rechnung mit mehreren Rechnungspositionen in SharePoint erfassen. Als Felder sollen “Position”, “Bezeichnung” und “Betrag” erfasst werden.

Variante 1: Felder für alle Datensätze in der Liste anlegen Wir legen für jede Rechnungsposition die benötigen Spalten an (Pos1, Bez1, Betr1, Pos2, Bez2, Betr2, … , PosN, BezN, BetrN). Hier ergeben sich zwei Probleme:

  1. Die Anzahl an Spalten in SharePoint-Listen in begrenzt. Zwar hängt die Begrenzung vom Spaltentyp ab, aber im Schnitt ist bei 255 Spalten Schluss.
  2. Alle Spalten wären immer sichtbar. Wenn ich nur 2 Rechnungspositionen erfassen möchte, habe ich trotzdem alle N Positionen auf dem Formular.

Variante 2: Erfassen über eine Lookup-Liste Möglichkeit 2 ist das Erfassen der Positionen in einer separaten Liste. Dabei würden die Positionen dann per Lookup der Rechnung zugeordnet. Hier ergeben sich wieder zwei Probleme:

  1. Ohne Erweiterung mit JavaScript o.ä. ist es nicht möglich, die Rechnungspositionen direkt beim Erfassen der Rechnung zu erstellen. Das ginge nur nacheinander und über einen separaten Dialog.
  2. Das Auswählen der Rechnung über ein Lookup ist eine nicht zu unterschätzende Fehlerquelle. Zudem wird das Lookup nach einer Weile sehr lang, was die Auswahl noch fehleranfälliger macht.

Wiederholter Bereich Der wiederholte Bereich löst die Probleme der beiden oben beschriebenen Varianten. Das Steuerelement funktioniert ähnlich wie ein Bereichs-Steuerelement. Alle benötigten Steuerelemente werden per Drag-and-Drop in den wiederholten Bereich geschoben und angeordnet. Ein Klick auf “Element hinzufügen” unterhalb des Bereichs dupliziert alle Steuerelemente unter Berücksichtigung der Anordnung und Formatierung. Da die Daten gesammelt gespeichert werden (mehr dazu im nächsten Abschnitt), müssen für die einzelnen Werte keine Spalten in der Liste angelegt werden. Die Anzahl der Elemente ist theoretisch endlos und nur durch die Datenbank limitiert (max. 2GB, bzw. etwas über 1 Milliarde Zeichen).

Wie funktioniert der wiederholte Bereich?

Der wiederholte Bereich speichert die Daten in einem mehrzeiligen Textfeld. Wichtig: es muss ein “Nur Text”-Textfeld sein, Rich-Text-Felder funktionieren nicht. Alle Informationen aus dem wiederholten Bereich (Feldtyp, Feldname, Wert, usw.) werden als XML gespeichert. Auf diese Weise kann die Information immer wieder mit den korrekten Steuerelementen dargestellt werden. Das XML hat immer folgendes Format:

<?xml version="1.0" encoding="utf-8"?>
<RepeaterData><Version />
<Items>
<Item>
<[FeldName1] type="[FeldTyp1]">[Wert1]</[FeldName1]>
<[FeldName2] type="[FeldTyp2]">[Wert]</[FeldName2]>
</Item>
<Item>
<[FeldName1] type="[FeldTyp1]">[Wert1]</[FeldName1]>
<[FeldName2] type="[FeldTyp2]">[Wert]</[FeldName2]>
</Item>
</Items>
</RepeaterData>

Da die Informationen im XML gespeichert werden, werden keine separaten Felder für die einzelnen Werte benötigt. Man sollte aber darauf achten, die Steuerelemente im wiederholten Bereich ordentlich zu benennen, damit die Informationen im XML nachvollziehbar bleiben.

Beispiel

Bleiben wir bei unserem Beispiel vom Anfang. Zur Erinnerung: Wir möchten Rechnungen mit allen Rechnungspositionen erfassen. Zunächst wird die Liste “Rechnungen” angelegt und die benötigten Spalten erstellt:

  • Datum | Datum (Nur Datum) | Standard: Heute
  • Betrag | Währung
  • RechnungsXML | Mehrzeiliger Text | Nur-Text
  • Die Titel-Spalte wird nicht benötigt und kann z.B. später per Workflow gesetzt werden.

Als nächstes erstellen wir unsere Nintex Form. Für meine Form habe ich nach dem automatischen Generieren alle Steuerelemente entfernt und bei null angefangen.

Screenshot Nintext Form Beispiel Bereich mit 4 Steuerelementen:  Positionsnummer Textfeld für die Bezeichnung Textfeld für den Betrag und Label für das Euro-Zeichen

Der wiederholte Bereich enthält 4 Steuerelemente:

  • Ein berechneter Wert für die Positionsnummer
  • Ein Textfeld für die Bezeichnung
  • Ein Textfeld für den Betrag
  • Ein Label für das Euro-Zeichen (optional)

Für die Darstellung der Rechnungsposition kann eine Inlinefunktion von Nintex verwendet werden.

Screenshot Nintext Form Inlinefunktion von Nintex für Rechnungsposition

Die beiden Textfelder sind weitestgehend im Standard. Das Feld für den Betrag ist so eingestellt, dass es nur “Währung” als Eingabe zulässt, also Zahlen und “.” bzw. “,” als Trennzeichen.

Der wiederholte Bereich wurde wie folgt konfiguriert:

Screenshot Control Settings in Nintex Forms für wiederholter Bereich

Die wichtigste Einstellung ist die Verbindung zum mehrzeiligen Textfeld in der Liste. Gut zu sehen sind die anderen Einstellungsmöglichkeiten. Ich habe für mein Beispiel lediglich den “Add row”-Text angepasst.

Zu guter Letzt habe ich noch ein berechnetes Feld eingefügt, dass die Gesamtsumme berechnet und in die Spalte “Betrag” schreibt.

Screenshot Control Settings in Nintex Forms für wiederholter Bereich berechnetes Feld  einfügen

Ergebnis

So sieht unsere fertige Nintex Form im Einsatz aus:

Screenshot fertige Nintex Form im Einsatz 1

Und so werden die Daten in der Liste angezeigt:

Screenshot fertige Nintex Form im Einsatz Anzeige der Daten in der Liste

Das XML für unsere Rechnungsdaten sieht wie folgt aus:

<?xml version="1.0" encoding="utf-8"?>
<RepeaterData><Version />
<Items>
<Item>
<Position type="System.String">1</Position>
<Bezeichnung type="System.String">Artikel 1</Bezeichnung>
<Betrag type="System.Decimal">200</Betrag>
</Item>
<Item>
<Position type="System.String">2</Position>
<Bezeichnung type="System.String">Artikel 2</Bezeichnung>
<Betrag type="System.Decimal">415.16</Betrag>
</Item>
<Item>
<Position type="System.String">3</Position>
<Bezeichnung type="System.String">Artikel 3</Bezeichnung>
<Betrag type="System.Decimal">1368.83</Betrag>
</Item>
</Items>
</RepeaterData>

Wie kann ich die Daten weiterverarbeiten?

Der einzige Nachteil daran, dass die Daten im XML-Format gespeichert werden, ist, dass sie nicht direkt ausgewertet werden können. Mit der Aktion “XML-Abfrage” in Nintex Workflow kann das XML bequem ausgelesen werden.

Screenshot XML-Abfrage in Nintex Workflow

Eingabe ist die Listenspalte mit unserem XML. Über XPath können wir die benötigten Werte auslesen und z.B. in einer Sammlung speichern. Wer sich nicht mit XPath auskennt, kann den mitgelieferten XPath Builder verwenden. Hierzu muss das XML manuell eingegeben werden. Also Element in der Liste erstellen, XML-Spalte in der Ansicht anzeigen, XML kopieren und in das Feld XML (siehe Screenshot oben) einfügen, auf “XPath Builder” klicken. Anschließend wird das XML als Baumansicht dargestellt.

Screenshot XML-Abfrage Daten in Nintex Workflow im XPath Builder auslesen

Der ausgewählte XML-Tag wird für die XML-Abfrage übernommen.

Viel Spaß beim Wiederholen!

Gruppe von Geschäftsleuten in einer Besprechung vor einer SharePoint Site
Referenz

Grünenthal: Mit Nintex agilen Prozessanforderungen begegnen

Grünenthal hat sich dazu entschieden, ihre SharePoint Plattform mit Nintex Workflow zu erweitern, mit dem Ziel, die internen Geschäftsprozesse zu optimieren.

Blue sky and clouds
Blog 09.12.15

Vorgesetzte in Nintex per LDAP-Abfrage ermitteln

"Meine Sekretärin erledigt das für mich." Es ist der Klassiker der Workflows: Die Genehmigung. Neu im novaCapta Blog ► Mit Nintex Vorgesetzte per LDAP-Abfrage ermitteln ✓ So funktioniert's ✓ Jetzt nachlesen!

Zwei Frauen schauen gemeinsam auf einen Bildschirm
Blog 05.08.20

Umfragen in Teams mit Microsoft Forms

Mit Microsoft Forms lassen sich Umfragen schnell und einfach in Teams erstellen bzw. integrieren.

Blog

catworkx behind the scenes: Unser Sales-Bereich

Ein Blick hinter die Kulissen: Wir stellen unser Vertriebsteam vor. Vertriebsleiter Dirk Zöllner und Kolleg:innen aus DACH erzählen, wie sie Kunden betreuen und warum Teamwork so wichtig ist.

Blog 28.02.24

DynamoDB starten: Einblicke in AWS Key-Value Datenbank 2

Erfahren Sie in diesem Blogartikel mehr über fortgeschrittene Techniken zur Modellierung von Datenbeziehungen in DynamoDB.

Übersicht

Jira für fortgeschrittene Anwender (Cloud)

In dem catworkx-Training „Jira für fortgeschrittene Anwender (Cloud)“ erhalten die Teilnehmer:innen eine umfassende Anleitung, wie man die Effizienz und Effektivität von Jira maximiert.

Training

Jira Administration Part 2 (Cloud)

Das Training vertieft die Kenntnisse über die Administrationsaufgaben, die im Kurs "Jira Administration Part 1 (Cloud)" erlernt wurden. Komplexe Schemata und fortgeschrittene Workflows werden...

Training

Jira Administration Part 2 (Cloud)

Das Training vertieft die Kenntnisse über die Administrationsaufgaben, die im Kurs "Jira Administration Part 1 (Cloud)" erlernt wurden. Komplexe Schemata und fortgeschrittene Workflows werden...

Training

Jira Administration Part 2 (Cloud)

Das Training vertieft die Kenntnisse über die Administrationsaufgaben, die im Kurs "Jira Administration Part 1 (Cloud)" erlernt wurden. Komplexe Schemata und fortgeschrittene Workflows werden....

Training

Jira Administration Part 2 (Cloud)

Das Training vertieft die Kenntnisse über die Administrationsaufgaben, die im Kurs "Jira Administration Part 1 (Cloud)" erlernt wurden. Komplexe Schemata und fortgeschrittene Workflows werden...

Training

Jira Administration Part 2 (Cloud)

Das Training vertieft die Kenntnisse über die Administrationsaufgaben, die im Kurs "Jira Administration Part 1 (Cloud)" erlernt wurden. Komplexe Schemata und fortgeschrittene Workflows werden...

Training

Jira Administration Part 2 (Cloud)

Das Training vertieft die Kenntnisse über die Administrationsaufgaben, die im Kurs "Jira Administration Part 1 (Cloud)" erlernt wurden. Komplexe Schemata und fortgeschrittene Workflows werden...

Training

Jira Administration Part 2 (Cloud)

Das Training vertieft die Kenntnisse über die Administrationsaufgaben, die im Kurs "Jira Administration Part 1 (Cloud)" erlernt wurden. Komplexe Schemata und fortgeschrittene Workflows werden...

Training

Jira Administration Part 2 (Cloud)

Das Training vertieft die Kenntnisse über die Administrationsaufgaben, die im Kurs "Jira Administration Part 1 (Cloud)" erlernt wurden. Komplexe Schemata und fortgeschrittene Workflows werden...

Training

Jira Administration Part 2 (Cloud)

Das Training vertieft die Kenntnisse über die Administrationsaufgaben, die im Kurs "Jira Administration Part 1 (Cloud)" erlernt wurden. Komplexe Schemata und fortgeschrittene Workflows werden angepasst.

Training

Getting more from Jira Workflows (Data Center)

In dem Training „Getting More from Jira Workflows (Data Center)“ lernen die Teilnehmer:innen gebräuchliche Status- bzw. Transitions-Eigenschaften und fortgeschrittene Workflow-Funktionalitäten kennen und diese zu konfigurieren.

Training

Getting More from Jira Workflows (Cloud)

In dem Training „Getting More from Jira Workflows (Cloud)“ lernen die Teilnehmer:innen gebräuchliche Status- bzw. Transitions-Eigenschaften und fortgeschrittene Workflow-Funktionalitäten kennen und lernen diese zu konfigurieren.

Training

Getting More from Jira Workflows (Cloud)

In dem Training „Getting More from Jira Workflows (Cloud)“ lernen die Teilnehmer:innen gebräuchliche Status- bzw. Transitions-Eigenschaften und fortgeschrittene Workflow-Funktionalitäten kennen und lernen diese zu konfigurieren.

Training

Getting More from Jira Workflows (Cloud)

In dem Training „Getting More from Jira Workflows (Cloud)“ lernen die Teilnehmer:innen gebräuchliche Status- bzw. Transitions-Eigenschaften und fortgeschrittene Workflow-Funktionalitäten kennen und lernen diese zu konfigurieren.

Training

Getting more from Jira Workflows (Data Center)

In dem Training „Getting More from Jira Workflows (Data Center)“ lernen die Teilnehmer:innen gebräuchliche Status- bzw. Transitions-Eigenschaften und fortgeschrittene Workflow-Funktionalitäten kennen und diese zu konfigurieren.

Bleiben Sie mit dem TIMETOACT GROUP Newsletter auf dem Laufenden!