Condividi tramite


Utilizzare collegamenti diretti con l'app per dispositivi mobili Power Apps

I collegamenti diretti consentono agli utenti di passare da un'applicazione all'altra su computer e dispositivi mobili. Semplici esempi includono un'app per dispositivi mobili con collegamento diretto a Facebook per accedere, un indirizzo e-mail con un collegamento diretto a un'app di posta per comporre un messaggio o un sito Web con un collegamento diretto a un app store per scaricare un'app per dispositivi mobili correlata.

Puoi aprire una visualizzazione entityrecord o entitylist nell'app Power Apps Mobile utilizzando URL di link diretti da altre app. Quando segui il collegamento da un'app esterna, l'elemento di destinazione si apre nell'app Power Apps Mobile per telefoni o tablet

Se hai già effettuato l'accesso alla tua istanza nell'app, il record di destinazione viene visualizzato quando segui il collegamento da un'app esterna. In caso contrario, ti verrà chiesto di accedere alla tua istanza nell'app per dispositivi mobili; dopo aver effettuato l'accesso, viene visualizzato l'elemento di destinazione. Devi avere l'app Power Apps Mobile per telefoni o tablet installata sul tuo dispositivo mobile per utilizzare questa funzionalità.

Parametri URL supportati per un'app basata su modello

Utilizza il gestore dell'applicazione e i parametri della stringa di query seguenti per comporre l'URL.

I collegamenti diretti all'app Power Apps Mobile dovrebbero iniziare con quanto segue:

ms-apps://<org-url>_<app-id>?tenantId=<tenant-id>&environmentId=<environment-id>&appLogicalName=<appLogicalName>&appType=AppModule&openApp=true&restartApp=true&forceOfflineDataSync=true

Importante

org-url non può contenere https://. Di seguito è riportato un esempio di collegamento diretto ad un'app basata su modello:
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=aaaabbbb-0000-cccc-1111-dddd2222eeee&environmentId=g67tfyufhkjfg&appLogicalName=cr12_e567

Parametro Descrizione Obbligatorio
<app di destinazione>
  • ms-dynamicsxrm -> Dynamics 365 per telefoni
  • ms-apps-fs -> Servizio sul campo
  • ms-apps -> Power Apps
  • ms-mobile-apps -> app per dispositivi mobili native sottoposte a wrapping
<org-url> Si connette all'URL dell'organizzazione corretto.
<app-id> Apre il modulo dell'app corretto.
tenantId=<tenant-id> Si connette al tenant corretto.
*environmentId=<environment-id> Identifica in modo univoco l'ambiente all'interno di un tenant.
*appLogicalName=<app-logical-name> Nome univoco dell'app. Per altre informazioni su come trovare questo nome univoco dell'app in modern Studio, vedere Gestire le impostazioni delle app basate su modello nella finestra di progettazione app e per l'editor classico, vedere Gestire le proprietà delle app basate su modello nella finestra di progettazione app (versione classica)
appType=AppModule Indica che l'app di destinazione è un'app basata su modello.
restartApp=true Riavvia l'app basata su modello. Necessario per garantire che i parametri vengano passati quando l'app è già aperta. No
autoLoginUpn=<e-mail> Compila automaticamente la posta elettronica e attiva l'accesso.

Nota: questo parametro verrà ignorato se un utente è già connesso all'app.
No
forceOfflineDataSync=true Garantisce l'attivazione della sincronizzazione dei dati in modo che siano disponibili tutti i dati più recenti. No

* Considerazioni

  • L'ID ambiente e appLogicalName sono obbligatori per tutti i nuovi collegamenti diretti.
  • I collegamenti diretti esistenti senza un ID ambiente o appLogicalName avranno prestazioni più lente fino a dicembre 2025, dopo di che non saranno supportate.
  • Aggiorni tutti i collegamenti diretti esistenti per includere sia l'ID ambiente sia il nome logico dell'app (appLogicalName) per migliorare le prestazioni e ridurre il tempo di attesa.

