Calcola Campo

Nota:

Questo strumento è disponibile solo in ModelBuilder.

Lo strumento Calcola campo utilizza un'espressione SQL per calcolare i valori di un campo nuovo o esistente. Sovrascrivendo un campo per il dataset di output non si influisce sui valori di campo nel dataset di input.

L'output è una variabile dei dati di output che può essere configurata come un layer intermedio o un layer ospitato.

Esempi

Di seguito vengono forniti alcuni esempi di utilizzo di questo strumento:

• Un dataset include campi per la numerazione degli edifici residenziali con pannelli solari sul tetto e il numero totale di edifici residenziali per quartiere. Calcola campo può essere utilizzato per creare un nuovo campo e calcolare il tasso di assorbimento solare per ogni quartiere.
• Un dataset include un campo numerico in cui -9999 è stato utilizzato come valore segnaposto, che potrebbe compromettere i risultati dell'analisi se questo campo fosse utilizzato come input. Calcola campo può essere utilizzato per cambiare il valore del campo in un valore predefinito appropriato per il subset di registrazione con il segnaposto -9999.

Note sull'utilizzo

Calcola campo include configurazioni per input, calcolo dei campi e layer risultato.

Input

Il gruppo Input include i seguenti parametri:

• Dataset di input specifica se l'input è un feature layer ospitato o un layer tabella ospitato. È possibile scegliere un dataset facendo clic su Layer .

• Applica i calcoli solo ad alcuni record definisce i criteri che determinano a quale sottoinsieme di record sarà applicato il calcolo del campo. Le feature che soddisfano tutti i criteri saranno incluse nel sottoinsieme. Per definire un'interrogazione, fai clic su Crea nuova interrogazione. Deve essere specificato un dataset di input per modificare l'espressione.

  Per applicare il calcolo a tutti i record, lasciare questo parametro in bianco.

  Ulteriori informazioni sulla creazione di un'interrogazione

Calcolo di campo

Il gruppo Calcolo di campo include i seguenti parametri:

• Campo da calcolare specifica il campo in cui saranno aggiunti i valori calcolati. È possibile scegliere da un elenco di campi esistenti o creare un nuovo campo.

  Se viene scelto un campo esistente, tutti i valori attualmente all'interno del campo saranno sovrascritti.

  Nota:

  Calcola campo crea un nuovo dataset di output. Sovrascrivendo un campo per il dataset di output non si influisce sui valori di campo nel dataset di input.

  Per creare un nuovo campo, fare clic su Crea nuovo campo e fornire le seguenti informazioni:
  • Nome campo: immettere un nome per il nuovo campo. Il nome del campo non può corrispondere a un nome esistente nel layer, non può contenere caratteri speciali o spazi e non può essere una parola chiave SQL.
  • Tipo campo: selezionare un tipo di campo dal menu. Il tipo di campo determinerà quali tipi di dati ed espressioni sono supportate per il calcolo del campo. Sono supportati i seguenti tipi di campo:
    • Doppio: numeri con posizioni decimali.
    • Intero: numeri interi compresi tra -2.147.483.648 e 2.147.483.647 (valore intero lungo).
    • Intero grande: numeri interi compresi tra -9.007.199.254,.40.991 e 9.007.199.254.740.991. Usare questo tipo quando occorre memorizzare numeri che non rientrano nell'intervallo del tipo di dati interi.
    • Stringa: qualsiasi sequenza di caratteri.
    • Data: data e ora.
    • Solo data: memorizza i una data ma non i valori dell'ora. Utile quando l'ora non è necessaria, ad esempio per registrare il giorno di scadenza di un permesso.
    • Solo ora: memorizza l'ora ma non i valori delle date. Il formato dell'ora è determinato dalle impostazioni utente. Questo tipo di dati di campo è utile per registrare valori come orari di partenza.

