Condividi tramite

Excel Online (Business)

Il connettore Excel Online (Business) consente di usare i file di Excel nelle raccolte documenti supportate da Microsoft Graph (OneDrive for Business, Siti di SharePoint e Gruppi di Office 365).

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio Class Regions
Copilot Studio Normale Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - China Cloud gestito da 21Vianet
App per la logica Normale Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Aree di Azure Cina
Power Apps Normale Tutte le aree di Power Apps , ad eccezione dei seguenti:
     - China Cloud gestito da 21Vianet
Power Automate Normale Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - China Cloud gestito da 21Vianet
Contatto
Nome Excel Online (Business)
URL https://learn.microsoft.com/en-us/connectors/excelonlinebusiness/
Email idcknowledgeeco@microsoft.com
Metadati del connettore
Editore Microsoft
Sito web https://products.office.com/excel
Informativa sulla privacy https://privacy.microsoft.com/
Categorie IA; Business intelligence

Problemi noti e limitazioni con le azioni

Breve descrizione Operations Descrizione lunga
Dati obsoleti Elencare le righe presenti in una tabella I dati potrebbero non essere aggiornati (potrebbero verificarsi ritardi) durante l'applicazione di filtri o l'ordinamento nelle righe elenco presenti in un'azione tabella .
Funzionalità di filtro Elencare le righe presenti in una tabella L'azione Elenco righe presenti in una tabella supporta il filtro e l'ordinamento di base:
- Supporta le funzioni di filtro seguenti: eq, ne, contains, startswith, endswith.
- Solo 1 funzione di filtro può essere applicata a una colonna.
- Per l'ordinamento è possibile usare solo 1 colonna.
Filtri in pila Elencare le righe presenti in una tabella Quando un filtro viene applicato utilizzando le righe dell'elenco di azioni presenti in una tabella, verrà aggiunto sopra i filtri esistenti.
Filtri non in pila Elencare le righe presenti in una tabella Se un filtro non viene applicato utilizzando le righe elenco presenti in un'azione tabella , tutti i filtri già impostati nel file di Excel verranno ignorati. L'azione recupera tutte le righe indipendentemente dai filtri preesistenti in Excel.
Impaginazione Elencare le righe presenti in una tabella L'azione Elenco righe presenti in una tabella restituisce fino a 256 righe per impostazione predefinita. Per ottenere tutte le righe, attivare la paginazione.
Selezionare righe non sequenziali Elencare le righe presenti in una tabella Il connettore recupera le righe per un massimo di 500 colonne nelle righe di elenco presenti in un'azione tabella . Le righe per le prime 500 colonne vengono restituite per impostazione predefinita. È possibile fornire un elenco delimitato da virgole di colonne specifiche da recuperare in un Select Query parametro.
Nome campo colonna chiave Aggiungere una colonna chiave a una tabella
Eliminare una riga
Ottenere una riga
Aggiornare una riga		 Il campo della colonna chiave fa distinzione tra maiuscole e minuscole.
Aggiornare/eliminare più righe Eliminare una riga
Aggiornare una riga		 Nel caso di più corrispondenze nelle operazioni, ad esempio Aggiornare una riga ed Eliminare una riga, verrà aggiornata/eliminata solo la prima riga.
Supporto per fogli di calcolo di Microsoft Excel Macro-Enabled Eseguire lo script L'azione Esegui script supporta inoltre il formato foglio di calcolo Macro-Enabled microsoft Excel (*.xlsm). Per altre informazioni, vedere Come usare i file di macro nei flussi di Power Automate.
Limitazione delle intestazioni di colonna di tabella Aggiungere una riga
Aggiornare una riga
Eliminare una riga		 Le modifiche di cui è stato eseguito il commit da operazioni come Aggiungere una riga, Aggiornare una riga, Eliminare una riga non sempre influiscono immediatamente dopo la risposta corretta da un'azione di Power Automate, LogicApps o Power Apps corrispondente. Sono previsti ritardi fino a 30 secondi a causa delle limitazioni del servizio back-end sottostanti.
Limitazioni dell'operazione di esecuzione dello script Eseguire lo script L'operazione di esecuzione dello script consente fino a 3 chiamate per 10 secondi e fino a 1600 chiamate al giorno.
Supporto per l'esecuzione di cloud sovrani per l'operazione script Eseguire lo script L'operazione di esecuzione dello script non è disponibile nei cloud sovrani (inclusi Gcc, GccHigh, DoD e altri cloud superiori).

