Freigeben über

OneNote (Business)

OneNote ist eine Notizen-App von Microsoft, die das Synchronisieren Ihrer Ideen, Skizzen und Notizen auf allen Ihren Geräten erleichtert. Stellen Sie eine Verbindung mit Ihrem Office 365-Konto her, bei dem OneDrive for Business aktiviert ist, um neue Abschnitte nachzuverfolgen, Notizen zu erstellen und vieles mehr.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Norm Alle Power Automate-Regionen
Logik-Apps Norm Alle Logik-Apps-Regionen
Power Apps Norm Alle Power Apps-Regionen
Power Automate Norm Alle Power Automate-Regionen
Connectormetadaten
Herausgeber Microsoft
Webseite https://products.office.com/onenote/digital-note-taking-app

Um diese Integration zu verwenden, benötigen Sie Zugriff auf ein OneNote-Notizbuch, das auf OneDrive For Business gespeichert ist. Um eine Verbindung herzustellen, wählen Sie "Anmelden" aus. Sie werden aufgefordert, Ihr O365-Konto mit aktiviertem OneDrive for Business bereitzustellen, und folgen Sie den restlichen Bildschirmen, um eine Verbindung zu erstellen.

Bekannte Probleme und Einschränkungen

  1. Wenn sie die Verbindung verwenden, wird die Liste des Notizbuchs, das Sie erwarten, nicht angezeigt, überprüfen Sie das Konto, mit dem Sie die Verbindung erstellt haben, und versuchen Sie es erneut. Wenn beim Verwenden des Connectors ein Fehler angezeigt wird, können Sie den Fehlercode nachschlagen, um weitere Informationen zu finden.
  2. Diese Integration erfordert eine Verbindung mit einem Konto, das über die Berechtigung "UserRemoteAPIs" verfügt. Wenn dieser Fehler angezeigt wird: "Fehler: Der Benutzer hat keine Berechtigungen für den Zugriff auf die angeforderte Ressource", das Konto verfügt möglicherweise nicht über die richtigen Berechtigungen. Ein SharePoint-Administrator kann Berechtigungsstufen steuern, indem er zu der Websitesammlung navigieren und die Websiteeinstellungen öffnet. Wählen Sie die Websiteberechtigungen und dann die Berechtigungsstufe aus, um die Berechtigungen (z. B. die Remoteschnittstellen verwenden) anzuzeigen, die die Ebene enthält. Wenn ein Benutzer, der zu einer bestimmten Ebene gehört, nicht über die erforderliche Berechtigung verfügt, ändern Sie entweder die Stufe, indem Sie das Kontrollkästchen für die Berechtigung aktivieren oder eine neue Berechtigungsstufe erstellen und diese dem Benutzer zuweisen.
  3. Der Connector unterstützt derzeit keinen expliziten Eingabeparameter "Seitentitel " für die Aktionen " Seite erstellen" . Dies ist eine Einschränkung, die sich aus der OneNote-API-Implementierung ergibt. Der Titel kann jedoch als Teil des Seiteninhalts in HTML mithilfe der <Titel><-/Titeltags> angegeben werden.
  4. Notizbuchabschnitt. Wenn Sie einen benutzerdefinierten Wert für den Parameter "Notebook Section" angeben möchten, geben Sie ihn im API-URL-Format an. Das API-URL-Muster: https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages. Weitere Informationen finden Sie in der OneNote-API-Dokumentation.
  5. Das Erstellen einer Seite in der Aktion "Schnelle Notizen " wird in folgenden Regionen nicht unterstützt:
    • Logik-Apps:
      • Azure Government
      • Azure China-Regionen
    • Power Automate und Power Apps:
      • US-Regierung (GCC)
      • US Government (GCC High)
      • China Cloud betrieben von 21Vianet
  6. Die Aktion "Seiteninhalt abrufen" wird in Power Apps nicht unterstützt, diese Aktion wird jedoch in Power Automate unterstützt.

Hinweis

