Una domanda di immagine con l'aspetto draw o annotate permette agli utenti di disegnare uno schizzo su una tela vuota o annotare un immagine o uno snapshot di una mappa. L'app da campo ArcGIS Survey123 include una tavolozza di strumenti di disegno predefinita di otto strumenti, incluse frecce, simboli marcatori generici e etichette di testo. Per ulteriori informazioni riguardo la tavolozza predefinita, consultare Modalità draw.
In aggiunta agli strumenti di disegno predefiniti, è possibile creare tavolozze personalizzate per la configurazione di strumenti di disegno e di annotazione. Per esempio, un'organizzazione di servizi pubblici potrebbe avere simboli e stili di linee che fanno riferimento a installazioni elettriche o gas.
Nota:
Le tavolozze personalizzate non sono supportate nell'app Web ArcGIS Survey123.
Per creare una tavolozza personalizzata eseguire i seguenti passaggi:
- Configura l'ambiente Python in ArcGIS Survey123 Connect in modo da poter eseguire gli strumenti Nuovo modello XLSPalette e Converti XLSPalette.
- Preparare una tavolozza personalizzata usando la specifica XLSPalette.
- Accertati che il modello XLSPalette e i file associati siano inclusi nella cartella dei supporti del sondaggio.
- Converti il modello XLSPalette in file .palette eseguendo lo strumento Converti XLSPalette nella scheda Supporti in Survey123 Connect.
- Nel XLSForm del rilevamento impostare la colonna body::esri:style per una domanda di immagine con aspetto draw o annotate in modo da usare una tavolozza personalizzata invece che quella predefinita specificando palette=<palette_name>.
Una tavolozza personalizzata viene configurata prima in un modello XLSPalette. Il modello XLSPalette, quindi, deve essere convertito in file .palette in modo da poterlo aggiungere al rilevamento. I modelli XLSPalette vengono convertiti con uno strumento nella scheda Supporti in Survey123 Connect.
Preparare una tavolozza personalizzata
Le tavolozze personalizzate sono configurate in XLSPalette, un file .xlsx che contiene i fogli di lavoro che saranno convertiti in un file .palette che potrà essere utilizzato nel rilevamento.
Per iniziare con la progettazione di una tavolozza personalizzata, occorre un modello XLSPalette. Survey123 Connect include uno strumento Nuovo modello XLSPalette per creare un modello vuoto. Per eseguire lo strumento, è necessario configurare un ambiente Python in Survey123 Connect. Per maggiori informazioni, vedere ConfiguraPython.
Apri il sondaggio in Survey123 Connect. Per creare un modello XLSPalette, fai clic su Strumenti, quindi su Nuovo modello XLSPalette. Viene creato un file modello nella cartella supporti denominato myXLSPalette1.xlsx. In alternativa, è possibile scaricare una copia del Survey123 modello XLSPalette da ArcGIS Online.
Ogni foglio di lavoro nel modello XLSPalette è un insieme di strumenti: un gruppo di strumenti nella tavolozza personalizzata. Le righe in ogni foglio di lavoro definiscono gli strumenti di annotazione nell'insieme di strumenti. Il seguente esempio mostra una configurazione di XLSPalette per tre strumenti di annotazione per un'ispezione di un gasdotto, contenenti due strumenti linea e uno strumento di demarcazione:
| type | Etichetta | strumento | simbolo | textSymbol |
|---|---|---|---|---|
linea | Linea Gas (Nuovo) | linea | color=Blue&size=5&style=dash | color=MediumBlue&size=14&anchor=bottom&italic |
linea | Linea Gas (Esistente) | linea | color=Yellow&size=5&outline.color=Black&outline.size=1 | color=#FFFFE0&size=14&anchor=bottom |
marcatore | Metro (Nuovo) | meter.svg |
Per maggiori informazioni sulla sintassi e i parametri da utilizzare per progettare una tavolozza personalizzata, consultare Specifiche XLSPalette. La sintassi completa è descritta anche nel foglio di lavoro Riferimenti nel modello XLSPalette.
Accertati che il modello XLSPalette e i file immagine utilizzati dalla tavolozza, ad esempio simboli marcatore SVG o icone insieme di strumenti, siano inclusi nella cartella supporti del sondaggio. Il modello XLSPalette deve essere ora convertito in un file .palette in modo da poterlo aggiungere al rilevamento.
Converti tavolozza
Per eseguire lo strumento Converti XLSPalette, è necessario configurare un ambiente Python in Survey123 Connect. Per maggiori informazioni, vedere ConfiguraPython.
Aprire il rilevamento in Survey123 Connect e navigare fino alla scheda Media. La scheda Media elenca i contenuti della cartella media del rilevamento. Un pulsante Converti è collocato accanto ai file .xlsx. Fai clic sul pulsante Converti per eseguire lo strumento Converti XLSPalette per convertire il modello XLSPalette in un file .palette utilizzabile nel rilevamento.
Quando la conversione è completata, il file .palette viene salvato nella cartella media e compare nella scheda Media.
Suggerimento:
Il nome del file .palette è lo stesso del file .xlsx di origine. Questo nome verrà utilizzato come un parametro XLSForm, quindi assicurarsi che non ci siano spazi nel nome del file.
Aggiungere una tavolozza al rilevamento
Dopo aver creato e convertito una tavolozza personalizzata è possibile aggiungerla a XLSForm. È possibile aggiungere quante tavolozze personalizzate si desidera al rilevamento; solo una tavolozza può però essere utilizzata in ciascuna domanda draw o annotate.
Per una domanda immagine con l'aspetto draw o annotate, digita palette=<nome_tavolozza> nella colonna body::esri:style, dove <nome_tavolozza> è il nome del file tavolozza senza l'estensione .palette, ad esempio: palette=Elettrico.
La tavolozza personalizzata verrà ora utilizzata per la domanda di immagine al posto della tavolozza predefinita.
Per aggiornare una tavolozza personalizzata, apporta le modifiche necessarie al file .xlsx ed esegui nuovamente lo strumento Converti XLSPalette dalla scheda Supporti. Ciò sostituirà il file .palette nella cartella media, e le modifiche sono visibili in Survey123 Connect una volta che l'anteprima del modulo è aggiornata. Ripubblicare il rilevamento per vedere le modifiche nell'app da campo Survey123.
Specifiche XLSPalette
Le specifiche di XLSPalette sono progettate appositamente per la creazione di strumenti di disegno e annotazione in Survey123. Le tavolozze personalizzate sono configurate in un file .xlsx usando la sintassi di XLSPalette. Il modello XLSPalette consiste in:
- Uno o più fogli di lavoro del set di strumenti, contenenti le colonne type, tool, symbol e textSymbol. Un set di strumenti è un gruppo di strumenti in una tavolozza. Una tavolozza può contenere tanti set di strumenti quanti necessario. Il nome di ogni foglio di lavoro del set di strumenti sarà visibile nell'app di campo Survey123 come nome di ogni scheda del set in una tavolozza personalizzata.
- Un foglio di lavoro di Riferimento, che fornisce una guida alla sintassi e ai parametri, da utilizzare per progettare una tavolozza.
- Un foglio di lavoro Versione che fornisce informazioni su quando il modello XLSPalette è stato aggiornato l'ultima volta.
- Un foglio di lavoro Elenchi che contiene tabelle per la validazione dei dati nei fogli di lavoro dei set di strumenti. Non modificare il contenuto di questo foglio.
È possibile aggiungere o rimuovere i fogli di lavoro dei set di strumenti quanto necessario. Per aggiungere un nuovo foglio di lavoro del set di strumenti, creare una copia di un foglio esistente per assicurarsi che il formato e la validazione della data siano conservati. I fogli dei set di strumenti che non contengono righe oltre a quella dell'intestazione vengono ignorati quando viene convertito l'XLSPalette in un file .palette.
Durante il lavoro con le proprietà degli strumenti, considerare che:
- La maggior parte delle proprietà dei simboli vengono specificati come coppie name=value e sono separati da una "&".
- I colori possono essere specificati con nomi colore HTML standard o codici colore esadecimali. È possibile utilizzare codici esadecimali a otto caratteri per impostare l'opacità.
- Le unità di dimensione e ampiezza sono in pixel.
- I simboli di linea supportano modelli di trattini personalizzati.
- Se il tipo di strumento è testo, è richiesto un valore nella colonna textSymbol. Per tutti gli altri tipi il valore in textSymbol è facoltativo.
Tipologie e strumenti
Una tavolozza può contenere qualsiasi combinazione di tipologia di strumenti. I tipi supportati sono linea, area, marcatore e testo, e devono essere forniti nella colonna tipo in ogni foglio di lavoro insieme di strumenti.
I tipi linea, area e testo supportano diversi strumenti che determinano lo stile del disegno di tale tipo. È possibile specificare lo strumento nella colonna strumento su ogni foglio di lavoro del set di strumenti. Non è necessario specificare uno strumento per i tipi marcatore e testo.
Per una lista completa degli strumenti supportati, consultare il foglio Riferimento nel modello XLSPalette.
Simbologia
Ogni strumento supporta varie proprietà simbolo che possono essere specificate nella colonna simbolo su ogni foglio di lavoro del set di strumenti.
Per le linee, è possibile specificare un formato tratteggiato personalizzato usando una o più coppie di spazio solido nel formato [n,n...], dove n è la lunghezza relativa del segmento, per esempio [4,3,2,3].
Per i simboli marcatore, il primo valore può essere il nome di un simbolo marcatore semplice di Esri o un nome file immagine con estensione del file. I formati immagine supportati sono SVG, PNG e JPG. I simboli marcatore semplici sono il cerchio, la croce, il diamante, il quadrato, il triangolo e la x.
Per una lista completa dei simboli e delle proprietà consultare il foglio Riferimento nel modello XLSPalette.
Testo
Ciascuno strumento può avere un'etichetta testuale corrispondente. È anche possibile specificare un'etichetta a sé stante usando il tipo testo. La formattazione del testo è specificata nella colonna textSymbol su ogni foglio di lavoro del set di strumenti.
Per la proprietà alignment è possibile specificare diversi valori di allineamento separati da una virgola, per esempio alignment=left,middle.
La proprietà anchor si applica solo ai tipi linea, area e marcatore, e specifica dove verrà posizionata l'etichetta relativamente all'elemento grafico.
Per una lista completa degli stili e delle proprietà consultare il foglio Riferimento nel modello XLSPalette.
Icona del set di strumenti
Le icone dei set di strumenti vengono mostrate con i loro nomi nelle tavolozze. Per impostazione predefinita, se tutti gli strumenti in un set usano lo stesso strumento, l'icona viene automaticamente impostata per corrispondere a tale strumento. Per specificare un'icona per un insieme di strumenti, accoda &icon= al nome del foglio di lavoro, seguito dal nome di un'icona dalla libreria di Icone IU Calcite di Esri o un file immagine salvato nella cartella supporti. I formati immagine supportati sono SVG, PNG e JPG.
Suggerimento:
Per risultati migliori, usare un singolo colore su uno sfondo trasparente per le icone dei set di strumenti. Le icone del set di strumenti sono visualizzate in scala di grigi nella tavolozza.
I nomi dei fogli di lavoro sono limitati a 31 caratteri e possono includere spazi, per esempio New Works&icon=electric.svg.