Skip to main content

Strumento Dati di output

Lo strumento Dati di output consente di scrivere i risultati di un flusso di lavoro in un file o in un'origine dati di tipo supportato.

Seleziona lo strumento Dati di output nella tavolozza degli strumenti e trascinalo nell'area di disegno del flusso di lavoro.

Componenti dello strumento

Output Data with Anchors.png

Figura: strumento Dati di output con ancoraggio.

Lo strumento Dati di output ha un ancoraggio.

Ancoraggio di input: consente di collegare l'ancoraggio di input al flusso di lavoro, così da scrivere i risultati del flusso di lavoro in un'origine dati o in un tipo di file supportato.

Configura lo strumento

Salvataggio tramite connessioni basate su file

Per scrivere i risultati del flusso di lavoro in una connessione basata su file:

  1. Nella finestra di configurazione dello strumento, fai clic su Seleziona la posizione di output per aprire la finestra Dati di output.

  2. Seleziona una connessione dati cloud in Connessioni o seleziona uno dei Dataset esistenti.

  3. Inserisci un Nome file. Se lo desideri, puoi selezionare l'icona {x} (Aggiungi parametro) per aggiungere parametri al valore di Nome file. Per ulteriori informazioni, consulta la sezione Parametri.

  4. Seleziona il Formato di file:

    • CSV: valori separati da virgole (.csv)

    • XLS: Microsoft Excel 1997-2003 (.xls)

    • XLSX: Microsoft Excel (.xlsx)

  5. A questo punto, scegli la posizione in cui salvare i dati di output. Puoi usare il valore predefinito di Percorso file o selezionare la casella di spunta Personalizza posizione per scegliere un percorso diverso. Se selezioni una posizione personalizzata, puoi usare l'icona {x} (Aggiungi parametro) per aggiungere parametri al percorso del file. Per ulteriori informazioni, consulta la sezione Parametri.

  6. Seleziona Avanti per personalizzare le Opzioni di output.

  7. Il menu a discesa Azioni di output su ogni esecuzione consente di selezionare l'azione da eseguire se, al momento dell'esecuzione del processo, esiste già un file con lo stesso nome.

    1. Per i file CSV:

      1. Crea nuovo

      2. Sovrascrivi

    2. Per i file di Excel:

      1. Crea nuova cartella di lavoro

      2. Sovrascrivi cartella di lavoro

      3. Crea nuovo foglio

      4. Sovrascrivi foglio esistente

      5. Aggiungi a foglio

      Ora è possibile scrivere contemporaneamente su fogli diversi in una cartella di lavoro di Excel. Ciò significa che puoi utilizzare 2 o più strumenti di output per scrivere su fogli separati nella stessa cartella di lavoro. Per eseguire questa operazione non è necessario lo strumento Blocca fino alla conclusione. La concorrenza è supportata solo quando è selezionata l'opzione Sovrascrivi foglio esistente.

  8. Quando selezioni il formato di file CSV, devi selezionare anche un Delimitatore, scegliendo fra Virgola, Tabulazione, Barra verticale e Punto e virgola.

  9. Scegli le opzioni aggiuntive per l'output:

    • Includi virgolette (solo formato file CSV)

    • Nome foglio (solo per i formati XLS e XLSX)

    • Output della partizione (solo per i formati XLS e XLSX): specifica se desideri pubblicare il file come file singolo o come file con più fogli. Se questa opzione è selezionata, seleziona dal menu a discesa Partizione tramite colonna la colonna da utilizzare per partizionare i fogli in base ai valori delle colonne.

    • Mantieni colonna di partizione nell'output (solo per i formati XLS e XLSX): deseleziona questa opzione se desideri escludere la colonna utilizzata per il partizionamento dall'output finale. Ad esempio, se dividi in base al trimestre, puoi escludere la colonna "Quarter" dall'output.

    • Includi nomi colonna come prima riga

  10. Seleziona Conferma per salvare i dettagli relativi ai dati di output. A questo punto puoi rivedere le impostazioni selezionate nel pannello di configurazione dello strumento Dati di output e, se necessario, modificarle utilizzando l'icona a forma di matita.

  11. Seleziona Esegui processo nel flusso di lavoro e salva il file nella connessione che hai scelto.

