È possibile assistere gli utenti mobili e i mittenti nel primo utilizzo di ArcGIS Workforce nei seguenti modi:
- Fornire un link per gli utenti mobili che possa essere usato per installare l'app, impostare l'URL del portale, scaricare la mappa, aprire un incarico e impostare lo stato di un incarico.
- Fornire un link per i mittenti che può essere usato per sveltire la creazione dell'incarico.
- Utilizzare il software di gestione dei dispositivi mobili (MDM) per distribuire e configurare l'app mobile, compreso l'URL del portale.
Aprire l'app mobile Workforce da un link
Gli utenti mobili possono specificare l'URL del portale Workforce o fornire direttamente un URL che specifichi l'URL del portale corretto. Consentire agli utenti mobili di accedere al portale giusto, condividendo un link tramite un'e-mail, un messaggio di testo, una pagina Web, un codice QR o un'altra applicazione. Se si fa clic su Workforce si apre sulla mappa designata per l'utilizzo da parte dell'operatore mobile.
Struttura del link
I link all'app mobile Workforce hanno il seguente formato: https://workforce.arcgis.app?parameter=value. Le coppie di parametri e valori sono sostituite con i valori che si preferisce usare per distribuire l'app. Ad esempio, il link https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis utilizza il parametro portalURL per portare gli utenti mobili direttamente alla schermata di accesso della propria organizzazione e richiede loro di accedere.
Parametri
I seguenti parametri sono supportati con i link Workforce. Se non ci sono parametri elaborati, toccando il link si apre Workforce (o si riceve una notifica per scaricare l'applicazione).
| Parametro | Valori | Note |
|---|---|---|
portalURL | L'URL del portale dell'organizzazione |
|
mapID | L'ID dell'elemento della mappa da scaricare e aprire in Workforce |
|
assignmentID | Il valore GlobalID dell'incarico da aprire in Workforce |
|
assignmentStatus | Lo stato fornito ad un incarico quando viene aperto in Workforce |
|
Di seguito sono forniti alcuni esempi di utilizzo di questi parametri volti a ottenere un comportamento specifico con un link Workforce.
Connettersi a un portale specifico
Specificare l'URL del portale a cui deve essere connesso il lavoratore mobile.
come nell'esempio seguente:
https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgisScaricare e aprire una mappa
Scaricare e aprire una mappa utilizzando il parametro mapID. Se l'operatore mobile ha scaricato la mappa sul proprio dispositivo, non si verificherà nessun download e la mappa specificata viene aperta in Workforce.
Di seguito sono riportati degli esempi:
- Aprire la mappa come operatore mobile attualmente connesso o, se non connesso, fornire loro la possibilità di accedere:
https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d - Connettersi a un determinato portale, quindi aprire la mappa:
https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis&mapID=3ac4145c1ac44aea86e9ed42e00fbb0d
Apri un incarico
Aprire un incarico nella mappa usando il parametro assignmentID.
come nell'esempio seguente:https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d&assignmentID=948b2bf3-f866-4516-97e7-00418d3b567d
Impostare lo stato di un incarico
Impostare lo stato di un incarico usando il parametro assignmentStatus.
come nell'esempio seguente:https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d&assignmentID=948b2bf3-f866-4516-97e7-00418d3b567d&assignmentStatus=2
Nota:
È possibile, ma non consigliato, utilizzare questo parametro per impostare lo stato dell'incarico in modi che non sono possibili nell'app mobile. Ad esempio, se un incarico ha uno stato di Assegnato, è possibile utilizzare un link di Workforce per impostarlo su In pausa, saltando lo stato In corso che sarebbe impostato dal lavoratore mobile. Saltare questo stato non è possibile nell'app mobile.
Aprire l'app web Workforce da un link
È possibile rendere più fluida la distribuzione dell'app web Workforce condividendo un link attraverso un'email, un messaggio, una pagina web, un codice QR o un'altra app. I link possono essere personalizzati con i parametri URL per aprire un incarico esistente o nuovo con le informazioni concernenti l'incarico già inserite.
Fornendo un link ai mittenti, questi possono creare degli incarichi che hanno le informazioni chiave inserite. Ad esempio, per creare degli incarichi da un'app di terze parti, è possibile includere un link che inserisca automaticamente la posizione, la descrizione e la data di consegna di un nuovo incarico.
Struttura del link
I link all'app Web Workforce iniziano sempre con il seguente formato: http://<portal-url>/apps/workforce/projects/<project-id>
Per aprire un incarico specifico, aggiungere /dispatch/assignments/<assignment-id> al link: http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/<assignment-id>.
Per avviare la creazione di un incarico, aggiungere /dispatch/assignments/new? al link e includere uno o più parametri separati da una "e" commerciale (&):
http://<your portal url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair&lat=34.057170&lon=-117.194150&location=EsriNota:
Il valore project-id si può trovare nell'URL quando il progetto Workforce è aperto. Ad esempio, se l'URL è http://arcgis.com/apps/workforce/projects/a0f297f949f549f0ade07eee562d9934, il valoreproject-id è a0f297f949f549f0ade07eee562d9934.
Codificare i parametri
Tutti i parametri nei link all'app web Workforce devono essere codificati. La codifica sostituisce i caratteri non validi con il simbolo percentuale (%) seguito dal relativo equivalente esadecimale.
Ad esempio, il seguente link ha dei parametri non codificati:http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair hydrant&lat=34.057170&lon=-117.194150&location=Esri Campus
Di seguito è riportato lo stesso link con parametri codificati:http://<portal-url>/apps/workforce/<project-id>new?assignmentType=repair%20hydrant&lat=34.057170&lon=-117.194150&location=Esri%20Campus
Esistono molti siti web e strumenti gratuiti per la generazione di URL codificati. Ad esempio, Albion Research Ltd. dispone della pagina URLEncode and URLDecode Page.
Creare un'assegnazione
Creare un link che lancia l'app web Workforce con le informazioni sull'incarico già inserite per un nuovo incarico. Ad esempio, se si ha un'app personalizzata per la creazione di valutazioni degli alberi, si può creare un link che apre Workforce con il tipo d'incarico e le informazioni sulla posizione già inserite per un nuovo incarico di valutazione degli alberi.
Parametri
i parametri elencati in basso sono supportati per la creazione di incarichi con i link Workforce.
| Parametro | Valori | Note |
|---|---|---|
assignmentType | Il tipo d'incarico dato a un determinato incarico. |
|
lat | La coordinata y dell'incarico in WGS84 (WKID: 4326) |
|
lon | La coordinata x dell'incarico in WGS84 (WKID: 4326) |
|
location | Il testo della posizione usato per l'incarico |
|
priority | La priorità attribuita a un incarico |
|
dueDateTime | La data e l'ora di consegna assegnate all'incarico |
|
workOrderId | Una chiave che fa riferimento a un ordine lavoro da un sistema esterno o di terze parti |
|
description | Informazioni sull'incarico |
|
assignee | L'utente assegnato all'incarico |
|
Nota:
Tutti i parametri sono facoltativi, tuttavia, i parametri assignmentType, lat, lon elocation devono essere riempiti prima di poter creare il nuovo incarico.
Se si sta utilizzando ArcGIS Enterprise, lat e lon sono gli unici parametri supportati quando si sta creando un incarico da un link. L'app Web Workforce su ArcGIS Enterprise utilizza la geocodifica inversa per riempire il parametro location.
Esempi
Ecco degli esempi di come i parametri possono essere utilizzati all'interno del link di un'app per inserire delle informazioni quando si sta creando un incarico Workforce:
- Creare un incarico utilizzando le coordinate:
http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?lat=34.057170&lon=-117.194150 - Creare un incarico di valutazione degli alberi con un livello di priorità medio ed assegnarlo ad un lavoratore mobile:
http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=inspect%20tree&lat=34.057170&lon=-117.194150&location=esri&priority=2&assignee=mobile_worker - Creare un incarico di riparazione condotti da consegnare entro il 23 maggio alle 03:00:
http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=pipe%20repair&lat=34.057170&lon=-117.194150&location=esri&dueDateTime=1621782000000 - Creare un incarico di riparazione con una descrizione del problema:
http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair&&lat=34.057170&lon=-117.194150&location=esri&description=Repair%20the%20valve.
Gestione dei dispositivi mobili
La gestione dei dispositivi mobili fa riferimento al software utilizzato per l'amministrazione dei dispositivi mobili all'interno di un'organizzazione. Una MDM viene utilizzata per migliorare la sicurezza dei dati e della rete e per impostare e applicare le politiche dei dispositivi mobili. Inoltre, l'utilizzo di una MDM aumenta l'efficienza delle installazioni delle applicazioni e la gestione dei dispositivi mobili, includendo il controllo di come e quando viene aggiornata un'applicazione. Per ulteriori informazioni sull'approccio di Esri alla MDM, consultare Modelli d'implementazione mobile sicura di ArcGIS nel Centro di Trust di ArcGIS.
Durante la preparazione all'installazione di Workforce sui dispositivi mobili dell'organizzazione tramite MDM, è possibile configurare alcune impostazioni dell'applicazione e del profilo. Queste includono l'URL del portale e le impostazioni VPN dell'applicazione.
Attenzione:
Se si sta utilizzando un dispositivoAndroid, dovrà essere installato Chrome o un altro browser e dovrà essere abilitato per mostrare la schermata di accesso del portale.
Configurazione dell'app Workforce
La configurazione dell'applicazione (anche chiamata AppConfig) fa riferimento a un formato per la fornitura delle impostazioni dell'applicazione come l'URL del portale. Invece di configurare tali impostazioni manualmente ogni volta che viene installata un'applicazione mobile, è possibile utilizzare una MDM per specificare e applicare automaticamente le configurazioni dell'applicazione. Queste impostazioni sono definite in un dizionario di coppie di valori chiave in un file .xml. La modalità di creazione del dizionario dipende dalla MDM in uso. Per ulteriori informazioni sulla configurazione dell'app, visitare la pagina Web della AppConfig Community.
Workforce ha le seguenti impostazioni che possono essere implementate con la configurazione dell'applicazione nella MDM:
| Chiave | Valore | Note |
|---|---|---|
portalURL | L'URL del portale dell'organizzazione |
|
Rete privata virtuale per applicazione
La configurazione di una rete privata virtuale per applicazione (VPN per applicazione) in una MDM consente di limitare l'accesso alle risorse interne alle applicazioni gestite in maniera specifica. Workforce può essere installato con questa configurazione. Per configurare la VPN per applicazione con Workforce, consultare la documentazione del software per l'MDM in uso.
Attenzione:
Se si è su iOS, Safari viene utilizzato per mostrare la schermata di accesso del portale in Workforce. Affinché tutto ciò funzioni correttamente con la VPN per applicazione abilitata, il dominio del portale (ad esempio, mycompany.com) deve essere specificato nelle impostazioni dei Domini Safari nel profilo della VPN per applicazione in uso. Se i Domini di Safari non sono impostati correttamente, i dispositivi mobili assegnati non possono accedere alla schermata di accesso del portale di Workforce.
Quando si imposta un valore dei domini Safari nel profilo della VPN per applicazione come descritto in precedenza, il browser Safari può accedere inoltre al dominio del portale specificato nei domini Safari. Per bloccare questo accesso, configurare Restrizione iOS (se disponibile nella MDM) per utilizzare Blocca app browser Safari sui dispositivi desiderati.
Dopo aver configurato le impostazioni VPN per applicazione per Workforce nella MDM, l'pp si connette automaticamente alla VPN per applicazione indicata quando la si apre su un dispositivo mobile gestito. Quando Workforce è in esecuzione in background, la VPN per applicazione è connessa soltanto a Workforce. Quando Workforce è chiuso, il dispositivo mobile si disconnette automaticamente dalla VPN per applicazione.