Centro assistenza di Workiva

Per esportare e importare dati in Microsoft Power BI® e gestire i vari oggetti che compongono la tua implementazione Power BI come parte di una catena, aggiungi un passaggio che includa un comando di connessione Microsoft Power BI.

Per abilitare questi comandi, un amministratore IT deve prima creare un connettore Power BI.

Nota: Il connettore non può connettersi a Power BI con l'autenticazione a più fattori (MFA) abilitata.

Aggiungi righe al dataset

Per aggiungere nuove righe di dati a una tabella all'interno del dataset di un'area di lavoro, usa il comando Aggiungi righe al dataset.

Nota: Questo comando considera le righe duplicate come aggiunte anche se ignorate da Power BI.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID del set di dati	Inserisci l'ID del set di dati.
Nome della tabella	Inserisci il nome della tabella a cui aggiungere le righe.
Dati	Inserisci il file che contiene i dati da aggiungere alla tabella.
Tipo di dati	Seleziona se Data è JSON o CSV.
Delimitatore	Se il tipo di dati è CSV, inserisci il delimitatore utilizzato nel file.

Output

Output	Tipo di output
Righe aggiunte	Numero intero

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Legare il set di dati al gateway

Per vincolare un set di dati da uno spazio di lavoro a un gateway, usa il comando Bind dataset to gateway. Supportato solo dal Data Gateway On-Premises.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID del set di dati	Inserisci l'ID del set di dati.
Gateway	Inserisci l'ID del gateway.

Output

Nessuno

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Clona rapporto

Per clonare un report da un'area di lavoro, usa il comando Clona report.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID rapporto	Inserisci l'ID del rapporto.
Nome	Inserisci il nome del nuovo report creato.
ID del dataset di destinazione	Inserisci l'ID del set di dati per il nuovo report. Per associare il nuovo report allo stesso dataset di ID report, lascia vuoto.
ID dell'area di lavoro di destinazione	Inserisci l'ID dell'area di lavoro per il nuovo report. Per "Il mio spazio di lavoro", inserisci un GUID vuoto di 00000000-0000-0000-0000-0000000000.Per associare il nuovo report allo stesso spazio di lavoro di ID spazio di lavoro, lascia vuoto.

Output

Output	Tipo di output
Report	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Crea set di dati

Per creare un nuovo set di dati in un'area di lavoro, usa il comando Create dataset.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
Nome	Inserisci il nome del set di dati.
Tabelle	Inserisci le tabelle del dataset.

Output

Output	Tipo di output
Set di dati	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Crea un percorso di caricamento temporaneo

Per creare un archivio blob temporaneo, ad esempio per importare file .PBIX da 1 GB a 10 GB, usa il comando Create temporary upload location. 

Per importare file .PBIX di grandi dimensioni, crea una posizione di upload temporanea, carica il file .PBIX utilizzando l'URL SAS (shared access signature) della risposta e chiama Post Import to Group specificando il fileUrl come URL SAS nel Request Body.

Nota: L'importazione di file .PBIX di grandi dimensioni è disponibile solo per gli spazi di lavoro con capacità premium e per i file .PBIX tra 1 GB e 10 GB.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.

Output

Output	Tipo di output
URL	Stringa
Scade a	Data

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Elimina tutte le righe nella tabella

Per eliminare tutte le righe da una tabella all'interno del dataset di un'area di lavoro, usa il comando Elimina tutte le righe nella tabella.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID del set di dati	Inserisci l'ID del set di dati.
Nome della tabella	Inserisci il nome della tabella da cui eliminare le righe.

Output

Nessuno

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Elimina dataset

Per eliminare un set di dati da un'area di lavoro, usa il comando Delete dataset.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID del set di dati	Inserisci l'ID del set di dati.

Output

Output	Tipo di output
Set di dati	Stringa

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Elimina un report

Per eliminare un report da un'area di lavoro, usa il comando Delete report.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID rapporto	Inserisci l'ID del report.

Output

Output	Tipo di output
ID rapporto cancellato	Stringa

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Esporta rapporto

Per esportare un report da un'area di lavoro a un file .PBIX, usa il comando Export report.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID rapporto	Inserisci l'ID del report.

Output