Errori comuni

Errore Soluzione
403 Vietato Assicurarsi che il file abbia accesso in scrittura.
502 BadGateway Questi errori verranno visualizzati se il foglio di calcolo è in modalità di sola lettura. Per informazioni sulla disabilitazione della modalità di sola lettura, vedere Modificare un foglio di calcolo di Excel in sola lettura.
429 Numero eccessivo di richieste Ciò si verifica se un utente effettua troppe richieste entro un breve periodo di tempo. Il limite di limitazione è univoco per ogni richiesta e varia in base al numero di richieste, alla memoria usata e ad altri fattori importanti. Se si verifica una limitazione, è consigliabile aggiungere ritardi espliciti per l'azione del connettore.
A causa dei limiti di limitazione nell'API Graph, questo problema può verificarsi anche a causa di diversi motivi:
1. Quando il numero di richieste globali dal flusso supera un limite, alcune richieste verranno limitate. Quali richieste vengono limitate e che non vengono selezionate in modo casuale dalla soluzione di limitazione di Azure.
2. Anche se non ha raggiunto il limite in #1, potrebbe comunque essere limitato a causa di motivi diversi. Di seguito sono riportati i motivi più comuni per la limitazione:
a. Premere i criteri di limitazione del servizio SharePoint.
b. Premere i criteri del servizio Excel Online, ad esempio la coda delle operazioni era piena a causa di troppe richieste.
c. La richiesta è in sospeso nella coda per un tempo più lungo del previsto. Ad esempio, le richieste che richiedono più di 30 potrebbero restituire 504 e 504 continuerebbero a causare una limitazione.
d. Troppi errori consecutivi in una sessione della cartella di lavoro.
e. Quando viene effettuata una richiesta a OfficeScripting sull'ID operazione "RunScriptProd" e se tali richieste sono più di 3 entro 10 secondi, viene limitata.

