Zum Hauptinhalt springen
Version: Preview

Deep Links

Es ist möglich MapEdit Mobile durch URL-Parameter zu öffnen, so genannte Deep Links.

Hinweis

Bitte beachten Sie, dass sich die Links für MapEdit Mobile (Web) und den nativen Apps aus technischen Gründen unterscheiden.

Achtung

Diese Funktionen sind derzeit noch stark in der Entwicklung, weshalb noch nicht alle Funktionen in allen Clients implementiert sind. Den aktuellen Fortschritt finden sie in der Feature-Matrix.

Web​

Eine Url für MapEdit Mobile (Web) hat folgenden Aufbau, wobei Parameter mit {PARAMETER} dargestellt werden:

http(s)://{IHRSERVER}/mapedit-web/?{PARAMETER}={WERT}, wobei mehrere Parameter genutzt werden können, welche dann mit & verknüpft werden.

Ein Beispielaufruf unter localhost:8080, der lediglich ein Projekt öffnen soll, könnte demnach folgendermaßen aussehen:

http://localhost:8080/mapedit-web?project=Testproject

Ein Beispiel unter localhost:8080, für das Highlighten eines Objekts:

http://localhost:8080/mapedit-web?project=Testproject&execute=highlight&connectionName=Datenbankname&tableName=Tabellenname&key=123

Mobile Apps (iOS/Android)​

Die nativen Apps gliedern die DeepLinks in zwei Bereiche: Kommandos und Konfiguration. Der grundlegende Aufbau eines Aufrufs sieht wie folgt aus:

mapedit://{BEREICH}?{PARAMETER}={WERT}&{PARAMETER}={WERT}

Mehrere Parameter können nacheinander angegeben werden und werden jeweils mit & verknüpft.

Beispielaufrufe für den Bereich Kommandos mit den einzelnen Ausführungsoptionen:

mapedit://command?execute=openForm&project=Testproject&formName=Testform&filter=spalte=10

mapedit://command?execute=highlight&project=Testproject&connectionName=Test_Connection&tableName=Test_Tabelle&filer=spalte>10&zoomLevel=10

mapedit://command?execute=openFormAndHighlight&project=Testproject&formName=Testform&filter=spalte<10&zoomLevel=15

mapedit://command?execute=openProject&project=Testproject

Unterstützte Parameter und Kommandos in iOS und Android​

Markieren von Punkten, Linien und Polygonen in der Karte​

Über das folgende Link Schema kannst du ein oder mehrere Objekte in der Karte markieren:

mapedit://command?execute=highlight
    project           (required, string)
    connectionName    (required, string)
    tableName         (required, string)
    filter            (required, string)
    zoomLevel         (optional, int)

Öffnen eines Formulars​

Mit diesem Link Schema kannst du ein Formular eines Projekts direkt öffnen, wahlweise mit oder ohne Filter:

mapedit://command?execute=openForm
    project         (required, string)
    formName        (required, string)
    filter          (optional, string)

Öffnen eines Formulars und die Position(en) in der Karten markieren​

Bei diesem Schema gibt es eine Besonderheit. Ist auf dem Bildschrim des Gerätes nicht genügend Platz, das Formular und Karte nebeneinander angezeigt werden können, wird standardmäßig das Formular angezeigt, wie zum Beispiel beim Smartphone. 

mapedit://command?execute=openFormAndHighlight
    project         (required, string)
    formName        (required, string)
    filter          (optional, string)
    zoomLevel       (optional, int)

Die DeepLinks verhalten sich unter iOS und Android gleich. Ist eine gültige Anmeldung vorhanden, wird die Karte oder das Formular sofort geöffnet, wenn die App gestartet ist. Ist die Anmeldung abgelaufen, muss sich der Anwender zuerst anmelden und danach wird die Karte oder das Formular geöffnet.

Nur ein einzelnes Projekt öffnen​

Um nur ein bestimmtes Projekt zu öffnen, kann das folgende Schema verwendet werden:

mapedit://command?execute=openProject
    project         (required, string)

Hinzufügen von MapEdit-Core Servern​

Die Internetadressen vom MapEdit Core Server kann ebenfalls über einen DeepLink hinzugefügt werden. Dazu muss nur der folgende Link aufgerufen werden.

mapedit://config?serverUrl=<server_url>

Weitere Infos finden Sie auf der Seite Erste Schritte.