• Espressione di calcolo del campo definisce un'espressione SQL utilizzata per calcolare i valori per Campo da calcolare. Fare clic su Espressione per aprire la finestra Editor espressione SQL. All'interno della finestra Editor espressione SQL, utilizzare Campi , Funzioni e operatori di base per creare un'espressione valida.

  Ulteriori informazioni sulla scrittura di espressioni SQL

  Se l'output dell'espressione e il tipo di campo sono parzialmente compatibili (per esempio i tipi di campo doppio e intero supportano entrambi gli output numerici ma con restrizioni diverse) i valori verranno trasformati automaticamente per soddisfare i requisiti del tipo di campo. La trasformazione avverrà automaticamente e senza nessuna notifica.

  La tabella che segue descrive come certi output saranno trasformati per compatibilità con il tipo di campo:

  Output	Tipo di campo	Trasformazione
  Double	Intero	Arrotondare il numero intero più prossimo
  Solo data	Data	Aggiungi 12:00 a.m. UTC a ciascuna data
  Data	Solo data	Converti la data e l'ora in UTC e salva la data
  Data	Solo ora	Converti la data e l'ora in UTC e salva l'ora

Layer risultato

Il gruppo Layer risultato include i seguenti parametri:

• Tipo di risultato specifica se l'output è un layer intermedio o un feature layer ospitato. Sono disponibili le seguenti opzioni:
  • Crea dati intermedi crea un dataset temporaneo che può essere utilizzato come input per un altro elemento di strumento. Questa è l'impostazione predefinita per tutti gli strumenti in un modello.
  • Crea layer ospitato crea un nuovo layer ospitato per il dataset di output. Se questa opzione viene scelta, sono disponibili i seguenti parametri:
    • Nome output specifica il nome del layer creato e visualizzato. Il nome deve essere unico. Se un layer con lo stesso nome esiste già nell'organizzazione, lo strumento non funzionerà e verrà chiesto di utilizzare un nome diverso.
    • Se esiste un layer con lo stesso nome, sovrascrivilo automaticamente determina se il modello può essere rieseguito senza modificare il nome del layer di output. Se il layer non esiste già nell'organizzazione, verrà creato un nuovo layer alla prima esecuzione del modello e verrà sovrascritto nelle successive esecuzioni del modello. Questo parametro è abilitato per impostazione predefinita.
    • Salva nella cartella specifica il nome di una cartella in I miei contenuti in cui verrà salvato il risultato.
  • Sovrascrivi layer esistente specifica un layer ospitato esistente che sarà sovrascritto dall'output dello strumento. Se questa opzione viene scelta, il parametro Layer da sovrascrivere è disponibile per cercare un layer esistente.

Ulteriori informazioni sugli output modello

Limitazioni

Allo strumento si applicano le seguenti limitazioni:

• Calcola campo è disponibile solo in ModelBuilder. Se non si sta utilizzando ModelBuilder, è possibile calcolare i valori dei campi in Map Viewer.
• Le espressioni spaziali non sono supportate.
• Gli elenchi dei valori di campo non sono disponibili nel builder delle interrogazioni quando il layer o tabella di input è l'output di un altro strumento.
• Se il valore calcolato per un campo stringa o numerico supera i limiti di lunghezza del campo, l'output apparirà nullo per i nuovi campi o manterrà il valore del campo di input per i campi esistenti.
• I calcoli di campo che utilizzano campi di input e output incompatibili possono produrre risultati imprevisti. Ad esempio, utilizzando un campo Solo ora per calcolare un risultato Solo data, si otterrà la data 1899-12-30 per tutti i campi. Altre combinazioni di campi incompatibili includono ingressi Solo ora con uscite Data e ingressi Solo data con uscite Solo ora.

Ambienti

Questo strumento non tiene conto degli ambienti di analisi.

Crediti

Questo strumento non consuma crediti.

Output

Calcola campo crea una variabile dei dati di output che potrebbe rappresentare dati intermedi o ospitati. Il dataset di output ha la stessa geometria e campi del dataset di input, a meno che sia aggiunto un nuovo campo per il calcolo.

Nota:

Calcola campo crea un nuovo dataset di output. Sovrascrivendo un campo per il dataset di output non si influisce sui valori di campo nel dataset di input.

Requisiti per la licenza

Questo strumento richiede il seguente tipo di utente e le seguenti configurazioni:

• Tipo di utente Professional o Professional Plus
• Ruolo Publisher, Facilitator o Amministratore, o un ruolo personalizzato equivalente

Risorse

Usare le seguenti risorse per saperne di più:

• Come creare un'interrogazione
• Calcolare valori di campo (Map Viewer)
• Calcola campo in ArcGIS Data Pipelines
• Calcola campo in ArcGIS Pro