Die folgenden Zeichen sind im Notizbuchnamen nicht zulässig: *":<>?/|%

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden
Häufigkeit der Triggerumfragen 1 1200 Sekunden

Aktionen

Abrufen von Abschnitten im Notizbuch

Abrufen von Abschnitten in einem bestimmten Notizbuch.
Abrufen von Seiten für einen bestimmten Abschnitt

Abrufen von Seiten für einen bestimmten Abschnitt.
Abrufen von Seiteninhalten

Html-Seiteninhalt abrufen.
Aktualisieren von Seiteninhalten

Html-Seiteninhalt aktualisieren.
Eine Seite löschen

Löschen einer Seite.
Erstellen einer Seite in einem Abschnitt

Neue Seite in einem angegebenen Abschnitt erstellen.
Erstellen einer Seite in Schnellen Notizen

Erstellen Sie eine neue Seite im Abschnitt "Schnelle Notizen".
Erstellen eines Abschnitts in einem Notizbuch

Erstellen eines Abschnitts in einem Notizbuch.
Zuletzt verwendete Notizbücher abrufen

Abrufen zuletzt verwendeter Notizbücher.

Abrufen von Abschnitten im Notizbuch

Vorgangs-ID:
GetSectionsInNotebook

Abrufen von Abschnitten in einem bestimmten Notizbuch.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Notizbuchschlüssel
 notebookKey True string

Ein Schlüssel, der das Notizbuch identifiziert. Beachten Sie, dass dies für die API spezifisch ist und nicht von Hand eingegeben werden kann.

Gibt zurück

Name Pfad Typ Beschreibung
value
 value array of SectionListItem

Abrufen von Seiten für einen bestimmten Abschnitt

Vorgangs-ID:
GetPagesInSection

Abrufen von Seiten für einen bestimmten Abschnitt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Notizbuchschlüssel
 notebookKey True string

Ein Schlüssel, der das Notizbuch identifiziert. Beachten Sie, dass dies für die API spezifisch ist und nicht von Hand eingegeben werden kann.
Notizbuchabschnitt
 sectionId True string

API-URL der Abschnittsseiten.

Gibt zurück

Body
GetPagesInSectionResponse

Abrufen von Seiteninhalten

Vorgangs-ID:
GetPageContent

Html-Seiteninhalt abrufen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Notizbuchschlüssel
 notebookKey True string

Ein Schlüssel, der das Notizbuch identifiziert. Beachten Sie, dass dies für die API spezifisch ist und nicht von Hand eingegeben werden kann.
Notizbuchabschnitt
 sectionId True string

API-URL der Abschnittsseiten.
Seiten-ID
 pageId True string

Eindeutige ID der Seite.

Gibt zurück

Html-Inhalt der Seite

response
string

Aktualisieren von Seiteninhalten

Vorgangs-ID:
UpdatePageContent

Html-Seiteninhalt aktualisieren.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Notizbuchschlüssel
 notebookKey True string

Ein Schlüssel, der das Notizbuch identifiziert. Beachten Sie, dass dies für die API spezifisch ist und nicht von Hand eingegeben werden kann.
Notizbuchabschnitt
 sectionId True string

API-URL der Abschnittsseiten.
Seiten-ID
 pageId True string

Eindeutige ID der Seite.
Ziel
 target string

Das zu aktualisierende Element.
Maßnahme
 action string

Die Aktion, die für das Zielelement ausgeführt werden soll.
Standort
 position string

Der Speicherort, an dem der angegebene Inhalt hinzugefügt werden soll.
Content
 content html

Der neue Inhalt.

Gibt zurück

Html-Inhalt der Seite

response
string

Eine Seite löschen

Vorgangs-ID:
DeletePage

Löschen einer Seite.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Notizbuchschlüssel
 notebookKey True string

Ein Schlüssel, der das Notizbuch identifiziert. Beachten Sie, dass dies für die API spezifisch ist und nicht von Hand eingegeben werden kann.
Notizbuchabschnitt
 sectionId True string

