Navigation

Um die Anbindungen einer Auswertung zu konfigurieren, gehen Sie auf: Navigationsleiste → Auswertungen → Auswertung bearbeiten → Anbindungen.
Siehe auch: Auswertung anlegen / bearbeiten

Um das Dateiformat zu konfigurieren, gehen Sie auf: Navigationsleiste → Auswertungen → Auswertung bearbeiten → Dateiformat.

Überblick

Die Anleitung beschreibt, wie Auswertungen aus der Labordatenbank automatisiert exportiert werden können. Es gibt zwei Hauptbereiche: das Dateiformat und die Anbindungen.

Dateiformat

Für CSV-Exporte lassen sich Dateiname (inkl. dynamischer Variablen), Zeichensatz, Feld- und Zeilentrennzeichen sowie weitere Optionen wie eine Kopfzeile mit Spaltennamen konfigurieren. Über einen Exporttransformationscode sind auch andere Formate wie JSON oder XML möglich.

Anbindungen

Es stehen vier Exportwege zur Verfügung:

E-Mail:
Auswertungsergebnisse werden als Dateianhang oder Link versendet, wahlweise einmal pro Auswertung oder zeilenweise pro Empfänger. Betreff, Text und Empfängeradresse können mit Spaltenwerten aus der Auswertung dynamisch befüllt werden.

SFTP/FTP:
Die Auswertungsdatei wird auf einen externen Server übertragen. In der Enterprise-Variante ist zusätzlich ein zeitgesteuerter oder ereignisbasierter automatischer Auslöser möglich.

HTTPS-Export (PUSH):
Das Ergebnis wird per Knopfdruck als JSON-Datensatz an einen externen Webservice gesendet, wahlweise per POST oder PUT, optional mit Zertifikatsauthentifizierung.

HTTPS-Abruf (PULL):
Die Auswertung wird als geschützter Endpunkt bereitgestellt, den externe Systeme bei Bedarf selbst als CSV oder JSONabrufen können.

Dateiformat für den Export konfigurieren

CSV-Datei

Im Bereich Dateiformat können Sie das Dateiformat konfigurieren.
Damit eine Einlesung in anderen Systemen einwandfrei funktioniert, können Sie das Dateiformat für einen CSV Export vorgeben, folgende Einstellmöglichkeiten haben Sie zur Verfügung.

Dateiname
Der Name der zu exportierenden CSV-Datei kann von Ihnen vorgegeben werden. Optional können Variablen verwendet werden. Wird kein Dateiname von Ihnen festgelegt, wird automatische der Name der Auswertung als Dateiname verwendet.

Optionale Variablen:

• _DATE_YMD_HHMMSS_ für Zeitstempel
• _UNIXTIME_ für Unix-Zeit
• _VAR_SPALTENBEZEICHNUNG_ für Spalteninhalte

Durch die Dateiendung .xml ist es ebenfalls möglich, die CSV Struktur als Excel Datei bereitzustellen.

Zeichensatz
Bestimmt die Textkodierung der CSV-Datei. UTF-8 ist der Standard und unterstützt internationale Zeichen. Bei Problemen mit Umlauten oder Sonderzeichen können andere Kodierungen wie z.B. ISO-8859-1 (Latin-1) oder Windows-1252 (ANSI) gewählt werden.

Feldtrennzeichen
Legt fest, welches Zeichen die einzelnen Datenfelder (Spalten) voneinander trennt. Häufig verwendete Optionen sind:

• Semikolon (;) - Standard in CSV Dateien
• Tabulator - Für tabulatorgetrennte Dateien (Excel)

Feldbegrenzerzeichen
Definiert, ob Textfelder von besonderen Zeichen umschlossen sind. Wichtig bei Texten mit Zeilenumbrüchen oder wenn das Feldtrennzeichen selbst im Text vorkommt. Wenn Feldbegrenzer im Text erscheinen, werden diese automatisch verdoppelt (escaped).

