Vzorce vám umožní získat z vytvářených pravidel více informací než pomocí základních předdefinovaných pravidel. Vzorce se používají například pro výpočet aktuálního nebo budoucího data nebo dokonce pro zřetězení textu.
V tomto článku
Přehled
Vzorec je výraz XPath (XML Path Language), který se skládá z hodnot, polí nebo skupin, funkcí a operátorů, které se používají k výpočtu a zobrazení dalších hodnot. Pomocí vzorce můžete vytvořit novou hodnotu pro pole a zobrazit ji v ovládacím prvku, který je s tímto polem svázaný. Vzorce se dají použít takto:
Vypočítat matematickou hodnotu na základě hodnot, které jste zadali při návrhu šablony, nebo na základě hodnot, které uživatel zadá při vyplňování šablony formuláře.
Spusťte pravidlo založené na hodnotě, která se vypočítá pomocí vzorce.
Zobrazí text jen pro čtení, který se vypočítá z jiných ovládacích prvků, nebo zobrazí hodnotu jiného ovládacího prvku.
Funkce je výraz, který vrací hodnotu na základě výsledků výpočtu. Hodnoty použité ve funkcích se nazývají argumenty. Kromě některých funkcí specifických pro InfoPath můžete použít standardní funkce XPath 1.0, které jsou součástí aplikace InfoPath. Funkce se skládají z následujících tří částí:
- Jméno Název funkce obvykle poskytuje nápovědu k akci, kterou funkce provede.
- Vrácená hodnota Výsledek funkce.
- Argumenty Hodnoty, které funkce používá k provedení výpočtu.
Funkce může k vrácení hodnoty vyžadovat argumenty. Pokud funkce vyžaduje argumenty, musíte vědět, kolik argumentů se vyžaduje, a datový typ každého argumentu. Funkce nebude fungovat, pokud zadáte nesprávný počet nebo typ požadovaných argumentů.
Následující obrázek znázorňuje vztah mezi funkcemi, výrazy a vzorci.
Přidání ovládacího prvku počítané hodnoty
Ovládací prvek počítané hodnoty můžete použít k zobrazení textu jen pro čtení, zobrazení hodnoty jiného ovládacího prvku ve formuláři a vytvoření vzorců založených na výrazech XPath. Pokud například vyvíjíte šablonu formuláře pro sledování výdajů, můžete přidat ovládací prvek počítané hodnoty, který zobrazí celkový počet zadaných výdajů.
Poznámka
Ovládací prvek počítané hodnoty pouze zobrazuje data a neukládá je, proto byste ovládací prvek počítané hodnoty měli použít pouze v případě, že nechcete uložit jeho hodnotu nebo na něj odkazovat v jiném vzorci.
Na šabloně formuláře umístěte kurzor na místo, kam chcete vložit ovládací prvek.
Na kartě Domů klikněte ve skupině Ovládací prvky na ovládací prvek počítané hodnoty .
V dialogovém okně Vložit počítanou hodnotu udělejte jednu z těchto věcí:
Chcete-li zadat text nebo výraz XPath přímo do ovládacího prvku počítané hodnoty, zadejte do pole XPath .
Pokud chcete vložit vzorec, klikněte na Upravit vzorec
a potom zadejte požadovaný vzorec do textového pole Vzorec a podle potřeby použijte následující:- Pokud chcete do vzorce vložit pole nebo skupinu, klikněte na Vložit pole nebo skupinu, klikněte na pole nebo skupinu v dialogovém okně Vybrat pole nebo skupinu a potom klikněte na OK.
- Pokud chcete do vzorce vložit funkci, klikněte na Vložit funkci, vyberte funkci v dialogovém okně Vložit funkci a potom klikněte na OK.
Pokud funkce vyžaduje parametry, vyberte funkci v dialogovém okně Vložit funkci , klikněte na OK a potom v textu Vzorce poklikejte na místo, kde je to uvedeno, a před kliknutím na OK vyberte požadovaný parametr. - Pokud chcete do vzorce vložit hodnotu nebo matematický operátor, zadejte hodnotu nebo symbol matematické operace do pole Vzorec .
Matematické operátory zahrnují sčítání (+), odčítání (-), násobení (*) a dělení (/).
Matematické vzorce obvykle závisejí na celočíselné nebo desetinné hodnotě jako argumentech. Pokud se chcete vyhnout prázdným hodnotám ve vzorci, klikněte na kartě Soubor na Možnosti formuláře , vyberte Upřesnit a ujistěte se, že je vybraná možnost Považovat prázdné hodnoty za nula .
Přidání vzorce do ovládacího prvku
I když můžete použít ovládací prvek počítané hodnoty k zobrazení výsledků vzorce, nejste omezeni na použití ovládacího prvku počítaná hodnota. Pomocí vzorce můžete také nastavit výchozí hodnotu jiných ovládacích prvků, například textových polí. Existují dva způsoby, jak nastavit výchozí hodnotu ovládacího prvku. Můžete použít výchozí statickou hodnotu jednoduše zadáním požadované hodnoty do pole Hodnota v dialogovém okně Vlastnosti pole nebo skupiny , nebo můžete použít vzorec k nastavení výchozí hodnoty pole na základě jiných hodnot ve formuláři. Následujícím postupem nastavíte výchozí hodnotu pole založeného na vzorci:
Vyberte ovládací prvek, do kterého chcete přidat vzorec, a potom v části Nástroje řízení klikněte na kartě Vlastnosti ve skupině Vlastnosti na Výchozí hodnota.
Klikněte na Vložit vzorec
vedle pole Hodnota .Do textového pole Vzorec zadejte požadovaný vzorec a podle potřeby použijte následující:
Pokud chcete do vzorce vložit pole nebo skupinu, klikněte na Vložit pole nebo skupinu, klikněte na pole nebo skupinu v dialogovém okně Vybrat pole nebo skupinu a potom klikněte na OK.
Pokud chcete do vzorce vložit funkci, klikněte na Vložit funkci, vyberte funkci v dialogovém okně Vložit funkci a potom klikněte na OK.
Pokud funkce vyžaduje parametry, vyberte funkci v dialogovém okně Vložit funkci , klikněte na OK a potom v textu Vzorce poklikejte na místo, kde je to uvedeno, a před kliknutím na OK vyberte požadovaný parametr.Pokud chcete do vzorce vložit hodnotu nebo matematický operátor, zadejte hodnotu nebo symbol matematické operace do pole Vzorec .
Matematické operátory zahrnují sčítání (+), odčítání (-), násobení (*) a dělení (/).Tip:
Matematické vzorce obvykle závisejí na celočíselné nebo desetinné hodnotě jako argumentech. Pokud se chcete vyhnout prázdným hodnotám ve vzorci, klikněte na kartě Soubor na Možnosti formuláře a pak vyberte Upřesnit. Ujistěte se, že je vybraná možnost Považovat prázdné hodnoty za nula .
Pokud chcete vzorec upravit jako vzorec XPath, zaškrtněte políčko Upravit XPath (pokročilé), které změní vzorec na verzi výrazu XPath vzorce.
Pokud chcete ve vzorci zkontrolovat správnou syntaxi, klikněte na tlačítko Ověřit vzorec . Pokud vzorec obsahuje chyby:
Kliknutím na Zobrazit podrobnosti v dialogovém okně Microsoft InfoPath zobrazíte chyby ve vzorci. Tady je několik návrhů, jak tyto chyby vyřešit:
- Pokud ve vzorci používáte funkci, ověřte, že pro funkci používáte správné argumenty. Některé funkce vyžadují pole nebo skupiny, zatímco jiné funkce vyžadují zadané hodnoty jako argumenty.
- V případě potřeby vzorec odstraňte a znovu zadejte, abyste měli jistotu, že je správně zadaný.
- Klikněte na OK.
- Pokud chcete aktualizovat výchozí hodnotu pole, když se změní hodnoty, na kterých je pole založeno, zaškrtněte políčko Aktualizovat hodnotu při přepočtu vzorce . Pokud to uděláte, klikněte na OK a v části Ovládací nástroje na kartě Vlastnosti ve skupině Vlastnosti klikněte na Vlastnosti ovládacího prvku. Klikněte na kartu Zobrazení a zaškrtněte políčko Jen pro čtení .
Použití vzorce v pravidle
Při zadávání podmínek v pravidlech ověřování, formátování nebo akcí je možné k řízení podmínky použít vzorec. Můžete to udělat tak, že při přiřazování pravidla k ovládacímu prvku nebo šabloně formuláře vyberete použít vzorec z třetího rozevíracího seznamu v dialogovém okně Podmínka .
Funkce data a času
Adddays
Přidá dny k datu nebo datu a času.
Syntaxe
addDays(datum, dny)
| Argument | Popis |
|---|---|
| date | Počet dní v druhém argumentu se přidá k datu v tomto argumentu. Tento argument může být datový typ Datum (datum) nebo Datum a čas (dateTime). |
| dny | Počet dnů, které chcete přičíst k datu v prvním argumentu. Tento parametr musí být datový typ Celé číslo (celé číslo). Pokud v tomto argumentu použijete záporné číslo, bude návratovou hodnotou dřívější datum. |
Příklad
Chcete, aby pole v šabloně formuláře obsahovalo datum 60 dnů od dnešního data. Šablona formuláře obsahuje pole s názvem fldToday a výchozí hodnotou je dnešní datum. Pokud chcete vypočítat nové datum pomocí této funkce, použijte v novém poli s datem následující vzorec:
addDays(fldToday; 60)
addSeconds
Přidá sekundy k času nebo datu a času.
Syntaxe
addSeconds(čas, sekundy)
| Argument | Popis |
|---|---|
| time | Hodnota data a času nebo časová hodnota, která je odkazem na jiné pole v šabloně formuláře nebo výsledkem funkce data nebo času, například now() nebo today(). Počet sekund v druhém argumentu se přičte k času v tomto argumentu. Tento argument může být datový typ Datum (datum) nebo Datum a čas (dateTime). Pokud se jedná o datový typ Čas, vrátí se datový typ Čas. Pokud se jedná o datový typ Datum, vrátí se datový typ Datum a čas. |
| Sekund | Počet sekund, který chcete přidat k hodnotě data a času nebo hodnotě času v prvním argumentu. Pole v tomto parametru musí být datový typ Celé číslo (celé číslo). Pokud v tomto argumentu použijete záporné číslo, je vrácená hodnota dřívější datum a čas nebo dřívější čas. |
Příklad
Šablona formuláře obsahuje pole s názvem fldCurrentTime, které jako výchozí hodnotu používá aktuální čas, a druhé pole, které používá funkci addSeconds ve vzorci k zobrazení času 120 sekund od aktuálního času. Pokud chcete vypočítat novou časovou hodnotu pomocí této funkce, zadejte do druhého pole následující vzorec:
addSeconds(fldCurrentTime; 120)
Nwo
Vrátí aktuální systémové datum a čas.
Pokud chcete vrátit jenom aktuální datum, použijte funkci today.
Syntaxe
now()
Tato funkce nepoužívá argumenty.
Příklad
Pokud chcete zjistit datum a čas vytvoření formuláře založeného na šabloně formuláře, použijte v poli následující vzorec:
now()
dnes
Vrátí aktuální systémové datum. Pro pole kalendářních dat seznamu SharePointu použijte funkci now().
Pokud chcete vrátit datum i čas, použijte funkci now.
Syntaxe
today()
Tato funkce nepoužívá argumenty.
Příklad
Pokud chcete získat datum vytvoření formuláře založeného na šabloně formuláře, použijte v poli následující vzorec:
today()
Funkce polí
count
Spočítá počet instancí pole nebo skupiny.
Syntaxe
count(field)
| Argument | Popis |
|---|---|
| pole | Název opakujícího se pole nebo opakující se skupiny, která se má spočítat ve formuláři. |
Příklad
Navrhujete šablonu formuláře, jejíž formuláře budou dodavatelé používat k hlášení svých produktů a inventáře. Šablona formuláře obsahuje opakující se skupinu s názvem grpProduct pro produkty odeslané dodavatelem. Každá skupina obsahuje informace o produktu a jeho úrovni zásob. Když dodavatel přidá produkt do formuláře, který je založený na této šabloně formuláře, aplikace InfoPath vytvoří novou instanci opakující se skupiny.
Šablona formuláře obsahuje ve zdroji dat pole obsahující počet produktů odeslaných dodavatelem. Pokud chcete automaticky spočítat počet produktů odeslaných dodavatelem, což je počet instancí opakující se skupiny grpProduct, použijte v poli Počet produktů následující vzorec:
count(grpProduct)
Poslední
Vrátí poslední výskyt opakujícího se pole nebo skupiny.
Poznámka
Pokud navrhujete šablonu formuláře kompatibilní s prohlížečem, nezobrazí se tato funkce v seznamu Funkce v dialogovém okně Vložit funkci.
Syntaxe
field_name[last()]
I když samotná funkce nemá žádné požadované parametry, můžete tuto funkci použít jako predikát pro zadaný název pole.
Příklad
Navrhujete šablonu formuláře, kterou dodavatelé vyplní, aby nahlásili své zásoby produktů. Šablona formuláře má datové připojení k webové službě, která má metodu, která kontroluje, zda byly dokončeny informace o produktu pro všechny produkty od dodavatele. Metoda potřebuje poslední produkt v seznamu produktů, který byl odeslán dodavatelem.
Informace o produktu jsou uloženy v různých polích opakující se skupiny s názvem grpProduct. Když dodavatel přidá do formuláře produkt, aplikace InfoPath přidá novou opakující se skupinu s názvem grpProduct. Pokud dodavatel hlásí několik produktů, zdroj dat formuláře bude obsahovat více instancí opakující se skupiny grpProduct.
Abyste měli jistotu, že webové službě odešlete správné informace, přidejte pole, které bude obsahovat informace o posledním produktu ve skupině produktů od dodavatele. Pokud chcete toto pole nakonfigurovat tak, aby automaticky načítalo poslední produkt, použijte jako výchozí hodnotu pro pole posledního produktu následující vzorec:
grpProduct[last()]
local-name
Vrátí místní název pole nebo skupiny.
Poznámka
- Pokud je argumentem opakující se pole nebo opakující se skupina, vrátí funkce hodnotu prvního opakujícího se pole nebo opakující se skupiny.
- Když uživatel vyplní formulář webového prohlížeče, vzorec, který používá tuto funkci, odešle data formuláře na server, aby získal návratovou hodnotu pro tuto funkci.
Syntaxe
local-name(pole)
| Argument | Popis |
|---|---|
| Pole | Název pole, jehož atribut local name chcete vrátit. |
Příklad
Navrhujete šablonu formuláře, která se používá pro povolení aplikací. Šablona formuláře má datové připojení k metodě ve webové službě. Tato metoda vyžaduje hodnotu atributu local-name pole pro číslo licence dodavatele. Název pole číslo licence je fldLicenseNumber.
Máte pole, které bude obsahovat hodnotu atributu local name. Pokud chcete automaticky načíst hodnotu atributu local name pole s číslem licence, použijte následující vzorec jako výchozí hodnotu pole, které bude obsahovat hodnotu atributu local name:
local-name(fldLicenseNumber)
Název
Vrátí název a předponu oboru názvů pole nebo skupiny.
Poznámka
- Pokud je argumentem opakující se pole nebo opakující se skupina, vrátí funkce název a předponu prvního opakujícího se pole nebo opakující se skupiny ve formuláři.
- Když uživatel vyplní formulář založený na šabloně formuláře s podporou prohlížeče, vzorec, který používá tuto funkci, odešle data formuláře na server, aby získal návratovou hodnotu pro tuto funkci.
Syntaxe
name(field)
| Argument | Popis |
|---|---|
| Pole | Název pole, jehož předponu oboru názvů a název chcete vrátit. |
Příklad
Navrhujete šablonu formuláře, která se používá pro povolení aplikací. Šablona formuláře má datové připojení k metodě ve webové službě. Tato metoda vyžaduje atribut name pole pro číslo licence dodavatele. Název pole číslo licence je fldLicenseNumber.
Máte pole, které bude obsahovat hodnotu atributu name. Pokud chcete automaticky načíst hodnotu atributu name, použijte jako výchozí hodnotu pole následující vzorec:
name(fldLicenseNumber)
namespace-uri
Vrátí úplný obor názvů pole nebo skupiny.
Poznámka
- Pokud je argument množinou polí nebo skupin, vrátí funkce obor názvů prvního pole nebo skupiny ve formuláři.
- Když uživatel vyplní formulář webového prohlížeče, vzorec, který používá tuto funkci, odešle data formuláře na server, aby získal návratovou hodnotu pro tuto funkci.
Syntaxe
namespace-uri(field)
| Argument | Popis |
|---|---|
| Pole | Název pole, jehož identifikátor URI oboru názvů chcete načíst. |
Příklad
Navrhujete šablonu formuláře, která se používá pro povolení aplikací. Šablona formuláře odesílá data do webové služby. Ke zpracování dat z formuláře založeného na šabloně formuláře webová služba vyžaduje identifikátor URI oboru názvů z konkrétního pole elementu ve zdroji dat. Pole v šabloně formuláře, které obsahuje data identifikátoru URI oboru názvů, má název fldComplete.
Máte pole, které bude obsahovat identifikátor URI oboru názvů pole elementu. Pokud chcete automaticky načíst identifikátor URI oboru názvů, použijte následující vzorec jako výchozí hodnotu pro pole, které bude obsahovat identifikátor URI oboru názvů:
namespace-uri(fldComplete)
Pozici
Vrátí index (nebo pozici) pole nebo skupiny vzhledem k ostatním polím nebo skupinám ve stejné nadřazené skupině.
Poznámka
Tato funkce není k dispozici v šablonách formulářů webového prohlížeče.
Syntaxe
position()
Příklad
Navrhujete šablonu formuláře, kterou dodavatelé vyplní, aby nahlásili své zásoby produktů. Informace o produktu jsou uloženy v polích v opakující se skupině. Opakující se skupina je vázána na opakující se tabulku, která umožňuje dodavateli přidat nové nebo upravit stávající informace o produktu.
V prvním sloupci opakující se tabulky chcete zobrazit číslo řádku v textovém poli. Pokud chcete automaticky zobrazit číslo řádku, když dodavatel přidá nový produkt do opakující se tabulky, použijte jako výchozí hodnotu textového pole následující vzorec:
position()
Matematické funkce
Vzorce, které obsahují matematické funkce, obvykle vyžadují argumenty, které jsou celá čísla nebo desetinné hodnoty. Chcete-li zajistit, aby argumenty byly celočíselné nebo desetinné hodnoty místo hodnot null, klikněte na tlačítkoUpřesnitmožnosti> formuláře souboru> a ujistěte se, že je zaškrtnuté políčko Považovat prázdné hodnoty za nulové.
Průměrná
Vypočítá průměr číselných hodnot v poli, které je v opakující se skupině.
Poznámka
Opakující se pole musí být číselného datového typu a musí být zahrnuto do skupiny.
Syntaxe
avg(field)
| Argument | Popis |
|---|---|
| Pole | Názvy opakujícího se pole ve skupině, pro kterou chcete vypočítat průměrnou hodnotu. |
Příklad
Navrhujete šablonu formuláře, jejíž formuláře budou dodavatelé používat k hlášení svých produktů a zásob. Šablona formuláře obsahuje opakující se pole s názvem fldPrice, které je v opakující se skupině, která obsahuje data o jednotlivých produktech prodaných dodavatelem. Skupina je vázána na ovládací prvek tabulky s opakováním.
V šabloně formuláře máte pole, které bude obsahovat průměrnou cenu všech produktů prodaných tímto dodavatelem. Pokud chcete vypočítat průměrnou cenu, použijte v poli pro průměrnou cenu následující vzorec:
avg(fldPrice)
Boolean
Vrátí hodnotu true, pokud pole nebo skupina existuje. V opačném případě vrátí hodnotu false.
Tím se vrátí hodnota true i v případě, že byl odstraněn ovládací prvek přidružený k poli, ale pole stále existuje.
Syntaxe
boolean(pole)
| Argument | Popis |
|---|---|
| Pole | Opakující se pole nebo opakující se skupina, které má tato funkce zkontrolovat. |
Příklad
Navrhujete šablonu formuláře, kterou budou dodavatelé používat k hlášení zásob produktů. Informace o produktu jsou uloženy v různých polích v opakující se skupině s názvem grpProduct. Každá opakující se skupina obsahuje pole, která obsahují informace o jednotlivých produktech. Pokud dodavatel poskytne informace o sedmi produktech, bude formulář obsahovat sedm opakujících se skupin.
Opakující se skupina je vázána na ovládací prvek opakující se tabulky, který dodavateli umožňuje přidávat nové nebo revidovat stávající informace o produktu. Dodavatel může přidávat nebo odstraňovat řádky z opakující se tabulky.
Pokud uživatel odebere všechny řádky v opakující se tabulce, chcete dialogové okno zobrazit. Do zdroje dat přidáte pole, které obsahuje slovo "true", pokud má ovládací prvek opakující se tabulky alespoň jeden řádek, a slovo "false", pokud ovládací prvek opakující se tabulka neobsahuje žádné řádky.
V ovládacím prvku tabulka s opakováním nakonfigurujete pravidlo tak, aby se zobrazilo dialogové okno, pokud je hodnota v poli nepravda. Pokud chcete automaticky určit, jestli opakující se tabulka obsahuje alespoň jeden řádek, použijte následující vzorec, protože výchozí hodnota pole obsahuje slovo "true" nebo "false":
boolean(grpProduct)
Strop
Zaokrouhlí číslo nahoru na nejbližší celé číslo.
Syntaxe
strop(číslo)
| Argument | Popis |
|---|---|
| Číslo: | Název pole, které má číselnou hodnotu. |
Příklad
Navrhujete šablonu formuláře vyúčtování výdajů pro vaši společnost. Výdaje se odesílají webové službě, která má parametr, který přijímá pouze celá čísla. Částka výdajů odeslaná do tohoto parametru musí být zaokrouhlená na vyšší celočíselnou hodnotu. Částka výdajů je uložena v poli s názvem fldExpenseAmount a celočíselná hodnota je uložena v jiném poli. Pokud chcete vypočítat vyšší celočíselnou hodnotu, použijte jako výchozí hodnotu pro druhé pole následující vzorec:
strop(fldExpenseAmount)
Pokud uživatel vytvoří formulář založený na šabloně formuláře a do pole fldExpenseAmount zadá hodnotu 145,87, bude hodnota v poli, které obsahuje vzorec, 146.
Eval
Vrátí hodnoty pole nebo skupiny. Druhý argument definuje výraz pro výpočet pole nebo skupiny. Zkušební funkce je obvykle vnořená do funkce, která pracuje s polem nebo skupinou, jako je součet nebo průměr.
Syntaxe
eval(pole, výraz)
| Argument | Popis |
|---|---|
| pole | Název pole nebo skupiny, jejichž hodnoty budou vyhodnoceny výrazem v druhém argumentu. |
| Výraz | Výraz, který se použije u prvního argumentu. Výrazem může být buď funkce XPath, nebo výraz uzavřený do dvojitých uvozovek (" "). |
Příklad
Navrhujete šablonu formuláře vyúčtování výdajů pro vaši společnost. Šablona formuláře obsahuje pole s názvem fldTotal, které obsahuje částku výdajů. Pole fldTotal je součástí opakující se skupiny s názvem grpExpenses. Další pole je vázáno na textové pole, které obsahuje součet všech výdajů. Pokud chcete zobrazit součet všech výdajů, když uživatel zadá částku výdajů, použijte v poli celkové výdaje následující vzorec:
eval(grpExpenses;sum(fldTotal))
false
Vrátí hodnotu false.
Syntaxe
false()
Tato funkce nepoužívá argumenty.
Příklad
Navrhujete šablonu formuláře, jejíž formuláře použijí dodavatelé k žádosti o stavební povolení. Šablona formuláře má dva oddíly: jeden oddíl pro kontaktní informace a druhý oddíl pro informace související se stavebním povolením. Při vyplňování tohoto formuláře budou muset dodavatelé před vyplněním části stavebního povolení kompletně vyplnit sekci kontaktních informací.
Chcete-li toho dosáhnout, vytvoříte pravidlo, které nastaví hodnotu logického pole na hodnotu false, pokud je některé z polí v části kontaktních informací prázdné. Pole s logickou hodnotou může mít buď logickou skutečnou hodnotu, nebo logickou hodnotu false. Podmíněné formátování také nakonfigurujete tak, aby skrýval ovládací prvek oddílu obsahující informace o stavebním povolení, pokud je hodnota pole Logická hodnota false.
Pokud chcete skrýt ovládací prvek oddílu, který obsahuje pole pro informace o stavebním povolení, nakonfigurujte pravidlo tak, aby se tato funkce spustila v poli Logická hodnota, pokud je některé z polí v části kontaktních informací prázdné.
Podlaze
Zaokrouhlí číslo na nejbližší menší celé číslo.
Syntaxe
floor(číslo)
| Argument | Popis |
|---|---|
| Číslo: | Název pole, které má číselnou hodnotu. |
Příklad
Navrhujete šablonu formuláře vyúčtování výdajů pro vaši společnost. Výdaje se odesílají webové službě, která používá parametr, který přijímá pouze celočíselná čísla. Částka výdajů odeslaná do tohoto parametru musí být zaokrouhlená na nižší celočíselnou hodnotu. Částka výdajů je uložena v poli s názvem fldExpenseAmount a celočíselná hodnota je uložena v jiném poli. Pokud chcete vypočítat nižší celočíselnou hodnotu, použijte následující vzorec jako výchozí hodnotu pro druhé pole:
floor(fldExpenseAmount)
Max
Vrátí největší číslo v poli nebo skupině.
Syntaxe
max(pole)
| Argument | Popis |
|---|---|
| pole | Opakující se pole ve skupině nebo pole v opakující se skupině, pro které chcete najít nejvyšší hodnotu. |
Příklad
Navrhujete šablonu formuláře, jejíž formuláře budou dodavatelé používat k hlášení zásob svých produktů. Šablona formuláře obsahuje opakující se skupinu, která obsahuje několik polí obsahujících data o produktech dodavatelů. Pole s názvem fldPrice v opakující se skupině obsahuje cenu produktu.
Další pole ve zdroji dat šablony formuláře bude obsahovat nejvyšší cenu ze všech produktů prodaných tímto dodavatelem. Pokud chcete vrátit nejvyšší cenu, použijte v poli s nejvyšší cenou následující vzorec:
max(fldPrice)
Min
Vrátí nejmenší číslo v poli nebo skupině.
Syntaxe
min(pole)
| Argument | Popis |
|---|---|
| Pole | Opakující se pole ve skupině nebo pole v opakující se skupině, pro které chcete najít nejvyšší hodnotu. |
Příklad
Navrhujete šablonu formuláře, jejíž formuláře budou dodavatelé používat k hlášení zásob svých produktů. Šablona formuláře obsahuje opakující se skupinu, která obsahuje několik polí obsahujících data o dodavatelích produktů. Pole s názvem fldPrice v opakující se skupině obsahuje cenu produktu.
Další pole ve zdroji dat šablony formuláře bude obsahovat nejnižší cenu ze všech produktů prodaných tímto dodavatelem. Pokud chcete vrátit nejnižší cenu, použijte v poli nejnižší cena následující vzorec:
min(fldPrice)
ne
Vrátí hodnotu true, pokud je logická hodnota false nebo null. Vrátí hodnotu false, pokud je logická hodnota true nebo není null.
Syntaxe
not(boolean_value)
| Argument | Popis |
|---|---|
| boolean_value | Pole s logickým datovým typem. |
Příklad
Navrhujete šablonu formuláře, jejíž formuláře použijí dodavatelé k žádosti o stavební povolení. Šablona formuláře obsahuje jeden oddíl pro kontaktní informace a druhý oddíl pro informace související se stavebním povolením. Při vyplňování tohoto formuláře budou muset dodavatelé před vyplněním části stavebního povolení kompletně vyplnit sekci kontaktních informací.
Chcete-li toho dosáhnout, vytvoříte pravidlo, které nastaví hodnotu logického pole na false, pokud některé z polí v části kontaktních informací zůstane prázdné. Pole logické hodnoty může mít buď logickou hodnotu true, nebo logickou hodnotu false. Potom pomocí stejného vzorce skryjete ovládací prvek oddílu, který obsahuje informace o stavebním povolení, pokud je logická hodnota pole false. Pokud chcete toto pravidlo nastavit, použijte následující vzorec k nastavení logického pole na hodnotu false:
not(true())
Číslo:
Převede hodnotu na číslo.
Pokud hodnotu v argumentu nelze převést na číslo, vrátí funkce hodnotu NaN.
Syntaxe
number(value)
Popis argumentu
value Pole s hodnotou, která se má převést na číslo.
Příklad
Navrhujete šablonu formuláře, jejíž formuláře použijí dodavatelé k žádosti o stavební povolení. Šablona formuláře obsahuje oddíl, do kterého může dodavatel zadat svoji obchodní adresu. Pokud chcete ověřit, že dodavatel zadává platnou adresu, použijete datové připojení k webové službě, která může adresu ověřit. Pokud je adresa ověřená, může dodavatel odeslat formulář do databáze SQL. Databáze SQL používá textové pole pro číslo adresy i název ulice. Webová služba vyžaduje, aby číslo adresy bylo číselného datového typu a aby název ulice byl datový typ text.
Pokud chcete odesílat data do webové služby i do databáze SQL, musí být adresa uložená jako dva různé datové typy:
- Chcete-li odeslat adresu webové službě, musí být číslo adresy číselný datový typ a název ulice musí být textový datový typ.
- Pokud chcete odeslat adresu do databáze SQL, musí být číslo adresy i název ulice datový typ text.
Chcete také, aby dodavatel zadal svou adresu pouze jednou. Chcete-li převést adresu na správné datové typy a zajistit, aby dodavatel zadal adresu pouze jednou, obsahuje šablona formuláře pole s názvem fldAddressNumber pro zadání čísla adresy a další pole pro zadání názvu ulice. Obě pole jsou nakonfigurovaná jako textové datové typy.
Pokud chcete odeslat číslo adresy do webové služby, musíte převést data v poli fldAddressNumber (uloženém jako datový typ text) na číselný datový typ. Hodnota čísla adresy převedené na číselný datový typ je uložena v jiném poli, které je nakonfigurováno pro ukládání číselných datových typů.
Pokud chcete převést číslo adresy z textového datového typu na číselný datový typ, použijte následující vzorec jako výchozí hodnotu pole fldAddressNumber:
number(fldAddressNumber)
nz
Vrátí pole nebo skupinu se všemi prázdnými poli nahrazenými nulou (0).
Syntaxe
nz(pole)
| Argument | Popis |
|---|---|
| Pole | Pole, u kterého chcete zkontrolovat hodnotu. |
Příklad
Navrhujete šablonu formuláře, kterou dodavatelé vyplní, aby nahlásili své zásoby produktů. Dodavatel odešle své inventáře produktů do webové služby prostřednictvím formuláře založeného na šabloně formuláře. Metoda webové služby vyžaduje, aby všechny prvky obsahující číselná data měly číselnou hodnotu. Webová služba odmítne formulář, který obsahuje prázdný číselný prvek.
Šablona formuláře obsahuje pole s názvem fldAvailability, které obsahuje číslo odpovídající schopnosti dodavatele poskytnout tento produkt. Dodavatel může do tohoto pole zadat číslo. Pokud chcete zajistit, aby dodavatel mohl odeslat svůj formulář na základě vaší šablony formuláře webové službě a automaticky nastavit hodnotu pole na nulu, pokud dodavatel nezadá číslo, použijte jako výchozí hodnotu pro toto pole následující vzorec:
nz(fldDostupnost)
Kolo
Zaokrouhlí číslo na nejbližší celé číslo.
Pokud je celočíselná hodnota přesně v polovině mezi dvěma zaoblenými celočíselnými hodnotami, je vrácená hodnota další největší celočíselná hodnota.
Syntaxe
round(number)
| Argument | Popis |
|---|---|
| Číslo: | Pole obsahující číslo, které bude pomocí tohoto vzorce zaokrouhleno. |
Příklad
Navrhujete šablonu formuláře, jejíž formuláře budou dodavatelé používat k hlášení zásob svých produktů. Šablona formuláře obsahuje opakující se skupinu, která obsahuje několik polí obsahujících data o produktech dodavatelů. Jedno z polí s názvem fldPrice v opakující se skupině obsahuje cenu produktu.
Šablona formuláře má datové připojení k webové službě. Metoda webové služby vyžaduje zaokrouhlit každou cenu na celočíselnou hodnotu. Chcete-li odeslat odpovídající hodnotu metodě webové služby, přidejte do zdroje dat opakující se pole. Toto pole používá následující vzorec k zaokrouhlení ceny v poli fldPrice na celočíselnou hodnotu:
round(fldPrice)
Součet
Vrátí součet všech polí v poli nebo skupině. Každé pole se nejprve převede na číselnou hodnotu.
Syntaxe
sum(pole)
| Argument | Popis |
|---|---|
| Pole | Název pole v opakující se skupině nebo opakujícího se pole ve skupině, jehož hodnoty budou přidány. Pokud chcete přidat pole ze dvou různých skupin, oddělte argumenty pomocí operátoru sjednocení (|). Příklad: sum( název pole 1 | název pole 2). |
Příklad
Navrhujete šablonu formuláře vyúčtování výdajů. Šablona formuláře obsahuje skupinu, která obsahuje výdajové položky. Množství každé položky je uloženo v poli s názvem fldExpenseAmount. Skupina je vázána na opakující se tabulku, která zobrazuje každou výdajovou položku jako řádek. Šablona formuláře obsahuje ovládací prvek textového pole, který zobrazuje celkové výdaje. Pokud chcete zobrazit celkové výdaje, ovládací prvek textového pole obsahuje následující vzorec:
sum(fldExpenseAmount)
true
Vrátí hodnotu true.
Syntaxe
true()
Tato funkce nepoužívá argumenty.
Příklad
Navrhujete šablonu formuláře, jejíž formuláře použijí dodavatelé k žádosti o stavební povolení. Šablona formuláře obsahuje jeden oddíl pro kontaktní informace a druhý oddíl pro informace týkající se stavebního povolení. Při vyplňování tohoto formuláře budou muset dodavatelé před vyplněním části stavebního povolení kompletně vyplnit sekci kontaktních informací.
Za tímto účelem vytvoříte pravidlo, které nastaví hodnotu logického pole na true, pokud všechna pole v části kontaktních informací obsahují data. Pole s logickou hodnotou může mít logickou hodnotu true nebo false. Pokud je hodnota logického pole true, zobrazí se ovládací prvek oddílu, který obsahuje informace o stavebním povolení.
Pokud chcete zobrazit ovládací prvek oddílu, který obsahuje informace o stavebním povolení, nakonfigurujte pravidlo tak, aby se tato funkce spustila v poli Logická hodnota, pokud všechna pole v části kontaktních informací obsahují data.
Textové funkce
Concat
Kombinuje dvě nebo více polí textových řetězců do jednoho textového řetězce.
Syntaxe
concat(text1; text2; ...)
| Argument | Popis |
|---|---|
| text 1 | Pole obsahující text, který se má zkombinovat do jednoho řádku textu s textem v argumentu 2. |
| text2, ... | Ore nebo více dalších polí obsahujících text, který se má zkombinovat s předchozím polem. Textová pole oddělte čárkou. |
Příklad
Navrhujete šablonu formuláře, která obsahuje pole s názvem fldFirstName a pole s názvem fldLastName. Do třetího pole přidejte následující vzorec, který způsobí, že bude obsahovat text "Tento formulář byl vyplněn křestním příjmením<><>":
concat("Tento formulář byl vyplněn uživatelem ", fldFirstName; " ", fldLastName, ".")
Poznámka
Veškerý skutečný text zadaný jako textový argument, včetně mezer nebo interpunkce, musí být vložen do uvozovek (").
Obsahuje
Vrátí hodnotu true, pokud první pole nebo textový řetězec obsahuje druhé. V opačném případě vrátí hodnotu false.
Syntaxe
contains(within_text, find_text)
| Argument | Popis |
|---|---|
| Kde: | Pole obsahující text, který se má prohledávat. |
| Co: | Pole, které obsahuje text nebo text uzavřený v uvozovkách (" ") pro vyhledání v prvním argumentu. |
Příklad
Navrhujete šablonu formuláře se třemi textovými poli. První z nich umožní uživateli zadat dlouhé množství textu do prvního textového ovládacího prvku s názvem fldText. Druhá umožní uživateli zadat krátký segment textu s názvem fldFindText. Třetí textové pole porovná druhé textové pole s prvním a určí, jestli se hodnota v druhém poli nachází v prvním poli, a zobrazí výsledek. Jako výchozí hodnota by měl být následující vzorec:
contains(fldText;fldFindText)
normalize-space
Odebere prázdné znaky z textového řetězce.
Poznámka
Tím odeberete všechny úvodní, koncové a opakující se prázdné mezery z pole s datovým typem text.
Syntaxe
normalize-space(text)
| Argument | Popis |
|---|---|
| text | Text obsahující úvodní, koncové nebo opakující se prázdné mezery, které chcete odebrat. Uzavřete text do dvojitých uvozovek (" "). |
Příklad
Návrh šablony formuláře, která obsahuje pole s názvem fldText (které je vázáno na ovládací prvek textové pole). Pokud chcete normalizovat text zadaný v prvním poli a zobrazit hodnotu v prvním poli bez nadbytečných prázdných znaků, přidejte druhé pole s následujícím vzorcem jako výchozí hodnotou:
normalize-space(fldText)
začíná na
Vrátí hodnotu true, pokud první pole nebo textový řetězec začíná druhým. V opačném případě vrátí hodnotu false.
Syntaxe
starts-with(text, start_text)
| Argument | Popis |
|---|---|
| text | Název pole, které obsahuje hledaný text. Oddělte argumenty čárkou. |
| start_text | Text, který se má hledat na začátku pole zadaného v prvním argumentu. Tímto argumentem může být pole nebo text, který je uzavřen do dvojitých uvozovek (" "). |
Příklad
Navrhujete šablonu formuláře se třemi textovými poli. První z nich umožní uživateli zadat dlouhé množství textu do prvního textového ovládacího prvku s názvem fldText. Druhá umožní uživateli zadat krátký segment textu s názvem fldFindText. Třetí textové pole porovná druhé textové pole s prvním a indikuje, jestli hodnota v prvním poli začíná hodnotou ve druhém poli, a zobrazí výsledek. Jako výchozí hodnota by měl být následující vzorec:
starts-with(fldText, fldFindText)
Řetězec
Převede hodnotu na textový řetězec.
Syntaxe
string(value)
| Argument | Popis |
|---|---|
| hodnota | Pole obsahující hodnotu, která se má převést na text. |
Příklad
Navrhujete šablonu formuláře, jejíž formuláře použijí dodavatelé k žádosti o stavební povolení. Šablona formuláře obsahuje oddíl, do kterého může dodavatel zadat svoji obchodní adresu. Aby bylo možné ověřit, že dodavatel zadává platnou adresu, má šablona formuláře datové připojení k webové službě, která může adresu ověřit. Pokud je adresa ověřená, může dodavatel odeslat formulář do databáze SQL. Databáze SQL používá textové pole pro adresu ulice. Webová služba vyžaduje, aby číslo adresy bylo číselného datového typu a aby název ulice byl datový typ text.
Pokud chcete odesílat data do webové služby i databáze SQL, musí být adresa uložená ve dvou různých datových typech:
- Chcete-li odeslat adresu webové službě, musí být číslo adresy číselný datový typ.
- Pokud chcete odeslat adresu do databáze SQL, musí být číslo adresy i název ulice datový typ text.
Chcete také, aby dodavatel zadal svou adresu pouze jednou. Chcete-li převést adresu na správné datové typy a zajistit, aby dodavatel zadal adresu pouze jednou, obsahuje formulář pole pro zadání čísla adresy s názvem fldAddressNumber a další pole pro zadání názvu ulice. Pole fldAddressNumber je číselný datový typ a pole s názvem ulice je textový datový typ.
Pokud chcete odeslat úplnou adresu (číslo adresy i název ulice) do databáze SQL, musíte zkombinovat hodnoty v poli fldAddressNumber a poli název ulice do jedné hodnoty, která je textovým datovým typem. Nejprve je potřeba převést číselná data v poli fldAddressNumber, které ukládá data jako číselný datový typ, na datový typ text. Do zdroje dat přidáte pole, které bude obsahovat úplnou adresu jako datový typ text.
Chcete-li převést textová data v poli fldAddressNumber na textový datový typ, abyste mohli použít webovou službu, nakonfigurujte jiné pole, které bude obsahovat číslo adresy jako textový datový typ. Chcete-li převést číslo adresy z číselného datového typu na datový typ text, použijte jako výchozí hodnotu pro toto pole následující vzorec:
string(fldAddressNumber)
délka řetězce
Vrátí počet znaků v textovém řetězci.
Syntaxe
string-length(text)
| Argument | Popis |
|---|---|
| text | Pole, jehož hodnotou je text, který chcete spočítat. |
Příklad
Navrhujete šablonu formuláře, která obsahuje pole s názvem fldText, které je vázáno na ovládací prvek textové pole. Šablona formuláře obsahuje druhé pole, které slouží k počítání počtu znaků zadaných do prvního formuláře. K tomu by druhé pole obsahovalo jako výchozí hodnotu následující vzorec:
string-length(fldText)
Podřetězec
Vrátí určitou část textového řetězce. Druhý argument určuje počáteční pozici a třetí argument určuje, kolik znaků se má zahrnout.
Syntaxe
substring(text, start_position, char_count)
| Argument | Popis |
|---|---|
| text | Pole s textovým datovým typem nebo textem, které jsou uzavřeny v dvojitých uvozovkách (" "). Funkce prohledá tento text a vrátí všechny znaky z pozice zadané v druhém argumentu až do počtu znaků zadaných ve třetím argumentu nebo na konec textu podle toho, co nastane dříve. |
| start_position | Počáteční pozice textu, který se má načíst z prvního argumentu. Tento argument musí být celé číslo nebo odkaz na pole nakonfigurované tak, aby ukládaly datové typy celých čísel (celé číslo). |
| char_count | Počet znaků, které chcete načíst, počínaje počáteční pozicí zadanou v druhém argumentu. Tento argument musí být celé číslo nebo odkaz na pole nakonfigurované tak, aby ukládaly datové typy celých čísel (celé číslo). |
Příklad
Navrhujete šablonu formuláře, která obsahuje následující pole a ovládací prvky:
- Pole s názvem fldText, které je vázáno na ovládací prvek textové pole. Toto pole obsahuje text, který funkce hledá.
- Pole s názvem fldStartingPosition, které je vázáno na ovládací prvek textové pole. Toto pole je nakonfigurované jako datový typ celého čísla. Pole obsahuje počáteční pozici funkce.
- Pole s názvem fldNumberOfCharacters, které je vázáno na ovládací prvek textové pole. Toto pole je nakonfigurované jako datový typ celého čísla. Pole obsahuje počet znaků, které funkce vrátí.
- Ovládací prvek textového pole, který zobrazuje výsledky funkce. Ovládací prvek textového pole obsahuje následující vzorec:
substring(fldText, fldStartingPosition, fldNumberOfCharacters)
Pokud uživatel zadá "Tento formulář byl vytvořen ze šablony formuláře aplikace InfoPath". v prvním textovém poli, následované 4 ve druhém a 16 ve třetím, pak by čtvrté textové pole obsahovalo "s form was creat".
podřetěžce po
Vrátí text v prvním textovém řetězci, který následuje po prvním výskytu druhého textového řetězce.
Syntaxe
substring-after(text, find_text)
| Argument | Popis |
|---|---|
| text | Pole s textovým datovým typem nebo textem, které jsou uzavřeny v dvojitých uvozovkách (" "). Funkce prohledá text v tomto argumentu a vrátí všechny znaky, které následují za textem v druhém argumentu. |
| Co: | Text, který se má hledat v textu prvního argumentu. Text může být buď hodnota v poli s datovým typem text, nebo text, který je uzavřen v dvojitých uvozovkách (" "). Funkce vyhledá text v prvním argumentu pro tento text a potom vrátí všechny znaky, které následují za textem v tomto argumentu. |
Příklad
Navrhujete šablonu formuláře, která obsahuje následující pole a ovládací prvky:
- Pole s názvem fldText, které je vázáno na ovládací prvek textové pole. Toto pole obsahuje text, který funkce hledá.
- Pole s názvem fldSubstringText, které je vázáno na ovládací prvek textové pole. Toto pole obsahuje text, který je druhým argumentem funkce.
- Ovládací prvek textového pole, který zobrazuje výsledky funkce. Ovládací prvek textového pole obsahuje následující vzorec:
substring-after(fldText, fldSubstringText)
Pokud uživatel zadá "Tento formulář byl vytvořen ze šablony formuláře aplikace InfoPath". v poli fldText a "InfoPath" ve druhém, pak třetí ovládací prvek textového pole bude obsahovat "šablona formuláře".
podřetěžce před
Vrátí text v prvním textovém řetězci, který předchází prvnímu výskytu druhého textového řetězce.
Syntaxe
substring-before(text, find_text)
| Argument | Popis |
|---|---|
| text | Pole s textovým datovým typem nebo textem, které jsou uzavřeny v dvojitých uvozovkách (" "). Funkce vyhledá text v tomto argumentu a vrátí všechny znaky před textem druhého argumentu find_text. |
| Co: | Hodnota, která se má hledat v textovém argumentu. Tato hodnota může být buď hodnota v poli s textovým datovým typem, nebo text, který je uzavřen v dvojitých uvozovkách (" "). Funkce vyhledá text v prvním argumentu (textu) pro tento text a pak vrátí všechny znaky před textem v tomto argumentu. |
Příklad
Navrhujete šablonu formuláře s následujícími poli a ovládacími prvky:
- Pole s názvem fldText, které je vázáno na ovládací prvek textové pole. Toto pole obsahuje text, který funkce hledá.
- Pole s názvem fldSubstringText, které je vázáno na ovládací prvek textové pole. Toto pole obsahuje text, který je druhým argumentem funkce.
- Ovládací prvek textového pole Aa, který zobrazuje výsledky funkce. Ovládací prvek textového pole obsahuje následující vzorec:
substring-before(fldText, fldSubstringText)
Pokud uživatel zadá "Tento formulář byl vytvořen ze šablony formuláře aplikace InfoPath". v poli fldText a "created" ve druhém, pak třetí ovládací prvek textového pole bude obsahovat "Tento formulář byl".
přeložit
Vrátí první textový řetězec s každým znakem v druhém textovém řetězci nahrazeným znakem na odpovídající pozici ve třetím textovém řetězci.
Syntaxe
translate(text, find_chars, replace_chars)
| Argument | Popis |
|---|---|
| text | Název pole obsahujícího text, jehož znaky budou nahrazeny. Oddělte argumenty čárkou. |
| find_chars | Znak nebo hodnota pole s textovým datovým typem, které budou nahrazeny znaky ve třetím argumentu. Oddělte argumenty čárkou. |
| replace_chars | Znak nebo hodnota pole s datovým typem text, který nahradí všechny výskyty znaku v druhém argumentu. |
Příklad
Navrhujete šablonu formuláře, jejíž formuláře použijí dodavatelé k žádosti o stavební povolení. Šablona formuláře obsahuje oddíl, do kterého může dodavatel zadat svoji obchodní adresu. Oddíl obsahuje pole s názvem fldStreetAddress, které je vázané na ovládací prvek textového pole, do kterého může dodavatel zadat svoji adresu.
Chcete-li ověřit, že dodavatel zadává platnou adresu, máte datové připojení k webové službě, která může ověřit adresu. Webová služba vyžaduje v adrese malá písmena.
Chcete-li převést všechna velká písmena v adrese ulice na malá, přidejte do zdroje dat další pole, které bude obsahovat adresu, která je převedena na malá písmena. Výchozí hodnota tohoto pole obsahuje následující vzorec:
translate(fldStreetAddress, ABCDEFGHIJKLMNOPQRSTUVWXYZ, abcdefghijklmnopqrstuvwxyz)
Funkce adresy URL
SharePointListUrl
Vrátí adresu sharepointového seznamu nebo knihovny formulářů, kde je formulář hostovaný (pouze InfoPath 2010).
Syntaxe
SharePointListUrl()
Tato funkce nepoužívá argumenty.
Příklad
Navrhujete šablonu formuláře pro sharepointový seznam a chcete přidat odkaz na umístění, kde je seznam hostovaný, například "http://sharepointserver/site/list/". Chcete-li to provést, přidejte ovládací prvek hypertextového odkazu, nastavte ho na jen pro čtení a pak následujícím způsobem nastavte výchozí hodnotu pole, na které je ovládací prvek propojen:
SharePointListUrl()
Poznámka
Pokud šablona formuláře není hostovaná na sharepointovém serveru, vrátí funkce SharePointListUrl() pouze "http://sharepointserver/site/list/".
SharePointServerRootUrl
Vrátí adresu sharepointového serveru, na kterém je formulář hostovaný (pouze InfoPath 2010).
Syntaxe
SharePointServerRootUrl()
Tato funkce nepoužívá argumenty.
Příklad
Navrhujete šablonu formuláře pro sharepointový seznam a chcete přidat odkaz na kořen sharepointového serveru, kde je seznam hostovaný, například "http://sharepointserver/site/list/". Chcete-li to provést, přidejte ovládací prvek hypertextového odkazu, nastavte ho na jen pro čtení a pak následujícím způsobem nastavte výchozí hodnotu pole, na které je ovládací prvek propojen:
SharePointServerRootUrl()
Poznámka
Pokud šablona formuláře není hostovaná na sharepointovém serveru, vrátí funkce SharePointListUrl() pouze "http://sharepointserver/site/list/".
SharePointCollectionUrl
Vrátí adresu sharepointové kolekce webů, ve které je formulář hostovaný (jenom InfoPath 2010).
Syntaxe
SharePointCollectionUrl()
Tato funkce nepoužívá argumenty.
Příklad
Navrhujete šablonu formuláře pro sharepointový seznam a chcete přidat odkaz na kolekci webů sharepointového serveru, kde je seznam hostovaný, například "http://sharepointserver/sitecollection/". Chcete-li to provést, přidejte ovládací prvek hypertextového odkazu, nastavte ho na jen pro čtení a pak následujícím způsobem nastavte výchozí hodnotu pole, na které je ovládací prvek propojen:
SharePointCollectionUrl()
Poznámka
Pokud šablona formuláře není hostovaná na sharepointovém serveru, vrátí funkce SharePointListUrl() pouze "http://sharepointserver/sitecollection/".
SharePointSiteUrl
Vrátí adresu sharepointového webu, na kterém je formulář hostovaný (pouze InfoPath 2010).
Syntaxe
SharePointSiteUrl()
Tato funkce nepoužívá argumenty.
Příklad
Navrhujete šablonu formuláře pro sharepointový seznam a chcete přidat odkaz na sharepointový web, na kterém je seznam hostovaný, například "http://sharepointserver/site/". Chcete-li to provést, přidejte ovládací prvek hypertextového odkazu, nastavte ho na jen pro čtení a pak následujícím způsobem nastavte výchozí hodnotu pole, na které je ovládací prvek propojen:
SharePointSiteUrl()
Poznámka
Pokud šablona formuláře není hostovaná na sharepointovém serveru, vrátí funkce SharePointListUrl() pouze "http://sharepointserver/site/".
Funkce userName
Username
Vrátí uživatelské jméno osoby vyplňující formulář (Microsoft InfoPath 2007 a novější).
Poznámka
Pokud uživatel vyplňuje formulář ve webovém prohlížeči, uživatelské jméno se načte z Microsoft Windows SharePoint Services 3.0 nebo novější.
Syntaxe
userName()
Tato funkce nepoužívá argumenty.
Příklad
Navrhujete šablonu formuláře vyúčtování výdajů pro vaši společnost. Společnost, která používá platební karty, odesílá záznamy o výdajích zaměstnanců elektronicky do databáze, kterou vaše společnost udržuje. K načtení záznamů o výdajích zaměstnance potřebuje databáze uživatelské jméno zaměstnance, který vyplňuje formulář založený na šabloně formuláře.
Do zdroje dat šablony formuláře přidáte pole pro uložení uživatelského jména zaměstnance. Vytvoříte také datové připojení dotazu, které k načtení výdajů použije hodnotu tohoto pole v dotazu.
Abyste měli jistotu, že zaměstnanec vyplňující vyúčtování výdajů používá správné uživatelské jméno, vytvořte vazbu pole na ovládací prvek textového pole. Pokud chcete zobrazit uživatelské jméno uživatele, který vytváří formulář založený na této šabloně formuláře, použijte následující vzorec jako výchozí hodnotu pole vázaného na ovládací prvek textového pole:
userName()