Zum Hauptinhalt springen

Lookupliste

Die Lookuplisten Aktionen in linqi erlauben es, Lookuplisten aus Prozessen zu lesen und zu schreiben. So können Sie Einträge aus einer Lookupliste abfragen, anlegen, aktualisieren oder löschen. Damit können Sie Lookuplisten beispielsweise als eine Art Datenbank nutzen, um Daten automatisch mit Ihren Prozessen synchron zu halten.

info

Für die Arbeit mit Lookuplisten Aktionen müssen Sie das entsprechende Feature aktivieren. Die Lookupliste selbst müssen Sie zuvor in den Stammdaten anlegen.

Anwendungsfälle​

Lookuplisten Aktionen eignen sich immer dann, wenn Prozesse Daten in einer Lookupliste pflegen oder aus ihr lesen sollen:

  • Kundendaten synchron halten: Wenn ein Prozess Kundendaten ändert, z.B. eine neue Adresse oder einen neuen Ansprechpartner, kann er den zugehörigen Eintrag in der Kunden-Lookupliste automatisch aktualisieren. So bleibt die Liste ohne manuellen Pflegeaufwand aktuell.
  • Standortdaten: Sie können z.B. Standorte oder Lager mit zugehörigen Daten in einer Lookupliste ablegen. Ein Prozess kann diese Daten abfragen und sie z.B. in Formularen oder E-Mails anzeigen, oder neue Standorte bei Bedarf anlegen.
  • Als Datenbank nutzen: Lookuplisten sind eine gute Möglichkeit, um prozessbezogene Daten, z.B. Budgets oder Zuordnungen, in linqi zu verwalten und aus Prozessen heraus zu lesen oder zu ändern.

Geteilte Konfiguration​

Viele Lookuplisten Aktionen haben eine grundlegend ähnliche Konfiguration. Daher werden hier erst diese allgemeinen Konfigurationen erklärt, um sie nicht in jeder Aktion zu wiederholen.

Allgemeine Konfiguration​

In allen Aktionen müssen Sie zu Beginn die Lookupliste angeben, mit der die Aktion arbeitet:

  • Lookupliste: Wählen Sie hier die Lookupliste aus, mit welcher gearbeitet werden soll. Diese Liste muss zuvor in den Stammdaten angelegt worden sein.

Filterkonfiguration​

Die Aktionen zum Aktualisieren und Löschen (sowie zum Abfragen) erlauben es, einen Filter zu definieren. So können Sie bestimmen, welche Einträge geladen, aktualisiert oder gelöscht werden. Einen Filter können Sie über folgende Einstellungen definieren:

  • Mehrere Einträge erlauben: Diese Option steht nur bei den Aktionen zum Aktualisieren und Löschen zur Verfügung. Im Standard erlaubt linqi es nur, maximal einen Eintrag gleichzeitig zu bearbeiten. Dies ist dafür gedacht, dass Sie nicht aus Versehen sehr viele Einträge der Liste überschreiben oder löschen. Wenn Sie planen, mehr als einen Eintrag gleichzeitig zu bearbeiten, müssen Sie diese Option aktivieren.

  • Filter kombinieren: Wählen Sie hier aus, ob ein Eintrag alle Filter (Und) oder nur einen der Filter (Oder) erfüllen muss, um von der Aktion betroffen zu sein.

  • Filterzuordnung: Hier definieren Sie die eigentlichen Filter. Pro Filter wählen Sie die Spalte aus, nach der gefiltert wird, bestimmen dann den Operator und geben anschließend den Vergleichswert an. Dabei können Sie entweder einen festen Wert eingeben oder einen Platzhalter nutzen. Für die Filterung stehen nur die Spaltentypen Text, Zahl und Datum zur Verfügung. Die verfügbaren Operatoren hängen vom Spaltentyp ab:

    • Text: Ist gleich, Nicht gleich, Enthält, Enthält nicht, Beginnt mit, Endet mit, Ist nicht leer, Ist leer
    • Zahl / Datum: Ist gleich, Nicht gleich, Größer als, Größer oder gleich, Kleiner als, Kleiner oder gleich, Ist nicht leer, Ist leer

    Wenn Sie z.B. als Spalte Kundenname, als Operator Beginnt mit und als Wert linqi wählen, werden alle Einträge gefunden, deren Kundenname mit linqi beginnt.

Spaltenzuordnung​

