Verknüpfungen
diaLIMS Link
diaLIMS-Links sind spezielle Links in der App, in Berichten, E-Mails oder auf Webseiten, die das diaLIMS verarbeiten kann, in dem z.B. der verlinkte Datensatz in der App geladen wird.
Ein diaLIMS-Link ist technisch gesehen ein im Betriebssystem registrieres Protokoll, das mit der diaLIMS-Anwendung verknüpft ist.
Es wird dabei zwischen den Protokollen dialims und web+dialims unterschieden, die folgendermaßen aufgebaut sind:
dialims://<klassenname>:<oid>
web+dialims://type=<klassenname>&id=<oid>
Die Variable <klassenname> muss durch den Klassennamen und die Variable <oid> durch die Objekt-ID des zu öffnenden Datensatzes ersetzt werden.
Folgende Beispiele öffnen die Probe mit der oid = 1.1234.20 :
dialims://Probe:1.1234.20
web+dialims://type=Probe&id=1.1234.20
Da das Angeben derartiger Links manuell nicht sinnvoll ist, werden diese Links nur in automatisch auszufüllenden HTML-E-Mail-Vorlagen verwendet. Beispiele dafür finden sich im Vorlagenverzeichnis der diaLIMS-Installation.
Für die diaLIMS-interne Navigation unterstützen die diaLIMS Web App und diaLIMS Desktop App grundsätzlich beide Protokolle.
diaLIMS-Links mit dem Protokoll web+dialims können aus der diaLIMS Desktop App in der Standard Web App des Betriebssystems, z.B. in der diaLIMS Web App geöffnet werden. Halten Sie dafür beim Öffnen eines entsprechenden Links zusätzlich die Alt-Taste gedrückt.
Beim Verwenden von diaLIMS-Links außerhalb des diaLIMS wird abhängig vom verwendeten Protokoll und der lokalen Protokoll-Registrierung jeweils eine andere diaLIMS-Anwendung geöffnet.
Das von diaLIMS verwendete URL-Protokoll wird über die Option System > DialimsLinkUrlProtocol gesteuert.
diaLIMS-Links einrichten ("web+dialims"-Protokoll)
Das Protokoll web+dialims wird direkt über die App-Installation der diaLIMS Web App oder über die Browseroberfläche in der Navigationsleiste bzw. über Einstellungen > Datenschutz und Sicherheit > Website-Einstellungen > Zusätzliche Berechtigungen > Protokoll-Handler eingerichtet.
Anschließend können diaLIMS-Links sowohl intern als auch aus anderen lokalen Anwendungen (z.B. Outlook oder Word) verwendet werden.
Es ist technisch möglich, über manuelle Konfiguration das web+dialims-Protkoll auch so einzurichten, dass standardmäßig die diaLIMS Desktop App geöffnet wird.
Die Einrichtung entspricht im Wesentlichen der Einrichtung des dialims-Protokolls, nur dass dabei der Protokoll-Name ausgetauscht werden muss.
Einrichten für Windows und Outlook ("dialims"-Protokoll)
Damit diaLIMS-Link unter Windows mit MS-Outlook in einer E-Mail funktioniert, müssen einige Einträge in der Windows-Registry erfolgen. Im diaLIMS-Installationsverzeichnis befindet sich die Datei registry/dialims.reg, die als Schablone für den Import der notwendigen Registry-Einträge dienen kann.
Diese Datei muss aber in jedem Fall angepasst werden.
So ist in dieser Datei die folgende Pfadangabe zum diaLIMS-Programm enthalten: C:\Program Files\dialims\Programm\diaLIMS.exe. Diese Pfadangabe muss angepasst werden, wenn diaLIMS nicht unter C:\Program Files\dialims installiert ist.
Außerdem sind hinter dieser Pfadangabe diverse diaLIMS-Start-Parameter anzupassen. Es können hier i.d.R. dieselben Parameter angegeben werden, wie in der Startverknüpfung des diaLIMS angegeben sind. Folgende Parameter sind mindestens anzugeben:
- de DE <kunden-locale>
- -Ddb=<database-type>
- -Ddbname=<database-url>
Die in spitzen Klammern stehenden Begriffe (inklusive der Klammern) müssen entsprechend der Kundenumgebung angepasst werden. Weitere Übergabeparameter sind möglich.
Die Datei kann anschließend einfach per Doppelklick in die Registry importiert werden.
Es erscheint die Nachfrage vom Windows, ob die Registry-Einträge importiert werden sollen. Dies ist mit Ja zu bestätigen.
Der Import funktioniert nur mit Administratorberechtigung.
Alternativ kann man die folgenden Registry-Einträge auch manuell eintragen. Dazu muss man mit Administratorberechtigung das Program regedit.exe starten. Folgende Einträge sind zu machen:
HKEY_CLASSES_ROOT dialims (Standard) = "URL:dialims Protocol" URL Protocol = "" HKEY_CLASSES_ROOT dialims shell open command (Standard) = "C:\Program Files\dialims\Programm\diaLIMS.exe" de DE <kunden-locale> -Ddb=<database-type> -Ddbname=<database-url> "%1"
Es sind auch UNC-Namen für die Pfadangabe möglich. Die in spitzen Klammern stehenden Begriffe (inklusive der Klammern) müssen entsprechende der Kundenumgebung angepasst werden. Weitere Übergabeparameter sind möglich.
diaLIMS-Links für Firefox konfigurieren ("dialims"-Protokoll)
Damit diaLIMS-Link im Firefox funktioniert, muss dort folgendes konfiguriert werden:
- Im Url-Feld about:config eingeben. Warnungen quittieren.
- Nach network.protocol-handler filtern.
- Wenn es einen Eintrag für network.protocol-handler.external.dialims gibt, diesen durch Doppelklick auf true setzen.
- Ansonsten einen neuen Boolean-Eintrag network.protocol-handler.external.dialims anlegen und diesen auf true setzen.
diaLIMS-Links für Opera konfigurieren ("dialims"-Protokoll)
Damit diaLIMS-Link in Opera funktioniert, muss dort folgendes konfiguriert werden:
- Menü aufrufen: Extras->Einstellungen->Erweitert->Programme
- Neuen Eintrag dialims mit Verweis auf die
dialims.exehinzufügen