Verwenden von Notiztags auf OneNote-SeitenUse note tags in OneNote pages

Gilt für Heimanwender-Notizbücher in OneDrive | Unternehmensnotizbücher in Office 365Applies to Consumer notebooks on OneDrive | Enterprise notebooks on Office 365

Verwenden Sie das data-tag-Attribut zum Hinzufügen und Aktualisieren von Kontrollkästchen, Sternen und anderen integrierten Notiztags auf einer OneNote-Seite, wie in der folgenden Abbildung gezeigt.Use the data-tag attribute to add and update check boxes, stars, and other built-in note tags on a OneNote page, as shown in the following image.

Drei Notiztags auf einer OneNote-Seite.

Notiztag-AttributeNote tag attributes

Ein Notiztag wird im HTML-Code einer OneNote-Seite durch das data-tag-Attribut dargestellt.In the HTML of a OneNote page, a note tag is represented by the data-tag attribute. Beispiel:For example:

  • Ein deaktiviertes Aufgabenfeld: <p data-tag="to-do">An unchecked to-do box: <p data-tag="to-do">

  • Ein aktiviertes Aufgabenfeld: <p data-tag="to-do:completed">A checked to-do box: <p data-tag="to-do:completed">

  • Ein Stern: <h2 data-tag="important">A star: <h2 data-tag="important">

Ein data-tag-Wert besteht aus einem Shape und manchmal einem Status (siehe unterstützte Werte.)A data-tag value is composed of a shape, and sometimes a status (see all supported values).

EigenschaftProperty BeschreibungDescription
shapeshape Der Bezeichner für das Notiztag (Beispiel: to-do oder important).The identifier of the note tag (example: to-do or important).
statusstatus Der Status der Kontrollkästchen von Notiztags.The status of check box note tags. Dies wird nur dazu verwendet, die Kontrollkästchen als abgeschlossen zu kennzeichnen.This is used only to set check boxes as completed.

Hinzufügen oder Aktualisieren von NotiztagsAdd or update note tags

Verwenden Sie zum Hinzufügen oder Aktualisieren eines integrierten Notiztags das data-tag-Attribut für ein unterstütztes Element.To add or update a built-in note tag, just use the data-tag attribute on a supported element. Im Folgenden ist z. B. ein Absatz als wichtig gekennzeichnet:For example, here's a paragraph marked as important:

<p data-tag="important">...</p>

Trennen Sie mehrere Notiztags durch Kommas:Separate multiple note tags with commas:

<p data-tag="important, critical">...</p>

Sie können ein data-tag für die folgenden Elemente definieren:You can define a data-tag on the following elements:

Eine Liste der Notiztags, die Sie mit Microsoft Graph verwenden können, finden Sie unter Integrierte Notiztags.See Built-in note tags for a list of note tags that you can use with Microsoft Graph. Das Hinzufügen oder Aktualisieren von benutzerdefinierten Tags mit Microsoft Graph wird nicht unterstützt.Adding or updating custom tags using Microsoft Graph is not supported.

BeispieleExamples

Im Folgenden finden Sie eine einfache Aufgabenliste, in der das erste Element abgeschlossen ist.Here's a simple to-do list with the first item completed.

<p data-tag="to-do:completed" data-id="prep">Till garden bed</p> 
<p data-tag="to-do" data-id="spring">Plant peas and spinach</p>
<p data-tag="to-do" data-id="summer">Plant tomatoes and peppers</p>

Beachten Sie, dass die oben aufgeführten <p>-Tags jeweils ein data-id-Attribut enthalten.Note that the <p> tags above each include a data-id attribute. Dies erleichtert das Aktualisieren der Kontrollkästchen-Notiztags.This makes it easier to update the check box note tags. Mit der folgenden Anforderung wird z. B. die Aufgabe Frühjahrsbepflanzung als abgeschlossen gekennzeichnet. For example, the following request marks the spring planting to-do item as completed.

