visualInfo-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Ein komplexer Typ zum Darstellen der visualElements-Eigenschaft im Activity-Objekt .

Jede Benutzeraktivität wird in der Zeitachse als adaptive Karte angezeigt. App-Entwicklern wird empfohlen, eine benutzerdefinierte Karte bereitzustellen, die das Wesentliche der Aktivität erfasst, die in Ihrer App stattgefunden hat. Dies ist möglich, indem eine benutzerdefinierte JSON-Karte in der Inhaltseigenschaft bereitgestellt wird.

Zusätzlich zu den visuellen Metadaten mit einer adaptiven Karte kann die App Inhaltsmetadaten angeben – Daten, die verwendet werden, um Rückschlüsse auf die Aktivität des Benutzers zu erstellen, um neue Aktivitäten für zukünftige erneute Interaktionen anzubieten. Dies ist möglich, indem die contentInfo-Eigenschaft der Aktivität verwendet wird, um ein JSON-Objekt bereitzustellen, das schema.org Eigenschaften nutzt, um den Inhalt zu beschreiben.

Wenn keine benutzerdefinierte Karte bereitgestellt wird, wird mithilfe der Eigenschaften displayText und description eine einfache Karte generiert. Benutzerdefinierte Karten werden empfohlen, um die besten Inhalte aus Ihrer App heraus zu präsentieren.

Eigenschaften

Eigenschaft Typ Beschreibung
displayText Zeichenfolge Erforderlich. Kurzbeschreibung der eindeutigen Aktivität des Benutzers (z. B. Dokumentname in Fällen, in denen sich eine Aktivität auf die Dokumenterstellung bezieht)
description Zeichenfolge Optional. Längere Textbeschreibung der individuellen Aktivität des Benutzers (Beispiel: Dokumentname, erster Satz und/oder Metadaten)
backgroundColor Zeichenfolge Optional. Hintergrundfarbe, die zum Rendern der Aktivität in der Benutzeroberfläche verwendet wird – Markenfarbe für die Anwendungsquelle der Aktivität. Muss eine gültige Hexadezimalfarbe sein
content Nicht typisiertes JSON-Objekt Optional. Benutzerdefiniertes Datenelement – JSON-Objekt, das zum Bereitstellen benutzerdefinierter Inhalte zum Rendern der Aktivität in der Windows Shell-Benutzeroberfläche verwendet wird
Namensnennung imageInfo Optional. JSON-Objekt, das zum Darstellen eines Symbols verwendet wird, das die Anwendung darstellt, die zum Generieren der Aktivität verwendet wird

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
    "@data.type": "microsoft.graph.visualInfo",
    "attribution": {
        "@odata.type": "microsoft.graph.imageInfo",
        "iconUrl": "String (URL)",
        "alternateText": "String",
        "addImageQuery": "boolean"
    },
    "description": "String",
    "backgroundColor": "String",
    "displayText": "String",
    "content": {
        "@data.type": "microsoft.graph.Json"
    }
}
  • Last updated on