DifficultySchwierigkeitsgrad: expertExperte

Es ist möglich, Workplace App zu starten und mit einer einzigen Benutzeraktion zu bestimmten Bildschirmen/Funktionen zu navigieren.

Dieses Verhalten kann erreicht werden, indem die URL entweder von einer Webanwendung/Website oder von einer anderen Anwendung auf demselben Gerät aus aufgerufen wird.

Der Verknüpfungsmechanismus wird von der standardmäßigen Workplace App unterstützt, sowohl auf iOS- als auch auf Android-Plattformen.

Image Added

Was sind Deep Links?

Deep Links sind vordefinierte benutzerdefinierte URLs, die zum Aufrufen einer Anwendung aus einer externen Anwendung oder Umgebung verwendet werden können. So wird beispielsweise durch die Auswahl der Schaltfläche "Navigieren" auf einer Website die Standardanwendung "Karten" auf dem Gerät gestartet, wo die Navigation automatisch beginnt.

Voraussetzungen

Um eine Anwendung zu aktivieren, die Deep Links unterstützt, müssen folgende Bedingungen erfüllt sein:

• Die Zielanwendung (in diesem Fall: The Workplace App) muss auf dem Gerät installiert sein

• Die Quellanwendung muss die benutzerdefinierte URL aufrufen, um die Navigation auszulösen

• Die Deep-Link-URL muss gut formatiert sein und alle erforderlichen Parameter enthalten, die von der Zielanwendung erwartet werden.

Deep Links in der Workplace App

Die Workplace App unterstützt Deep Links zu den folgenden Bildschirmen oder Funktionen:

• Buchen Sie ein Zimmer

• Live-Grundriss ansehen

Deep-Link-Konstruktionsformat

Der Deep Link besteht aus 3 Abschnitten:

• Schema - Die URL, die von einer App registriert wird. Sie teilt dem System mit, dass die App Links verarbeiten kann, die mit diesem Schema beginnen.

• Gastgeber - Ein eindeutiger Bezeichner für die Anwendung/Funktion, die Sie aufrufen möchten. Dies ist nützlich, wenn mehrere Seiten in einer App dasselbe Schema behandeln.

• Parameter - Eine Liste von Schlüssel-Werte-Paaren, die von der Anwendung erfasst werden können. Sowohl die Schlüssel als auch die Werte sollten vom Typ String sein.

Das Format, in dem diese strukturiert sind, ist:

PA://spacewell?targetview={0}&extraparam={1}&username={2}

WhereWo,

Scheme Schema = PA://

Host Gastgeber = spacewell Weltraumbahnhof

Parameters Parameter = targetview, extraparam and usernameund benutzername

Host

For now, both host and scheme should remain constant while creating deep links for integration with the Workplace app. The expected values are described above.

The Workplace app is designed in such a way that it can handle Scheme in both upper and lower case, as it is case sensitive.

und Schema

Im Moment sollten sowohl der Host als auch das Schema konstant bleiben, wenn Sie Deep Links für die Integration mit der Workplace App erstellen. Die erwarteten Werte sind oben beschrieben.

Die Workplace App ist so konzipiert, dass sie Scheme sowohl in Groß- als auch in Kleinbuchstaben verarbeiten kann, da sie zwischen Groß- und Kleinschreibung unterscheidet.

Parameter

Die folgenden Parameter werden von der Workplace App erwartet, um die oben genannten Anwendungsfälle zu ermöglichen.

Kombinationen von targetview und extraparam

Die folgenden Kombinationen von targetview und extraparam werden von der Workplace App unterstützt. Wenn ein falscher Wert für targetview übergeben wird, zeigt die Workplace App eine entsprechende Fehlermeldung an und navigiert zurück zur Launcher-App. Die Rückwärtsnavigation wird standardmäßig nur unter Android unterstützt.

Beispiele

How to activate Workplace app (destination app) from a link in a source app?

A deep link can be considered the same as a web URL, which means that it can be launched like any other web URL. It can be involved on click of a button, pasted in the device’s web browser (Chrome/Safari) or involved from a native iOS or Android app.

Shared below are some examples, which might help in implementing the logic in the source apps.

Wie kann man die Workplace App (Ziel-App) über einen Link in einer Quell-App aktivieren?