PATCH https://graph.microsoft.com/v1.0/me/onenote/notebooks/pages/{page-id}/content

Content-Type: application/json
Authorization: Bearer {token}

[
   {
    'target':'#spring',
    'action':'replace',
    'content':'<p data-tag="to-do:completed"  data-id="spring">Plant peas and spinach</p>'
  }
]

Die folgende Anforderung erstellt eine Seite, die alle integrierten Notiztags enthält.The following request creates a page that contains all built-in note tags.

POST https://graph.microsoft.com/v1.0/me/onenote/notebooks/pages

Content-Type: text/html
Authorization: Bearer {token}


<!DOCTYPE html>
<html>
  <head>
    <title data-tag="to-do:completed">All built-in note tags</title>
  </head>
  <body>
    <h1 data-tag="important">Paragraphs with built-in note tags</h1>
    <p data-tag="to-do">to-do</p>
    <p data-tag="important">important</p>
    <p data-tag="question">question</p>
    <p data-tag="definition">definition</p>
    <p data-tag="highlight">highlight</p>
    <p data-tag="contact">contact</p>
    <p data-tag="address">address</p>
    <p data-tag="phone-number">phone-number</p>
    <p data-tag="web-site-to-visit">web-site-to-visit</p>
    <p data-tag="idea">idea</p>
    <p data-tag="password">password</p>
    <p data-tag="critical">critical</p>
    <p data-tag="project-a">project-a</p>
    <p data-tag="project-b">project-b</p>
    <p data-tag="remember-for-later">remember-for-later</p>
    <p data-tag="movie-to-see">movie-to-see</p>
    <p data-tag="book-to-read">book-to-read</p>
    <p data-tag="music-to-listen-to">music-to-listen-to</p>
    <p data-tag="source-for-article">source-for-article</p>
    <p data-tag="remember-for-blog">remember-for-blog</p>
    <p data-tag="discuss-with-person-a">discuss-with-person-a</p>
    <p data-tag="discuss-with-person-b">discuss-with-person-b</p>
    <p data-tag="discuss-with-manager">discuss-with-manager</p>
    <p data-tag="send-in-email">send-in-email</p>
    <p data-tag="schedule-meeting">schedule-meeting</p>
    <p data-tag="call-back">call-back</p>
    <p data-tag="to-do-priority-1">to-do-priority-1</p>
    <p data-tag="to-do-priority-2">to-do-priority-2</p>
    <p data-tag="client-request">client-request</p>
    <h1 data-tag="important">Paragraphs with check boxes marked with "completed" status</h1>
    <p data-tag="to-do:completed">to-do:completed</p>
    <p data-tag="discuss-with-person-a:completed">discuss-with-person-a:completed</p>
    <p data-tag="discuss-with-person-b:completed">discuss-with-person-b:completed</p>
    <p data-tag="discuss-with-manager:completed">discuss-with-manager:completed</p>
    <p data-tag="schedule-meeting:completed">schedule-meeting:completed</p>
    <p data-tag="call-back:completed">call-back:completed</p>
    <p data-tag="to-do-priority-1:completed">to-do-priority-1:completed</p>
    <p data-tag="to-do-priority-2:completed">to-do-priority-2:completed</p>
    <p data-tag="client-request:completed">client-request:completed</p>
    <h1 data-tag="important">Multiple note tags</h1>
    <p data-tag="project-a,  client-request:completed">Two note tags:  project-a, client-request:completed</p>
    <p data-tag="idea, send-in-email, question">Three note tags:  idea, send-in-email, question</p>
    <h1 data-tag="important">Using note tags with other elements</h1>
    <p><b>Note tag on a list item:</b></p>
    <ul>
      <li data-tag="to-do-priority-1:completed">Make a to-do list</li>
    </ul>
    <p><b>Note tag on an image:</b></p>
    <img data-tag="source-for-article" src="https://placecorgi.com/200" />
    <p><b>Note tag with embedded style:</b></p>
    <p data-tag="important">Next time, <b>don't</b> forget to invite <span style="background-color:yellow">Dan</span>.</p>
  </body>