API-URL der Abschnittsseiten.
Seiten-ID
 pageId True string

Eindeutige ID der Seite.

Erstellen einer Seite in einem Abschnitt

Vorgangs-ID:
CreatePageInSection

Neue Seite in einem angegebenen Abschnitt erstellen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Notizbuchschlüssel
 notebookKey True string

Ein Schlüssel, der das Notizbuch identifiziert. Beachten Sie, dass dies für die API spezifisch ist und nicht von Hand eingegeben werden kann.
Notizbuchabschnitt
 sectionId True string

API-URL der Abschnittsseiten.
Seiteninhalt
 pageContent True html

Seiteninhalt.

Gibt zurück

Body
Page

Erstellen einer Seite in Schnellen Notizen

Vorgangs-ID:
CreatePageInQuickNotes

Erstellen Sie eine neue Seite im Abschnitt "Schnelle Notizen".

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Seiteninhalt
 pageContent True html

Seiteninhalt.

Gibt zurück

Body
Page

Erstellen eines Abschnitts in einem Notizbuch

Vorgangs-ID:
CreateSectionInNotebook

Erstellen eines Abschnitts in einem Notizbuch.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Notizbuchschlüssel
 notebookKey True string

Ein Schlüssel, der das Notizbuch identifiziert. Beachten Sie, dass dies für die API spezifisch ist und nicht von Hand eingegeben werden kann.
Name des neuen Abschnitts
 name string

Der Name des neuen Abschnitts.

Gibt zurück

Body
CreateSectionInNotebookResponse

Zuletzt verwendete Notizbücher abrufen

Vorgangs-ID:
GetNotebooks

Abrufen zuletzt verwendeter Notizbücher.

Gibt zurück

response
array of Notebook

Auslöser

Beim Erstellen einer neuen Abschnittsgruppe

Löst einen Fluss aus, wenn einer neuen Abschnittsgruppe ein Notizbuch hinzugefügt wird.
Beim Erstellen eines neuen Abschnitts

Löst einen Fluss aus, wenn einem Notizbuch ein neuer Abschnitt hinzugefügt wird.
Wenn eine neue Seite in einem Abschnitt erstellt wird

Löst einen Fluss aus, wenn einem Abschnitt eine neue Seite hinzugefügt wird.

Beim Erstellen einer neuen Abschnittsgruppe

Vorgangs-ID:
OnNewSectionGroupInNotebook

Löst einen Fluss aus, wenn einer neuen Abschnittsgruppe ein Notizbuch hinzugefügt wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Notizbuchschlüssel
 notebookKey True string

Ein Schlüssel, der das Notizbuch identifiziert. Beachten Sie, dass dies für die API spezifisch ist und nicht von Hand eingegeben werden kann.

Gibt zurück

Antwort für eine neue Abschnittsgruppe.

Body
NewSectionGroupResponse

Beim Erstellen eines neuen Abschnitts

Vorgangs-ID:
OnNewSectionInNotebook

Löst einen Fluss aus, wenn einem Notizbuch ein neuer Abschnitt hinzugefügt wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Notizbuchschlüssel
 notebookKey True string

Ein Schlüssel, der das Notizbuch identifiziert. Beachten Sie, dass dies für die API spezifisch ist und nicht von Hand eingegeben werden kann.

Gibt zurück

Antwort für einen neuen Abschnitt.

Body
NewSectionResponse

Wenn eine neue Seite in einem Abschnitt erstellt wird

Vorgangs-ID:
OnNewPageInSection

Löst einen Fluss aus, wenn einem Abschnitt eine neue Seite hinzugefügt wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Notizbuchschlüssel
 notebookKey True string

Ein Schlüssel, der das Notizbuch identifiziert. Beachten Sie, dass dies für die API spezifisch ist und nicht von Hand eingegeben werden kann.
Notizbuchabschnitt
 sectionId True string

API-URL der Abschnittsseiten.

Gibt zurück

Antwort auf eine neue Seite.

Body
NewPageResponse

Definitionen