Ein Deeplink kann wie eine Web-URL betrachtet werden, was bedeutet, dass er wie jede andere Web-URL aufgerufen werden kann. Er kann per Klick auf eine Schaltfläche aufgerufen, in den Webbrowser des Geräts (Chrome/Safari) eingefügt oder von einer nativen iOS- oder Android-App aus aufgerufen werden.

Im Folgenden sind einige Beispiele aufgeführt, die bei der Implementierung der Logik in den Quellanwendungen hilfreich sein könnten.

Xamarin iOS Beispiel

string url = string.Format("PA://spacewell?targetview={0}&extraparam={1}&username={2}", viewName, extraParamValue, userName);

UIApplication.SharedApplication.OpenUrl(new NSUrl(url));

Xamarin Android

Beispiel

string url = string.Format("PA://spacewell?targetview={0}&extraparam={1}&username={2}", viewName, extraParamValue, userName);                

Android.Net.Uri uri = Android.Net.Uri.Parse(url);

Intent intent = new Intent(Intent.ActionView, uri);

StartActivity(intent);

Web/JavaScript

Verwendung von Seitenumleitungen

window.location.replace("PA://spacewell?targetview=FLOORPLAN&extraparam=0000012345&username=aaa");

Verwendung eines Links

<a href="PA://spacewell?targetview=FLOORPLAN&extraparam=0000012345&username=aaa">Floorplan<>Grundriss</a>

Wie navigiert man zurück zur Ausgangsanwendung?

Android

Back navigation in Android is supported out-of-the-box. When a user navigates back from the Workplace app and the app was invoked from a deep link, Workplace app is dismissed, and the user can continue working on the previous app.

This offers a seamless navigation experience to the user.

iOS

On iOS platform, when an app is launched (Workplace app in this case), the launcher app is automatically dismissed to the background. Subsequently, back navigation to the previous app is not available out of the box.

If back navigation is required, the same deep linking mechanism can be used, but in the opposite direction. To enable this, the Workplace app will launch the source app (iOS app) via a deep link defined in the source app.

To enable this feature, most likely a development is required in the source iOS app; where Workplace app can trigger back navigation using the below URL scheme.

“pabacknavigation”

 This can be achieved by implementing the below changes in the source iOS app:

• In the AppDelegate, implement OpenURL method and return true.

Image Removed

• In info.plist, add a custom URL scheme. It must be called “pabacknavigation”

Image Removed

If back navigation is not needed, the user will have to manually switch back to the source app after performing an operation in the Workplace iOS app.

SearchDie Rückwärtsnavigation in Android wird sofort unterstützt. Wenn ein Benutzer von der Workplace App zurücknavigiert und die App über einen Deep Link aufgerufen wurde, wird die Workplace App beendet und der Benutzer kann mit der vorherigen App weiterarbeiten.

Dies bietet dem Nutzer eine nahtlose Navigation.

iOS

Wenn auf der iOS-Plattform eine App gestartet wird (in diesem Fall die Workplace App), wird die Launcher-App automatisch in den Hintergrund verschoben. Die Navigation zurück zur vorherigen App ist dann nicht mehr möglich.

Wenn eine Rückwärtsnavigation erforderlich ist, kann derselbe Deep-Linking-Mechanismus verwendet werden, allerdings in umgekehrter Richtung. Um dies zu ermöglichen, startet die Workplace App die Quell-App (iOS-App) über einen in der Quell-App definierten Deep Link.

Um diese Funktion zu aktivieren, ist höchstwahrscheinlich eine Entwicklung in der iOS-App erforderlich, bei der die Workplace App die Rückwärtsnavigation unter Verwendung des folgenden URL-Schemas auslösen kann.

"pabacknavigation"

Dies kann durch die Implementierung der folgenden Änderungen in der iOS-Quellanwendung erreicht werden:

• Implementieren Sie im AppDelegate die Methode OpenURL und geben Sie true zurück.

Image Added

• Fügen Sie in info.plist ein benutzerdefiniertes URL-Schema hinzu. Es muss "pabacknavigation" genannt werden.

Image Added

Wenn die Rückwärtsnavigation nicht benötigt wird, muss der Benutzer nach einer Operation in der Workplace iOS-App manuell zur Ausgangs-App zurückwechseln.

Suche