</html>

Weitere Informationen zum Erstellen von Seiten finden Sie unter Erstellen von OneNote-Seiten.For more information about creating pages, see Create OneNote pages. Weitere Informationen zum Aktualisieren von Seiten finden Sie unter Aktualisieren von OneNote-Seiten.For more about updating pages, see Update OneNote pages.

Notiztags in ListenNote tags on lists

Hier sind einige Richtlinien für das Arbeiten mit Notiztags in Listen:Here are some guidelines for working with note tags on lists:

  • Verwenden Sie p-Elemente für Aufgabenlisten.Use p elements for to-do lists. Sie zeigen keine Aufzählungen oder Nummern an und können einfacher aktualisiert werden.They don't display a bullet or number, and they're easier to update.

  • Zum Erstellen oder Aktualisieren von Listen, die dasselbe Notiztag für alle Listenelemente anzeigen, definieren Sie data-tag in ul oder ol.To create or update lists that display the same note tag for all list items, define data-tag on the ul or ol. Um die gesamte Liste zu aktualisieren, müssen Sie data-tag für ul oder ol neu definieren.To update the entire list, you'll need to redefine data-tag on the ul or ol.

  • Zum Erstellen oder Aktualisieren von Listen, die ein eindeutiges Notiztag für einige oder alle Listenelemente anzeigen, definieren Sie data-tag für li-Elemente, und schachteln Sie die li-Elemente nicht in ul oder ol.To create or update lists that display a unique note tag for some or all list items, define data-tag on li elements, and don't nest the li elements in a ul or ol. Um die gesamte Liste zu aktualisieren, müssen Sie das ul-Element, das in der HTML-Ausgabe zurückgegeben wird, entfernen und nur die ungeschachtelten li-Elemente zurückgeben.To update the entire list, you'll need to remove the ul that's returned in the output HTML and provide only the unnested li elements.

  • Um bestimmte li-Elemente zu aktualisieren, setzen Sie die li-Elemente einzeln als Ziel ein und definieren Sie data-tag des li-Elements.To update specific li elements, target the li elements individually and define the data-tag on the li element. Ein einzeln adressiertes li-Element kann so aktualisiert werden, dass es ein eindeutiges Notiztag anzeigt, unabhängig davon, wie die Liste ursprünglich definiert wurde.Any individually addressed li element can be updated to display a unique note tag, no matter how the list was originally defined.

    Die Richtlinien basieren auf den folgenden Regeln, die von Microsoft Graph angewendet werden:The guidelines are based on the following rules that are applied by Microsoft Graph:

    • Die data-tag-Einstellung für ein ul- oder ol-Element überschreibt alle Einstellungen in untergeordneten li-Elementen.The data-tag setting for a ul or ol overrides all settings on child li elements. Dies gilt auch dann, wenn das ul- oder ol-Element kein data-tag angibt, aber seine untergeordneten li-Elemente dies tun.This applies even when the ul or ol doesn't specify a data-tag but its child li elements do.

      Wenn Sie beispielsweise ein ul- oder ol-Element erstellen, das data-tag="project-a" definiert, zeigen alle Listenelemente das Notiztag Project A an.For example, if you create a ul or ol that defines data-tag="project-a", all its list items will display the Project A note tag. Wenn dagegen das ul- oder ol-Element kein data-tag definiert, zeigt keines seiner Elemente ein Notiztag an.Or if the ul or ol doesn't define a data-tag, none of its items will display a note tag. Diese Außerkraftsetzung geschieht unabhängig von expliziten Einstellungen in untergeordneten li-Elementen.This override happens regardless of any explicit settings on child li elements.

  • Eindeutige data-tag-Einstellungen werden für Listenelemente unter den folgenden Bedingungen berücksichtigt:Unique data-tag settings are honored for list items under the following conditions:

    • Die li-Elemente sind nicht in einem ul oder ol in einer Erstellungs- oder Aktualisierungsanforderung geschachtelt.The li elements are not nested in a ul or ol in a create or update request.

    • Ein li-Element wird einzeln in einer Aktualisierungsanforderung adressiert.An li element is individually addressed in an update request.

  • Ungeschachtelte li-Elemente, die im Eingabe-HTML-Code gesendet wurden, werden in einem ul im Ausgabe-HTML-Code zurückgegeben.Unnested li elements sent in input HTML are returned in a ul in the output HTML.

  • Im Ausgabe-HTML-Code werden alle data-tag-Listeneinstellungen in span-Elementen für die Listenelemente definiert.In output HTML, all data-tag list settings are defined on span elements on the list items.