Wenn Sie Werte in eine Lookupliste schreiben wollen, z.B. um einen Eintrag anzulegen oder zu aktualisieren, können Sie in der Spaltenzuordnung definieren, welche Werte in welche Spalte geschrieben werden:

  • Spalte: Wählen Sie hier die Spalte aus, die mit einem Wert befüllt werden soll. Dabei kann jede Spalte nur einmal ausgewählt werden.
  • Wert: Über diese Konfigurationsmöglichkeit geben Sie an, welcher Wert in die Spalte geschrieben wird. Dabei können Sie entweder einen festen Wert eingeben oder einen Platzhalter nutzen. Der verfügbare Platzhaltertyp hängt vom Datentyp der Spalte ab, z.B. Text, Zahl, Datum, Person oder Datei.

Aktionen​

Lookuplisten Eintrag abfragen​

Über diese Aktion können Sie Einträge aus einer Lookupliste abfragen. Dabei stehen folgende Konfigurationsmöglichkeiten zur Verfügung:

  • Allgemeine Konfiguration: Die allgemeine Konfiguration (s.o.) definiert, aus welcher Lookupliste Sie Einträge abfragen wollen.
  • Filterkonfiguration: Über die Filterkonfiguration (s.o.) können Sie definieren, welche Einträge Sie abfragen wollen. Ist hier kein Filter definiert, werden alle Einträge der Lookupliste geladen.
  • Spalten welche geladen werden: Wählen Sie hier aus, welche Spalten geladen werden sollen. Mindestens eine Spalte ist erforderlich. Diese Spalten stehen anschließend als Platzhalter zur Verfügung.
  • Sortierspalte: Sie können hier optional eine Spalte auswählen, nach der die Ergebnisse sortiert werden, und über die Sortierrichtung bestimmen, ob die Ergebnisse auf- oder absteigend sortiert werden.

Diese Aktion stellt folgende Platzhalter zur Verfügung:

  • Jede geladene Spalte: Jede geladene Spalte kann als Platzhalter ausgewählt werden. Dabei werden außerhalb von Schleifen die Werte aller Einträge mit einem Komma getrennt.
  • Anzahl Einträge: Hierüber können Sie die Anzahl der gefundenen Einträge referenzieren. Dies können Sie z.B. auch in Bedingungen nutzen, um zu prüfen, ob ein Eintrag existiert.
  • Einträge: Innerhalb einer Schleife, z.B. einer Tabelle in einem Formular, können Sie hierüber die Einträge referenzieren, die dann durchlaufen werden.

Lookuplisten Eintrag anlegen​

Über diese Aktion können Sie einen neuen Eintrag in einer Lookupliste anlegen. Dabei stehen folgende Konfigurationsmöglichkeiten zur Verfügung:

  • Allgemeine Konfiguration: Die allgemeine Konfiguration (s.o.) definiert, in welche Lookupliste der Eintrag angelegt wird.
  • Spaltenzuordnung: Über die Spaltenzuordnung (s.o.) definieren Sie, welche Werte der neue Eintrag erhalten soll.

Lookuplisten Eintrag aktualisieren​

Über diese Aktion können Sie einen oder mehrere Einträge in einer Lookupliste aktualisieren. Dabei stehen folgende Konfigurationsmöglichkeiten zur Verfügung:

  • Allgemeine Konfiguration: Die allgemeine Konfiguration (s.o.) definiert, in welcher Lookupliste Einträge aktualisiert werden.
  • Filterkonfiguration: Über die Filterkonfiguration (s.o.) definieren Sie, welche Einträge aktualisiert werden.
  • Spaltenzuordnung: Über die Spaltenzuordnung (s.o.) definieren Sie, welche neuen Werte in die Spalten geschrieben werden. Dabei werden nur die Spalten aktualisiert, die Sie hier auch angeben.
hinweis

Wenn der Filter mehr als einen Eintrag findet und die Option Mehrere Einträge erlauben nicht aktiviert ist, bricht die Aktion mit einem Fehler ab.

Lookuplisten Eintrag löschen​

Mit dieser Aktion können Sie einen oder mehrere Einträge aus einer Lookupliste löschen. Dabei stehen folgende Konfigurationsmöglichkeiten zur Verfügung:

  • Allgemeine Konfiguration: Die allgemeine Konfiguration (s.o.) definiert, aus welcher Lookupliste Einträge gelöscht werden.
  • Filterkonfiguration: Über die Filterkonfiguration (s.o.) definieren Sie, welche Einträge gelöscht werden.
hinweis

Wenn der Filter mehr als einen Eintrag findet und die Option Mehrere Einträge erlauben nicht aktiviert ist, bricht die Aktion mit einem Fehler ab.