Condividi tramite

OneNote (Business)

OneNote è un'app che prende nota da Microsoft che semplifica la sincronizzazione delle tue idee, schizzi e note in tutti i tuoi dispositivi! Connettersi all'account di Office 365 con OneDrive for Business abilitato per tenere traccia delle nuove sezioni, creare note e altro ancora.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio Class Regions
Copilot Studio Normale Tutte le aree di Power Automate
App per la logica Normale Tutte le aree di App per la logica
Power Apps Normale Tutte le aree di Power Apps
Power Automate Normale Tutte le aree di Power Automate
Metadati del connettore
Editore Microsoft
Sito web https://products.office.com/onenote/digital-note-taking-app

Per usare questa integrazione, è necessario accedere a un blocco appunti di OneNote archiviato in OneDrive For Business. Per stabilire una connessione, selezionare Accedi. Verrà richiesto di specificare l'account di Office 365 con OneDrive for Business abilitato, seguire il resto delle schermate per creare una connessione.

Problemi noti e limitazioni

  1. Quando si usa la connessione, se non viene visualizzato l'elenco dei notebook previsti, controllare l'account con cui è stata creata la connessione e riprovare. Se viene visualizzato un errore durante l'uso del connettore, è possibile cercare il codice di errore per altre informazioni.
  2. Questa integrazione richiede la connessione con un account con l'autorizzazione "UserRemoteAPIs". Se viene visualizzato questo errore: "Errore: l'utente non dispone delle autorizzazioni per accedere alla risorsa richiesta", l'account potrebbe non avere le autorizzazioni corrette. Un amministratore di SharePoint può controllare i livelli di autorizzazione passando alla raccolta siti e aprendo le impostazioni sito. Selezionare le autorizzazioni del sito e quindi il livello di autorizzazione per visualizzare le autorizzazioni (ad esempio, Usa interfacce remote) contenute nel livello. Se un utente appartenente a un determinato livello non dispone dell'autorizzazione richiesta, modificare il livello selezionando la casella relativa all'autorizzazione o creare un nuovo livello di autorizzazione e assegnarlo all'utente.
  3. Il connettore attualmente non supporta un parametro di input esplicito Titolo pagina per le azioni Crea pagina . Si tratta di una limitazione derivante dall'implementazione dell'API OneNote. Tuttavia, il titolo può essere specificato come parte del contenuto della pagina in HTML usando i <tag titolo></titolo>.
  4. Sezione Notebook. Se si vuole specificare un valore personalizzato per il parametro Sezione notebook, specificarlo nel formato DELL'URL DELL'API. Modello di URL api: https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages. Per altre informazioni, è possibile consultare la documentazione dell'API di OneNote.
  5. La creazione di una pagina nell'azione Note rapide non è supportata nelle aree seguenti:
    • App per la logica:
      • Azure Government
      • Aree di Azure della Cina
    • Power Automate e Power Apps:
      • Governo degli Stati Uniti (GCC)
      • Governo degli Stati Uniti (GCC High)
      • China Cloud gestito da 21Vianet
  6. L'azione Recupera contenuto pagina non è supportata in Power Apps, ma questa azione è supportata in Power Automate.

Annotazioni

I caratteri seguenti non sono consentiti nel nome del notebook: *":<>?/|%

Limiti per la limitazione delle richieste

Nome Chiamate Periodo di rinnovo
Chiamate API per connessione 100 60 secondi
Frequenza dei polling dei trigger 1 1200 secondi

Azioni

Aggiornare il contenuto della pagina

Aggiornare il contenuto della pagina HTML.
Creare una pagina in Note rapide

Creare una nuova pagina nella sezione Note rapide.
Creare una pagina in una sezione

Creare una nuova pagina in una sezione specificata.
Creare una sezione in un notebook

Creare una sezione in un notebook.
Elimina una pagina

Eliminare una pagina.
Ottenere il contenuto della pagina

Ottenere il contenuto della pagina HTML.
Ottenere notebook recenti

Ottenere notebook recenti.
Ottenere pagine per una sezione specifica