Der folgende Code zeigt, wie einige dieser Regeln angewendet werden.The following code shows how some of these rules are applied. Der Eingabe-HTML-Code erstellt zwei Listen mit Notiztags.The input HTML creates two lists with note tags. Der Ausgabe-HTML-Code wird für die Listen zurückgegeben, wenn Sie den Inhalt der Seite abrufen.The output HTML is what's returned for the lists when you retrieve page content.

Eingabe-HTMLInput HTML

<!--To display the same note tag on all list items, define note tags on the ul or ol.--> 
<ul data-tag="project-a" data-id="agenda">
  <li>An item with a Project A note tag</li>
  <li>An item with a Project A note tag</li>
</ul>

<!--To display unique note tags on list items, don't nest li elements in a ul or ol.--> 
<li data-tag="idea" data-id="my-idea">An item with an Idea note tag</li>
<li data-tag="question" data-id="my-question">An item with a Question note tag</li>

Ausgabe-HTMLOutput HTML

<ul>
  <li><span data-tag="project-a">An item with a Project A note tag</span></li>
  <li><span data-tag="project-a">An item with a Project A note tag</span></li>
</ul>
<br />
<ul>
  <li style="..."><span data-tag="idea">An item with an Idea note tag</span></li>
  <li style="..."><span data-tag="question">An item with a Question note tag</span></li>
</ul>

Abrufen von NotiztagsRetrieve note tags

Integrierte Notiztags sind im Ausgabe-HTML-Code enthalten, wenn Sie Seiteninhalte abrufen:Built-in note tags are included in the output HTML when you get page content:

GET ../api/v1.0/pages/{page-id}/content

Ein data-tag-Attribut in der HTML-Ausgabe enthält immer einen Shape-Wert. Zusätzlich ist ein Status enthalten, wenn es sich um ein Kontrollkästchen-Notiztag handelt, das auf „completed“ festgelegt wurde.A data-tag attribute in the output HTML always includes a shape value, and it only includes a status if it represents a check box note tag that's set to completed. Das folgende Beispiel zeigt den Eingabe-HTML-Code, der zum Erstellen einiger Notiztags verwendet wurde, und den zurückgegebenen Ausgabe-HTML-Code.The following examples show the input HTML used to create some note tags and the output HTML that's returned.

Eingabe-HTMLInput HTML

<h1>Status meeting</h1>
<p data-tag="important">Next week's meeting has been moved to <b>Wednesday</b>.</p>
<p data-tag="question">What are the exact dates for the conference?</p>
<p>Upcoming training opportunities. See Katie for more info.</p>
<p data-tag="project-a">Around the room updates.</p>
<ul data-tag="critical">
  <li>Design handouts</li>
  <li>Plan keynote</li>
</ul>

Ausgabe-HTMLOutput HTML

<h1 style="...">Status meeting</h1>
<p data-tag="important">Next week's meeting has been moved to <span style="font-weight:bold">Wednesday</span>.</p>
<p data-tag="question">What are the exact dates for the conference?</p>
<p>Upcoming training opportunities. See Katie for more info.</p>
<p data-tag="project-a">Around the room updates.</p>
<ul>
  <li><span data-tag="critical">Design handouts</span></li>
  <li><span data-tag="critical">Plan keynote</span></li>
