Table of contents
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern
Zuletzt aktualisiert: 25.07.2018

Extrahieren von Daten aus Aufnahmen

Gilt für: Privatanwender-Notizbücher auf OneDrive | Enterprise-Notizbücher auf Office 365

Verwenden Sie die OneNote-API zum Extrahieren von Visitenkartendaten aus einem Bild oder von Rezept- und Produktdaten von einer URL.

Extraktionsattribute

Zum Extrahieren und Transformieren von Daten schließen Sie einfach ein div-Tag in die create-page- oder update-page-Anforderung ein, das den Quellinhalt, die Extraktionsmethode sowie ein Ausweichverhalten angibt. Die API rendert extrahierte Daten auf der Seite in einem einfach zu lesenden Format.

<div
  data-render-src="image-or-url"
  data-render-method="extraction-method"
  data-render-fallback="fallback-action">
</div>

data-render-src

Die Inhaltsquelle. Dies kann ein Bild einer Visitenkarte oder eine absolute URL von zahlreichen beliebten Rezept- oder Produktwebsites sein. Erforderlich.

Verwenden Sie für optimale Ergebnisse beim Angeben einer URL die kanonische URL, die ggf. im HTML-Code der Quellwebseite definiert ist. Eine kanonische URL kann beispielsweise folgendermaßen in der Quellwebseite definiert werden:

<link rel="canonical" href="www.domainname.com/page/123/size12/type987" />

data-render-method

Die auszuführende Extraktionsmethode. Erforderlich.

WertBeschreibung
extract.businesscardExtraktionen von Visitenkarten.
extract.recipeExtraktionen von Rezepten.
extract.productExtraktionen von Produktlisten.
extractEin unbekannter Datenextraktionstyp.

Für optimale Ergebnisse geben Sie den Inhaltstyp (extract.businesscard, extract.recipe oder extract.product) an, falls bekannt. Wenn der Typ nicht bekannt ist, verwenden Sie die extract-Methode; die OneNote-API versucht daraufhin, den Typ automatisch zu ermitteln.

data-render-fallback

Das Ausweichverhalten, wenn die Extraktion fehlschlägt. Wenn der Wert weggelassen wird, gilt der Standardwert render.

WertBeschreibung
render()Rendert das Quellbild oder eine Momentaufnahme der Rezept- oder Produktwebseite.
n/vHat keine Wirkung.
Die Option ist nützlich, wenn Sie zusätzlich zum extrahierten Inhalt immer eine Momentaufnahme der Visitenkarte oder Webseite auf der Seite einschließen möchten. Achten Sie darauf, ein separates img-Element in der Anforderung zu senden, wie in den Beispielen dargestellt.

Extraktionen von Visitenkarten

Die OneNote-API sucht und rendert die folgenden Kontaktinformationen basierend auf dem Bild einer Visitenkarte einer Person oder eines Unternehmens.

Eine vCard (.VCF-Datei) mit den extrahierten Kontaktinformationen wird ebenfalls in die Seite eingebettet. Die vCard-Datei ist eine bequeme Möglichkeit zum Abrufen von Kontaktinformationen beim Abrufen von HTML-Seiteninhalten.

Häufige Szenarien für Visitenkartenextraktionen

Abbildung zum Extrahieren von Visitenkarteninformationen und Rendern der Visitenkarte

Geben Sie die extract.businesscard-Methode und das none-Ausweichverhalten an. Senden Sie auch ein img-Element mit dem src-Attribut, das auch auf das Bild verweist. Wenn die API keinen Inhalt extrahieren kann, wird nur das Bild der Visitenkarte gerendert.

<div
    data-render-src="name:scanned-card-image"
    data-render-method="extract.businesscard"
    data-render-fallback="none">
</div>
<img src="name:scanned-card-image" />


Abbildung zum Extrahieren von Visitenkarteninformationen und Rendern des Bilds der Visitenkarte, wenn die Extraktion fehlschlägt

Geben Sie die extract.businesscard-Methode an, und verwenden Sie das standardmäßige render-Ausweichverhalten. Wenn die API keinen Inhalt extrahieren kann, wird stattdessen das Bild der Visitenkarte gerendert.

<div
    data-render-src="name:scanned-card-image"
    data-render-method="extract.businesscard">
</div>

Bei Visitenkartenextraktionen wird das Bild als benannten Teil in einer mehrteiligen Anforderung gesendet. Unter Hinzufügen von Bildern und Dateien finden Sie Beispiele, in denen gezeigt wird, wie ein Bild in einer Anforderung gesendet wird.

