OneNote (företag)
OneNote är en anteckning som tar en app från Microsoft som gör det enkelt att synkronisera dina idéer, skisser och anteckningar på alla dina enheter! Anslut till ditt Office 365-konto med OneDrive för företag aktiverat för att spåra nya avsnitt, skapa anteckningar med mera.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Tjänster | Class | Regioner |
|---|---|---|
| Copilot Studio | Norm | Alla Power Automate regioner |
| Logiska appar | Norm | Alla Logic Apps-regioner |
| Power Apps | Norm | Alla Power Apps-regioner |
| Power Automate | Norm | Alla Power Automate regioner |
| Metadata för anslutningsprogram | |
|---|---|
| Utgivare | Microsoft |
| Webbplats | https://products.office.com/onenote/digital-note-taking-app |
Om du vill använda den här integreringen behöver du åtkomst till en OneNote-anteckningsbok som lagras i OneDrive för företag. Om du vill upprätta en anslutning väljer du Logga in. Du uppmanas att ange ditt O365-konto med OneDrive för företag aktiverat. Följ resten av skärmarna för att skapa en anslutning.
Kända problem och begränsningar
- Om du inte ser listan över notebook-filer som du förväntar dig när du använder anslutningen kontrollerar du det konto som du skapade anslutningen med och försöker igen. Om du ser ett fel när du använder anslutningsappen kan du söka efter felkoden för mer information.
- Den här integreringen kräver anslutning med ett konto som har behörigheten "UserRemoteAPIs". Om du ser det här felet: "Fel: användaren inte har behörighet att komma åt den begärda resursen" kanske kontot inte har rätt behörigheter. En SharePoint-administratör kan styra behörighetsnivåer genom att bläddra till webbplatssamlingen och öppna webbplatsinställningarna. Välj Platsbehörigheter och sedan Behörighetsnivå för att se de behörigheter (till exempel Använd fjärrgränssnitt) som nivån innehåller. Om en användare som tillhör en viss nivå inte har den behörighet som krävs ändrar du antingen nivån genom att markera rutan för behörigheten eller skapa en ny behörighetsnivå och tilldela den till användaren.
- Anslutningsappen stöder för närvarande inte någon explicit sidrubrik för indataparametern för åtgärderna Skapa sida . Det här är en begränsning som härrör från OneNote API-implementeringen. Titeln kan dock anges som en del av sidinnehållet i HTML med hjälp av taggarna <för rubrik></rubrik.>
-
Notebook-avsnitt. Om du vill ange ett anpassat värde för notebook-avsnittsparametern anger du det i API-URL-format. API-url-mönstret:
https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages. Mer information finns i dokumentationen för OneNote API. -
Åtgärden Skapa en sida i snabbanteckningar stöds inte i följande regioner:
- Logic Apps:
- Azure Government
- Azure Kina-regioner
- Power Automate och Power Apps:
- Amerikanska myndigheter (GCC)
- Amerikanska myndigheter (GCC High)
- China Cloud drivs av 21Vianet
- Logic Apps:
- Åtgärden Hämta sidinnehåll stöds inte i Power Apps, men den här åtgärden stöds i Power Automate.
Anmärkning
Följande tecken tillåts inte i notebook-namnet: *":<>?/|%
Begränsningsgränser
| Name | Anrop | Förnyelseperiod |
|---|---|---|
| API-anrop per anslutning | 100 | 60 sekunder |
| Frekvens för utlösarundersökningar | 1 | 1200 sekunder |
Åtgärder
| Hämta avsnitt i notebook-filen |
Hämta avsnitt i en specifik notebook-fil. |
| Hämta senaste notebook-filer |
Hämta de senaste notebook-filerna. |
| Hämta sidinnehåll |
Hämta HTML-sidinnehåll. |
| Hämta sidor för ett visst avsnitt |
Hämta sidor för ett visst avsnitt. |
| Skapa avsnitt i en notebook-fil |
Skapa avsnitt i en notebook-fil. |
| Skapa en sida i Snabbanteckningar |
Skapa en ny sida i avsnittet Snabbanteckningar. |
| Skapa sida i ett avsnitt |
Skapa en ny sida i ett angivet avsnitt. |
| Ta bort en sida |
Ta bort en sida. |
| Uppdatera sidinnehåll |
Uppdatera HTML-sidinnehåll. |
Hämta avsnitt i notebook-filen
Hämta avsnitt i en specifik notebook-fil.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Notebook-nyckel
|
notebookKey | True | string |
En nyckel som identifierar anteckningsboken. Observera att detta är specifikt för API:et och kan inte skrivas för hand. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
värde
|
value | array of SectionListItem |
Hämta senaste notebook-filer
Hämta sidinnehåll
Hämta HTML-sidinnehåll.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Notebook-nyckel
|
notebookKey | True | string |
En nyckel som identifierar anteckningsboken. Observera att detta är specifikt för API:et och kan inte skrivas för hand. |
|
Notebook-avsnitt
|
sectionId | True | string |
API-URL för avsnittssidorna. |
|
Sid-ID
|
pageId | True | string |
Unikt ID för sidan. |
Returer
Sidans HTML-innehåll
- response
- string
Hämta sidor för ett visst avsnitt
Hämta sidor för ett visst avsnitt.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Notebook-nyckel
|
notebookKey | True | string |
En nyckel som identifierar anteckningsboken. Observera att detta är specifikt för API:et och kan inte skrivas för hand. |
|
Notebook-avsnitt
|
sectionId | True | string |
API-URL för avsnittssidorna. |
Returer
Skapa avsnitt i en notebook-fil
Skapa avsnitt i en notebook-fil.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Notebook-nyckel
|
notebookKey | True | string |
En nyckel som identifierar anteckningsboken. Observera att detta är specifikt för API:et och kan inte skrivas för hand. |
|
Namnet på det nya avsnittet
|
name | string |
Namnet på det nya avsnittet. |
Returer
Skapa en sida i Snabbanteckningar
Skapa en ny sida i avsnittet Snabbanteckningar.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Sidinnehåll
|
pageContent | True | html |
Sidinnehåll. |
Returer
- Body
- Page
Skapa sida i ett avsnitt
Skapa en ny sida i ett angivet avsnitt.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Notebook-nyckel
|
notebookKey | True | string |
En nyckel som identifierar anteckningsboken. Observera att detta är specifikt för API:et och kan inte skrivas för hand. |
|
Notebook-avsnitt
|
sectionId | True | string |
API-URL för avsnittssidorna. |
|
Sidinnehåll
|
pageContent | True | html |
Sidinnehåll. |
Returer
- Body
- Page
Ta bort en sida
Ta bort en sida.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Notebook-nyckel
|
notebookKey | True | string |
En nyckel som identifierar anteckningsboken. Observera att detta är specifikt för API:et och kan inte skrivas för hand. |
|
Notebook-avsnitt
|
sectionId | True | string |
API-URL för avsnittssidorna. |
|
Sid-ID
|
pageId | True | string |
Unikt ID för sidan. |
Uppdatera sidinnehåll
Uppdatera HTML-sidinnehåll.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Notebook-nyckel
|
notebookKey | True | string |
En nyckel som identifierar anteckningsboken. Observera att detta är specifikt för API:et och kan inte skrivas för hand. |
|
Notebook-avsnitt
|
sectionId | True | string |
API-URL för avsnittssidorna. |
|
Sid-ID
|
pageId | True | string |
Unikt ID för sidan. |
|
Target
|
target | string |
Elementet som ska uppdateras. |
|
|
Åtgärd
|
action | string |
Åtgärden som ska utföras på målelementet. |
|
|
Plats
|
position | string |
Platsen där det angivna innehållet ska läggas till. |
|
|
Content
|
content | html |
Det nya innehållet. |
Returer
Sidans HTML-innehåll
- response
- string
Utlösare
| När en ny avsnittsgrupp skapas |
Utlöser ett flöde när en ny avsnittsgrupp läggs till i en notebook-fil. |
| När en ny sida skapas i ett avsnitt |
Utlöser ett flöde när en ny sida läggs till i ett avsnitt. |
| När ett nytt avsnitt skapas |
Utlöser ett flöde när ett nytt avsnitt läggs till i en notebook-fil. |
När en ny avsnittsgrupp skapas
Utlöser ett flöde när en ny avsnittsgrupp läggs till i en notebook-fil.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Notebook-nyckel
|
notebookKey | True | string |
En nyckel som identifierar anteckningsboken. Observera att detta är specifikt för API:et och kan inte skrivas för hand. |
Returer
Svar för en ny avsnittsgrupp.
När en ny sida skapas i ett avsnitt
Utlöser ett flöde när en ny sida läggs till i ett avsnitt.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Notebook-nyckel
|
notebookKey | True | string |
En nyckel som identifierar anteckningsboken. Observera att detta är specifikt för API:et och kan inte skrivas för hand. |
|
Notebook-avsnitt
|
sectionId | True | string |
API-URL för avsnittssidorna. |
Returer
Svar för en ny sida.
- Body
- NewPageResponse
När ett nytt avsnitt skapas
Utlöser ett flöde när ett nytt avsnitt läggs till i en notebook-fil.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Notebook-nyckel
|
notebookKey | True | string |
En nyckel som identifierar anteckningsboken. Observera att detta är specifikt för API:et och kan inte skrivas för hand. |
Returer
Svar för ett nytt avsnitt.
- Body
- NewSectionResponse
Definitioner
CreateSectionInNotebookResponse
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
OData-kontext
|
@odata.context | string |
OData-kontexten. |
|
Skapad efter namn
|
createdBy | string |
Det här avsnittet har skapats med namn. |
|
Skapad tid
|
createdTime | date-time |
Det här avsnittet skapade tid. |
|
Skapa avsnitt i notebook-objekt-ID
|
id | string | |
|
Standardavsnittsflagga
|
isDefault | boolean |
En flagga för att ange om detta är standardavsnittet. |
|
Senast ändrad av
|
lastModifiedBy | string |
Senast ändrad efter namn. |
|
Senast ändrade tid
|
lastModifiedTime | date-time |
Den tid då det här avsnittet senast ändrades. |
|
Skrivbordsklient href
|
links.oneNoteClientUrl.href | string |
OneNote desktop client href. |
|
Webbklient href
|
links.oneNoteWebUrl.href | string |
OneNote-webbklient href. |
|
Avsnittsnamn
|
name | string |
Namnet på avsnittet. |
|
Sid-URL:en
|
pagesUrl | string |
Url:en för sidorna. |
|
Url för att skapa avsnitt i notebook-filen
|
self | string |
Url:en för att skapa avsnittet i notebook-gruppen. |
Sida
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Sidrubrik
|
title | string |
Sidans rubrik. |
|
links
|
links | Link |
Länkarna som är associerade med OneNote-sidan. |
|
Innehålls-URL
|
contentUrl | string |
En URL till sidinnehållet. |
|
Senast ändrat datum
|
lastModifiedTime | date-time |
Sidans senast ändrade datum. |
|
Skapelsedatum
|
createdTime | date-time |
Det datum då sidan skapades. |
|
Id
|
id | string |
Den unika identifieraren för sidan. |
Notebook
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
filnamn
|
FileName | string | |
|
Key
|
Key | string |
ParentNotebook
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Överordnad notebook-nyckel
|
id | string |
Den överordnade notebook-filens unika identifierare. |
|
Namn på överordnad anteckningsbok
|
name | string |
Namnet på den överordnade anteckningsboken. |
|
Url för överordnad anteckningsbok
|
self | string |
En URL-länk till den överordnade notebook-filen. |
Länk
Länkarna som är associerade med OneNote-sidan.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
oneNoteClientUrl
|
oneNoteClientUrl | OneNoteClientUrl | |
|
oneNoteWebUrl
|
oneNoteWebUrl | OneNoteWebUrl |
OneNoteClientUrl
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
OneNote-klient-URL
|
href | string |
En länk till anteckningsboken med onenote-windows-klienten. |
OneNoteWebUrl
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
OneNote-webb-URL
|
href | string |
En länk till anteckningsboken med onenote-webbklienten. |
SectionListItem
Fälten som ingår i ett avsnittslistobjekt.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Avsnittsnamn
|
name | string |
Namnet på avsnittet. |
|
Avsnittsnyckel
|
pagesUrl | string |
Den nyckel som används för att referera till det här avsnittet; också en URL till sidorna. |
|
Avsnittsidentifierare
|
id | string |
Unikt ID för avsnittet. |
SectionResponse
Fälten som ingår i ett avsnitt.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Utvecklare
|
createdBy | string |
Skaparen av avsnittet. |
|
Skapandedatum
|
createdTime | date-time |
Skapandedatum och tid för avsnittet. |
|
Avsnittsidentifierare
|
id | string |
Unikt ID för avsnittet. |
|
Senast ändrad av
|
lastModifiedBy | string |
Användaren som senast ändrade avsnittet. |
|
Senast ändrat datum
|
lastModifiedTime | date-time |
Senaste ändringsdatum och tid för avsnittet. |
|
Avsnittsnamn
|
name | string |
Namnet på avsnittet. |
|
Url för sidor
|
pagesUrl | string |
Url till sidorna i det här avsnittet. |
|
parentNotebook
|
parentNotebook | ParentNotebook | |
|
URL
|
self | string |
Url:en till det här avsnittet. |
SectionGroupResponse
Fälten som ingår i en avsnittsgrupp.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Skapad datum
|
createdTime | date-time |
Skapandedatum och tid för avsnittsgruppen. |
|
Utvecklare
|
createdBy | string |
Skaparen av avsnittsgruppen. |
|
Identifikator
|
id | string |
Unik identifierare för avsnittsgruppen. |
|
Senaste modifierare
|
lastModifiedBy | string |
Den användare som senast ändrade avsnittsgruppen. |
|
Senast ändrat datum
|
lastModifiedTime | date-time |
Senaste ändringsdatum och tid för avsnittsgruppen. |
|
Namn
|
name | string |
Namnet på avsnittsgruppen. |
|
Avsnitts-URL
|
sectionsUrl | string |
Url för avsnitten i den här avsnittsgruppen. |
|
Avsnittsgrupps-URL
|
self | string |
URL:en till den här avsnittsgruppen. |
NewSectionResponse
Svar för ett nytt avsnitt.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Sektioner
|
value | array of SectionResponse |
En matris med objekt som var och en representerar ett visst avsnitt. |
NewSectionGroupResponse
Svar för en ny avsnittsgrupp.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Avsnittsgrupper
|
value | array of SectionGroupResponse |
En matris med objekt som var och en representerar en specifik avsnittsgrupp. |
NewPageResponse
Svar för en ny sida.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Sidor
|
value | array of Page |
En matris med objekt som var och en representerar en specifik sida. |
GetPagesInSectionResponse
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
OData-kontext
|
@odata.context | string |
OData-kontexten. |
|
Sidor i avsnittsvärdeobjekt
|
value | array of object |
värde |
|
Innehålls-URL
|
value.contentUrl | string |
Innehålls-URL:en. |
|
Skapad av app-ID
|
value.createdByAppId | string |
Skapad av app-ID. |
|
Skapad tid
|
value.createdTime | date-time |
Den skapade tiden för det här svaret. |
|
Unik identifierare för svar
|
value.id | string |
Den unika identifieraren för det här svaret. |
|
Senast ändrad tid
|
value.lastModifiedTime | date-time |
Den senaste ändrade tiden för det här objektet. |
|
OneNote-skrivbordsklient href
|
value.links.oneNoteClientUrl.href | string |
OneNote desktop client href. |
|
OneNote-webbklient href
|
value.links.oneNoteWebUrl.href | string |
OneNote-webbklient href. |
|
Unik identifierare för överordnat avsnitt
|
value.parentSection.id | string |
Den unika identifieraren för det här objektets överordnade avsnitt. |
|
Överordnat avsnittsnamn
|
value.parentSection.name | string | |
|
Sidor i avsnittet Överordnat avsnitt
|
value.parentSection.self | string |
URL:en till sidorna i avsnittet överordnat avsnitt. |
|
OData-kontext för överordnat avsnitt
|
value.parentSection@odata.context | string |
OData-kontext för överordnat avsnitt. |
|
Sidor i avsnittsgrupp
|
value.self | string |
URL:en till gruppen Sidor i avsnitt. |
|
Sidrubrik
|
value.title | string |
Sidrubrik. |
snöre
Det här är den grundläggande datatypen "string".