Ottenere pagine per una sezione specifica.
Ottenere sezioni nel notebook

Ottenere sezioni in un notebook specifico.

Aggiornare il contenuto della pagina

ID operazione:
UpdatePageContent

Aggiornare il contenuto della pagina HTML.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del notebook
 notebookKey True string

Chiave che identifica il notebook. Si noti che questo è specifico per l'API e non può essere tipizzato a mano.
Sezione Notebook
 sectionId True string

URL API delle pagine di sezione.
ID pagina
 pageId True string

ID univoco della pagina.
Obiettivo
 target string

Elemento da aggiornare.
Action
 action string

Azione da eseguire sull'elemento di destinazione.
Posizione
 position string

Percorso in cui aggiungere il contenuto fornito.
Content
 content html

Nuovo contenuto.

Restituisce

Contenuto HTML della pagina

response
string

Creare una pagina in Note rapide

ID operazione:
CreatePageInQuickNotes

Creare una nuova pagina nella sezione Note rapide.

Parametri

Nome Chiave Necessario Tipo Descrizione
Contenuto pagina
 pageContent True html

Contenuto della pagina.

Restituisce

Corpo
Page

Creare una pagina in una sezione

ID operazione:
CreatePageInSection

Creare una nuova pagina in una sezione specificata.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del notebook
 notebookKey True string

Chiave che identifica il notebook. Si noti che questo è specifico per l'API e non può essere tipizzato a mano.
Sezione Notebook
 sectionId True string

URL API delle pagine di sezione.
Contenuto pagina
 pageContent True html

Contenuto della pagina.

Restituisce

Corpo
Page

Creare una sezione in un notebook

ID operazione:
CreateSectionInNotebook

Creare una sezione in un notebook.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del notebook
 notebookKey True string

Chiave che identifica il notebook. Si noti che questo è specifico per l'API e non può essere tipizzato a mano.
Nome della nuova sezione
 name string

Nome della nuova sezione.

Restituisce

Corpo
CreateSectionInNotebookResponse

Elimina una pagina

ID operazione:
DeletePage

Eliminare una pagina.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del notebook
 notebookKey True string

Chiave che identifica il notebook. Si noti che questo è specifico per l'API e non può essere tipizzato a mano.
Sezione Notebook
 sectionId True string

URL API delle pagine di sezione.
ID pagina
 pageId True string

ID univoco della pagina.

Ottenere il contenuto della pagina

ID operazione:
GetPageContent

Ottenere il contenuto della pagina HTML.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del notebook
 notebookKey True string

Chiave che identifica il notebook. Si noti che questo è specifico per l'API e non può essere tipizzato a mano.
Sezione Notebook
 sectionId True string

URL API delle pagine di sezione.
ID pagina
 pageId True string

ID univoco della pagina.

Restituisce

Contenuto HTML della pagina

response
string

Ottenere notebook recenti

ID operazione:
GetNotebooks

Ottenere notebook recenti.

Restituisce

response
array of Notebook

Ottenere pagine per una sezione specifica

ID operazione:
GetPagesInSection

Ottenere pagine per una sezione specifica.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del notebook
 notebookKey True string

Chiave che identifica il notebook. Si noti che questo è specifico per l'API e non può essere tipizzato a mano.
Sezione Notebook
 sectionId True string

URL API delle pagine di sezione.

Restituisce

Corpo
GetPagesInSectionResponse

Ottenere sezioni nel notebook

ID operazione:
GetSectionsInNotebook

Ottenere sezioni in un notebook specifico.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del notebook
 notebookKey True string

Chiave che identifica il notebook. Si noti che questo è specifico per l'API e non può essere tipizzato a mano.

Restituisce

Nome Percorso Tipo Descrizione
value
 value array of SectionListItem

Trigger

Quando viene creata una nuova pagina in una sezione

Attiva un flusso quando viene aggiunta una nuova pagina a una sezione.
Quando viene creata una nuova sezione

Attiva un flusso quando viene aggiunta una nuova sezione a un notebook.
Quando viene creato un nuovo gruppo di sezioni