Problemi noti e limitazioni generali

  • La dimensione massima di un file di Excel supportato dal connettore Excel Online (Business) è di 25 MB.
  • Un file di Excel può essere bloccato per un aggiornamento o un'eliminazione fino a 6 minuti dall'ultimo utilizzo del connettore.
  • Le modifiche simultanee ai file apportate da altri connettori o le modifiche manuali non sono supportate. Gli utenti devono evitare di scrivere dati in un singolo file di Excel da più client contemporaneamente (Excel Desktop, Excel Web, Power Automate, LogicApps o Power Apps). Ciò può causare possibili conflitti di unione e incoerenza dei dati.
  • Il connettore supporta i file nei formati Foglio di calcolo Open XML di Microsoft Excel (*.xlsx) e Cartella di lavoro binaria di Microsoft Excel (*.xlxb).
  • La File proprietà prevista dalle azioni del connettore deve essere compilata usando una delle opzioni seguenti:
    • Selezionare un file dalla selezione file.
    • Usare un output dei trigger/azioni del connettore OneDrive for Business (proprietà o File identifier fileId, a seconda di quale sia presente per l'azione o il trigger di OneDrive for Business specifico).
    • Usare un output dei trigger/azioni del connettore SharePoint (proprietà o Identifier fileId, a seconda di quale sia presente per l'azione o il trigger di SharePoint specifico).
    • Immettere il percorso del file a partire da Unità. Esempi:
      • Se il file si trova in OneDrive e il percorso completo è OneDrive/file.xlsx e il parametro Drive è OneDrive, l'input file.xlsx.
      • Se il file è in Gruppi di Office 365 e il percorso completo è Documents/Inner Documents/file.xlsx e il parametro Drive è Documents, input Inner Documents/file.xlsx.
  • Il connettore non supporta l'uso dei parametri OData per le tabelle che contengono colonne nascoste.
  • Il timeout del connettore causato dai calcoli di nuovo può verificarsi se sono presenti formule complesse o se sono presenti troppe righe nel foglio di lavoro. In entrambi i casi, i dati possono essere inseriti più volte a causa dei criteri di ripetizione dei tentativi. Come soluzione alternativa, verificare se le formule potrebbero essere semplificate o ridotte. In caso contrario, è possibile impostare la modalità di calcolo per la cartella di lavoro su Manuale. Per altre informazioni, vedere qui.
  • Filter Query / Order By / Select Query I parametri dell'operazione supportano solo nomi di colonna alfanumerici.
  • Le tabelle pivot non sono supportate a causa delle limitazioni dell'API Graph.
  • Il connettore restituisce sempre tutte le raccolte documenti disponibili nel controllo a discesa Raccolta documenti. Per la maggior parte degli utenti, verrà restituita una sola raccolta documenti, ma se sono disponibili più raccolte, tutte verranno elencate. Per altre informazioni sulla raccolta documenti (ad esempio, unità risorse) e sul comportamento previsto per utenti, gruppi e siti, passare a Elenca unità - Osservazioni.
  • Il connettore può popolare fino a 64.000 righe automaticamente se l'opzione Inserisci ID generato automaticamente nella tabella di Excel è selezionata durante un'importazione di tabella in Power Apps.
  • Le intestazioni di colonna delle tabelle che contengono solo un numero possono causare un comportamento imprevisto nelle operazioni come Aggiornare una riga, Eliminare una riga a causa delle limitazioni del servizio back-end sottostante. Come soluzione alternativa, rinominare tali colonne in modo che contengano anche altri caratteri.
  • È possibile modificare un file di Excel e una nuova versione può essere visibile nella cronologia delle versioni del file anche quando viene eseguita un'azione di sola lettura. Questo comportamento è previsto dalla progettazione a causa di meccanismi di salvataggio interni del servizio back-end del connettore.
  • Gli utenti guest non possono accedere al documento se provengono da un tenant diverso rispetto agli utenti principali. In questo caso, l'utente riceverà un errore HTTP 404 (Non trovato).
  • In Fairfax Logic Apps questo connettore supporta solo le connessioni usando un account commerciale (.com).
  • I file di SharePoint potrebbero non essere disponibili. L'API Graph non passa l'indirizzo IP dell'utente a SharePoint. Pertanto, se è abilitato un criterio basato sulla posizione, SharePoint non può determinare se l'utente si trova all'interno del limite attendibile. Per questo motivo, quando si accede alla raccolta di SharePoint, è possibile che venga visualizzato un errore "A causa dei criteri dell'organizzazione, non è possibile accedere a queste risorse da questo percorso di rete". Per altre informazioni, vedere qui.
  • La selezione file visualizzerà solo fino a 200 elementi per cartella. Gli utenti potrebbero avere problemi a trovare elementi se in una cartella sono presenti più di 200 elementi.
  • Se sono presenti errori 504 continui, i clienti potrebbero riscontrare limitazioni a causa di restrizioni diverse dell'API Graph. Di seguito sono riportati alcuni suggerimenti per ridurre le operazioni a esecuzione prolungata di 504:
    • Aggiornare la tabella in modo che sia il più semplice possibile con un minor numero di formule e dipendenze.
    • Utilizzare un altro foglio di lavoro o una cartella di lavoro vuota con lo stesso formato di tabella se il conteggio delle righe è elevato.
  • L'accesso in scrittura a un file è necessario per tutte le azioni. In caso contrario, l'API Graph restituirà 403 Forbidden un errore. Inoltre, il connettore restituirà l'errore 502 BadGateway se il foglio di calcolo è in modalità di sola lettura. Per disabilitare la modalità di sola lettura, vedere altre informazioni qui.
  • La dimensione massima supportata di ogni richiesta di connettore è di 5 MB.

Gestione dei nomi delle colonne

I nomi di colonna nei risultati della risposta dell'azione possono essere trasformati per essere compatibili con il formato OData:

Personaggio Valore codificato
. _x002e_
@ _x0040_
: _x003a_
# _x0023_

Ad esempio, Column [one]#1 ->Column [one]_x0023_1

Limiti generali

Nome Value
Numero massimo di varianti di colonna Identity che possono essere usate per ottenere/inserire/aggiornare/eliminare una riga da una singola tabella di Excel. Il valore corrente è impostato su 2, il che significa che fino a due varianti di nome di colonna devono essere usate tra flussi di lavoro per una determinata tabella. 2

Concetti ed esempi

  • Colonna chiave: Colonna in una tabella che verrà usata per cercare un valore (valore chiave).
  • Valore chiave: Valore nella colonna chiave che verrà usata per identificare una riga specifica.

La tabella seguente è un esempio. Per eseguire un'operazione di riga nella seconda riga della tabella, deve key column essere e key value deve essere Column 1200.

Colonna 1 Colonna 2 Colonna 3
100 A-2 A-3
200 B-2 B-3
300 C-2 C-3

Limiti per la limitazione delle richieste

Nome Chiamate Periodo di rinnovo
Chiamate API per connessione 100 60 secondi

Azioni

Aggiorna una riga

Aggiornare una riga usando una colonna chiave. Il valore di input sovrascriverà le celle specificate e le colonne lasciate vuote non verranno aggiornate. Per aggiungere (invece di sovrascrivere) un valore, usare l'azione "Recupera una riga" per recuperare prima il contenuto.
Aggiungere una colonna chiave a una tabella

Aggiungere una colonna chiave a una tabella di Excel. La nuova colonna verrà aggiunta a destra.
Aggiungere una riga in una tabella

Aggiungere una nuova riga nella tabella di Excel.
Aggiungere una riga in una tabella [DEPRECATO]

Questa azione è stata deprecata. Usare invece Aggiungi una riga in una tabella .

Aggiungere una nuova riga nella tabella di Excel.
Creare un foglio di lavoro

Creare un nuovo foglio di lavoro nella cartella di lavoro di Excel.
Creare una tabella

Creare una nuova tabella nella cartella di lavoro di Excel.
Elencare le righe presenti in una tabella

Elencare le righe presenti in una tabella.
Elimina una riga

Eliminare una riga usando una colonna chiave.
Eseguire lo script

Esegue uno script di Office su una cartella di lavoro di Excel. Usare questa azione quando lo script viene salvato nel percorso predefinito.
Eseguire script dalla raccolta di SharePoint

Esegue uno script di Office su una cartella di lavoro di Excel. Usare questa azione quando lo script viene salvato all'esterno del percorso predefinito.
Ottenere fogli di lavoro

Ottenere un elenco di fogli di lavoro nella cartella di lavoro di Excel.
Ottenere tabelle

Ottenere un elenco di tabelle nella cartella di lavoro di Excel.
Ottenere una riga

Ottenere una riga usando una colonna chiave.

Aggiorna una riga

ID operazione:
PatchItem

Aggiornare una riga usando una colonna chiave. Il valore di input sovrascriverà le celle specificate e le colonne lasciate vuote non verranno aggiornate. Per aggiungere (invece di sovrascrivere) un valore, usare l'azione "Recupera una riga" per recuperare prima il contenuto.

Parametri

Nome Chiave Necessario Tipo Descrizione
Posizione
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari i due punti)
Raccolta documenti
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
File
 file True string

Selezionare un file di Excel tramite Esplora file.
Tabella
 table True string

Selezionare una tabella dall'elenco a discesa.
Colonna chiave
 idColumn True string

Selezionare una colonna dall'elenco a discesa.
Valore chiave
 id True string

Immettere il valore della chiave.
Specificare le proprietà dell'elemento
 item True dynamic

Specificare le proprietà dell'elemento.
Formato DateTime
 dateTimeFormat string

Formato DateTime.

Restituisce

Gli output di questa operazione sono dinamici.

Aggiungere una colonna chiave a una tabella

ID operazione:
CreateIdColumn

Aggiungere una colonna chiave a una tabella di Excel. La nuova colonna verrà aggiunta a destra.

Parametri

Nome Chiave Necessario Tipo Descrizione
Posizione
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari i due punti).
Raccolta documenti
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
File
 file True string

