Dotaz definuje, jaká data se budou extrahovat ze zdroje dat, a má podobu cesty ke schématu zdroje dat. Dotaz můžete přiřadit k prvku šablony, aby definoval kontext dat daného prvku a jeho podřízených prvků.
Informace o této úloze
Dotazy v produktu
IBM® Rational DOORS začínají kořenovým prvkem (modulem), pokračují jeho podřízenými prvky (objekty) až po podřízené atributy objektu. Např.
Module/Object/Attribute/Name.
Dotazy v produktu
IBM Rational Tau mají syntaxi podobnou syntaxi XPath. Avšak na rozdíl od XPath neurčuje dotaz produktu Rational Publishing Engine filtr. Filtr a klauzule pro řazení jsou od dotazu odděleny. Každý prvek schématu, kromě dotazu, je definován prostřednictvím nativního dotazu produktu
Rational Tau. Tento dotaz, který je vyjádřen v jazyce OCL, načítá data produktu Rational Tau.
Např. kořenový prvek pod prvkem modelu model.rootResource má k sobě připojen dotaz produktu Rational Tau ve tvaru
GetModelRoots().
Postup
- Přiřaďte dotazy.
- V produktu Document Studio otevřete pohled Schéma zdroje dat.
- Přidejte prvky do šablony.
- Přetáhněte dotazy z pohledu Schéma zdroje dat do prvků.
Dotaz je přiřazen k prvku šablony. Atributy typu dotazu, prvku přetaženého z pohledu
Schéma zdroje dat, můžete použít v libovolném místě prvku šablony a jeho podřízených prvků.
- Nastavte dotaz na prvek dotazu.
Poznámka: Můžete zpracovat podmnožinu prvků šablony, když nastavíte omezení na počet prvků dotazu.
- V aplikaci Document Studio vyberte prvek šablony, který obsahuje dotaz.
- V pohledu Vlastnosti vyberte kartu Data.
- Do vlastnosti Omezení zadejte počet objektů ze zdroje dat, které se budou v příslušném dotazu používat. Hodnota 0 (nula) představuje neomezené nastavení dotazu.
- Přiřaďte opakující se vlastnosti dotazu. Rekurzi dat lze používat k extrakci všech podřízených požadavků z hlavního zdrojového požadavku ve schématu.
- Vyberte prvek, který obsahuje dotaz.
- V pohledu Vlastnosti zadejte do vlastnosti Rekurzivní úroveň, kolik úrovní je tento dotaz hluboký.
- Do vlastnosti Rekurzivní segmenty zadejte, kolikrát se budou segmenty v dotazu opakovat.
Další informace o rekurzivních úrovních a segmentech najdete v níže uvedeném příkladu.
- Uložte změny.
Výsledky
Když u prvku používáte dotaz, máte k dispozici tři vizuální indikátory, které se v editoru obsahu šablon standardně zobrazují modře.
- Název schématu zdroje dat.
- Kontext zobrazovaný se znakem dolaru ($).
- Název dotazu.
Tip: Volby Vymazat odkazy a Vymazat data pracují při mazání informací z dotazů odlišně. Volba Vymazat odkazy je dostupná pouze v případě, když vyberete prvek obsahující dotaz. Volba Vymazat odkazy odebere všechny dotazy, atributy, filtry, řazení a podmínky na vybraném prvku a jeho podřízených prvcích, jsou-li k nim rovněž přiřazeny nějaké dotazy či atributy. Volba Vymazat data odebere všechny dotazy, atributy, filtry, řazení a podmínky na vybraném prvku a jeho podřízených prvcích. Stránky předlohy, styly a vlastnosti formátování odebrány nejsou.
Příklad: Rekurzivní úroveň a rekurzivní segmenty
Seznam softwarových požadavků na použití dotazu
PRRequirement ve schématu
IBM Rational RequisitePro, které máte k dispozici v ukázkách nainstalovaných v produktu
Rational Publishing Engine, najdete v souboru:
%RPE_HOME%\source\XML\examples\RequisitePro.xsdPro každý požadavek
PRRequirement můžete extrahovat všechny podřízené požadavky a pro každý podřízený požadavek můžete extrahovat všechny jeho podřízené požadavky, aniž byste přidali do své šablony každý dotaz.
Místo toho, abyste přidali všechny následující dotazy:
- [$1] Project/Requirements/PRRequirement pro extrakci
PRRequirements.
- [$2] $1/Children/Relationship/RelatedReq pro extrakci podřízených požadavků každého požadavku
PRRequirement.
- [$3] $2/Children/Relationship/RelatedReq pro extrakci podřízených požadavků všech podřízených požadavků každého požadavku
PRRequirement.
Můžete vytvořit jeden dotaz pro všechny tyto požadavky:
- Přidejte dotaz Project/Requirements/PRRequirement/Children/Relationship/RelatedReq do prvku.
- Přidejte hodnoty do vlastností Rekurzivní úroveň a Rekurzivní segmenty.
- Spusťte sestavu k testování.
Při spuštění sestavy se zahrnou tyto dotazy:
Pokud zjistíte,že zadaný počet pro vlastnost
Rekurzivní segmenty je vyšší než počet segmentů, který dotaz obsahuje, můžete použít jednu z těchto dvou voleb k vyřešení problému:
- Vyberte prvek, který používá vlastnost Rekurzivní segmenty. V pohledu Vlastnosti vyberte kartu Data a snižte hodnotu pro vlastnost rekurzivních segmentů.
- Také můžete znovu navrhnout dotaz ke spuštění z odlišného nadřízeného dotazu. Pokud vaše hodnota Rekurzivní segmenty je jeden příliš velký segment, vytvořte prvek kontejneru a přidejte dotaz, který je o jednu úroveň výše než nadřízený dotaz existujícího prvku.
Pak přesuňte existující prvek do prvku kontejneru.
Jak pokračovat dále
Tip: Seznam dotazů a atributů můžete prohledávat klepnutím pravým tlačítkem myši na prvek a výběrem volby . Otevře se pohled Vyhledávání a zobrazí seznam dotazů a atributů. Poklepáním na dotaz nebo atribut ve výsledcích můžete upravit jeho obsah.
Klepnutím pravým tlačítkem myši na prvek a výběrem volby můžete vyhledat seznam přiřazení proměnných, atributů a dotazů použitých v prvku. Otevře se pohled Hledat a zobrazí se seznam. Pokud chcete upravit položku, poklepejte na ni ve výsledcích.
Dotaz nebo atribut můžete vyhledat v pohledu Schémata zdrojů dat z prvku, pro který se použil, a to klepnutím pravým tlačítkem myši na daný prvek a výběrem volby
. Otevře se pohled Schéma zdroje dat a v něm bude zvýrazněn příslušný atribut nebo dotaz.