Output	Tipo di output
Esportazione del rapporto (.PBIX)	File

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Ottieni set di dati

Per recuperare un set di dati da un'area di lavoro, usa il comando Get dataset.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID del set di dati	Inserisci l'ID del set di dati.

Output

Output	Tipo di output
Set di dati	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Ottieni i dati del set di dati

Per recuperare un elenco di fonti di dati per il dataset di un'area di lavoro, usa il comando Get dataset datasources.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID del set di dati	Inserisci l'ID del set di dati.

Output

Output	Tipo di output
Fonti di dati	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore nell'autenticazione con Power BI

Ottieni tabelle del dataset

Per recuperare un elenco di tabelle all'interno del dataset di un'area di lavoro, usa il comando Get dataset tables.

Nota: Questo comando supporta solo i dataset Push.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID del set di dati	Inserisci l'ID del set di dati.

Output

Output	Tipo di output
Tabelle	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Ottieni il report

Per recuperare un report da un'area di lavoro, usa il comando Ottieni report.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID rapporto	Inserisci l'ID del report.

Output

Output	Tipo di output
Report	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Importa file

Per creare nuovi contenuti in un'area di lavoro da un file .PBIX, usa il comando Importa file.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
Nome del set di dati	Inserisci il nome visualizzato dei dati, compresa l'estensione del file.
In caso di conflitto di nomi	Seleziona cosa fare se esiste già un set di dati con lo stesso nome. Per impostazione predefinita, Ignora.
File .PBIX	Quando importi un file .PBIX, inserisci il file da importare. Il file deve essere inferiore a 1GB.
Informazioni sull'importazione	Se stai importando un file .PBIX di grandi dimensioni, inserisci i suoi dettagli.
Esegui in modo asincrono	Per non attendere il completamento dell'importazione, seleziona questa casella.

Output

Output	Tipo di output
Importazione	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Elenca i cruscotti

Per elencare i cruscotti che esistono in un'area di lavoro e a cui l'utente può accedere, usa il comando List dashboards.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.

Output

Output	Tipo di output
Dashboard	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Elenca i set di dati

Per elencare i dataset che esistono in un'area di lavoro e a cui l'utente può accedere, usa il comando List datasets.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.

Output

Output	Tipo di output
Set di dati	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Elenca le fonti di dati del gateway

Per elencare le risorse di dati di un gateway, usa il comando List gateway datasources.

Proprietà

Proprietà	Dettaglio
ID del gateway	Inserisci l'ID del gateway.

Output

Output	Tipo di output
Fonti di dati	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Elenca i gateway

Per elencare i gateway di cui l'utente è amministratore, usa il comando List gateways.

Proprietà

Nessuno

Output

Output	Tipo di output
Gateway	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Elenca report

Per elencare i report di un'area di lavoro, usa il comando List reports.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.

Output

Output	Tipo di output
Report	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Riassegnare i report al set di dati

Per rilanciare un report da un'area di lavoro a un set di dati, usa il comando Rebind reports to dataset.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID rapporto	Inserisci l'ID del report.
ID set di dati	Inserisci l'ID del nuovo set di dati per il report di rimbalzo.

Output

Output	Tipo di output
ID rapporto	Stringa

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Aggiornare il set di dati

Per aggiornare il set di dati di un'area di lavoro, usa il comando Aggiorna il set di dati.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID del set di dati	Inserisci l'ID del set di dati.
Tipo di notifica	Seleziona il tipo di notifica da inviare al termine dell'aggiornamento.

Output

Nessuno

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore di autenticazione con Power BI

Aggiorna il contenuto del report

Per aggiornare un report da un'area di lavoro in modo che abbia lo stesso contenuto di un altro report, usa il comando Aggiorna il contenuto del report.

Proprietà

Proprietà	Dettaglio
ID workspace	Inserisci l'ID dell'area di lavoro.
ID rapporto	Inserisci l'ID del rapporto.
ID del rapporto di origine	Inserisci l'ID del rapporto di origine.
ID dell'area di lavoro di origine	Inserisci l'ID dell'area di lavoro con il report di origine.

Output

Output	Tipo di output
Report	JSON

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
1	Errore	Si è verificato un errore durante l'esecuzione
2	Errore	Si è verificato un errore nell'autenticazione con Power BI