Zeilenumbruch
Bestimmt, wie Zeilenenden, Umbrüche in der Datei markiert sind:

• CR (Carriage Return) - Klassisches Mac-Format
• LF (Line Feed) - Unix/Linux-Format
• CRLF - Windows-Format

Zusätzliche Optionen
Die zusätzlichen Optionen können Sie aktivieren, indem Sie die jeweilige Checkbox anhaken:

• CSV-Datei mit der Attributzeile beginnen

Aktivieren Sie diese Option, wenn die erste Zeile die Spaltennamen enthalten soll. Dies erleichtert die Interpretation der Daten beim Import in andere Systeme.

• Zeilenumbruch nach der letzten Zeile anhängen

Fügt am Ende der Datei einen zusätzlichen Zeilenumbruch hinzu.
Manche Systeme erwarten dies für eine korrekte Verarbeitung.

Diese Einstellungen gewährleisten, dass CSV-Dateien korrekt interpretiert und importiert werden können.

Weitere Dateiformate

Optional gibt es mittels Export Transformationscode die Möglichkeit andere Dateiformate für den automatischen Export bereitzustellen, so zum Beispiel JSON oder XML.

Anbindungen für den Export konfigurieren

Im Bereich Anbindungen legen Sie fest, wie und wohin die Ergebnisse Ihrer Auswertungen automatisch versendet werden.

E-Mail Versand

Um vollautomatisierte, personalisierte E-Mails aus Ihrer Labordatenbank mit dynamischen Inhalten und Anhängen basierend auf Ihren Auswertungsdaten zu versenden, stehen Ihnen die folgenden Einstellungen zur Verfügung:

Grundeinstellungen

E-Mail-Adresse

Geben Sie eine oder mehrere (durch Komma getrennte) E-Mail-Adressen ein.

Die Empfängeradresse kann fest hinterlegt, oder mit dynamischer Variable Bsp.: VAR_AN befüllt werden. Die Variable wird aus den Spalten der Auswertungsdaten befüllt - dazu muss die Auswertung eine Spalte "An" enthalten, dann wird automatisch die Variable _VAR_AN_ durch den Inhalt der Spalte ausgetauscht.

Natürlich stehen Ihnen auch CC/BCC zur Verfügung.

• CC (Carbon Copy): Sichtbare Kopie-Empfänger
• BCC (Blind Carbon Copy): Versteckte Kopie-Empfänger

Betreff und Text
Der Betreff und der Text der Mail kann ebenfalls optional Variablen aus der Auswertung enthalten, die automatisch durch Werte aus den entsprechenden Spalten der Auswertung ersetzt werden. Variablen beginnen mit _VAR_, verwenden Großbuchstaben und Unterstriche statt Leerzeichen.

Versandoptionen
Im Dropdown unterhalb des Textfeldes für den E-Mail Text, können Sie festlegen, ob pro Auswertung eine E-Mail oder pro Auswertungszeile eine E-Mail verschickt wird.

• Der Inhalt der ersten Zeile wird für die E-Mail-Variablen verwendet:
  In diesem Fall wird für eine Auswertung immer eine E-Mail versendet.
• Der Inhalt wird zeilenweise für bis zu 10 E-Mails verwendet:
  Mit dieser Auswahl erzeugt jede Zeile der Auswertung eine separate E-Mail mit den jeweiligen Variablenwerten.

Anhänge hinzufügen
Sie haben mehrere Möglichkeiten, Daten als Anhang beizufügen. Aktivieren Sie die passende Option, indem Sie die jeweilige Checkbox anhaken.

• Link zur Auswertung:
  Fügt einen Link zur Online-Ansicht der ursprünglichen Auswertung in den E-Mail-Text ein, nützlich, wenn die E-Mail an Nutzer der Labordatenbank versendet werden.