Extraktionen von Rezepten

Die OneNote-API sucht und rendert die folgenden Informationen auf der Grundlage einer Rezeptkarten-URL.

Die API ist für Rezepte von vielen beliebten Websites wie Allrecipes.com, FoodNetwork.com und SeriousEats.com optimiert.

Häufige Szenarien für Rezeptextraktionen

Extrahieren von Rezeptinformationen und Rendern eines Snapshots der Rezeptwebseite

Geben Sie die extract.recipe-Methode und das none-Ausweichverhalten an. Senden Sie auch ein img-Element, wobei das data-render-src-Attribut auf die Rezept-URL festgelegt ist. Wenn die API keinen Inhalt extrahieren kann, wird nur ein Snapshot der Rezeptwebseite gerendert.

Dieses Szenario bietet möglicherweise die meisten Informationen, da die Webseite weitere Informationen, wie z. B. Kundenbewertungen und Vorschläge, enthalten kann.

<div
    data-render-src="http://allrecipes.com/recipe/guacamole/"
    data-render-method="extract.recipe"
    data-render-fallback="none">
</div>
<img data-render-src="http://allrecipes.com/recipe/guacamole/" />


Extrahieren von Rezeptinformationen und Rendern eines Snapshots der Rezeptwebseite, wenn die Extraktion fehlschlägt

Geben Sie die extract.recipe-Methode an, und verwenden Sie das standardmäßige Render-Ausweichverhalten. Wenn die API keinen Inhalt extrahieren kann, wird stattdessen ein Snapshot der Rezeptwebseite gerendert.

<div
    data-render-src="http://www.foodnetwork.com/recipes/alton-brown/creme-brulee-recipe.html"
    data-render-method="extract.recipe">
</div>


Extrahieren von Rezeptinformationen und Rendern eines Links zum Rezept

Geben Sie die extract.recipe-Methode und das none-Ausweichverhalten an. Senden Sie auch ein a-Element, wobei das src-Attribut auf die Rezept-URL festgelegt ist (Sie können alternativ auch andere Informationen senden, die Sie der Seite hinzufügen möchten). Wenn die API keinen Inhalt extrahieren kann, wird nur der Rezept-Link gerendert.

<div
    data-render-src="http://www.seriouseats.com/recipes/2014/09/diy-spicy-kimchi-beef-instant-noodles-recipe.html"
    data-render-method="extract.recipe"
    data-render-fallback="none">
</div>
<a href="http://www.seriouseats.com/recipes/2014/09/diy-spicy-kimchi-beef-instant-noodles-recipe.html">Recipe URL</a>

Extraktionen von Produktlisten

Die API ist für Produkte von vielen beliebten Websites wie Amazon.com und HomeDepot.com optimiert.

Häufige Szenarien für Rezeptextraktionen

Extrahieren von Produktinformationen und Rendern eines Snapshots der Produktwebseite

Geben Sie die extract.product-Methode und das none-Ausweichverhalten an. Senden Sie auch ein img-Element, wobei das data-render-src-Attribut auf die Produkt-URL festgelegt ist. Wenn die API keinen Inhalt extrahieren kann, wird nur ein Snapshot der Produktwebseite gerendert.

Dieses Szenario bietet möglicherweise die meisten Informationen, da die Webseite weitere Informationen, wie z. B. Kundenbewertungen und Vorschläge, enthalten kann.

<div
    data-render-src="http://www.amazon.com/Microsoft-Band-Small/dp/B00P2T2WVO"
    data-render-method="extract.product"
    data-render-fallback="none">
</div>
<img data-render-src="http://www.amazon.com/Microsoft-Band-Small/dp/B00P2T2WVO" />


Extrahieren von Produktinformationen und Rendern eines Snapshots der Produktwebseite, wenn die Extraktion fehlschlägt

Geben Sie die extract.product-Methode an, und verwenden Sie das standardmäßige Render-Ausweichverhalten. Wenn die API keinen Inhalt extrahieren kann, wird stattdessen ein Snapshot der Produktwebseite gerendert.

<div
    data-render-src="http://www.sears.com/craftsman-19hp-42-8221-turn-tight-174-hydrostatic-yard-tractor/p-07120381000P"
    data-render-method="extract.product">
</div>


Extrahieren von Produktinformationen und Rendern eines Links zum Produkt

