Zum Inhalt

Einrichtung der DFÜ - Datenboxen (labGate #iConnect für MacOS)

In dieser Anleitung wird gezeigt wie Datenboxen in labGate #connect für MacOS konfiguriert werden. Den Download der aktuellen Version des MacOS Clients finden Sie hier:

https://www.vireq.com/produkte/labgate/labgate-connect/download/

Nachdem Sie die ZIP Datei heruntergeladen haben, entpacken Sie bitte diese Datei. In dem neu entstandenen Ordner öffnet sich daraufhin ein neuer Ordner mit dem Namen "labGate-iconnect-current". Hier klicken Sie doppelt auf die Datei "labGate #iConnect-1.0.pkg". Der Installationsdialog öffnet sich.

Da die Meldung erscheint, dass die Software nicht von einem zertifizierten Entwickler stammt, muss über die Sicherheitseinstellung "Dennoch öffnen" ausgewählt werden, um die Installation zu starten.

Anschließend ein Ziellaufwerk auswählen und Fortfahren.

Mit den Standardeinstellungen die Installation starten.

Nach erfolgreicher Installation über "Schließen" beenden.

Danach kann das Installationsprogramm in den Papierkorb verschoben werden.

Als erstes klicken Sie mit der rechten Maustaste auf das labGate Symbol in der Taskleiste und klicken anschließend auf "konfigurieren...". Um in die Modulkonfiguration zu gelangen, klicken Sie unten auf den Button "Eigenständige Module konfigurieren...".

Es öffnet sich nun das Konfigurationsmenü "Eigenständige Module...". Hier wählen Sie den Punkt "DFÜ-Datenboxen" und klicken anschließend auf "konfigurieren...".

Nun öffnet sich das Fenster "Datenbox-Anbindungen konfigurieren...". Hier können Sie beliebig viele Anbindungen erstellen. Mit Anbindungen sind Verbindungen an verschiedenen Servern oder an gleichen Servern mit verschiedenen Login Daten gemeint.

Um eine neue Anbindung hinzuzufügen klicken Sie unten auf das Symbol mit dem Plus Zeichen. Mit dem Minus Symbol können Sie Anbindungen löschen.

Wenn Sie auf das Plus Symbol klicken erscheint ein neuer Eintrag und Sie sehen die Konfiguration für diese Anbindung auf der rechten Seite.

Hier geben Sie zunächst der Anbindung einen Namen. Darunter füllen Sie die Felder mit den jeweiligen Server- und Logindaten. Zum Test der Verbindung klicken Sie bitte auf den Button "Datenboxen abfragen".

Wenn dem angegebenen Benutzer auf labGate #web Datenboxen zugeordnet wurden, erscheinen diese jetzt unterhalb der Anbindung. Mit setzen der Haken vor der Datenbox werden diese aktiviert.

In der Konfiguration der Anbindung können Sie unter den Punkt "Zielverzeichnis" das Verzeichnis angeben wohin die abgerufenen Dateien abgelegt werden sollen.

Unter "Dateien mit gleichem Namen" können Sie wählen, was geschehen soll, wenn Dateien abgelegt werden die den gleichen Namen haben. Folgende Auswahl steht Ihnen zur Verfügung:

Aktion Beschreibung
Überschreiben Dateien mit gleichem Namen werden überschrieben.
Anhängen LDT Dateien mit gleichem Namen werden um den neuen Datensatz erweitert.
Nicht abrufen Dateien mit gleichem Namen werden nicht abgerufen und auf dem Server belassen.
Um Zähler erweitern Dateien mit gleichem Namen werden umbenannt und am Ende um einen Zähler ((1), (2)) erweitert.

Wenn Sie eine Datenbox anwählen erscheint auf der rechten Seite die Option "Datenbox-Standardeinstellungen überschreiben". Diese Option ist Standardmäßig deaktiviert.

Wenn Sie die Option aktivieren, bekommen Sie Möglichkeit für diese Datenbox ein separates Zielverzeichnis zu wählen. Zusätzlich können Sie wählen was mit gleichnamigen Dateien aus dieser Datenbox geschehen soll.

Bei deaktivierter Option werden die Standardwerte aus der Anbindungskonfiguration verwendet.

labGate #iconnect - Verknüpfung für Desktop Datenboxabruf

Diese Funktion ist erst mit labGate #iConnect ab Version 1.9.0 verfügbar.

Abruf via Kommandozeile

labGate #connect kann über die Kommandozeile einen Abruf von Datenboxen in einer laufenden labGate #connect-Instanz auslösen.

  • Für den Abruf muss labGate #iConnect mit einem Parameter 

    "open -n '/Applications/labGate #iConnect.app' --args -trigger=labgate_connect_databox"

  • Der Abruf einer bestimmten Datenbox wird ebenfalls unterstützt. Hierzu muss der Parameter wie folgt lauten:

    "open -n '/Applications/labGate #iConnect.app' --args -trigger=labgate_connect_databox_[NameDerAnbindung]"

Verknüpfung herunterladen und anpassen

Um das ganze so einfach wie möglich zu gestalten, haben wir Ihnen den kompletten Abruf (aller eingestellten Datenboxen) vorbereitet, sodass die ZIP nur noch heruntergeladen werden muss, mit Doppelklick entpackt und angepasst werden kann.

Laden Sie hierzu die DFUE Abruf.zip weiter oben auf dieser Webseite herunter. Sollte das aus irgendeinem Grund nicht möglich sein, können Sie die Desktopverknüpfung auch manuell am Mac erstellen, wie hier beschrieben.

Anschließend ziehen Sie den DFUE Abruf auf den Desktop (Schreibtisch).

Konfiguration von Einzelabrufen

Sollten Sie nur einzelne Datenboxen abrufen wollen, müssen Sie den DFUE Abruf mit dem Programm Automator öffnen.

Nachdem starten von Automator wählen Sie Vorhandenes Dokument öffnen... und klicken dann die DFUE Abruf App an und bestätigen Sie mit Öffnen.

Anschließend haben Sie die folgende Ansicht und können in der rechten Seite - falls notwendig - den trigger anpassen. 

"open -n '/Applications/labGate #iConnect.app' --args -trigger=labgate_connect_databox_[NameDerAnbindung]"

Sie können den Abruf anschließend für die jeweilige Datenbox umbenennen z. B. DFUE Abruf Praxis XY.

Bild (Desktop Icon) des Programms ändern

Hierzu benötigen Sie einmal das Logo des Labors als Bild-Datei.

Um das Icon des Programms zu ändern (z.B. auf das Logo des Labors) klicken Sie mittels "control + Linksklick" auf das Icon des Programms und wählen Informationen im Kontextmenü.

Dann legen Sie sich das Bild (was am Ende zu sehen sein soll) in die Zwischenablage und machen in dem Info Fenster ein Klick auf das kleine Bild oben links und fügen das gewünschte Bild (control + V) ein.

Erstellung der Desktopverknüpfung (optional)

  • Um die Verknüpfung auf dem Desktop ablegen zu können, benötigen Sie das Programm Automator. Diesen finden Sie im Finder unter Programme oder via Spotlight-Suche.

  • Wenn der Automator gestartet wird, wählen Sie bitte Neues Dokument aus, um eine neue App anzulegen.

  • Im nächsten Schritt wählen Sie Programm als Dokument aus.

  • Nun suchen Sie in den möglichen Schritten nach "ausführen" (oder run falls die Sprache auf Englisch eingestellt ist) und machen einen doppelklick auf Shell-Skript ausführen

  • In dem Kasten rechts fügen Sie nun das folgende Shell-Skript hinzu und stellen oben die Shell auf /bin/sh

    open -n '/Applications/labGate #iConnect.app' --args -trigger=labgate_connect_databox

  • Nachdem nun das Skript hinterlegt ist, muss das Programm noch gespeichert werden. Dazu gehen Sie bitte auf Ablage und auf Sichern

  • Anschließend wählen Sie hier einen Namen unter dem das zu finden sein soll und den Ablageort (Schreibtisch) und klicken auf Sichern

Automatisierter Abruf der Datenboxen alle X Minuten

databoxes.sh

Einrichtung des Cron

Die Einrichtung des Cron Jobs erfolgt entsprechend an einem PC. Sie müssen dem Programm Cron erstmal an einem Mac den Zugriff auf die komplette Festplatte erlauben, falls dies noch nicht geschehen ist.

Dazu öffnen Sie einmal den Finder und klicken auf "Gehe zu" anschließend auf "Gehe zum Ordner ..."

Im anschließenden sich öffnen Fenster geben Sie nun folgenden Pfad ein /usr/sbin/ und bestätigen durch drücken der Enter Taste (oder indem Sie auf Öffnen klicken).

Hier haben Sie nun das Programm cron gefunden. Nun öffnen Sie bitte die Einstellungen des Mac und gehen auf Sicherheit & Datenschutz → Datenschutz → Festplattenvollzugriff

Hier wird das Benutzer- / Adminpasswort benötigt

Sollte hier unten links ein Schloss zu sehen sein, muss dies angeklickt werden, um das die Bearbeitung freizugeben. Hier muss einmal via Drag & Drop das Programm cron hinterlegt werden.

     

Terminal arbeiten und hinterlegen vom Skript

Hinterlegen Sie nun das Skript was sie am Anfang der Anleitung herunterladen konnten im Ordner labor_abruf , falls er noch nicht existiert, legen Sie diesen bitte an.

 

Sollten Sie nur bestimmte Datenboxen abrufen wollen, müssten Sie das Skript wie hier beschrieben anpassen.

Anschließend wechseln Sie (im Terminal) in den Ordner und machen das Skript ausführbar:

cd ~/labor_abruf
chmod +x databoxes.sh

Anschließend benötigen Sie nun ein Terminal (was Sie mit Hilfe der Spotlight-Suche recht einfach finden können).

Hier haben Sie nun die Option den crontab mit vi oder mit nano zu bearbeiten. Der userfreundlichere Editor ist nano.

Crontab Bearbeitung mit dem vi

Im Terminal geben Sie einmal 

crontab -e

ein.

Nun öffnet sich der vi Editor, um hier die eine Zeile hinterlegen zu können drücken Sie bitte i dann müsste unten am Terminalrand ein --Insert-- erscheinen.

Nun hinterlegen Sie bitte folgendes: 

*/15 * * * * ~/labor_abruf/databoxes.sh

und drücken ESC und anschließend :w und :q um den vi zu beenden

Es gibt die Meldung crontab: installing new crontab wenn der crontab erfolgreich hinzugefügt werden konnte.

Somit wird alle 15 Minuten ein Abruf der Datenboxen durchgeführt.

Crontab Bearbeitung mit nano

Im Terminal geben Sie einmal 

EDITOR=nano crontab -e

ein.

Nun öffnet sich der nano Editor, hier können Sie nun einfach folgendes hinterlegen:

*/15 * * * * ~/labor_abruf/databoxes.sh

um das ganze abzuspeichern, drücken Sie bitte nun (bei Team viewer CTRL + X ) oder wenn Sie am Mac sind Command +x

Es gibt die Meldung crontab: installing new crontab wenn der crontab erfolgreich hinzugefügt werden konnte.

Somit wird alle 15 Minuten ein Abruf der Datenboxen durchgeführt.