Možnosti chování zdroje source-behaviour
Specifikace upřesňující chování a vlastnosti v případě nastavení zdroje segmentu.
[count-at] [; disable-bookmarks] [; new-source] [; next-col-list] [; next-specif-col-list] [; open-button] [; select-button] [; select-on-change] [; show-repeats-on-select] [; specify-button] [; start-fdk]
Tato vlastnost upravuje některé rysy spojené s propojením zdroje pomocí vlastnosti source. Vlastnost se dále skládá z dílčích pod-vlastností oddělených středníkem, které teprve upravují potřebné chování či jiné rysy spojené s propojováním dokumentů:
-
count-at - omezení výpočtu na nové či existující dokumenty
-
new-source - možnost zákazu tvoření zdroje
-
show-repeats-on-select - možnost zahrnout opak. do výběru
-
next-col-list - rozšiřující seznam sloupců ve výběru
-
next-specif-col-list - rozšiřující seznam sloupců v upřesnění (specifikaci)
-
select-on-change - propojení akce výběru se změnou kolonky
-
start-fdk - mění výběr třetího dokumentu ve zdroji typu
foreign -
disable-bookmarks - umožňuje zakázat použití záložek pro vložení zdroje
-
select-button - možnost skrytí tlačítka "Vybrat"
-
open-button - možnost skrytí tlačítka "Otevřít" / "Nový"
-
specify-button - možnost skrytí tlačítka "Upřesnit"
show-repeats-on-select - nabídka opakovatelných při výběru
Při kliknutí na tlačítko "Vybrat" u segmentu s cizím zdrojem se zobrazí seznam s odpovídajícími zdrojovými dokumenty. V tomto seznamu se nabízí ve sloupečcích hodnoty z políček, která se mají v cílovém dokumentu naplnit. Standardně nejsou mezi tyto sloupečky zahrnuty ty kolonky, které ještě potřebují další upřesnění - čerpají z opakovatelných segmentů zdrojového dokumentu. Důvodem je, aby se seznam vybíraných dokumentů nenásobil počtem jejich opakovatelných segmentů. Někde to však může být žádoucí a právě nastavením vlastnosti na true nebo yes můžeme změnit tento výchozí stav (false/no):
show-repeats-on-select:yes
next-col-list - rozšiřující seznam sloupců ve výběru
Tato vlastnost se rovněž jako předchozí týká seznamu pro výběr cizího dokumentu. Pomocí této vlastnosti můžete rozšířit seznam sloupců vedle standardních zahrnutých ve výběru. Tato vlastnost se může dobře hodit zejm. při výběru prvku, kde jediný sloupeček s hodnotami vybíraného prvku můžeme snadno doplnit o bližší identifikaci zdrojového dokumentu obsahujícího žádaný prvek.
Syntaxe vlastnosti je taková, že se za dvojtečku uvede čárkami oddělený seznam absolutních XPath odkazů na prvky služby zdrojového dokumentu (je lhostejno ze které služby téhož zdrojového dokumentu). Takže zápis může vypadat i takto:
next-col-list:/identifikace/ID,/identifikace/jmeno
next-specif-col-list - rozšiřující seznam sloupců v upřesnění
K tomu, k čemu slouží next-col-list u výběrových uzlů, slouží next-specif-col-list u uzlů specifikačních. Je možností jak rozšířit nabídku upřesnění zdrojového opakování v okně se seznamem zdrojových opakování. Syntaxe je shodná s vlastností next-col-list.
select-button-title - změna bubliny tlačítka výběru
Touto vlastností se nastavuje obsah bublinové nápovědy u tlačítka pro výběr zdrojového dokumentu. Tento text pak nahrazuje automaticky generovanou nápovědu.
specify-button-title - změna bubliny tlačítka upřesnění
Touto vlastností se nastavuje obsah bublinové nápovědy u tlačítka pro upřesnění zdrojového opakování. Tento text pak nahrazuje automaticky generovanou nápovědu.
disable-bookmarks - zakáz použití záložek
Každý výběrový uzel má možnost buď jednotlivého nebo i hromadného (u opakovatelných) vyběru zdrojových dokumentů ze záložek. Zdroj tedy není vybrán z databáze za použití příp. omezení source-filter a starting-specification, předem v záložkách připravených odkazů bez ohledu na to, zda vybraný dokument odpovídá zdrojovému filtru a bez provedení výchozí specifikace. To může působit potíže tam, kde nastavení filtru a úvodní specifikace jsou pro správnost použití klíčové. Proto je za pomoci nastavení klíčového slova disable-bookmarks na hodnotu true lze tuto možnost použití záložek eliminovat. Nastavení disable-bookmarks má výchozí hodnotu false použitou při jeho nedefinování, která použití záložek pro vložení zdroje umožňuje.
select/open/specify-button - skrytí tlačítka
Vlastnosti select-button, open-button a specify-button mohou nabývat hodnot show (výchozí) nebo hide. Každá z vlastností skrývá jedeno z tlačítek výběrového a specifikačního uzlu. Jde o tlačítko "Vybrat", "Nový" resp. "Otevřít" (podle toho, zda je vybrán zdrojový dokument k otevření či zda není a je nabízena možnost vytvořit nový dokument jako zdroj) či "Upřesnit". Standardně jsou tlačítka zobrazována.
Potenciální vlastnické uzly
Vlastnost source-behaviour je možné uvést u následujících uzlů:
Podřízené stránky
count-at - omezení výpočtu na nové či existující dokumenty
Nastavení tohoto chování je účinné pouze u zdrojového mechanizmu count (počítaný prvek). Standardně se výpočty provádějí bez ohledu na to, zda jde o nově tvořený dokument (tj. instanci dokumentu) dosud neuložený v databázi či dokument již z databáze otevřený. Pouze se vždy zohledňuje, zda uživatel vypočtenou hodnotu nepřepsal hodnotou jinou. Nastavení count-at umožňuje omezit výpočty na provádění pouze u nových nebo naopak pouze u existujících. Mechanismus vypnutí výpočtu při přepsání hodnoty uživatelem zůstává zachován. Vlastnost count-at tedy může být nastavena na jednu z následujících tří možností:
new-source - možnost zákazu tvoření zdroje
Někdy je zapotřebí ošetřit, aby zdrojový dokument nebyl tvořen jako nový dokument, ale pouze přebírán z již existujících a nebo případné propojení aby zůstalo nerealizováno. Například ruční párování provize přímo na bankovní výpis by mohlo způsobit vytvoření nového bankovního obratu aniž by tento obrat byl skutečností.
select-on-change - propojení akce výběru se změnou kolonky
Často nastávají případy, kde je jedna kolonka ve výběrovém uzlu natolik určující, že jednoznačně identifikuje požadovanou položku pro výběr (např. kód ceníku, číselné ID apod.). V takových případech bývá pro urychlení zadávání dobré napojit na provedení změny v kolonce automatické provedení výběru. Tj. při zadání hodnoty do určité kolonky se může po odskočení z kolonky (zaznamenání změny) provést výběr automaticky. Není třeba již používat tlačítko vybrat či klávesovou zkratku F12. Akce výběru je již vázána na samotnou změnu této kolonky. Toto propojení zároveň také zajišťuje větší konzistenci obsahu vyplněné kolonky identifikátoru a provedení výběru v oblasti či prvku.
set-remote-select - výběr třetího dokumentu ve zdroji
Přeloženo - nastavení vzdáleného výběru. Každý dokument můžeme definovat tak, že využívá jiného dokumentu prostřednictvím výběrového uzlu. Tento uzel může být typu initial, lexicon či foreign - to už víme z předchozích podkapitol (vlastnost source). Pomocí tohoto propojení můžeme využívat data zdrojových dokumentů a u mechanismu foreign je můžeme i měnit tím, že změníme hodnotu propojeného prvku. To může být účelné pokud například zástupce klienta, který jakožto samostatný dokument má propojení na obecnější dokument osoba, změní telefonní číslo. Pak se toto číslo promítne i do osoby. Pomocí mechanismu foreign jako takového ještě ovšem nemůžeme změnit vyběr třetího dokumentu provedený v dokumentu zdrojovém.
start-fdk - nastavení výhozí hodnoty cizího klíče
Někdy nastávají situace, kdy v databázi jsou určité typy dokumentu velmi stabilní a jejich instance jsou předem známé. V takových případech může být žádoucí, aby bylo u výběrového uzlu cizího dokumentu, ktery je napojen na tento stabilní zdroj, byl přednastaven úvodní výběr a uživatel nebyl zatěžován neustálým výběrem téhož typu dokumentu.