Attiva un flusso quando viene aggiunto un nuovo gruppo di sezioni a un notebook.

Quando viene creata una nuova pagina in una sezione

ID operazione:
OnNewPageInSection

Attiva un flusso quando viene aggiunta una nuova pagina a una sezione.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del notebook
 notebookKey True string

Chiave che identifica il notebook. Si noti che questo è specifico per l'API e non può essere tipizzato a mano.
Sezione Notebook
 sectionId True string

URL API delle pagine di sezione.

Restituisce

Risposta per una nuova pagina.

Corpo
NewPageResponse

Quando viene creata una nuova sezione

ID operazione:
OnNewSectionInNotebook

Attiva un flusso quando viene aggiunta una nuova sezione a un notebook.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del notebook
 notebookKey True string

Chiave che identifica il notebook. Si noti che questo è specifico per l'API e non può essere tipizzato a mano.

Restituisce

Risposta per una nuova sezione.

Corpo
NewSectionResponse

Quando viene creato un nuovo gruppo di sezioni

ID operazione:
OnNewSectionGroupInNotebook

Attiva un flusso quando viene aggiunto un nuovo gruppo di sezioni a un notebook.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del notebook
 notebookKey True string

Chiave che identifica il notebook. Si noti che questo è specifico per l'API e non può essere tipizzato a mano.

Restituisce

Risposta per un nuovo gruppo di sezioni.

Corpo
NewSectionGroupResponse

Definizioni

CreateSectionInNotebookResponse

Nome Percorso Tipo Descrizione
Contesto OData
 @odata.context string

Contesto OData.
Creato in base al nome
 createdBy string

Questa sezione creata in base al nome.
Tempo di creazione
 createdTime date-time

Questa sezione ha creato l'ora.
Creare una sezione nell'ID oggetto del notebook
 id string
Flag di sezione predefinito
 isDefault boolean

Flag che indica se si tratta della sezione predefinita.
Data ultima modifica
 lastModifiedBy string

Ultima modifica in base al nome.
Ora ultima modifica
 lastModifiedTime date-time

Ora dell'ultima modifica di questa sezione.
Href client desktop
 links.oneNoteClientUrl.href string

Href del client desktop di OneNote.
Href client Web
 links.oneNoteWebUrl.href string

Href client Web di OneNote.
Nome sezione
 name string

Nome della sezione.
URL delle pagine
 pagesUrl string

URL delle pagine.
URL per la creazione di una sezione nel notebook
 self string

URL da creare nella sezione nel gruppo di notebook.

Pagina

Nome Percorso Tipo Descrizione
Titolo pagina
 title string

Titolo della pagina.
links
 links Link

Collegamenti associati alla pagina di OneNote.
URL contenuto
 contentUrl string

URL del contenuto della pagina.
Data ultima modifica
 lastModifiedTime date-time

Data dell'ultima modifica della pagina.
Data di creazione
 createdTime date-time

Data di creazione della pagina.
id
 id string

Identificatore univoco della pagina.

Notebook

Nome Percorso Tipo Descrizione
Nome del file
 FileName string
Key
 Key string

ParentNotebook

Nome Percorso Tipo Descrizione
Chiave del notebook padre
 id string

Identificatore univoco del notebook padre.
Nome notebook padre
 name string

Nome del notebook padre.
URL del notebook padre
 self string

Collegamento url al notebook padre.

Collegamenti associati alla pagina di OneNote.

Nome Percorso Tipo Descrizione
oneNoteClientUrl
 oneNoteClientUrl OneNoteClientUrl
oneNoteWebUrl
 oneNoteWebUrl OneNoteWebUrl

OneNoteClientUrl

Nome Percorso Tipo Descrizione
URL client di OneNote
 href string

Collegamento al blocco appunti tramite il client Windows di OneNote.

OneNoteWebUrl

Nome Percorso Tipo Descrizione
URL Web di OneNote
 href string

Collegamento al blocco appunti tramite il client Web di OneNote.

SectionListItem

Campi inclusi in una voce di elenco di sezioni.

