Přidání schématu zdroje dat REST průvodcem zjišťování schématu

Schéma zdroje dat lze vytvořit i pro zdroj dat REST. Vytvoření schématu zjednodušuje tvorbu obsahu šablon dokumentů pro moduly se stejnou strukturou a se stejným nebo podobným seznamem atributů.

Informace o této úloze

Pokud k vytváření schémat zdrojů dat používáte průvodce Zjišťování schématu, můžete si vybrat ze dvou voleb typu Reportable REST, které by mohla vaše aplikace podporovat, a to buď rozhraní REST API 1.0, nebo rozhraní REST API 2.0. Obraťte se na svého administrátora systému, pokud nevíte, kterou verzi rozhraní REST API vaše aplikace podporuje.

Zjišťování schématu (REST API 1.0)

Postup

  1. V aplikaci Document Studio klepněte na volbu Data > Zjišťování schématu > Zjišťování schématu REST.
  2. Zadejte podrobnosti o připojení:
    1. Zadejte Název zdroje dat.
    2. Zadejte Popis zdroje dat.
    3. Zadejte Základní adresu URL prostředku.
    4. Ze seznamu vyberte Typ ověřování. Pokud není vybrán žádný typ, je testován každý typ, dokud není nalezen správný typ. Uvedení typu umožňuje eliminaci tohoto procesu.
    5. Pokud je prostředek na zabezpečeném serveru, zadejte Jméno uživatele.
    6. Pokud je prostředek na zabezpečeném serveru, zadejte Heslo.
  3. Klepněte na tlačítko Další.
  4. V závislosti na tom, zda váš zdroj dat používá datové služby, se zobrazí jedno z následujících oken:

    Pokud zdroj dat nepoužívá datové služby, zobrazí se okno Vytvořit prostředek.

    1. Zadejte Název nového prostředku.
    2. Zadejte Popis nového prostředku.
    3. Zadejte Relativní cestu nového prostředku.
    Pokud je zdroj dat REST dostupný prostřednictvím adaptérů Reporting Data Services, zobrazí se okno Vyhledat pomocí datové služby.
    1. Vyberte prvek ve stromu schématu XML.
    2. Ze seznamu atributů vyberte hodnotu href.
    3. Klepněte na tlačítko Další. Zobrazí se adresa URL vybraného prostředku.
  5. Vyberte adresu URL a klepněte na tlačítko Dokončit, nebo pomocí adresy URL vyhledejte podřízený prostředek. Vyhledání podřízeného prostředku:
    1. Vyberte adresu URL a klepněte na tlačítko Další.
    2. Vyberte prvek v podokně schématu XML.
    3. Ze seznamu atributů vyberte hodnotu href.
  6. Pokud jste vyhledali podřízený prostředek, klepněte na volbu Dokončit. Průvodce se dokončí a zobrazí adresu URL v okně Konfigurace. Pokud je prostředek na zabezpečeném serveru, zadejte do konfiguračního okna jméno a heslo uživatele.

Zjišťování schématu (REST API 2.0)

Informace o této úloze

Poznámka: Produkt Rational Publishing Engine podporuje pouze zkrácený formát RDF. Poskytovatelé musí přijmout a dodržovat požadavky application/xml. Viz téma Základní specifikace Open Services for Lifecycle Collaboration verze 2.0.
Produkt Rational Publishing Engine podporuje pouze poskytovatele OSLC v2, kteří postupují podle specifikace Reportable REST v2 Specification.
  • Služba OSLC musí mít schopnosti dotazování definované v prostředku služby pro všechny prostředky, které jsou určené pro tvorbu sestav.
  • Každá schopnost dotazování pro tvorbu sestav:
    • Musí mít odkaz oslc:queryBase, který ukazuje na prostředek se seznamem prostředků určených pro tvorbu sestav. Prostředky v seznamu musí být označeny jako oslc:isMemberProperty v prostředku tvaru prostředku (Resource Shape Resource) prostředku seznamu.
    • Musí mít specifikaci oslc:resourceShape, která popisuje prostředek seznamu.

Postup

  1. Klepněte na volbu Data > Zjišťování schématu > Zjišťování schématu REST v2.
  2. Zadejte podrobnosti o připojení:
    1. Zadejte Základní adresu URL prostředku.
      Musíte znát adresu URL poskytovatele služby, kterého chcete akceptovat. Tato adresa URL je protějškem adresy URL aplikace Reporting Data Services pro zdroj dat REST schopný tvorby sestav. Produkt Rational Publishing Engine načítá data ze zdroje dat jako seznam dotazů. Tyto prostředky ukládá služba, ve které se lze na data dotazovat a interpretovat. Služba poskytuje také dotazovací službu, která pomáhá filtrovat data podle nastavené podmínky nebo upřesnit podmnožiny dat. Tyto dotazy jsou určeny pro daný typ prostředku a umožňují vám přistupovat k prostředku specifického typu. Služba ID2 schopná tvorby sestav může vystavovat řadu typ prostředků, jako např. požadavky na změnu produktu nebo uživatele. Služba dotazu pomáhá uživateli načítat data efektivně nebo jako podmnožinu dat, ale to není povinné. Služba dotazu je k dispozici pro všechny prostředky. Každý produkt může definovat vlastní prostředky a dotazy pro přístup k těmto prostředkům.
    2. Ze seznamu vyberte Typ ověřování.
    3. Pokud je prostředek na zabezpečeném serveru, zadejte Jméno uživatele.
    4. Pokud je prostředek na zabezpečeném serveru, zadejte Heslo.
  3. Klepněte na tlačítko Další.
  4. Vyberte službu REST v2 a k ní příslušný dotaz a klepněte na tlačítko Další. Zobrazí se vlastnosti vybraných služeb.
  5. V seznamu označte požadované vlastnosti a klepněte na volbu Testovat oslc.select. Okno Potvrzení výsledku zobrazí vybrané služby. Potvrďte, že služby jsou správně. Když klepnete na tlačítko Správně, změní se stav pole Testovat oslc.select na hodnotu true. Klepněte na tlačítko Další.

    Pole Testovat oslc.properties se nepoužívá často.

  6. Musíte zadat pouze filtr nebo klauzuli řazení dotazu, např. cq:Product{cq:Product="Rational Publishing Engine"} v klauzuli Query include oslc.where clause a Query include oslc.orderBy clause.
  7. Klepnutím na volbu Testovat oslc.where a Testovat oslc.orderBy ověříte připojení. Produkt Rational Publishing Engine vytváří pomocí definovaných voleb úplný požadavek.
  8. Klepněte na tlačítko Další. Zobrazí se shrnutí vašeho dotazu. Klepněte na tlačítko Dokončit. Průvodce se dokončí a zobrazí adresu URL v okně Konfigurace. Je-li prostředek na zabezpečeném serveru, můžete v okně Konfigurace zadat jméno a heslo uživatele.

Zpětná vazba