DifficultyMoeilijkheidsgraad: expert

Het is mogelijk om Workplace App te starten en met één enkele gebruikersactie naar specifieke schermen/functies te navigeren.

Dit gedrag kan worden bereikt door de URL te starten vanuit een webapplicatie/website of vanuit een andere app op hetzelfde apparaat.

Het koppelingsmechanisme wordt ondersteund op de standaard Workplace app, zowel op iOS als Android platformen.

Image Added

Wat zijn deep links?

Deep links zijn vooraf gedefinieerde aangepaste URL's die kunnen worden gebruikt om een app aan te roepen vanuit een externe app of omgeving. Als je bijvoorbeeld de knop "navigeren" selecteert op een website, wordt de standaardapplicatie "kaarten" gestart op het apparaat, waar de navigatie automatisch wordt gestart.

Vereisten

Om een toepassing te activeren die deeplinks ondersteunt, moet aan de volgende voorwaarden worden voldaan:

• De app van bestemming (in dit geval: The Workplace App) moet geïnstalleerd zijn op het apparaat

• De bron-app moet de aangepaste URL aanroepen om navigatie te activeren

• De deep link URL moet goed geformatteerd zijn en alle vereiste parameters doorgeven, zoals verwacht door de bestemmingsapp.

Deep links in de Workplace app

De Workplace app ondersteunt deeplinks naar de onderstaande schermen of functies:

• Boek een kamer

• Bekijk live plattegrond

Bouwformaat met diepe verbinding

De deeplink bestaat uit 3 delen:

• Regeling - De URL die is geregistreerd door een app. Hiermee wordt het systeem geïnformeerd dat de app links kan verwerken die beginnen met dit schema.

• Gastheer - Een unieke identificatie voor de app/functie die je wilt aanroepen. Dit is bruikbaar als meerdere pagina's in een app hetzelfde schema afhandelen.

• Parameters - Een lijst van key-value paren, die kunnen worden vastgelegd door de applicatie. Zowel de sleutels als de waarden moeten van het type string zijn.

Het formaat waarin deze zijn gestructureerd is:

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

WhereWaar,

Scheme Regeling = PA://

Host Gastheer = spacewell ruimteput

Parameters = targetview, extraparam and username

Host and Scheme

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.

en gebruikersnaam

Gastheer en regeling

Voorlopig moeten zowel host als schema constant blijven tijdens het maken van deeplinks voor integratie met de Workplace app. De verwachte waarden zijn hierboven beschreven.

De Workplace app is zo ontworpen dat het zowel hoofdletters als kleine letters kan verwerken, omdat het hoofdlettergevoelig is.

Parameters

De volgende parameters worden verwacht door de Workplace app om de bovenstaande use cases mogelijk te maken.

targetview en extraparam combinaties

De onderstaande combinaties van targetview en extraparam worden ondersteund door de Workplace app. Als een onjuiste waarde wordt doorgegeven voor targetview, zal de Workplace app een relevante foutmelding tonen en terugnavigeren naar de launcher app. Terugnavigatie wordt alleen op Android out of the box ondersteund.

Voorbeelden

Hoe kan ik een Workplace 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.

bestemmingsapp) activeren vanuit een link in een bronapp?

Een deeplink kan worden beschouwd als hetzelfde als een web URL, wat betekent dat het kan worden gelanceerd zoals elke andere web URL. De link kan worden gebruikt door op een knop te klikken, kan worden geplakt in de webbrowser van het apparaat (Chrome/Safari) of kan worden gebruikt vanuit een native iOS- of Android-app.

Hieronder staan enkele voorbeelden die kunnen helpen bij het implementeren van de logica in de bron-apps.

Xamarin iOS-voorbeeld

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

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

Xamarin Android

-voorbeeld

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 nieuwe Intent(Intent.ActionView, uri);

StartActivityStartActiviteit(intentintentie);

Web/JavaScript

Paginaomleidingen gebruiken

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

Een link gebruiken

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

Hoe navigeer ik terug naar de bronapp?

Android

Back navigation Terugnavigatie in Android is supported wordt 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.

Searchondersteund. Wanneer een gebruiker terugnavigeert vanuit de Workplace app en de app werd aangeroepen vanuit een deeplink, wordt de Workplace app verlaten en kan de gebruiker verder werken in de vorige app.

Dit biedt de gebruiker een naadloze navigatie-ervaring.

iOS

Op het iOS-platform wordt bij het starten van een app (in dit geval de Workplace-app) de launcher-app automatisch naar de achtergrond verplaatst. Vervolgens is terugnavigeren naar de vorige app niet direct beschikbaar.

Als terugnavigatie vereist is, kan hetzelfde deep linking mechanisme worden gebruikt, maar dan in omgekeerde richting. Om dit mogelijk te maken, zal de Workplace app de bron app (iOS app) starten via een deep link die is gedefinieerd in de bron app.

Om deze functie in te schakelen, is waarschijnlijk een ontwikkeling nodig in de iOS app als bron; de Workplace app kan de terug-navigatie activeren met behulp van het onderstaande URL-schema.

"pabacknavigation"

Dit kan worden bereikt door de onderstaande wijzigingen door te voeren in de iOS app als broncode:

• Implementeer in de AppDelegate de methode OpenURL en retourneer true.

Image Added

• Voeg in info.plist een aangepast URL-schema toe. Het moet "pabacknavigation" heten.

Image Added

Als terugnavigatie niet nodig is, moet de gebruiker handmatig terugschakelen naar de bron-app na het uitvoeren van een bewerking in de Workplace iOS app.

Zoek op