</ul>

Beachten Sie, dass das auf Listenebene definierte data-tag-Attribut auf dessen Listenelemente übertragen wird.Note that the data-tag attribute defined at the list level is pushed to its list items. Weitere Informationen zur Verwendung von Notiztags mit Listen finden Sie unter Notiztags in Listen.For more information about using note tags with lists, see Note tags on lists.

Hinweis: Im HTML-Ausgabe-Code werden die Notiztags für Definition und Speicherung als data-tag="remember-for-later" zurückgegeben.Note: In the output HTML, the definition and remember-for-later note tags are both returned as data-tag="remember-for-later". Das title-Element gibt keine Notiztaginformationen zurück.The title element doesn't return any note tag information.

Integrierte Notiztags für OneNoteBuilt-in note tags for OneNote

OneNote umfasst die folgenden integrierten Notiztags:OneNote includes the following built-in note tags:

Alle integrierten Notiztags.

Die Werte, die Sie dem data-tag-Attribut zuweisen können, werden in der folgenden Tabelle aufgeführt.The values you can assign to the data-tag attribute are shown in the following table. Benutzerdefinierte Tags werden nicht unterstützt.Custom tags are not supported.

TagsTags
shape[:status] to-do

to-do:completed
important
question definition highlight
contact address phone-number
web-site-to-visit idea password
critical project-a project-b
remember-for-later movie-to-see book-to-read
music-to-listen-to source-for-article remember-for-blog
discuss-with-person-a

discuss-with-person-a:completed
discuss-with-person-b

discuss-with-person-b:completed
discuss-with-manager

discuss-with-manager:completed
send-in-email schedule-meeting

schedule-meeting:completed
call-back

call-back:completed
to-do-priority-1

to-do-priority-1:completed
to-do-priority-2

to-do-priority-2:completed
client-request

client-request:completed

AntwortinformationenResponse information

Microsoft Graph gibt die folgenden Informationen in der Antwort zurück.Microsoft Graph returns the following information in the response.

AntwortdatenResponse data BeschreibungDescription
ErfolgscodeSuccess code HTTP-Statuscode 201 bei erfolgreich ausgeführter POST-Anforderung, HTTP-Statuscode 204 bei erfolgreich ausgeführter PATCH-AnforderungA 201 HTTP status code for a successful POST request, and a 204 HTTP status code for a successful PATCH request.
FehlerErrors Informationen zu OneNote-Fehlern, die Microsoft Graph zurückgeben kann, finden Sie unter Fehlercodes für OneNote-APIs in Microsoft Graph.Read Error codes for OneNote APIs in Microsoft Graph to learn about OneNote errors that Microsoft Graph can return.

BerechtigungenPermissions

Zum Erstellen oder Aktualisieren von OneNote-Seiten müssen Sie die entsprechenden Berechtigungen anfordern.To create or update OneNote pages, you'll need to request appropriate permissions. Wählen Sie die niedrigste Berechtigungsstufe, die Ihre App zur Erledigung ihrer Aufgaben benötigt.Choose the lowest level of permissions that your app needs to do its work.

Berechtigungen für BEITRAG-SeitenPermissions for POST pages

  • Notes.CreateNotes.Create
  • Notes.ReadWriteNotes.ReadWrite
  • Notes.ReadWrite.AllNotes.ReadWrite.All

Berechtigungen für PATCH-SeitenPermissions for PATCH pages

  • Notes.ReadWriteNotes.ReadWrite
  • Notes.ReadWrite.AllNotes.ReadWrite.All

Weitere Informationen zu Berechtigungsbereichen und deren Funktionsweise finden Sie unter OneNote-Berechtigungsbereiche.For more information about permission scopes and how they work, see OneNote permission scopes.

Siehe auchSee also