Správa typů polí

Knowledge Graph podporuje různé typy polí, z nichž každé je určeno pro jiný druh dat.

Standardní typy polí

Každé pole je definováno typem. Toto jsou standardní typy polí dostupné na platformě Yext.

Typ pole souboru

Typ pole souboru umožňuje ukládat soubory přímo do vašich subjektů. Tento typ lze použít ve vlastních polích a typech vlastních polí.

Vlastnosti

Typ pole souboru se skládá z následujících pěti vlastností:

Typy polí souborů lze nakonfigurovat tak, aby podporovaly jeden soubor nebo seznam souborů. Tím se automaticky nastaví maximální počet ověření nahraných souborů na 1, resp. 5 000.

Platnost

Výchozí ověření polí souboru je uvedeno níže. Můžete také nastavit ověření pro vlastní pole souboru a typy vlastních polí souboru.

Poznámka: existuje známý problém s JsonFormat.Printer, který ovlivňuje Configuration as Code, kdy se vlastnost maxSize při vyžádání vrátí jako řetězec. Při použití však musí být tato vlastnost číslo.

Nahrávání souborů

Soubory lze nahrávat pomocí všech rozhraní pro úpravu subjektů v nástroji Knowledge Graph (tj. Úprava subjektů, Nahrávání subjektů, Konektory, API a CaC).

Všechna rozhraní podporují nahrávání souborů odkazem na zdrojovou adresu URL. Nahrávání z místního systému souborů je podporováno pouze v nástroji Úprava subjektů.

Pokud chcete nahrát soubor hostovaný online, uveďte hostovanou adresu URL pomocí vlastnosti url. Uvedená adresa URL se poté přenese do vlastnosti sourceUrl, zatímco pole URL se změní na adresu URL tohoto souboru hostovanou Yext.

Aktualizace souborů

Pokud chcete změnit soubor uložený v poli subjektu, aktualizujte hodnotu vlastnosti url tak, aby odpovídala adrese URL nového hostovaného souboru. Odesílání aktualizací do vlastnosti sourceUrl není podporováno.

Řetězec uživatelského agenta používaný ke stahování souborů je YextBot YextFileDownloader/1.0.

Přístup k uloženým souborům

K souborům uloženým v subjektech lze přistupovat prostřednictvím sekce Úprava subjektu a přes rozhraní API.

Úprava subjektu

Soubory lze stahovat z vlastnosti URL. Stav úprav tohoto pole zobrazí všechny vlastnosti pole Soubor. Vlastnosti souboru nelze v sekci Úprava subjektu upravovat, s výjimkou názvu souboru.

API

Otevřením adresy URL uložené ve vlastnosti url se soubor stáhne do místního zařízení. Takto by to vypadalo v Entities: GET.

Při vynechání ostatních polí vypadá odpověď takto:

{
  "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
	}]
    }]
  }
}

Typ pole fotografie

Typ pole fotografie umožňuje ukládat fotografie přímo do subjektů. Tento typ lze použít ve vlastních polích a typech vlastních polí.

Vlastnosti

Typ pole fotografie se skládá z následujících pěti vlastností:

Platnost

Můžete nastavit ověření pro vlastní pole fotografie a typy vlastních polí fotografie.

Omezení

Nahrávání fotografií

Fotografie lze nahrávat pomocí všech rozhraní pro úpravu subjektů v nástroji Knowledge Graph.

Všechna rozhraní podporují nahrávání fotografií odkazem na zdrojovou adresu URL. Nahrání fotografie z místního systému souborů je podporováno pouze v nástroji Úprava subjektů.

Pokud chcete nahrát fotografii hostovanou online, vyplňte adresu URL fotografie ve vlastnosti url. Uvedená adresa URL se poté přenese do vlastnosti sourceUrl, zatímco pole URL bude obsahovat adresu URL fotografie hostovanou Yext.
 

Aktualizace fotografií

Pokud chcete změnit fotografii uloženou v daném poli Fotografie, aktualizujte hodnotu vlastnosti url tak, aby odpovídala adrese URL nově hostované fotografie. Odesílání aktualizací přímo do vlastnosti sourceUrl není podporováno.

Přístup k fotografiím

Po nahrání obrázku do subjektu se jeho hostovaná adresa URL uloží jako odkaz v poli tohoto subjektu. K subjektu můžete přistupovat prostřednictvím API a přímo načíst URL adresu fotografie, například:

Při vynechání ostatních polí vypadá odpověď takto:

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

Každému obrázku je přiřazen dlouhý identifikátor UUID (výše uvedený dlouhý náhodný řetězec), takže adresa URL má formát: a.mktgcdn.com/p/UUID/WIDTHxHEIGHT.EXT.

Podporovány jsou protokoly HTTP i HTTPS.