Skip To Content

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 negli elementi della libreria di frammenti di codice del notebook, che vengono utilizzati per organizzare i propri 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 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. In alternativa, selezionare una cartella ne Il mio contenuto in cui salvare la propria libreria di frammenti di codice.
  5. Fare clic su Crea.

Quando si crea una libreria di frammenti di codice, questa viene archiviata nella propria organizzazione come qualsiasi altro elemento. È possibile gestire le proprie librerie di frammenti di codice facendo clic sul pulsante Altre opzioni, Altro nel riquadro Frammenti di codice e facendo clic su Gestisci elementi della libreria. Dalla finestra Gestisci elementi della libreria di frammenti di codice, è possibile creare una nuova libreria di frammenti di codice e, per ogni libreria di frammenti di codice, è possibile condividere, modificare, visualizzare la pagina dei dettagli dell'elemento e contrassegnare una libreria come deprecata.

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 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 anche il numero di frammenti presenti in quella libreria.

  4. Aggiungere il codice per il frammento eseguendo una delle seguenti operazioni:
    • 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.
    • Se il notebook utilizza il runtime versione 7.0 o precedenti, inserire il codice per il frammento di codice.
      Nota:

      Copia e incolla 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, Altro per il frammento. Il menu a discesa Ulteriori opzioni fornisce le opzioni Modifica, Disattiva ed Elimina utilizzabili su un frammento.

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 Aggiungi nel riquadro dei frammenti di codice oppure fare clic su Inserisci nel notebook nel riquadro dell'anteprima del codice per inserire il frammento di codice nel notebook 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.

    • Controllare i crediti rimanenti (solo ArcGIS Online)
    • Controllare i crediti di un utente specifico (solo ArcGIS Online)
    • Acquisire l'URL del servizio base di un elemento layer
    • Interrogare attività notebook non riuscite
    • Interroga i registri del portale e salva come CSV (solo ArcGIS Enterprise)
    • Accedere 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 in una directory del workspace
    • Creare un file geodatabase con una feature class vuota
    • Creare una cartella nella directory del workspace
    • Scaricare un elemento file dal portale nella directory del workspace
    • Elencare dataset
    • Elencare file
    • Rimuovere un file geodatabase nella directory del workspace
    • Rimuovere una cartella nella directory del workspace
    • Decomprimere un file nella directory del workspace
  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 feature layer
    • Convertire una feature class in DataFrame abilitato spazialmente
    • Convertire un feature layer in DataFrame abilitato spazialmente
    • Convertire un DataFrame abilitato spazialmente in feature class
    • Visualizzare un'immagine da un URL
    • Visualizzare un'immagine dalla directory del workspace
    • Inserire i valori mancanti
    • Elencare i campi in una feature class
    • Elencare i campi in un layer
    • Elencare i layer in un elemento
    • Tracciare un DataFrame abilitato spazialmente (avvio rapido)
    • Tracciare un DataFrame abilitato spazialmente con il renderer di interruzione classe
    • Tracciare un DataFrame abilitato spazialmente con un semplice renderer
    • Tracciare un DataFrame abilitato spazialmente con un renderer univoco
    • Pubblicare un DataFrame abilitato spazialmente come feature layer