Selezionare un file di Excel tramite Esplora file.
Tabella
 table True string

Selezionare una tabella dall'elenco a discesa.
Colonna chiave
 idColumn string

Specificare il nome della colonna chiave.

Aggiungere una riga in una tabella

ID operazione:
AddRowV2

Aggiungere una nuova riga nella tabella di Excel.

Parametri

Nome Chiave Necessario Tipo Descrizione
Posizione
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari due punti).
Raccolta documenti
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
File
 file True string

Selezionare un file di Excel tramite Esplora file.
Tabella
 table True string

Selezionare una tabella dall'elenco a discesa.
Riga
 item True dynamic

Riga da aggiungere alla tabella di Excel specificata.
Formato DateTime
 dateTimeFormat string

Formato DateTime.

Restituisce

Gli output di questa operazione sono dinamici.

Aggiungere una riga in una tabella [DEPRECATO]

ID operazione:
AddRow

Questa azione è stata deprecata. Usare invece Aggiungi una riga in una tabella .

Aggiungere una nuova riga nella tabella di Excel.

Parametri

Nome Chiave Necessario Tipo Descrizione
Posizione
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari due punti).
Raccolta documenti
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
File
 file True string

Selezionare un file di Excel tramite Esplora file.
Tabella
 table True string