Salvataggio tramite connessioni basate su SQL

Per scrivere i risultati del flusso di lavoro utilizzando una connessione basata su SQL:

  1. Nella finestra di configurazione dello strumento, fai clic su Seleziona la posizione di output per aprire la finestra Dati di output.

  2. Seleziona una connessione dati cloud in Connessioni o seleziona uno dei Dataset esistenti.

  3. Inserisci un nuovo valore in Nome tabella. Se lo desideri, puoi selezionare l'icona {x} (Aggiungi parametro) per aggiungere parametri al valore di Nome tabella. Per ulteriori informazioni, consulta la sezione Parametri.

  4. Quindi, seleziona lo schema in cui desideri salvare la tabella e fai clic su Avanti.

  5. Il menu a discesa Azioni di output su ogni esecuzione consente di selezionare l'azione da eseguire se, al momento dell'esecuzione del processo, esiste già una tabella con lo stesso nome.

    • Crea nuova tabella: consente di creare una nuova tabella.

    • Accoda a una tabella: i dati vengono aggiunti alla fine della tabella esistente.

    • Tronca tabella esistente: i dati presenti nella tabella vengono eliminati e sostituiti con i nuovi dati.

    • Rilascia tabella esistente: la tabella esistente viene eliminata e sostituita dalla nuova tabella.

    • Unisci a tabella esistente: i dati di output vengono uniti a quelli della tabella esistente.

  6. Seleziona Conferma per salvare i dettagli relativi ai dati di output. A questo punto puoi rivedere le impostazioni selezionate nel pannello di configurazione dello strumento Dati di output e, se necessario, modificarle utilizzando l'icona a forma di matita.

  7. Seleziona Esegui processo nel flusso di lavoro e salva il file nella connessione che hai scelto.

Scarica file

Per scaricare i dati di output sul computer in uso, devi prima salvarli in Alteryx One. L'opzione più rapida consiste nel salvare il file in una posizione predefinita dell'archiviazione di base. Puoi anche personalizzare la posizione all'interno dell'archiviazione di base o scegliere un connettore diverso.

Dopo aver eseguito il flusso di lavoro, accedi allo strumento Output nell'area di disegno e seleziona Download nella sezione Processo del pannello di destra.

Parametri

La finestra Parametri consente di applicare valori di stringa o timestamp dinamici ai dati di output. Puoi applicare parametri a nomi di file, percorsi di file e nomi di tabella, a seconda del tipo di connessione cloud.

  • I parametri di tipo Stringa hanno un valore predefinito che può essere sovrascritto a ogni esecuzione di processo, nell'ambito di una programmazione o di un piano.

  • I parametri di tipo Timestamp vengono popolati automaticamente con un timestamp formattato, al momento dell'esecuzione del processo.

Per aggiungere un parametro a un Nome file o a un Nome tabella...

  1. Nel campo Nome file o Nome tabella, seleziona l'icona {x} (Aggiungi parametro) per aprire la finestra Parametri.

  2. Se hai già creato un parametro, puoi selezionarlo nella sezione Parametri spazio di lavoro. Ricorda che i parametri vengono inseriti nella posizione in cui si trova il cursore nel campo Nome file. Per rimuovere un parametro dal nome di un file, fai clic sul parametro e seleziona Rimuovi.

  3. Se è necessario creare un nuovo parametro, seleziona + Nuovo. Puoi anche selezionare il collegamento Gestisci parametri per aprire la pagina Parametri, che consente di creare nuovi parametri e modificare quelli esistenti.