CreateSectionInNotebookResponse

Name Pfad Typ Beschreibung
OData-Kontext
 @odata.context string

Der OData-Kontext.
Erstellt anhand des Namens
 createdBy string

Dieser Abschnitt wurde anhand des Namens erstellt.
Erstellte Zeit
 createdTime date-time

Dieser Abschnitt hat Zeit erstellt.
Abschnitt in der Notizbuchobjekt-ID erstellen
 id string
Standardabschnittskennzeichnung
 isDefault boolean

Ein Kennzeichen, das anmerkt, ob dies der Standardabschnitt ist.
Zuletzt geändert von
 lastModifiedBy string

Zuletzt geändert nach Name.
Uhrzeit der letzten Änderung
 lastModifiedTime date-time

Der Zeitpunkt, zu dem dieser Abschnitt zuletzt geändert wurde.
Desktopclient href
 links.oneNoteClientUrl.href string

OneNote-Desktopclient href.
Webclient-Href
 links.oneNoteWebUrl.href string

OneNote-Webclient href.
Abschnittsname
 name string

Der Name des Abschnitts.
Die Seiten-URL
 pagesUrl string

Die URL der Seiten.
URL zum Erstellen eines Abschnitts im Notizbuch
 self string

Die URL zum Erstellen eines Abschnitts in der Notizbuchgruppe.

Seite

Name Pfad Typ Beschreibung
Seitentitel
 title string

Der Titel der Seite.
Verknüpfungen
 links Link

Die Links, die der OneNote-Seite zugeordnet sind.
Inhalts-URL
 contentUrl string

Eine URL zum Seiteninhalt.
Datum der letzten Änderung
 lastModifiedTime date-time

Das Datum der letzten Änderung der Seite.
Erstellt am
 createdTime date-time

Das Datum, an dem die Seite erstellt wurde.
Id
 id string

Der eindeutige Bezeichner der Seite.

Notebook

Name Pfad Typ Beschreibung
Dateiname
 FileName string
Key
 Key string

ParentNotebook

Name Pfad Typ Beschreibung
Übergeordneter Notizbuchschlüssel
 id string

Der eindeutige Bezeichner des übergeordneten Notizbuchs.
Name des übergeordneten Notizbuchs
 name string

Der Name des übergeordneten Notizbuchs.
Url des übergeordneten Notizbuchs
 self string

Ein URL-Link zum übergeordneten Notizbuch.

Die Links, die der OneNote-Seite zugeordnet sind.

Name Pfad Typ Beschreibung
oneNoteClientUrl
 oneNoteClientUrl OneNoteClientUrl
oneNoteWebUrl
 oneNoteWebUrl OneNoteWebUrl

OneNoteClientUrl

Name Pfad Typ Beschreibung
OneNote-Client-URL
 href string

Ein Link zum Notizbuch mithilfe des OneNote-Windows-Clients.

OneNoteWebUrl

Name Pfad Typ Beschreibung
OneNote-Web-URL
 href string

Ein Link zum Notizbuch mithilfe des OneNote-Webclients.

SectionListItem

Die Felder, die in einem Abschnittslistenelement enthalten sind.

Name Pfad Typ Beschreibung
Abschnittsname
 name string

Der Name des Abschnitts.
Abschnittsschlüssel
 pagesUrl string

Der Schlüssel, der verwendet wird, um auf diesen Abschnitt zu verweisen; auch eine URL zu den Seiten.
Abschnittsbezeichner
 id string

Eindeutiger Bezeichner des Abschnitts.

SectionResponse

Die Felder, die in einem Abschnitt enthalten sind.

Name Pfad Typ Beschreibung
Schöpfer
 createdBy string

Der Ersteller des Abschnitts.
Erstellungsdatum
 createdTime date-time

Das Erstellungsdatum und die Uhrzeit des Abschnitts.
Abschnittsbezeichner
 id string

Eindeutiger Bezeichner des Abschnitts.
Zuletzt geändert von
 lastModifiedBy string