Selezionare una tabella dall'elenco a discesa.
Riga
 item True dynamic

Riga da inserire nella tabella di Excel specificata.

Creare un foglio di lavoro

ID operazione:
CreateWorksheet

Creare un nuovo foglio di lavoro nella cartella di lavoro di Excel.

Parametri

Nome Chiave Necessario Tipo Descrizione
Posizione
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari due punti).
Raccolta documenti
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
File
 file True string

Selezionare un file di Excel tramite Esplora file.
Nome
 name string

Nome foglio di lavoro.

Restituisce

Corpo
WorksheetMetadata

Creare una tabella

ID operazione:
CreateTable

Creare una nuova tabella nella cartella di lavoro di Excel.

Parametri

Nome Chiave Necessario Tipo Descrizione
Posizione
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari i due punti).
Raccolta documenti
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
File
 file True string

Selezionare un file di Excel tramite Esplora file.
Nome della tabella
 TableName string

Immettere il nome della tabella di Excel.
Intervallo di tabelle
 Range True string

Immettere l'indirizzo della tabella usando la notazione A1.
Nomi delle colonne
 ColumnsNames string

Immettere i nomi delle colonne separati da ';' o ','.

Restituisce

Metadati delle tabelle

Corpo
TableMetadata

Elencare le righe presenti in una tabella

ID operazione:
GetItems

Elencare le righe presenti in una tabella.

Parametri

Nome Chiave Necessario Tipo Descrizione
Posizione
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari i due punti)
Raccolta documenti
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
File
 file True string

Selezionare un file di Excel tramite Esplora file.
Tabella
 table True string

Selezionare una tabella dall'elenco a discesa.
Query di filtro
 $filter string