• Ergebnis der Auswertung als Datei an die E-Mail anhängen:
  Hängt das komplette Auswertungsergebnis als Datei an die E-Mail an. Bei Bedarf kann der Dateiname mit der Variable _FILENAME_ dynamisch im Emailtext eingefügt werden. Die Dateieinstellungen sollten vorher definiert werden im Bereich 'Dateiformat'.

• Datei (Uploads oder PDFs) zeilenweise an jede E-Mail anhängen.:
  Hängt zeilenweise Dateien (Uploads oder PDFs) an jede E-Mail an.
  Erfordert eine Spalte mit upload_id_for_download_link==123 für unterzeichnete Berichte oder Angebote.
  Oder alternativ eine Spalte mit einer der folgenden Optionen um PDF's anzuhängen:
  pdf_datatype==invoice==x - Rechnungen (mit invoices.id)
  pdf_datatype==offer==x - Angebote (mit offer.id)
  pdf_datatype==report==x - Berichte (mit reports.id)
  pdf_datatype==order_worksheets==x==y - Arbeitsblätter (mit orders.id und designs.id)
  pdf_datatype==sample_worksheets==x==y - Probenarbeitsblätter (mit samples.id und designs.id)
  pdf_datatype==onlineorder==x - Online-Bestellungen (mit onlineorders.id)
  pdf_datatype==problem==x - Problemberichte (mit problems.id)

Zusätzlich ist das zeilenweise Versenden von erzeugten Dateien (Bsp. .ics /.xls ) möglich.
Dazu werden 3 Spalten in der Auswertung benötigt:

• Dateiname ... z.B. 'abc.xls'
• Content-Type ... z.B. 'xls'
• Dateiinhalt ... z.B.
  '160001 Testprobe 1442268000
  160002 ABC 1442872800
  160003 ABC 1442872800'

E-Mail versenden

Die E-Mails werden dann gemäß Ihrer Konfiguration verschickt, sobald Sie den grauen Button "Datei per E-Mail versenden" oberhalb der Auswertung drücken.

E-Mailvorschau anzeigen

Optional können Sie sich vorab eine Vorschau Ihrer E-Mail anzeigen lassen.
Gehen Sie dafür "E-Mailvorschau" unterhalb des E-Mail-Versand-Buttons und klicken Sie aus dem aufklappenden Menü.

Es öffnet sich ein Vorschaufenster mit folgenden Informationen (ggf. mit den aufgelösten Variablen):

• Empfängeradressen
• Betreff
• E-Mail-Text

Gesendete E-Mails nachvollziehen

Alle versandten E-Mails der LDB finden Sie unter: Navigationsleiste -> Kunden -> Postausgang

SFTP/FTP-Export

Sie können das Ergebnis einer Auswertung auf einem SFTP Server ablegen.

SFTP Account aktivieren

• Klicken Sie im Abschnitt SFTP/FTP Export auf "FTP / SFTP Account aktivieren"

Abbildung: SFTP Account aktivieren

• Wählen Sie daraufhin im Dropdown-Menü "Typ" die Option SFTP aus.
• Geben Sie die Zugangs-Daten (Server-Adresse, Port, Benutzername, Passwort, Verzeichnispfad) des Servers ein.

Abbildung: SFTP Account Zugangs-Daten

PDF-Datei Export konfigurieren

Ist Ihr Account aktiviert, können Sie wählen, ob eine PDF-Datei auf dem Server abgelegt werden soll.

• Aktivieren Sie die Checkbox "PDF Datei zeilenweise generieren und hochladen".
• Unterhalb der Checkbox ist der in der Auswertung verwendete Syntax beschrieben, um die jeweiligen Datentypen für den Export zur Verfügung zustellen.
• Wird diese Checkbox nicht aktiviert, erfolgt der Export, wie im Bereich "Dateiformat" definiert.

Automatischen Auslöser einrichten