Geben Sie die extract.product-Methode und das none-Ausweichverhalten an. Senden Sie auch ein a-Element, wobei das src-Attribut auf die Produkt-URL festgelegt ist (Sie können alternativ auch andere Informationen senden, die Sie der Seite hinzufügen möchten). Wenn die API keinen Inhalt extrahieren kann, wird nur der Seitenlink gerendert.

<div
    data-render-src="http://www.homedepot.com/p/Active-Ventilation-5-Watt-Solar-Powered-Exhaust-Attic-Fan-RBSF-8-WT/204203001"
    data-render-method="extract.product"
    data-render-fallback="none">
</div>
<a href="http://www.homedepot.com/p/Active-Ventilation-5-Watt-Solar-Powered-Exhaust-Attic-Fan-RBSF-8-WT/204203001">Product URL</a>

Extraktionen unbekannter Inhaltstypen

Wenn Sie den Inhaltstyp (Visitenkarte, Rezept oder Produkt), den Sie versenden möchten, nicht kennen, können Sie die unqualifizierte extract-Methode verwenden und die OneNote-API den Typ automatisch erkennen lassen. Dies ist möglicherweise sinnvoll, wenn Ihre App andere Aufnahmetypen sendet.

Wenn Sie den Inhaltstyp, den Sie senden möchten, nicht kennen, sollten Sie die Methode extract.businesscard, extract.recipe oder extract.product verwenden. In einigen Fällen lassen sich dadurch die Extraktionsergebnisse optimieren.

Häufige Szenarien für Extraktionen unbekannter Inhaltstypen

Senden Sie ein Bild oder eine URL, und rendern Sie das bereitgestellte Bild oder einen Snapshot der Webseite, wenn die Extraktion fehlschlägt

Geben Sie die extract-Methode an, damit die API den Inhaltstyp automatisch erkennen kann und verwenden Sie das standardmäßige render-Ausweichverhalten. Wenn die API keinen Inhalt extrahieren kann, wird stattdessen das bereitgestellte Bild oder ein Snapshot der Webseite gerendert.

<div
    data-render-src="some image or url"
    data-render-method="extract">
</div>

Informationen in der Antwort

AntwortdatenBeschreibung
ErfolgscodeHTTP-Statuscode 201 für eine erfolgreiche POST-Anforderung, HTTP-Statuscode 204 für eine erfolgreiche PATCH-Anforderung.
Fehler oder Warnungen

Tritt bei der Extraktion ein Fehler auf, verarbeitet die API die Anforderung so weit wie möglich und gibt im Nachrichtentext einen Warnungscode 20136 in der @api.diagnostics-Eigenschaft zurück. In folgenden Fällen tritt ein Fehler bei der Extraktion auf:
- Die erforderlichen Attribute data-render-src oder data-render-method fehlen.
- Die Werte data-render-src, data-render-method oder data-fallback-method sind leer oder ungültig.

Die API kann manchmal nur einen Teil des Zielinhalts extrahieren, selbst wenn er verfügbar ist. In diesem Fall verarbeitet der Dienst die Anforderung so weit wie möglich, gibt jedoch keine Warnung zurück.

Header „X-CorrelationId“Ein globaler Bezeichner (GUID), über den die Anforderung eindeutig identifiziert wird. Sie können diesen Wert zusammen mit dem Wert des Datum-Headers verwenden, wenn Sie mit dem Microsoft-Support arbeiten, um Probleme zu beheben.

Berechtigungen

Sie müssen zum Erstellen oder Aktualisieren der OneNote-Seiten die entsprechenden Berechtigungen anfordern. Wählen Sie die unterste Ebene an Berechtigungen aus, die Ihre App für ihre Arbeit benötigt.

Berechtigungen für POST-Seiten

PlattformBerechtigungsbereich
Consumeroffice.onenote_create, office.onenote_update_by_app, office.onenote_update
UnternehmenNotes.Create, Notes.ReadWrite.CreatedByApp, Notes.ReadWrite, Notes.ReadWrite.All

Berechtigungen für PATCH-Seiten

PlattformBerechtigungsbereich
Consumeroffice.onenote_update_by_app, office.onenote_update
UnternehmenNotes.ReadWrite.CreatedByApp, Notes.ReadWrite, Notes.ReadWrite.All

Weitere Informationen zu Berechtigungsbereichen und deren Funktionsweise finden Sie unter OneNote-Berechtigungsbereiche.

Weitere Ressourcen

© 2018 Microsoft