Query di filtro ODATA per limitare le voci restituite.
Ordina per
 $orderby string

Query ODATA orderBy per specificare l'ordine delle voci.
Conteggio superiore
 $top integer

Numero totale di voci da recuperare (impostazione predefinita = all).
Ignora conteggio
 $skip integer

Numero di voci da ignorare (valore predefinito = 0).
Selezionare query
 $select string

Elenco delimitato da virgole di colonne da recuperare (prime 500 per impostazione predefinita).
Formato DateTime
 dateTimeFormat string

Formato DateTime.
Estrai etichetta di riservatezza
 extractSensitivityLabel boolean

Valore booleano che indica se estrarre l'ID etichetta di riservatezza per l'artefatto associato.
Metadati delle etichette di riservatezza
 fetchSensitivityLabelMetadata boolean

Valore booleano se recuperare i metadati dell'etichetta di riservatezza per LabelId associato.

Restituisce

Gli output di questa operazione sono dinamici.

Elimina una riga

ID operazione:
DeleteItem

Eliminare una riga usando una colonna chiave.

Parametri

Nome Chiave Necessario Tipo Descrizione
Posizione
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari i due punti)
Raccolta documenti
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
File
 file True string

Selezionare un file di Excel tramite Esplora file.
Tabella
 table True string

Selezionare una tabella dall'elenco a discesa.
Colonna chiave
 idColumn True string

Selezionare una colonna dall'elenco a discesa.
Valore chiave
 id True string

Immettere il valore della chiave.

Eseguire lo script

ID operazione:
RunScriptProd

Esegue uno script di Office su una cartella di lavoro di Excel. Usare questa azione quando lo script viene salvato nel percorso predefinito.

Parametri

Nome Chiave Necessario Tipo Descrizione
Posizione
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari due punti).
Raccolta documenti
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
File
 file True string

Selezionare un file di Excel tramite Esplora file.
Sceneggiatura
 scriptId True string

Selezionare lo script di Office da eseguire dall'elenco a discesa.
ScriptParameters
 ScriptParameters True dynamic

Specificare i parametri di Office Script.

Restituisce

Gli output di questa operazione sono dinamici.

Eseguire script dalla raccolta di SharePoint

ID operazione:
RunScriptProdV2

Esegue uno script di Office su una cartella di lavoro di Excel. Usare questa azione quando lo script viene salvato all'esterno del percorso predefinito.

Parametri

Nome Chiave Necessario Tipo Descrizione
Percorso cartella di lavoro
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari due punti).
Raccolta cartelle di lavoro
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
Cartella
 file True string

Selezionare una cartella di lavoro di Excel tramite Esplora file.
Percorso script
 scriptSource True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group ID" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari i due punti).
Libreria di script
 scriptDrive True string

Selezionare la raccolta di SharePoint del file di Script di Office (con estensione osts) dall'elenco a discesa.
Sceneggiatura
 scriptId True string

Selezionare un file di script di Office (osts) in una raccolta di SharePoint dall'elenco a discesa.
ScriptParameters
 ScriptParameters True dynamic

Specificare i parametri per Lo script di Office.

Restituisce

Gli output di questa operazione sono dinamici.

Ottenere fogli di lavoro

ID operazione:
GetAllWorksheets

Ottenere un elenco di fogli di lavoro nella cartella di lavoro di Excel.

Parametri

Nome Chiave Necessario Tipo Descrizione
Posizione
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari due punti).
Raccolta documenti
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
File
 file True string

Selezionare un file di Excel tramite Esplora file.
Estrai etichetta di riservatezza
 extractSensitivityLabel boolean

Valore booleano che indica se estrarre l'ID etichetta di riservatezza per l'artefatto associato.
Metadati delle etichette di riservatezza
 fetchSensitivityLabelMetadata boolean

Valore booleano se recuperare i metadati dell'etichetta di riservatezza per LabelId associato.