Per utilizzare un parametro in Percorso file...

  1. Seleziona la casella di spunta Personalizza posizione.

  2. Seleziona l'icona di modifica (matita) accanto a Percorso file.

  3. Seleziona l'icona {x} (Aggiungi parametro) per aprire la finestra Parametri.

  4. Se hai già creato un parametro, puoi selezionarlo nella sezione Parametri spazio di lavoro. Ricorda che i parametri vengono inseriti nella posizione in cui si trova il cursore nel campo Nome file. Per rimuovere un parametro dal nome di un file, fai clic sul parametro e seleziona Rimuovi.

  5. Se è necessario creare un nuovo parametro, seleziona + Nuovo. Puoi anche selezionare il collegamento Gestisci parametri per aprire la pagina Parametri, che consente di creare nuovi parametri e modificare quelli esistenti.

Creazione di un parametro di tipo Stringa

Puoi utilizzare un parametro di tipo Stringa per etichettare dinamicamente i dati di output.

  1. Per creare un parametro di tipo Stringa, seleziona + Nuovo nella finestra Parametri, quindi seleziona Stringa dal menu a discesa Tipo.

  2. Inserisci un Nome per il parametro. Questo è il nome che viene visualizzato nel campo Nome file quando utilizzi il parametro.

  3. Inserisci una Descrizione. Dovrebbe essere una descrizione chiara, che sarà utile sia a te che agli altri utenti in futuro.

  4. Immetti un Valore predefinito per il parametro. Tale valore viene utilizzato quando il parametro non viene aggiornato dinamicamente.

  5. Seleziona Crea per creare il parametro e aggiungerlo al nome o al percorso. Per rimuovere un parametro, selezionalo e fai clic su Rimuovi.

Creazione di un parametro di tipo Timestamp

Puoi utilizzare un parametro di tipo Timestamp per inserire automaticamente un timestamp formattato al momento dell'esecuzione del processo.

Nota

A differenza dei parametri di tipo Stringa, i parametri di tipo Timestamp non vengono memorizzati nella pagina Parametri.

  1. Per creare un parametro di tipo Timestamp, seleziona + Nuovo dalla finestra Parametri, quindi seleziona Timestamp dal menu a discesa Tipo.

  2. Personalizza il valore di Formato timestamp in base alle tue esigenze. Il formato predefinito è yyyy-MM-dd. Per visualizzare le opzioni di personalizzazione, seleziona il pulsante +. In Anteprima formato viene visualizzata la data odierna utilizzando il formato selezionato.

  3. Imposta quindi il Valore timestamp. Scegli tra...

    • All'inizio del processo: genera il valore esatto della data e ora di avvio del processo.

    • In relazione all'inizio del processo: genera un timestamp relativo, rispetto all'ora di inizio del processo, che indica ad esempio 1 ora dopo l'inizio del processo.

      • Occorrenza: puoi scegliere di generare un timestamp Dopo o Prima della data/ora di inizio del processo.

      • Valore: scegli un valore numerico per la data e l'ora relative.

      • Unità: scegli un'unità di misura per la data e l'ora relative, Le opzioni includono:

        • Minuti

        • Ore

        • Giorni

        • Settimane

        • Mesi

        • Trimestri

        • Anni

  4. Quindi, seleziona un Fuso orario per il parametro del timestamp.

  5. Infine, seleziona Crea per creare il parametro e inserirlo nella posizione del cursore.

Parametri di sostituzione

Quando esegui un flusso di lavoro con parametri di tipo Stringa, vengono utilizzati i valori predefiniti specificati durante la creazione dei parametri. Tuttavia, è possibile ignorare questi valori.

Per sostituire il valore predefinito dei parametri di tipo Stringa...

  1. Seleziona l'icona del menu a discesa visualizzata sul pulsante Esegui processo.

  2. Seleziona Parametri per aprire la finestra Parametri di sostituzione.

  3. Inserisci i valori sostitutivi nella colonna Valore di sostituzione, per tutti i parametri in cui non desideri utilizzare il valore predefinito.

  4. Seleziona Salva ed esegui il processo per eseguire il flusso di lavoro con i valori aggiornati dei parametri.