In der Enterprise-Cloud Variante der Labordatenbank haben Sie zudem die Möglichkeit den Export zeitgesteuert ablaufen zu lassen oder einen automatischen Auslöser für den SFTP Export zu definieren, zum Beispiel das Unterzeichnen eines Prüfberichtes oder das Anlegen einer Probe.

ereignisbasierter automatischer Auslöser
Automatische Auslöser werden bei der gewählten Aktion (Probe anlegen/bearbeiten, Bericht anlegen/bearbeiten, Auftrag anlegen/bearbeiten...) unterhalb des Speichern - Knopfs angezeigt.
Der Automatismus wird durch den Haken in der zugehörigen Checkbox angestoßen.

Abbildung: Automatische Auslöser bei der gewählten Aktion

Ob diese Checkbox standardmäßig angehakt ist oder nicht, können Sie in der zugehörigen Auswertung über die Checkbox Auslöser vorausgewählt steuern:

Abbildung: Automatischen Auslöser einrichten

Verbindung testen

• Klicken Sie auf "SFTP / FTP Verbindung testen", um die Verbindung zum Server zu überprüfen.

Weiterführende Informationen finden Sie unter: SFTP / FTP Verbindung testen

Datei exportieren

Die Datei wird immer dann übermittelt, wenn Sie den grauen Button "Datei an SFTP-Server senden" oberhalb der Auswertung drücken.

HTTPS-Export

Mit der HTTP PUSH-Funktion können Sie das Ergebnis einer Auswertung als JSON-Datensatz an einen WebService Ihrer Wahl senden.

HTTPS-Export aktivieren

URL des Ziel-WebService eingeben

Der Export von Dateien via HTTP PUSH kann aktiviert werden, indem Sie die Zieladresse inkl. Username/Passwort in das dafür vorgesehen Feld eingetragen wird.

• Format der URL: https://username:password@api.customer.com
• Verwenden Sie immer https:// für sichere Verbindungen.
• Bei Bedarf kann an die URL über eine Variable ein Eintrag aus der ersten Zeile der SQL-Tabelle eingefügt werden.

Schreibweise: _VAR_SPALTENBEZEICHNUNG_

z.B..https://api.customer.com/results/submit_results?test_id=_VARProbeNO_

• Die Authentifizierung erfolgt über Username:Passwort in der URL.
• Die Auswertung wird als JSON-Datensatz verschickt. Standardmäßig wird eine flach formatierte JSON verschickt. Über einen ggf. hinterlegten Exporttansformationscode kann das Format individuell angepasst werden.

HTTPS Header
Im Feld "HTTP Header" können zusätzliche Header angeben werden.

HTTPS Methode
Die Standard-Methode für den HTTP Export ist POST, Sie können ebenfalls die Methode PUT verwenden.

Webservice Response Handler
Eine Antwort des HTTPS Endpunkt kann mittels Webservice Response Handler und JavaScript code verarbeitet werden.

Anmeldung mit P12 Zertifikat (optional)
Für die Anmeldung am HTTPS Endpunkt stellen wir Ihnen optional die Möglichkeit bereit, ein P12 Zertifikat in Ihrer Auswertung zu hinterlegen.

Datensatz exportieren

Zum Senden des Datensatzes wird Ihnen in Ihrer Auswertung die graue Schaltfläche "Datensatz senden" bereitgestellte.

HTTPS-Abruf

HTTP PULL ermöglicht es, dass externe Systemen die Auswertungsdaten auf Anfrage abrufen. Ihre entsprechend konfigurierte Auswertung stellt dabei einen WebService-Endpoint bereit, den andere Systeme abfragen können.

HTTPS-Abruf aktivieren

Um Dateien über HTTPS PULL abrufbar zu machen, wählen Sie die Schaltfläche "HTTP-Authentifizierung aktivieren" und definieren in dem folgenden Fenster einen Nutzernamen, sowie ein Passwort.

Optional können Sie in dem Schritt eine IP Adressenbeschränkung vornehmen.