Restituisce

Nome Percorso Tipo Descrizione
value
 value array of WorksheetMetadata
sensitivityLabelInfo
 sensitivityLabelInfo array of SensitivityLabelMetadata

Ottenere tabelle

ID operazione:
GetTables

Ottenere un elenco di tabelle nella cartella di lavoro di Excel.

Parametri

Nome Chiave Necessario Tipo Descrizione
Posizione
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari due punti).
Raccolta documenti
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
File
 file True string

Selezionare un file di Excel tramite Esplora file.
Estrai etichetta di riservatezza
 extractSensitivityLabel boolean

Valore booleano che indica se estrarre l'ID etichetta di riservatezza per l'artefatto associato.
Metadati delle etichette di riservatezza
 fetchSensitivityLabelMetadata boolean

Valore booleano se recuperare i metadati dell'etichetta di riservatezza per LabelId associato.

Restituisce

Nome Percorso Tipo Descrizione
value
 value array of object
id
 value.id string

ID tabella.
Nome
 value.name string

Nome della tabella.
Mostra colonne con banda
 value.showBandedColumns boolean

Mostra colonne con banda.
Evidenziare la prima colonna
 value.highlightFirstColumn boolean

Evidenziare la prima colonna.
Evidenziare l'ultima colonna
 value.highlightLastColumn boolean

Evidenziare l'ultima colonna.
Mostra righe con bande
 value.showBandedRows boolean

Mostra righe con bande.
Pulsante Mostra filtro
 value.showFilterButton boolean

Pulsante Mostra filtro.
Mostra intestazioni
 value.showHeaders boolean

Mostra intestazioni.
Mostra totali
 value.showTotals boolean

Mostra totali.
Style
 value.style string

Stile tabella.
sensitivityLabelInfo
 sensitivityLabelInfo array of SensitivityLabelMetadata

Ottenere una riga

ID operazione:
GetItem

Ottenere una riga usando una colonna chiave.

Parametri

Nome Chiave Necessario Tipo Descrizione
Posizione
 source True string

Selezionare dall'elenco a discesa o specificare uno dei seguenti elementi: - "me" - "URL sito di SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (sono necessari i due punti)
Raccolta documenti
 drive True string

Selezionare una raccolta documenti dall'elenco a discesa.
File
 file True string

Selezionare un file di Excel tramite Esplora file.
Tabella
 table True string

Selezionare una tabella dall'elenco a discesa.
Colonna chiave
 idColumn True string

Selezionare una colonna dall'elenco a discesa.
Valore chiave
 id True string

Immettere il valore della chiave.
Formato DateTime
 dateTimeFormat string

Formato DateTime.
Estrai etichetta di riservatezza
 extractSensitivityLabel boolean

Valore booleano che indica se estrarre l'ID etichetta di riservatezza per l'artefatto associato.
Metadati delle etichette di riservatezza
 fetchSensitivityLabelMetadata boolean

Valore booleano se recuperare i metadati dell'etichetta di riservatezza per LabelId associato.

Restituisce

Gli output di questa operazione sono dinamici.

Trigger

Per una riga selezionata

Attiva un flusso per una riga selezionata in una tabella di Excel. (Disponibile solo per Power Automate.)

Per una riga selezionata

ID operazione:
OnRowSelected

Attiva un flusso per una riga selezionata in una tabella di Excel. (Disponibile solo per Power Automate.)

Parametri

Nome Chiave Necessario Tipo Descrizione
operationId
 operationId True string
ospitante
 host object
parameters
 parameters True object
schema
 schema True object
intestazioniSchema
 headersSchema object

Restituisce

Nome Percorso Tipo Descrizione
righe
 body.rows array of object
items
 body.rows object
ID utente
 headers.x-ms-user-id-encoded guid

Identificatore univoco dell'utente che ha attivato il flusso in AAD.
Indirizzo e-mail dell'utente
 headers.x-ms-user-email-encoded byte