Der Benutzer, der den Abschnitt zuletzt geändert hat.
Datum der letzten Änderung
 lastModifiedTime date-time

Das Datum und die Uhrzeit der letzten Änderung des Abschnitts.
Abschnittsname
 name string

Der Name des Abschnitts.
Seiten-URL
 pagesUrl string

Url zu den Seiten in diesem Abschnitt.
parentNotebook
 parentNotebook ParentNotebook
URL
 self string

Die URL zu diesem Abschnitt.

SectionGroupResponse

Die Felder, die in einer Abschnittsgruppe enthalten sind.

Name Pfad Typ Beschreibung
Erstellungsdatum.
 createdTime date-time

Das Erstellungsdatum und die Uhrzeit der Abschnittsgruppe.
Schöpfer
 createdBy string

Der Ersteller der Abschnittsgruppe.
Kennung
 id string

Eindeutiger Bezeichner der Abschnittsgruppe.
Letzter Modifizierer
 lastModifiedBy string

Der Benutzer, der die Abschnittsgruppe zuletzt geändert hat.
Datum der letzten Änderung
 lastModifiedTime date-time

Datum und Uhrzeit der letzten Änderung der Abschnittsgruppe.
Name
 name string

Der Name der Abschnittsgruppe.
Abschnitts-URL
 sectionsUrl string

Url der Abschnitte in dieser Abschnittsgruppe.
Abschnittsgruppen-URL
 self string

Die URL zu dieser Abschnittsgruppe.

NewSectionResponse

Antwort für einen neuen Abschnitt.

Name Pfad Typ Beschreibung
Abschnitte
 value array of SectionResponse

Ein Array von Objekten, die jeweils einen bestimmten Abschnitt darstellen.

NewSectionGroupResponse

Antwort für eine neue Abschnittsgruppe.

Name Pfad Typ Beschreibung
Abschnittsgruppen
 value array of SectionGroupResponse

Ein Array von Objekten, die jeweils eine bestimmte Abschnittsgruppe darstellen.

NewPageResponse

Antwort auf eine neue Seite.

Name Pfad Typ Beschreibung
Seiten
 value array of Page

Ein Array von Objekten, die jeweils eine bestimmte Seite darstellen.

GetPagesInSectionResponse

Name Pfad Typ Beschreibung
OData-Kontext
 @odata.context string

Der OData-Kontext.
Seiten im Abschnittswertobjekt
 value array of object

value
Inhalts-URL
 value.contentUrl string

Die Inhalts-URL.
Erstellt von der App-ID
 value.createdByAppId string

Die von der App-ID erstellte.
Erstellte Zeit
 value.createdTime date-time

Die erstellte Zeit für diese Antwort.
Eindeutiger Bezeichner für Antwort
 value.id string

Der eindeutige Bezeichner für diese Antwort.
Zeitpunkt der letzten Änderung
 value.lastModifiedTime date-time

Der Zeitpunkt der letzten Änderung für dieses Objekt.
OneNote-Desktopclient href
 value.links.oneNoteClientUrl.href string

OneNote-Desktopclient href.
OneNote-Webclient href
 value.links.oneNoteWebUrl.href string

OneNote-Webclient href.
Eindeutiger Bezeichner des übergeordneten Abschnitts
 value.parentSection.id string

Der eindeutige Bezeichner für diesen übergeordneten Objektabschnitt.
Name des übergeordneten Abschnitts
 value.parentSection.name string
Seiten im übergeordneten Abschnitt "Abschnitt"
 value.parentSection.self string

Die URL zu den Seiten im übergeordneten Abschnitt des Abschnitts.
OData-Kontext des übergeordneten Abschnitts
 value.parentSection@odata.context string

Übergeordneter Abschnitt OData-Kontext.
Seiten in Abschnittsgruppe
 value.self string

Die URL zur Gruppe "Seiten in Abschnitt".
Seitentitel
 value.title string

Seitentitel.

Schnur

Dies ist der grundlegende Datentyp "string".