Bejegyzés használati listája

Hogyan kell lekérni egy konkrét bejegyzés használati listáját.

2022.02.01 — Posted by Webb & Flow


Tartalomjegyzék

Minden olyan entitás, ami nem a portál konfigurálásához kell, végső célja, hogy egy vagy több tartalom publikálásához fel legyen használva.

Emiatt szükség lehet arra, hogy lássuk, hogy egy adott bejegyzés melyik tartalmaknál van felhasználva, például, ha módosítjuk a bejegyzést, és látni szeretnénk, hogy melyik tartalmakat kell újra publikálni, hogy a módosítások élesedjenek.

Ezt a tartalom listát a konkrét tartalmakra vonatkozó jogoktól függetlenül le lehet kérni, azonban emiatt csak a legszükségesebb mezők érhetők el a válaszban.

GET /projects/PROJECTID/contents/byusage/ENTITY/ENTITYID

Az ENTITY a következő lehet:

  • box
  • css
  • js
  • htmlSablon
  • itemSablon
  • content
  • script
  • pic
  • uploadedPic
  • file
  • uploadedFile
  • icon
  • svg
  • template
  • contentType

Az ENTITYID a konkrét bejegyzés azonosítója.

A válasz egy standard entitás lista (Standard entitások adatmodellje), amiben mindig Content típusú bejegyzések lesznek.

Az alap tartalom listázással szemben a legnagyobb különbség, hogy ebben a listában vegyesen bármilyen fajtájú tartalom szerepelhet.

A visszaadott elemeknél a következő mezők érhetők el:

  • id
  • section
  • title
  • url
  • shortDescription
  • createdAt
  • createdBy
  • lastModAt
  • lastModBy

Minden mezőnél kizárólag a value almező érhető el, a szerkesztésre vonatkozó és egyéb plusz almezők nem.

A lista lekérése automatikusan frissíti az adott bejegyzés használati számát is, így nem kell külön azt az API-t is meghívni, ha nem ugyanazt a számot adja vissza, mint ahány elem a konkrét listán található.