Usare Python snippet di codice

Introdotto in ArcGIS Enterprise 11.0, ArcGIS Notebook Server consente di sfogliare e inserire nel notebook snippet di codice riutilizzabili, note come snippet di codice.

Creare un frammento di codice

Puoi creare un frammento di codice dal tuo notebook. I frammenti creati possono essere utilizzati nello stesso notebook o in altri notebook. I frammenti di codice creati vengono memorizzati in elementi della libreria di frammenti di codice del notebook nei tuoi contenuti, che vengono utilizzati per organizzare i frammenti, e possono essere condivisi.

Per creare un frammento di codice, devi prima creare una libreria di frammenti di codice del notebook in cui memorizzare i frammenti. Una libreria di frammenti di codice può includere fino a 100 frammenti.

Creare una libreria di frammenti di codice del notebook

Per creare una libreria di frammenti di codice, completa la procedura seguente:

1. Nella barra multifunzione superiore dell'editor di notebook, fai clic su Frammenti di codice.
2. Fai clic sul pulsante Aggiungi e scegli Crea elemento libreria.
3. Inserire un titolo e un riepilogo per la libreria e, facoltativamente, aggiungere i tag che rappresentano i frammenti di codice memorizzati nella libreria.
4. Fare clic su Crea.

Aggiungere un frammento di codice

Una volta creata una libreria, puoi aggiungervi frammenti di codice. Per aggiungere un frammento di codice, procedi nel modo seguente:

1. Nella barra multifunzione superiore dell'editor di notebook, fai clic su Frammenti di codice.
2. Fai clic sul pulsante Aggiungi e scegli Aggiungi frammento di codice.
3. Inserisci un titolo per il frammento di codice, scegli la libreria in cui aggiungerlo e inserisci una descrizione.

   L'elenco a discesa Seleziona un elemento di libreria frammento di codice visualizza le librerie a cui è possibile aggiungere il frammento di codice. L'elenco indica inoltre il numero di frammenti in tale libreria la cui proprietà di condivisione è impostata su Eredita.

4. Aggiungere il codice per il frammento.
   1. Se il notebook utilizza il runtime versione 8.0 o successive, selezionare la cella che si desidera aggiungere come frammento di codice e fare clic su Copia da cella attiva.
   2. Se il notebook utilizza il runtime versione 7.0 o precedenti, inserire il codice per il frammento di codice.

   Nota:

   Per i notebook che utilizzano il runtime versione 7.0 o precedenti, copiare e incollare il codice dalla cella del notebook invece di digitare direttamente il codice, per evitare errori di indentazione o altri errori di sintassi.

5. Fare clic su Salva.

È possibile apportare modifiche ai frammenti di codice facendo clic sul pulsante Ulteriori opzioni, per il frammento e facendo clic su Modifica.

Inserire uno snippet di codice

Utilizzando il riquadro Frammenti di codice, completare i seguenti passaggi per inserire un frammento di codice:

1. Nella barra multifunzione superiore dell'editor di notebook, fai clic su Frammenti di codice.
2. Accedi alla libreria di frammenti di codice contenente il frammento da inserire.
3. Fai clic su Visualizza dettagli per il frammento, per visualizzare un'anteprima del codice.
4. Una volta trovato il frammento di codice da inserire, fare clic sul pulsante Aggiungi, nel riquadro dei frammenti di codice oppure fare clic su Aggiungi al notebook nel riquadro dell'anteprima del codice per inserire il frammento di codice nel suo blocco note come una nuova cella.

Di seguito è riportato un esempio di frammento di codice che viene aggiunto al notebook.

# curated code snippet inserted from the Code snippets pane
from arcgis.gis import GIS
def check_org_credits_agol(gis: GIS):
    if "admin" in gis.__dict__:
        credits = gis.admin.credits.credits
        print(f"This ArcGIS Online organization has {credits} credits.")
    else:
        print("Please connect to the ArcGIS Online organization as an administrator to check credits.")

# create a GIS instance to pass to the code snippet function
gis_agol = GIS("https://www.arcgis.com/", "<admin_username>")

# call the code snippet function with your GIS instance
check_org_credits_agol(gis_agol)

Snippet di codice Esri

Tutti gli snippet di codice disponibili sono curati da Esri. Questi snippet di codice curati consentono di implementare i flussi di lavoro GIS più comuni nei propri notebook. Gli snippet di codice sono scritti come funzioni Python che possono essere inserite nel notebook e richiamate in tutto il notebook. È inoltre possibile modificare uno snippet di codice una volta aggiunto al notebook.

Nota:

Nella versione 11.0, i nomi e le descrizioni degli snippet di codice curati sono disponibili solo in inglese.

Di seguito sono riportati frammenti di codice disponibili che puoi inserire nel tuo notebook:

1. Amministrazione del GIS: frammenti di codice che eseguono attività comuni di amministrazione del GIS.

   Nota:

   Molti di questi snippet di codice richiedono una connessione di amministratore.

   • Controlla i crediti rimanenti (solo ArcGIS Online).
   • Controlla i crediti di un utente specifico (solo ArcGIS Online).
   • Ottiene l'URL del servizio di base di un elemento del livello.
   • Interrogare i registri del portale e salvare come CSV (solo ArcGIS Enterprise).
   • Accedi al portale per ArcPy.
2. Gestione dei contenuti: snippet di codice che aiutano a gestire i contenuti del GIS e i file nella directory dell'area di lavoro del notebook.
   • Copiare un geodatabase nella directory dell'area di lavoro.
   • Creare un geodatabase di file con una feature class vuota.
   • Creare una cartella nella directory dell'area di lavoro.
   • Scarica un elemento di file dal portale alla directory dell'area di lavoro.
   • Elencare i dataset.
   • Elenco file.
   • Rimuovere un file geodatabase nella directory dell'area di lavoro.
   • Rimuovere una cartella nella directory dell'area di lavoro.
   • Decomprimere un file nella directory dell'area di lavoro.
3. Scienza dei dati e analisi: frammenti di codice che possono essere implementati nei flussi di lavoro di scienza dei dati e analisi utilizzando ArcGIS API for Python, ArcPy e altre librerie Python.

   Nota:

   Usare il runtime avanzato del notebook per eseguire gli snippet di codice che richiedono ArcPy. Per ulteriori informazioni sui runtime dei notebook, consulta Specificare il runtime di un notebook.

   • Convertire una feature class in un feature layer.
   • Convertire una feature class in un dataframe spazialmente abilitato.
   • Convertire un feature layer in un dataframe con abilitazione spaziale.
   • Convertire un DataFrame spazialmente abilitato in una feature class.
   • Visualizza un'immagine da un URL.
   • Visualizza un'immagine dalla directory dell'area di lavoro.
   • Riempire i valori mancanti.
   • Elenca i campi in una feature class.
   • Elenca i campi in un layer.
   • Elenca i layer in un elemento.
   • Tracciare un DataFrame con abilitazione spaziale (avvio rapido).
   • Tracciare un DataFrame spazialmente abilitato con il renderer di classe break.
   • Tracciare un DataFrame spazialmente abilitato con un semplice renderer.
   • Tracciare un DataFrame con abilitazione spaziale e rendering di valori unici.
   • Pubblicare un DataFrame abilitato allo spazio come Feature Layer.