Indirizzo e-mail dell'utente che ha attivato questo flusso.
Nome utente
 headers.x-ms-user-name-encoded byte

Nome visualizzato dell'utente che ha attivato il flusso.
Marca temporale:
 headers.x-ms-user-timestamp string

Ora di attivazione del flusso.

Definizioni

TableMetadata

Metadati delle tabelle

Nome Percorso Tipo Descrizione
nome
 name string

Nome della tabella
title
 title string

Titolo tabella
x-ms-permission
 x-ms-permission string

Autorizzazione tabella
x-ms-capabilities
 x-ms-capabilities TableCapabilitiesMetadata

Metadati per una tabella (funzionalità)
schema
 schema Object
referencedEntities
 referencedEntities Object
webUrl
 webUrl string

Collegamento url

TableCapabilitiesMetadata

Metadati per una tabella (funzionalità)

Nome Percorso Tipo Descrizione
sortRestrictions
 sortRestrictions TableSortRestrictionsMetadata

Metadati per una tabella (restrizioni di ordinamento)
filterRestrictions
 filterRestrictions TableFilterRestrictionsMetadata

Metadati per una tabella (restrizioni di filtro)
selectRestrictions
 selectRestrictions TableSelectRestrictionsMetadata

Metadati per una tabella (restrizioni di selezione)
isOnlyServerPagable
 isOnlyServerPagable boolean

Restrizioni di paging del server
filterFunctionSupport
 filterFunctionSupport array of string

Elenco delle funzionalità di filtro supportate
serverPagingOptions
 serverPagingOptions array of string

Elenco delle funzionalità di paging basate su server supportate

Oggetto

TableSortRestrictionsMetadata

Metadati per una tabella (restrizioni di ordinamento)

Nome Percorso Tipo Descrizione
sortable
 sortable boolean

Indica se la tabella contiene colonne ordinabili
unsortableProperties
 unsortableProperties array of string

Elenco di proprietà non ordinamento
ascendingOnlyProperties
 ascendingOnlyProperties array of string

Elenco di proprietà che supportano solo l'ordine crescente

TableFilterRestrictionsMetadata

Metadati per una tabella (restrizioni di filtro)

Nome Percorso Tipo Descrizione
filterable
 filterable boolean

Indica se la tabella contiene colonne filtrabili
nonFilterableProperties
 nonFilterableProperties array of string

Elenco di proprietà non filtrabili
RequiredProperties
 requiredProperties array of string

Elenco delle proprietà obbligatorie

TableSelectRestrictionsMetadata

Metadati per una tabella (restrizioni di selezione)

Nome Percorso Tipo Descrizione
selezionabile
 selectable boolean

Indica se la tabella contiene colonne selezionabili

WorksheetMetadata

Nome Percorso Tipo Descrizione
id
 id string

ID foglio di lavoro.
Nome
 name string

Nome foglio di lavoro.
Posizione
 position integer

Posizione del foglio di lavoro.
Visibilità
 visibility string

Visibilità del foglio di lavoro.

SensitivityLabelMetadata

Nome Percorso Tipo Descrizione
sensitivityLabelId
 sensitivityLabelId string

Id SensitivityLabel.
nome
 name string

Nome sensitivityLabel.
nome visualizzato
 displayName string

Informazioni displayName di SensitivityLabel
Descrizione comando
 tooltip string

Dettagli di SensitivityLabel nella descrizione comando.
priorità
 priority integer

Priorità sensitivityLabel.
color
 color string

Colore SensitivityLabel.
èCrittografato
 isEncrypted boolean

è SensitivityLabel Encrypted.
èAbilitato
 isEnabled boolean

Indica se SensitivityLabel è Abilitato.
isParent
 isParent boolean

Indica se SensitivityLabel è Padre.
parentSensitivityLabelId
 parentSensitivityLabelId string

ID sensitivityLabel padre.