Složení hodnoty služby join-from
join-from skládá hodnotu prvku služby z více operandů. Používá se zejména
v rozhraní, když je třeba do jediné předané hodnoty spojit více hodnot
z content a pevný text.
{absolute-reference-to-document} | ::{absolute-reference-to-source-document} | '{text}' | {number} | true | false [, ...]
Operandy oddělujte čárkami. Platný operand je absolutní odkaz, zdrojový
absolutní odkaz začínající ::/, text uzavřený do apostrofů, číslo nebo true
či false; čárka uvnitř apostrofovaného textu není oddělovačem.
Například:
join-from="/osobni_udaje/zaradit_jako, ' (', /osobni_udaje/osobni_cislo_varch, ')'"
vytvoří hodnotu ve tvaru zařazení (osobní číslo). V prvku služby je /…
přímý odkaz do content vlastnického dokumentu; pouze ::/… se vyhodnocuje
přes služby efektivního zdrojového dokumentu. Po kompletaci je každý odkaz
jednou přeložen na přímou cestu do content. xjoin-from-way je čárkami
oddělený seznam normalizovaných cest a konstant ve stejném pořadí jako
join-from.
join-from je skládací šablona, kdežto take-from je mapovací kotva služby.
Při spojování hodnot proto uveďte oba atributy: take-from určuje základní
mapování a join-from pouze výsledné složení. Replicator existující take-from
nemění; pro zpětně kompatibilní starší zápis bez něj může po úspěšné kompletaci
odvodit první datový odkaz. Generovaná šablona rozhraní i zdrojová šablona
výběrového uzlu následně vloží odkazy jako načtené hodnoty a ostatní operandy
jako pevný text, vždy v pořadí zápisu.
Potenciální vlastnické uzly
join-from lze uvést u uzlu element.