Load One Item

Überblick

Mit dem Baustein Load One Item kann ein einzelner Datensatz von einer externen MySQL-Datenbank abgefragt werden.

Den Baustein findest du unter: Workflow-Baukasten → DO → Services → Databases → MySQL

Beispiel

Im Workflow sollen Daten zur Unternehmenswebseite aus der firmeneigenen MySQL-Benutzerdatenbank abgefragt werden. 

Konfigurationsoptionen

Der Baustein hat folgende Konfigurationsoptionen:

1. Name: Bezeichnung des Bausteins
2. Placeholders: Liste der verfügbaren Platzhalter
3. Eingabe der Verbindungsdaten:
   • Hostname: Hostname des MySQL-Servers
   • Port: Port des MySQL-Servers
   • Username: Benutzername
   • Password: Passwort
   • Database: Auswahl der MySQL-Datenbank
   • Table: Auswahl der MySQL-Tabelle
4. FIELDS: Definition der Datenstruktur mit den Daten, die im Workflow zur Verfügung gestellt werden. Die Datenstruktur kann, bei erfolgreicher Verbindung mit der MySQL-Datenbank, automatisiert über die Schaltfläche FETCH FIELDS? angelegt werden oder manuell. Siehe auch Datenstrukturen anlegen.
   
   
   
5. RELATIONS: Definition der Beziehungen zwischen den Tabellen
   • name: Name der Beziehung für den Workflow
   • table: Auswahl der MySQL-Tabelle
   • key: Auswahl des Schlüssels
   • foreignKey: Auswahl des Fremdschlüssels
     
     
     
6. WHERE: Filtermöglichkeiten
   • field: Datenfeld
   • Dropdownbox: Auswahl der Vergleichsoperation (z. B. equals =, lower than <)
   • value: Wert, nach welchem gefiltert wird
   • Bearbeitungsfunktionen: Über OR und AND können die Filterbedingungen verkettet werden. Über x wird eine Zeile gelöscht.
     
     
     
7. ORDER: Sortierungsoptionen
   • Order Columns: Definition der Spalte, anhand der sortiert wird
   • Order Direction: Definition der Sortierrichtung (aufsteigend oder absteigend)
     
     
     
8. LIMIT: Paginierungsoptionen
   • Start: Definition der Startposition
   • Limit: Definition der maximalen Anzahl an Datensätzen
     
     
     
9. SETTINGS: Einstellungen zur Abfrage
   • Timout: Definition eines Zeitlimits
   • Continue on errors?: Wenn aktiviert, läuft die Abfrage auch dann weiter, wenn das Zeitlimit erreicht wurde. Es wird jedoch eine Fehlermeldung im Statusmonitor ausgegeben.
     
     
     
10. FETCH FIELDS?: Automatisiertes Erstellen der Datenstruktur

Output des Bausteins

Im weiteren Verlauf des Workflows steht dir der abgefragte Datensatz als Platzhalter zur Verfügung. Zudem kannst du über success den Status abfragen und im Fehlerfall die error_message des MySQL-Servers auslesen.

Load One Item konfigurieren

1. Öffne den Konfigurationsdialog des Bausteins über mehr → edit.
   
   
2. Gib im Feld Name eine treffende Bezeichnung ein.
   Zum Beispiel: „Load One Item MySQL-DB“
   
   
3. Um dich mit dem MySQL-Server zu verbinden, gib in den Feldern Hostname, Port, Username und Password die entsprechenden Daten ein.
   
   
4. Klicke auf aktualisieren in der Zeile Database.
   ✓ Wenn die Verbindungsdaten korrekt sind, werden die verfügbaren Datenbanken geladen.
    
5. Wähle eine Datenbank im Feld Database aus.
   
   
6. Klicke auf aktualisieren in der Zeile Table.
   ✓ Wenn die Verbindungsdaten korrekt sind, werden die verfügbaren Tabellen geladen.
    
7. Wähle eine Tabelle im Feld Table aus.
   
   
8. Definiere die Abfrage des Datensatzes unter FIELDS, RELATIONS, WHERE, ORDER, LIMIT und SETTINGS.
   
   
9. Klicke auf SAVE.
   ✓ Der Baustein ist konfiguriert.

Verwandte Themen

• Datenstrukturen anlegen
• Load Item List
• Platzhalter und Accessors
• Datentypen

Weitere Informationen

–