Feldtypen verwalten

Der Knowledge Graph unterstützt verschiedene Feldtypen, die jeweils für unterschiedliche Datentypen konzipiert sind.

Standardfeldtypen

Jedes Feld ist durch einen Typ definiert. Dies sind die Standardfeldtypen, die auf der Yext-Plattform verfügbar sind.

Datei-Feldtyp

Der Feldtyp „Datei“ ermöglicht es Ihnen, Dateien direkt in Ihren Entitäten zu speichern. Dieser Typ kann in benutzerdefinierten Feldern und benutzerdefinierten Feldtypen verwendet werden.

Eigenschaften

Der Dateifeldtyp besteht aus den folgenden fünf Eigenschaften:

Dateifeldtypen können so konfiguriert werden, dass sie eine Datei oder eine Liste von Dateien unterstützen. Dadurch wird automatisch eine maximale Dateiupload-Validierung von 1 bzw. 5.000 Dateien erstellt.

Validierung

Die Standardvalidierung für Dateifelder ist unten aufgeführt. Sie können auch die Validierung für benutzerdefinierte Dateifelder und benutzerdefinierte Dateifeldtypen konfigurieren.

Hinweis: Es gibt ein bekanntes Problem mit JsonFormat.Printer, das Configuration as Code betrifft. Dabei wird die maxSize-Eigenschaft beim Abrufen als Zeichenkette zurückgegeben. Allerdings muss diese Eigenschaft beim Anwenden eine Zahl sein.

Dateien hochladen

Dateien können über alle Schnittstellen hochgeladen werden, um Entitäten im Knowledge Graph zu bearbeiten (z. B. Entität bearbeiten, Entity Upload, Connectors, API und CaC).

Alle Schnittstellen unterstützen Datei-Uploads durch Angabe einer Quell-URL. Das Hochladen von einem lokalen Dateisystem wird nur in Entität bearbeiten unterstützt.

Um eine Datei hochzuladen, die online gehostet wird, geben Sie die gehostete URL mithilfe der url Eigenschaft an. Diese bereitgestellte URL wird dann in die sourceUrl Eigenschaft übertragen, während das URL-Feld zur von Yext gehosteten URL dieser Datei wird.

Dateien aktualisieren

Um eine Datei zu ändern, die in einem Feld einer Entität gespeichert ist, aktualisieren Sie den Wert der url Eigenschaft mit der URL der neuen gehosteten Datei. Das Senden von Aktualisierungen an die sourceUrl Eigenschaft wird nicht unterstützt.

Der User-Agent-String, der zum Herunterladen von Dateien verwendet wird, ist YextBot YextFileDownloader/1.0.

Zugriff auf gespeicherte Dateien

Auf Entitäten gespeicherte Dateien können über Entität bearbeiten und über API abgerufen werden.

Entität bearbeiten

Dateien können über die URL-Eigenschaft heruntergeladen werden. Der Bearbeitungszustand dieses Feldes zeigt alle Eigenschaften des Dateifeldes an. Die Eigenschaften einer Datei können in Entität bearbeiten nicht bearbeitet werden, mit Ausnahme des Dateinamens.

API

Wenn Sie die in der url Eigenschaft gespeicherte URL öffnen, wird die Datei auf Ihr lokales Gerät heruntergeladen. So könnte dies bei einem Entities: GET aussehen.

Wenn andere Felder weggelassen wurden, sieht die Antwort folgendermaßen aus:

{
  "response": {
    "entities": [{
      "c_pdfFile": [{
  		"sourceUrl": "https://www.pdfs.com/123",
  		"url":"https://a.mktgcdn.com/f/3912636/123",
  		"mimeType": "application/pdf",
  		"name": "Instruction Manual",
  		"size": 2001
	}]
    }]
  }
}

Feldtyp Foto

Der Feldtyp Foto ermöglicht es Ihnen, Fotos direkt auf Ihren Entitäten zu speichern. Dieser Typ kann in benutzerdefinierten Feldern und benutzerdefinierten Feldtypen verwendet werden.

Eigenschaften

Der Feldtyp Foto setzt sich aus folgenden fünf Eigenschaften zusammen:

Validierung

Sie können die Validierung für benutzerdefinierte Felder und benutzerdefinierte Feldtypen konfigurieren.

Einschränkungen

Fotos hochladen

Fotos können über alle Schnittstellen zur Bearbeitung von Entitäten im Knowledge Graph hochgeladen werden.

Alle Schnittstellen unterstützen das Hochladen von Fotos durch Referenzierung einer Quell-URL. Das Hochladen eines Fotos aus einem lokalen Dateisystem wird nur in Entität bearbeiten unterstützt.

Um ein Foto hochzuladen, das online gehostet wird, füllen Sie die Foto-URL in die url Eigenschaft ein. Diese URL wird dann an die sourceUrl Eigenschaft weitergeleitet, während das URL-Feld die von Yext gehostete URL des Fotos ist.
 

Fotos aktualisieren

Um das Foto zu ändern, das in einem bestimmten Fotofeld gespeichert ist, aktualisieren Sie den Wert der url Eigenschaft auf die URL des neuen gehosteten Fotos. Das Senden von Aktualisierungen direkt an die sourceUrl Eigenschaft wird nicht unterstützt.

Zugriff auf Fotos

Sobald ein Bild in eine Entität hochgeladen wurde, wird die zugehörige gehostete URL als Referenz im Feld der Entität gespeichert. Sie können über die API auf die Entität zugreifen, um die URL des Fotos direkt abzurufen, zum Beispiel:

Wenn andere Felder weggelassen wurden, sieht die Antwort folgendermaßen aus:

{
  "response": {
    "entities": [{
      "photoGallery": [{
        "image": {
          "width": 314,
          "height": 366, 
          "url": "http://a.mktgcdn.com/p/Oua5ocwC7euaUFkJ-V8n3OpF76Xtfh_rdsDT9ki_laY/314x366.jpg"
      }]
    }]
  }
}

Jedem Bild wird eine lange UUID (die lange zufällige Zeichenkette oben) zugewiesen, sodass die URL die folgende Form hat: a.mktgcdn.com/p/UUID/WIDTHxHEIGHT.EXT.

Sowohl HTTP als auch HTTPS werden unterstützt.