Se si apre un modulo entityrecord o si crea un nuovo entityrecord, utilizza i seguenti parametri:

Parametro Descrizione Obbligatorio
etn=<nome-logico-entità> Designa la tabella a cui accedere.
pagetype=entityrecord Indica che la destinazione è un modulo.
id=<record-id> Designa il record specifico a cui andare; se lasciato vuoto, verrà aperto il modulo creato per la tabella.
extraqs=<form-id> Designa il modulo da aprire per entityrecord; se non specificato, si aprirà il modulo predefinito. Il parametro extraqs può essere utilizzato anche per impostare i valori di campo predefiniti. No

Se il collegamento accede a una visualizzazione entitylist, aggiungi i seguenti parametri:

Parametro Descrizione Obbligatorio
etn=<nome-logico-entità> Designa la tabella a cui accedere.
pagetype=entitylist Indica che stiamo accedendo a una visualizzazione.
viewid=<view-id> Designa quale visualizzazione aprire. No
Viewtype= <1039 se vista di sistema, 4230 se vista personale> Indica se la visualizzazione di destinazione è una visualizzazione di sistema o una visualizzazione personale. No

Parametri URL supportati per un'app canvas

ms-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&environmentId=<environment-id>&restartApp=true

Parametro Descrizione Obbligatorio
<app-id> Apre il modulo dell'app corretto.
tenantId=<tenantId> Si connette al tenant corretto.
*environmentId=<environment-id> Identifica in modo univoco l'ambiente all'interno di un tenant.
restartApp=true Riavvia l'app Canvas. Necessario per garantire che i parametri vengano passati quando l'app è già aperta. No
autoLoginUpn=<e-mail> Compila automaticamente la posta elettronica e attiva l'accesso.

Nota: questo parametro verrà ignorato se un utente è già connesso all'app.
No

* Considerazioni

  • L'ID ambiente è obbligatorio per tutti i nuovi link profondi.

  • I collegamenti diretti esistenti senza un ID ambiente avranno prestazioni più lente fino a dicembre 2025, dopo di che non saranno supportati.

  • Aggiornare tutti i collegamenti diretti esistenti per includere l'ID ambiente per migliorare le prestazioni e ridurre il tempo di attesa.

    Parametri URL supportati per un'app per dispositivi mobili native di cui è stato eseguito il wrapping

ms-mobile-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true

Importante

L'URL del collegamento diretto per un'app sottoposta a wrapping funziona solo quando sul dispositivo mobile è installata una sola app sottoposta a wrapping. Non funziona se sono installate più di un'app sottoposta a wrapping.

Parametro Descrizione Obbligatorio
<app-id> Apre il modulo dell'app corretto.
tenantId=<tenantId> Si connette al tenant corretto.
restartApp=true Riavvia l'app basata su modello. Necessario per garantire che i parametri vengano passati quando l'app è già aperta. No
autoLoginUpn=<e-mail> Compila automaticamente la posta elettronica e attiva l'accesso.

Nota: questo parametro verrà ignorato se un utente è già connesso all'app.
No

Risoluzione dei problemi

I collegamenti diretti possono essere aperti nel browser a seconda dei criteri aziendali e delle impostazioni del dispositivo dell'utente. Gli strumenti di gestione dei dispositivi mobili (MDM) e i sistemi operativi dei dispositivi hanno opzioni e impostazioni diverse che influiscono sulla modalità di gestione dei collegamenti diretti. Se i collegamenti diretti vengono aperti in un browser anziché direttamente in Power Apps per dispositivi mobili, assicurarsi che i criteri MDM e le impostazioni del dispositivo siano configurati in modo appropriato.

Ad esempio, su alcuni dispositivi Android, vai a Impostazioni>App>Power Apps>Apri per impostazione predefinita e aggiungi apps.powerapps.com per fare in modo che i collegamenti profondi si aprano direttamente nell'app Power Apps per dispositivi mobili.

Vedere anche

Importanti modifiche (funzionalità deprecate) previste nelle app canvas