Strumento Output dei file SharePoint

Versione:

2023.1

Last modified: May 31, 2022

Use the SharePoint Files Output tool to write data to your CSV, XLSX, and YXDB files as well as lists in your SharePoint site.

This tool is not automatically installed with Designer. To use this tool, download it from the Alteryx Community.

SharePoint Files Output version 2.1.0 also contains lists writing functionality which was a standalone data connector. Please note compatibility with Designer to maintain full functionality of the SharePoint Files data connector.

Configurazione dello strumento

Questo processo si applica a Microsoft SharePoint Online. Per installare lo strumento Output dei file SharePoint, in Designer apri il file YXI dei file SharePoint disponibile nella community di Alteryx.

Per installare lo strumento Output dei file SharePoint per tutti gli utenti, apri Designer come amministratore.

Per aggiungere Output dei file SharePoint nel flusso di lavoro, vai alla categoria di strumenti Connettori, seleziona Output dei file SharePoint e trascina lo strumento nel canvas.
Per l'autenticazione viene utilizzato il metodo OAuth.
- Per l'autenticazione cloud:
  - Registrati tramite browser Internet: utilizza l'applicazione Alteryx predefinita.
  - Fornisci le informazioni di autenticazione: utilizza la tua applicazione OAuth.Per eseguire l'autenticazione, immetti il tuo nome utente e la password. Per pianificare il flusso di lavoro su Server quando si utilizzano i servizi cloud, è necessario abilitare Usa entità del servizio (autenticazione solo app) in modo che il token abbia una scadenza estesa. Quando utilizzi lo strumento Input file SharePoint per la prima volta, devi fornire all'app il consenso per utilizzare le autorizzazioni elencate. Per informazioni su come creare un'applicazione API personalizzata, consulta Configurazione dell'applicazione API personalizzata.
    
    A seconda dei criteri aziendali, alcune autorizzazioni potrebbero richiedere l'approvazione dell'amministratore. In questo caso, inserisci il motivo nell'app e invia una richiesta o contatta direttamente il tuo team IT.
- Per l'autenticazione in locale:
  - Inserisci nome utente, password e URL.
  - Connettiti all'URL con l'account Windows.
Ora puoi scegliere le opzioni per Sito e Libreria documenti(puoi anche utilizzare Cerca).
Seleziona Aggiungi file e immetti il nome del file o seleziona un campo contenete il nome del file. L'estensione viene aggiunta automaticamente in base al formato del file selezionato.
Seleziona il pulsante Crea.
È anche possibile aggiungere una cartella (Aggiungi cartella), che viene selezionata automaticamente.
La scheda Opzioni mostra varie alternative, a seconda del formato file selezionato.
Per il formato file XLSX, nella scheda Dati puoi anche specificare in quale foglio scrivere i dati:
- Per nome foglio: consente di specificare direttamente il nome del foglio. Se il foglio non esiste, viene creato in SharePoint.
- Per campo: consente di creare più fogli in base alla scelta del nome del campo.
Puoi selezionare Azione file esistente (Rinomina, Sovrascrivi, Aggiungi e Interrompi) dal menu a discesa. Per impostazione predefinita viene eseguita l'azione Rinomina.
Seleziona Esegui per eseguire il flusso di lavoro.

Configurazione dell'applicazione API personalizzata

Il connettore SharePoint viene fornito con un'applicazione multi-tenant integrata, ma se preferisci un'applicazione personalizzata procedi come segue. Per ulteriori informazioni su come creare e gestire un'applicazione con i servizi cloud Microsoft Azure, consulta la documentazione di Azure.

Vai al sito https://portal.azure.com/#home.
Accedi con l'account Microsoft Azure Active Directory.
Nella schermata iniziale, utilizza Cerca o vai al menu nell'angolo superiore sinistro per aprire il servizio Azure Active Directory.
Apri Registrazioni app nel menu a sinistra.
Seleziona + Nuova registrazione.
Specifica il nome dell'app.
Scegli il tipo di account desiderato: sono consentiti sia il single-tenant che il multi-tenant.
Nella sezione opzionale URI di reindirizzamento:
- Seleziona Applicazione a pagina singola dal menu a discesa.
- Per mantenere la piena funzionalità con varie versioni del connettore, imposta i 2 URL:
  - https://cef.alteryx.com/designer/oauthcallback
  - https://login.live.com/oauth20_desktop.srf
Seleziona Registra.
- L'ID applicazione (client) è il tuo ID client.
- L'ID directory (tenant) è il tuo ID tenant.
Accedi ad Autorizzazioni API per aggiungere le seguenti Autorizzazioni delegate - Microsoft Graph
- Files.ReadWrite.All
- offline_access
- openid
- User.Read
- Sites.Read.All
- e-mail
- profilo
Per utilizzare l'entità servizio (autenticazione solo app), passa a Certificati & chiavi e aggiungi Nuovo segreto client. Copia il valore perché non sarà più accessibile una volta chiusa la pagina. Si tratta del tuo ID segreto. In Autorizzazioni API, aggiungi le seguenti Autorizzazioni applicazione - Microsoft Graph:
- Files.Read.all
- Files.ReadWrite.All
- Sites.Read.All

Select a File Format

XLSX

Data Range options specify the names of the sheets to create. Options are By Sheet Name and By Field.
- SharePoint Output excludes the field from the written data. You can keep it by selecting Keep Field in Output.

If you select the By Field option, multiple sheets will be created and named based on the value selected in Select Field.

Enter the cell in Start in cell to specify the start of data output.
Select Write headers to include headers in the output data.
Select Code Page to determine the encoding of the data.

CSV

Use Max Field Length to set the maximum length of each field, allowing control over string cut off.
Use Field Delimiter to select a field delimiter between fields. Options are Comma, Semicolon, Tab, Pipe, Space or Custom delimiter.
Select Write headers to include headers in the output data.
Use Quote Character to select a format of the quote. Options are None, Single Quote, Double Quote, or Custom.

Select Code Page to determine the encoding of the data.

YXDB

No options.

SharePoint Lists

Configure the Tool

Select a List. The contents are specific to the URL you specify. If your URL contains a directory, only lists for that directory are shown.
In Output Options, select an option for writing the list:
- Append Existing: Appends all the data to an existing table.
- Delete List and Append: Deletes all the original records from the table and then appends the data into the existing table.
- Update; Warn on Update Failure: Updates only existing records with the IDs you specify. If a record cannot be updated, a warning is reported.
- Update; Error on Update Failure: Updates only existing records with the IDs you specify. If a record cannot be updated, an error is reported and processing will stop.