URL für den Datei-Abruf erhalten
Ist die Datenübertragung via HTTPS Pull aktiviert, werden die Links gezeigt, über die externe Systeme die Auswertung abrufen können.
Nun ist diese Auswertung als CSV-Datei oder JSON-Datei über die angezeigten Links nach Eingabe des Benutzernamens und des Passwortes abrufbar, z.B.:

URL für CSV Abruf: https://labordatenbank.com/demo/stats/view/327/https

URL für JSON Abruf: https://labordatenbank.com/demo/stats/view/327/https_json

Geben Sie die URL an das externe System weiter, dass auf Ihre Auswertung zugreifen soll.

Die Abruf-URL mit Key kann mittels Auswertung erzeugt werden und verlinkt auf eine Auswertungsansicht, die auch für nicht eingeloggte User sichtbar ist.

Weitere Anwendungsbeispiele:

Ergebnis einer Auswertung als PDF per E-Mail verschicken

Zusätzlich zu den oben beschriebenen Möglichkeiten zum PDF Export können Sie die von der Auswertung ermittelten Daten als Tabelle auf einem PDF darstellen und diese PDF per E-Mail verschicken.

Folgende Komponenten sind dafür notwendig:

• eine PDF Vorlage Typ Auswertung
• eine Auswertung

Folgende Einstellungen sind bei der Auswertung notwendig, um die von der Auswertung ermittelten Daten als Tabelle am PDF darzustellen:

• Reiter Einstellungen: im Feld PDF Vorlage die relevante PDF-Vorlage (Typ Auswertung) ausgewählt
• Reiter SQL: Abfrage zur Ermittlung der Daten
• Reiter Dateiformat: Dateiname mit Endung .pdf
• Reiter Anbindungen: Konfiguration für E-Mail Versand inkl. aktiver Checkbox zu Ergebnis der Auswertung als Datei an die E-Mail anhängen

Abbildung: E-Mail im LDB - Postausgang mit dem Ergebnis einer Auswertung als PDF verschickt

Etiketten als CSV erzeugen und an Ihren SFTP-Server exportieren

Mit einer SQL-Auswertung erzeugen Sie Etikettendaten und exportieren diese als CSV-Datei auf Ihren SFTP-Server.
Gehen Sie bei der Einrichtung wie folgt vor:

SQL-Abfrage erstellen:
Erstellen Sie im Reiter SQL die Abfrage mit den für die Etiketten relevanten Daten.
Jede Spalte der Abfrage wird als Spalte in die CSV-Datei übernommen.

Export einrichten (Reiter Anbindungen):

• Klicken Sie im Abschnitt SFTP/FTP Export auf FTP / SFTP Account aktivieren und geben Sie anschließend die Zugangsdaten Ihres Servers ein.
  In der Auswertungsübersicht erscheint daraufhin eine eigene Schaltfläche, mit der Sie die Übermittlung an den SFTP-Server manuell auslösen können.
• Mit dem Betriebsmodell Enterprise Cloud Service lässt sich der Export automatisieren: Wählen Sie unter Automatischen Auslöser für diesen SFTP-Export einrichten den passenden Auslöser aus, z. B. Probe angelegt.

Hinweis: Beim SFTP-Export stellt die Anwendung die CSV-Datei auf dem Zielserver bereit. Die weitere Verarbeitung erfolgt durch das dort eingesetzte System.

Abbildung: SFTP/FTP Export mit automatischem Auslöser

Anzeigeort festlegen (Reiter Einstellungen):
Legen Sie fest, an welcher Stelle die Auswertung in Ihrer LDB aufscheinen soll, um den Export bei Bedarf manuell auslösen zu können. An der gewählten Stelle erscheint anschließend die mit dem Namen der der Auswertung benannte Schaltfläche, z. B. csv Etiketten drucken.
Reiter Einstellungen: Wählen Sie bei Erscheint in aus, wo die Auswertung aufscheinen soll, z. B. in der Probenübersicht oder der Proben Detailansicht (über Parameter).

