Word Online (Business)
Il connettore Word Online (Business) consente di usare file di Word nelle raccolte documenti supportate da Microsoft Graph (OneDrive for Business, Siti di SharePoint Online e gruppi di Office 365).
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Di alta qualità | Tutte le aree di Power Automate |
| App per la logica | Normale | Tutte le aree di App per la logica |
| Power Apps | Di alta qualità | Tutte le aree di Power Apps |
| Power Automate | Di alta qualità | Tutte le aree di Power Automate |
| Contatto | |
|---|---|
| Nome | Microsoft |
| URL | https://dotnet.territoriali.olinfo.it/en-us/connectors/wordonlinebusiness/ |
| idcknowledgeeco@microsoft.com |
| Metadati del connettore | |
|---|---|
| Editore | Microsoft |
| Sito web | https://products.office.com/en-us/word |
| Informativa sulla privacy | https://privacy.microsoft.com/en-us/privacystatement |
| Categorie | Contenuto e file |
Come creare modelli di Microsoft Word
È possibile compilare modelli di Microsoft Word in Windows o mac abilitando la scheda Sviluppo. Dopo aver abilitato tale scheda, nella sezione Controlli è possibile aggiungere tutti i controlli contenuto nel documento (vedere di seguito l'elenco dei controlli attualmente supportati). Usare le proprietà del controllo per assegnare al controllo un nome descrittivo che verrà usato in Power Automate. Dopo aver creato il documento di Word, salvarlo in una delle raccolte documenti supportate da Microsoft Graph: OneDrive for Business, Siti di SharePoint e Gruppi di Office 365.
A questo punto, è possibile iniziare a compilare il flusso. Aggiungere l'azione Popola un modello di Microsoft Word al flusso e quando si seleziona il file verrà visualizzato un elenco di tutti i controlli aggiunti. Popolare questi campi con valori da inserire nel nuovo documento di Microsoft Word. Infine, è possibile usare gli output dell'azione e inviare un messaggio di posta elettronica, salvare il documento in un'altra posizione o in un numero qualsiasi di altre azioni.
Controlli contenuto attualmente supportati
- Controllo contenuto testo normale
- Controllo contenuto casella combinata
- controllo contenuto elenco Drop-Down
- Controllo contenuto immagine
- Controllo contenuto sezione ripetuta
Problemi noti e limitazioni
- Il connettore Microsoft Word (Business) attualmente non supporta i controlli contenuto seguenti:
- Controllo contenuto RTF
- Controllo contenuto raccolta blocchi predefiniti
- Controllo contenuto selezione data
- Controllo contenuto casella di controllo
- Controlli modulo legacy
- La dimensione massima del file di input per entrambe le azioni di questo connettore è 10 MB
- I controller di contenuto delle immagini annidati non sono supportati.
- Il rendering dei nuovi caratteri di riga verrà eseguito quando l'impostazione "Consenti ritorno a capo (più paragrafi)" viene attivata nelle proprietà del controller del contenuto.
- La scheda Sviluppatore non è disponibile in Word online, inoltre, quando si modifica un documento generato, è consigliabile usare il client desktop di Word.
- La creazione di modelli in Word per Mac non è supportata.
- I codici di campo DisplayBarcode non sono supportati per l'azione Converti in PDF.
- SharePoint Locale non è supportato.
- Quando si usano collegamenti mailto non sono supportati più indirizzi (ad esempio: mailto:emailAddress1@contoso.com;emailAddress2@contoso.com? subject=MyEmailSubject). Come soluzione alternativa se si usano collegamenti mailto con due indirizzi gli utenti possono invece specificare un campo cc (ad esempio:
emailAddress1@contoso.com?cc=emailAddress2@contoso.com?subject=MyEmailSubject) o in alternativa per usare un singolo indirizzo di distribuzione degli indirizzi. - I nomi dei controller di contenuto all'interno del modello di documento devono essere univoci
- Le immagini non sono supportate nelle intestazioni nei modelli di word
- Quando si usa il file creato da questo connettore, l'aggiunta di un piccolo ritardo (~1min) garantisce che il file sia disponibile nelle azioni di completamento.
- Se è abilitato un criterio di accesso condizionale MFA (Multi-Factor Authentication), non è possibile utilizzare l'azione Popolamento di un modello di Microsoft Word.
- I documenti devono essere in grado di eseguire la conversione in meno di 2 minuti o il timeout della richiesta.
- Le immagini caricate tramite Popolamento di un modello di Microsoft Word non vengono ridimensionate automaticamente in base alle proporzioni. L'immagine avrà dimensioni del controller del contenuto immagine impostata durante la creazione del modello. Gli utenti devono ridimensionare manualmente.
- I controlli contenuto verranno bloccati per la modifica, i controlli ortografici e disattivati nell'applicazione desktop di Word per i file generati tramite l'azione Popolamento di un modello di Microsoft Word .
- Come soluzione alternativa, quando si aggiunge un controllo contenuto durante la creazione del modello, fare doppio clic sul controllo per rimuovere il testo esistente e sostituirlo con il testo di visualizzazione richiesto. In questo modo gli utenti possono modificare il contenuto del documento word generato dal modello usando Power Automate
- Se i caratteri Unicode vengono visualizzati correttamente nell'esportazione predefinita di Word, funzioneranno anche con action convertFile in Word Online Connector. Per impostazione predefinita, Microsoft Word non incorpora completamente tutti i tipi di carattere, soprattutto per i caratteri PUA o i glifi non standard, ad esempio il tipo di carattere Yu Mincho che usa caratteri di area di utilizzo privato (PUA), questi non fanno parte di Unicode standard e richiedono l'incorporamento dei tipi di carattere nel PDF per il rendering corretto.
- L'azione Converti documento di Word in PDF non supporta i file contrassegnati con valori di etichetta di riservatezza "Riservato" o "Estremamente riservato".
Guida per l'uso del controllo contenuto sezione ripetuta nel connettore Word Online.
È in corso l'abilitazione di tabelle ripetute nel connettore Word Online. Quando si crea un modello in Word, è necessario aggiungere il controllo contenuto sezione ripetuta. Si tratta del controllo nella scheda sviluppatore che consente di creare una tabella ripetuta. Il controllo contenuto sezione ripetuto consente agli utenti di ripetere righe in una tabella e in testo normale. Ecco una guida per lavorare con il controllo contenuto sezione ripetuta:
Per creare un modello con testo ripetuto: aggiungere innanzitutto un controllo contenuto sezione ripetuta dalla scheda sviluppatore. Aggiungere quindi controller di contenuto testo normale all'interno del controller di contenuto di ripetizione padre. Qualsiasi testo esterno a un controller di contenuto annidato sarà statico. Durante l'aggiunta dei controller di contenuto annidati, assicurarsi di passare alle proprietà e di aggiungere un titolo univoco. Ad esempio, se il modello è simile
<repeat> I would like to <plain> a </plain> and <plain> b </plain> </repeat>a , l'utente può modificare dinamicamente i valori diaeb.Per aggiungere una riga ripetuta al modello, è sufficiente aggiungere una tabella, selezionare la riga completa (che si vuole ripetere) e selezionare il controller di contenuto ripetuto dalla scheda sviluppatore. È ora possibile aggiungere controller di contenuto di testo normale annidati nelle colonne che si desidera essere dinamiche. Durante l'aggiunta dei controller di contenuto annidati, assicurarsi di passare alle proprietà e di aggiungere un titolo univoco.
Dopo aver aggiunto un controllo contenuto sezione ripetuta, i controller di contenuto annidati verranno visualizzati nell'azione del connettore Word. È possibile fare clic sul pulsante "Aggiungi nuovo elemento" per aggiungere una nuova riga. Se il numero di righe desiderate è dinamico, l'utente deve creare una matrice di valori e passarla nel campo di ripetizione. Ad esempio, una matrice valida per l'esempio precedente sarà simile alla seguente: [{"a": "value for row 1", "b": "value for row 1"}, {"a": "value for row 2", "b": "value for row 2"}] Here the keys of the objects are the titles of the nested content controllers. Di conseguenza, è necessario aggiungere un titolo univoco. Questa matrice può essere facilmente costruita usando l'operazione di selezione dei dati eseguendo il mapping dei valori di una matrice con i dati alla matrice di input.
Note aggiuntive:
- Per formattare la tabella è sufficiente formattare il testo e la tabella nel modello e la formattazione verrà mantenuta nel documento generato.
- Se non è presente alcun titolo per un controller di contenuto annidato in ripetizione, si otterrà un titolo casuale.
- Se è presente un titolo duplicato, entrambi i controller di contenuto verranno sostituiti con lo stesso contenuto
Guida all'uso di immagini nel connettore Word Online.
- Aggiungere un controller di contenuto immagine nel modello. Non eliminare l'immagine segnaposto. È possibile ridimensionarlo e posizionarlo nuovamente.
- Aggiungere una proprietà title al controller del contenuto dell'immagine in modo da poterla identificare facilmente nella finestra di progettazione di Power Automate.
- Quando il campo immagine viene visualizzato nella finestra di progettazione, aggiungere il contenuto del file di un'immagine JPG o PNG come valore. Il valore dovrebbe essere simile al seguente: { "$content-type": "image/png", "$content": "iVBORw0KG... i/DhQmCC" } dove il contenuto è l'immagine con codifica Base64.
Guida alla formattazione del documento di Word generato nel connettore Word Online.
Qualsiasi formattazione eseguita su testo, immagine o tabella nel modello verrebbe mantenuta nel documento generato. Per aggiungere la formattazione a un controller di contenuto vuoto, è possibile passare alle proprietà del controller del contenuto e selezionare "Usa uno stile per formattare il testo digitato nel controllo vuoto". È quindi possibile aggiungere nuovi stili.
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Convertire un documento word in PDF |
Ottiene una versione PDF del file selezionato |
| Creare un documento di Microsoft Word con il contenuto specificato |
Crea un file di Microsoft Word con il contenuto specificato nella directory radice (uso solo da Copilot Studio) |
| Popolare un modello di Microsoft Word |
Legge un modello di Microsoft Word per compilare quindi i campi modello con valori dinamici selezionati per generare un documento di Word. |
Convertire un documento word in PDF
Ottiene una versione PDF del file selezionato
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 Word tramite Esplora file. |
|
Estrai etichetta di riservatezza
|
extractSensitivityLabel | boolean |
Selezionare se si vuole estrarre l'etichetta di riservatezza (false, true). |
|
|
Metadati delle etichette di riservatezza
|
fetchSensitivityLabelMetadata | boolean |
Valore booleano se recuperare i metadati dell'etichetta di riservatezza per LabelId associato. |
Restituisce
- Documento PDF
- binary
Creare un documento di Microsoft Word con il contenuto specificato
Crea un file di Microsoft Word con il contenuto specificato nella directory radice (uso solo da Copilot Studio)
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Content
|
content | True | string |
Contenuto del documento di parola |
|
Nome del file
|
fileName | string |
Nome del file |
Restituisce
- URL documento di Microsoft Word
- string
Popolare un modello di Microsoft Word
Legge un modello di Microsoft Word per compilare quindi i campi modello con valori dinamici selezionati per generare un documento di Word.
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 Word tramite Esplora file. |
|
dynamicFileSchema
|
dynamicFileSchema | dynamic |
Schema dinamico degli elementi nel file selezionato |
Restituisce
- Documento di Microsoft Word
- binary
Definizioni
corda
Si tratta del tipo di dati di base 'string'.
binario
Si tratta del tipo di dati di base 'binary'.