Kā atrast nepieciešamo Horizon REST resursu?

[#1]

Esat iegādājušies un uzstādījuši Horizon REST saskarni. Piedurknes ir atrotītas un esat gatavi ķerties pie integrācijas risinājuma izstrādes. Apsveicu!

Taču tagad sākas grūtākais (un interesantākais). Horizon ir apjomīga funkcionalitāte, kuras lielākā daļa ir pieejama REST saskarnē. Pamēģiniet REST saskarnes ieejas punktu: http://localhost:7378/rest (kur “localhost:7378” vietā ir jūsu aktuālā REST servera adrese un ports).

Rezultātā iegūsim daudzu tūkstošu rindiņu garu sarakstu. Kā tajā atrast un izvēlēties nepieciešamo resursu?

Pieņemsim, ka vēlaties veikt salīdzinoši vienkāršu uzdevumu - nolasīt Horizon klientu sarakstu.

Ja mēģināsiet Horizon REST resursu sarakstā sameklēt “Klientu saraksts”, tad atradīsiet resursu, kas saucas “Klientu saraksts pamatdatos” (/rest/TDdmKlPamatDat). Vai tas ir vajadzīgais?

Te der atcerēties, ka viens no Horizon pamatjēdzieniem ir dokumentu pamatveids. Izliekam šo lauku Klientu sarakstā (skat. attēlu):

Redzam, ka dokumenta pamatveids saucas “Klienta kartīte”. Tagad varam meklēt pēc šīs frāzes Horizon REST resursu sarakstā un iegūstam saiti uz Klientu kartītes resursu:

    <link>
      <href>/rest/TDdmCustomer</href>
      <description>Klienta kartīte</description>
    </link>

Ejam uz šo resursu /rest/TDdmCustomer un sameklējam saiti uz Klienta kartītes kolekcijas resursu (meklējot pēc <href rel="collection">). Tas izskatās šādi:

  <link>
    <href rel="collection">/rest/TDdmKlSar</href>
    <description>Klientu izvēles saraksts</description>
  </link>

Rezultātā esam ieguvuši resursu darbam ar klientu sarakstu /rest/TDdmKlSar.

Bet kā tad paliek ar otru klientu sarakstu? Kuru no šiem izmantot?

Uz to nav viennozīmīga atbilde un tā ir atkarīga no konkrētās situācijas. Šajā gadījumā atšķirība ir tajā, ka /rest/TDdmKlSar satur arī darbinieku klienta kartītes (no Personāla moduļa), kamēr /rest/TDdmKlPamatDat tādas nerādīs.