Nome Percorso Tipo Descrizione
Nome sezione
 name string

Nome della sezione.
Tasto sezione
 pagesUrl string

Chiave usata per fare riferimento a questa sezione; anche un URL per le pagine.
Identificatore di sezione
 id string

Identificatore univoco della sezione.

SectionResponse

Campi inclusi in una sezione.

Nome Percorso Tipo Descrizione
Creatore
 createdBy string

Creatore della sezione.
Data di creazione
 createdTime date-time

Data e ora di creazione della sezione.
Identificatore di sezione
 id string

Identificatore univoco della sezione.
Data ultima modifica
 lastModifiedBy string

Utente che ha modificato la sezione per l'ultima volta.
Data ultima modifica
 lastModifiedTime date-time

Data e ora dell'ultima modifica della sezione.
Nome sezione
 name string

Nome della sezione.
URL pagine
 pagesUrl string

URL delle pagine in questa sezione.
parentNotebook
 parentNotebook ParentNotebook
URL
 self string

URL di questa sezione.

SectionGroupResponse

Campi inclusi in un gruppo di sezioni.

Nome Percorso Tipo Descrizione
Data di creazione
 createdTime date-time

Data e ora di creazione del gruppo di sezioni.
Creatore
 createdBy string

Creatore del gruppo di sezioni.
Identificatore
 id string

Identificatore univoco del gruppo di sezioni.
Ultimo modificatore
 lastModifiedBy string

Utente che ha modificato l'ultimo gruppo di sezioni.
Data ultima modifica
 lastModifiedTime date-time

Data e ora dell'ultima modifica del gruppo di sezioni.
Nome
 name string

Nome del gruppo di sezioni.
URL sezioni
 sectionsUrl string

URL delle sezioni all'interno di questo gruppo di sezioni.
URL gruppo di sezioni
 self string

URL di questo gruppo di sezioni.

NewSectionResponse

Risposta per una nuova sezione.

Nome Percorso Tipo Descrizione
Sezioni
 value array of SectionResponse

Matrice di oggetti, ognuno dei quali rappresenta una sezione specifica.

NewSectionGroupResponse

Risposta per un nuovo gruppo di sezioni.

Nome Percorso Tipo Descrizione
Gruppi di sezioni
 value array of SectionGroupResponse

Matrice di oggetti, ognuno dei quali rappresenta un gruppo di sezioni specifico.

NewPageResponse

Risposta per una nuova pagina.

Nome Percorso Tipo Descrizione
Pagine
 value array of Page

Matrice di oggetti, ognuno dei quali rappresenta una pagina specifica.

GetPagesInSectionResponse

Nome Percorso Tipo Descrizione
Contesto OData
 @odata.context string

Contesto OData.
Pagine nell'oggetto valore sezione
 value array of object

value
URL contenuto
 value.contentUrl string

URL del contenuto.
Creato dall'ID app
 value.createdByAppId string

Oggetto creato dall'ID app.
Tempo di creazione
 value.createdTime date-time

Ora di creazione per questa risposta.
Identificatore univoco per la risposta
 value.id string

Identificatore univoco per questa risposta.
Ora ultima modifica
 value.lastModifiedTime date-time

Ora dell'ultima modifica per questo oggetto.
Href del client desktop di OneNote
 value.links.oneNoteClientUrl.href string

Href del client desktop di OneNote.
Href client Web di OneNote
 value.links.oneNoteWebUrl.href string

Href client Web di OneNote.
Identificatore univoco della sezione padre
 value.parentSection.id string

Identificatore univoco per questa sezione padre dell'oggetto.
Nome sezione padre
 value.parentSection.name string
Pagine nella sezione padre sezione
 value.parentSection.self string

URL delle pagine nella sezione padre della sezione.
Contesto OData della sezione padre
 value.parentSection@odata.context string

Contesto OData della sezione padre.
Gruppo Pagine in sezione
 value.self string

URL del gruppo Pagine nella sezione.
Titolo pagina
 value.title string

Titolo pagina.

corda

Si tratta del tipo di dati di base 'string'.