Abbildung: Etikettendruck aus Probenübersicht

Abbildung: Etikettendruck aus Probendetailansicht über Parameter

Etiketten als PDF an Ihren SFTP-Server exportieren

Mit einer SQL-Auswertung und einer gekoppelten PDF-Vorlage können Sie Etiketten erzeugen und diese als PDF automatisch auf Ihren SFTP-Server exportieren. Optional können Sie die Etiketten manuell direkt an ihren Drucker senden.
So richten Sie den Export ein:

PDF-Vorlage anlegen:
Erstellen Sie eine PDF-Vorlage vom Typ Auswertung.

SQL-Auswertung erstellen:
Erstellen Sie im Reiter SQL die Abfrage mit den für die Etiketten relevanten Daten. Jede Spaltenüberschrift der Abfrage steht anschließend als Variable zur Verfügung und kann über die Designelemente der PDF-Vorlage auf dem Etikett abgebildet werden.

Auswertung mit der PDF-Vorlage koppeln (Auswertung, Reiter Einstellungen):

• PDF-Vorlage: Wählen Sie im oberen Dropdown die zuvor erstellte PDF-Vorlage aus. Wählen Sie im unteren Dropdown die Option Je Zeile eine Seite anzeigen – so wird für jede Zeile der Auswertung eine eigene PDF-Seite (ein Etikett) erzeugt, und die Spalten stehen als Variablen für die Designelemente je Seite bereit.
• Standardaktion: Wählen Sie die Option PDF aus.

Abbildung: SQL-Auswertung mit PDF-Vorlage koppeln

Designelemente mit Variablen befüllen (PDF-Vorlage, Designelement anlegen)
Verwenden Sie die durch die SQL-Abfrage erzeugten Variablen als Inhalt der Designelemente. Leiten Sie den Variablennamen nach folgender Regel aus der Spaltenüberschrift ab:

• Spaltenüberschrift in Großbuchstaben schreiben
• Leerzeichen durch Unterstriche ersetzen
• Variable mit einem Unterstrich beginnen und beenden
• Beispiel: Aus der Spaltenüberschrift Sample wird die Variable Probe

Abbildung: Designelemente mit den Variablen aus der Auswertung.

Optional: Etiketten manuell direkt an den Drucker senden
Sie können das erzeugte PDF auch direkt an Ihren Drucker senden. Legen Sie dazu fest, an welcher Stelle die Auswertung aufscheinen soll. An der gewählten Stelle erscheint anschließend eine Schaltfläche zum Erstellen des PDF.
Folgende Einstellung ist bei der Auswertung notwendig:
Reiter Einstellungen: Wählen Sie bei Erscheint in aus, wo die Auswertung aufscheinen soll, z. B. in der Probenübersicht und Proben-Detailansicht.
Lassen Sie das PDF anschließend über die Schaltfläche erzeugen, öffnen Sie es und senden Sie es aus dem PDF-Viewer an den Drucker.

Export einrichten (Auswertung, Reiter Anbindungen)

• Klicken Sie im Abschnitt SFTP/FTP Export auf FTP / SFTP Account aktivieren und geben Sie anschließend die Zugangsdaten Ihres Servers ein. In der Auswertungsübersicht erscheint daraufhin eine eigene Schaltfläche, mit der Sie die Übermittlung an den SFTP-Server manuell auslösen können.
• Mit dem Betriebsmodell Enterprise Cloud Service lässt sich der Export automatisieren: Wählen Sie unter Automatischen Auslöser für diesen SFTP-Export einrichten den passenden Auslöser aus, z. B. Probe angelegt.

Hinweis: Beim SFTP-Export stellt die Anwendung die CSV-Datei auf dem Zielserver bereit. Die weitere Verarbeitung erfolgt durch das dort eingesetzte System.

Abbildung: Etiketten als PDF mit den Daten aus der Auswertung