| | Žinynas ir straipsniai „Kaip?“ Susiję produktai ir technologijos Palaikymas ir atsiliepimai Techniniai ištekliai Papildomi ištekliai | Įspėjimas: Jūs mėginate peržiūrėti šį puslapį su nepalaikoma naršyklės versija. Šis puslapis geriausiai veikia su „Microsoft Internet Explorer 6.0“ ar vėlesne versija, „Firefox 1.5“ arba „Netscape Navigator 8.0“ ar vėlesne versija. Sužinokite apie palaikomas naršykles daugiau.
Microsoft Office InfoPath formos šablonų funkcijas galite naudoti daugeliui užduočių, tokių kaip laukų skaičiaus skaičiavimas arba stulpelių sumų skaičiavimas pasikartojančiose lentelėse, atlikti. Funkcijos naudojamos formulėse (formulė: „XPath“ rinkinys, kurį sudaro reikšmės, laukai arba grupės, funkcijos ir operatoriai. Formules galima naudoti matematinėms reikšmėms skaičiuoti, datoms ir laikui rodyti ir laukams nurodyti.), kurias įvedate savo formos šablono valdiklių arba laukų dialogo lange Formulės įterpimas. Šiame straipsnyje
Funkcijų apžvalga
InfoPath funkcija yra išraiška, kuri grąžina reikšmę pagal skaičiavimo rezultatus. Funkcijos naudojamos formulėse, kurias įvedate dialogo lange Formulės įterpimas. Funkcijas sudaro šios trys dalys:
Pavadinimas Funkcijos pavadinimas. Paprastai pavadinimas leidžia suprasti, kokį veiksmą funkcija atliks.
Grąžinama reikšmė Funkcijos rezultatas.
Argumentai Reikšmės, kurių funkcijai reikia skaičiavimui atlikti.
Funkcijai gali reikėti, bet gali ir nereikėti argumentų reikšmei grąžinti. Jei funkcijai argumentų reikia, jūs turite žinoti, kiek argumentų reikia ir koks yra kiekvieno argumento duomenų tipas. Funkcija neveiks, jei pateiksite neteisingą reikiamų argumentų skaičių arba tipą.
Funkcijos argumentas yra XPath išraiška – reikšmių, funkcijų ir operatorių derinys, apskaičiuojantis vieną reikšmę.
Toliau pateiktame pavyzdyje rodomas ryšys tarp funkcijų, išraiškų ir formulių.

Puslapio pradžia
Datos ir laiko funkcijos
| Funkcija |
Aprašas |
Sintaksė |
| addDays |
Grąžina datą, kuri yra antrojo argumento pridėjimo prie pirmojo argumento rezultatas. Grąžinamos reikšmės duomenų tipas priklauso nuo pirmojo argumento duomenų tipo.
- Duomenų tipas Data (data) grąžina duomenų tipą Data (data).
- Duomenų tipas Data ir laikas (dateTime) grąžina duomenų tipą Data ir laikas (dateTime).
|
addDays(argument1, argument2)
argument1 Prie šios datos bus pridėtas antrasis argumentas. Šio argumento duomenų tipas gali būti Data (data) arba Data ir laikas (dateTime).
argument2
Dienų skaičius,kurį norite pridėti prie pirmojo argumento. Šio parametro duomenų tipas turi būti Visas skaičius (sveikasis skaičius).
|
| addSeconds |
Grąžina laiką, kuris yra antrojo argumento pridėjimo prie pirmojo argumento rezultatas. Grąžinamos reikšmės duomenų tipas priklauso nuo pirmojo argumento duomenų tipo.
- Duomenų tipas Laikas (laikas) grąžina duomenų tipą Laikas (laikas).
- Duomenų tipas Data (data) arba Data ir laikas (dateTime) grąžina duomenų tipą Data ir laikas (dateTime).
|
addSeconds(argument1, argument2)
argument1
Prie šio laiko bus pridėtas antrasis argumentas. Šio argumento duomenų tipas gali būti Laikas (laikas), Data (data) arba Data ir laikas (dateTime).
argument2
Sekundžių skaičius, kurį norite pridėti prie pirmojo argumento. Šio parametro lauko duomenų tipas turi būti Visas skaičius (sveikasis skaičius).
|
| now |
Grąžina datos ir laiko duomenų tipą Data ir laikas (dateTime), kai forma atidaroma pirmą kartą. |
now() Ši funkcija nenaudoja argumentų
|
| today |
Grąžina datos duomenų tipą Data (data), kai forma atidaroma pirmą kartą. |
today() Ši funkcija nenaudoja argumentų
|
Puslapio pradžia
Lauko funkcijos
| Funkcija |
Aprašas |
Sintaksė |
|
name |
Grąžina argumente nurodyto lauko pavadinimo išplėstinį pavadinimą. Išplėstiniame pavadinime yra esamos vardų srities prefiksas ir nurodyto lauko arba grupės pavadinimas. Jei argumentas yra laukų arba grupių rinkinys, funkcija grąžina pirmojo formos lauko arba grupės pavadinimą ir prefiksą. Kai vartotojas užpildo naršyklei pritaikytą formos šabloną, šią funkciją naudojanti formulė išsiunčia duomenis į serverį, siekdama gauti šios funkcijos grįžties reikšmę.
|
name(argument) argument Lauko, kurio vardų srities prefiksą ir pavadinimą norite gauti, pavadinimas.
|
|
position |
Grąžina lauko arba grupės indeksą arba padėtį atsižvelgiant į kitus tos pačios grupės laukus ir grupes. Ši funkcija visada grąžina 1, kai yra naudojama formulėje, kurioje yra skaičiavimas, arba taisyklės formulėje. Pastaba Jei kuriate su naršykle suderinamą formos šabloną, šios funkcijos dialogo lango Funkcijų įterpimas sąraše Funkcijos nebus.
|
position() Ši funkcija nenaudoja argumentų
|
| count |
Grąžina formos laukų arba grupių egzempliorių skaičių. |
count(argument) argument Lauko arba grupės, kurią reikia skaičiuoti, pavadinimas.
|
| current |
Grąžina dabartinį grupės lauką arba grupę. Šią funkciją galite naudoti, jei norite peržiūrėti didesnės išraiškos pasikartojančios lentelės arba pasikartojančios sekcijos dabartinę eilutę. Pastaba Šios funkcijos dialogo lange Funkcijos įterpimas nėra. Jei norite naudoti šią funkciją, įveskite ją kaip XPath išraišką dialogo lango Formulės įterpimas lauke Formulė.
|
current() Ši funkcija nenaudoja argumentų
|
| id |
Grąžina laukų arba grupių, kurių lauko ID atribute nurodyta reikšmė, XPath išraišką.
Kai vartotojas užpildo naršyklei pritaikytą formos šabloną, šią funkciją naudojanti formulė išsiunčia duomenis į serverį, siekdama gauti šios funkcijos grįžties reikšmę.
Pastaba Šios funkcijos dialogo lange Funkcijos įterpimas nėra. Jei norite naudoti šią funkciją, įveskite ją kaip XPath išraišką dialogo lango Formulės įterpimas lauke Formulė.
|
id("argument") argument Lauko arba grupės ID atributo reikšmė. Ši reikšmė turi būti apsupta dvigubų kabučių („ “).
|
| last |
Grąžina paskutinio lauko egzemplioriaus reikšmę. Pastaba Jei kuriate su naršykle suderinamą formos šabloną, šios funkcijos dialogo lango Funkcijų įterpimas sąraše Funkcijos nebus.
|
field name[last()] Nors pačioje funkcijoje nėra reikiamų parametrų, ją galite naudoti kaip konkretaus lauko pavadinimo taisyklės sąlygą.
|
| local-name |
Grąžina lauko pavadinimą be vardų srities arba paskutinį XPath išraiškos pavadinimą. Jei parametras yra laukų arba grupių rinkinys, jis grąžina pirmojo lauko arba grupės reikšmę. Kai vartotojas užpildo naršyklei pritaikytą formos šabloną, šią funkciją naudojanti formulė išsiunčia duomenis į serverį, siekdama gauti šios funkcijos grįžties reikšmę.
|
local-name(argument) argument Lauko, kurio vietos pavadinimo atributą norite gauti, pavadinimas.
|
| namespace-uri |
Grąžina visą argumento vardų srities vieningąjį identifikatorių (URI) (Vieningas išteklių identifikatorius (URI): teksto eilutė, naudojama identifikuoti interneto ištekliams pagal tipą ir vietą.). Jei argumentas yra laukų arba grupių rinkinys, funkcija grąžina pirmojo formos lauko arba grupės vardų sritį. Kai vartotojas užpildo naršyklei pritaikytą formos šabloną, šią funkciją naudojanti formulė išsiunčia duomenis į serverį, siekdama gauti šios funkcijos grįžties reikšmę.
|
namespace-uri(argument) argument Lauko, kurio vardų srities vieningąjį identifikatorių (URI) norite gauti, pavadinimas.
|
Puslapio pradžia
Matematinės funkcijos
Pastaba Formulėms, kuriose yra matematinių funkcijų, paprastai reikia argumentų, kurie yra sveikieji skaičiai arba dešimtainės reikšmės. Norėdami įsitikinti, kad argumentai yra sveikieji skaičiai arba dešimtainės reikšmės, o ne neapibrėžtos reikšmės, dialogo lango Formos parinktys (meniu Įrankiai) kategorijoje Išsamiau pažymėkite žymės langelį Tuščias reikšmes laikyti nuliu.
| Funkcija |
Aprašas |
Sintaksė |
|
avg |
Grąžina vidutinę grupės laukų reikšmę. Kiekvienas laukas turi būti skaitinio duomenų tipo ir turi būti įtrauktas į grupę.
|
avg(argument) argument Grupės laukų, kurių vidutinę reikšmę norite gauti, pavadinimai.
|
|
boolean |
Grąžina teisingą, jei argumentas yra teigiamas skaičius, arba klaidingą, jei argumentas yra nulis arba neigiamas skaičius. |
boolean(argument) argument
Išraiška, kurią turi įvertinti funkcija.
|
|
ceiling |
Grąžina mažiausią sveikąjį skaičių, kuris yra lygus arba didesnis už argumento reikšmę. Ne sveikojo skaičiaus reikšmė suapvalinama iki kito didžiausio sveikojo skaičiaus reikšmės.
|
ceiling(argument) argument Lauko, kuriame yra skaitinė reikšmė, pavadinimas.
|
|
eval |
Grąžina nurodytos antrojo argumento išraiškos taikymo pirmajam argumentui rezultatą. |
eval(argument1, argument2 ) argument1 Lauko arba grupės, kurios reikšmę įvertins antrojo argumento išraiška, pavadinimas.
argument2
Dvigubomis kabutėmis („ “) apsupta išraiška, kuri turėtų būti taikoma pirmajam argumentui.
|
|
false |
Grąžina klaidingą Bulio logikos reikšmę.
Naudokite šią funkciją kaip taisyklių sekos, vykdomos tuomet, kai nėra sąlygos, dalį. |
false() Ši funkcija nenaudoja argumentų
|
|
floor |
Grąžina mažiausią sveikąjį skaičių, kuris yra lygus arba mažesnis už argumento reikšmę. Ne sveikojo skaičiaus reikšmė suapvalinama iki kito mažiausio sveikojo skaičiaus reikšmės.
|
floor(argument) argument Lauko, kuriame yra skaitinė reikšmė, pavadinimas.
|
|
min |
Grąžina mažiausią grupės lauko reikšmę.
|
min(argument) argument Grupės, turinčios laukų, kurių mažiausias reikšmes norite rasti, pavadinimas.
|
|
not |
Grąžina teisingą, jei išraiška yra lygi nuliui, mažesnė už nulį, klaidinga arba neapibrėžta; grąžina klaidingą, jei išraiška yra didesnė už nulį, teisinga arba ne neapibrėžta. |
not(argument) argument Išraiška, kurią turi įvertinti funkcija.
|
|
number |
Grąžina argumento išraiškos konvertavimo į skaičių rezultatą. |
number(argument) argument Išraiška, kurią turi įvertinti funkcija.
|
|
nz |
Grąžina nulį, jei argumento reikšmė yra tuščia, arba grąžina argumento reikšmę.
|
nz(argument) argument Lauko, kurį turi įvertinti funkcija, pavadinimas.
|
|
round |
Grąžina skaičių, kurio reikšmė suapvalinta iki sveikojo skaičiaus. Jei nesveikoji reikšmė yra lygiai tarp dviejų suapvalintų sveikųjų reikšmių, grąžinama kita didesnė sveikoji reikšmė.
|
round(argument) argument Išraiška, kurią turi įvertinti funkcija.
|
|
sum |
Grąžina grupės laukų reikšmių sumą. |
sum(argument) argument Grupės laukų, kurių reikšmės bus pridėtos, pavadinimai.
Jei norite pridėti laukų dviejose skirtingose grupėse, naudokite sąjungos operatorių (|), kad atskirtumėte argumentus. Pavyzdžiui, suma ( lauko pavadinimas 1 | lauko pavadinimas 2).
|
|
true |
Grąžina teisingą Bulio logikos reikšmę. Naudokite šią funkciją kaip taisyklių sekos, vykdomos tuomet, kai sąlyga yra, dalį. |
true() Ši funkcija nenaudoja argumentų
|
| max |
Grąžina didžiausią grupės lauko reikšmę. |
max(argument) argument Grupės, turinčios laukų, kurių didžiausias reikšmes norite rasti, pavadinimas.
|
Puslapio pradžia
Tekstinės funkcijos
| Funkcija |
Aprašas |
Sintaksė |
|
contains |
Grąžina teisingą, jei pirmojo argumento reikšmėje yra teksto, nurodyto antrajame argumente, arba grąžina klaidingą, jei antrojo argumento teksto nėra pirmojo argumento reikšmėje. |
contains(argument1, argument2)
argument1 Lauko, kuriame yra ieškotinas tekstas, pavadinimas.
argument2 išraiška, turinti teksto, kurio reikia ieškoti pirmajame argumente.
|
| concat |
Grąžina tekstą, gaunamą kaip argumentų jungimo rezultatas. |
concat(argument1, argument2, ...) argument Dvi ar daugiau išraiškos, turinčios teksto, kurį reikia sujungti į vieną tekstą. Atskirkite išraiškas kableliu.
|
| normalize-space |
Grąžina tekstą, kuriame pašalinti visi priekyje ir pabaigoje esantys bei pasikartojantys tarpai. Kai vartotojas užpildo naršyklei pritaikytą formos šabloną, šią funkciją naudojanti formulė išsiunčia duomenis į serverį, siekdama gauti šios funkcijos grįžties reikšmę.
Pastaba Laukai, kuriuose duomenų tipas Tekstas automatiškai pašalino priekyje ir pabaigoje esančius bei pasikartojančius tarpus iš reikšmės.
|
normalize-space(argument) argument Tekstas, kurio pradžioje ir pabaigoje yra tarpų arba pasikartojančių tarpų, kuriuos norite pašalinti. Tekstą rašykite tarp dvigubų kabučių („ “).
|
| starts-with |
Grąžina teisingą, jei pirmojo argumento tekstas prasideda antrojo argumento tekstu, arba grąžina klaidingą, jei antrojo argumento teksto nėra pirmojo argumento teksto pradžioje.
|
starts-with(argument1, argument2) argument1 Lauko, kuriame yra ieškotinas tekstas, pavadinimas.
argument2 Tekstas, kurio reikia ieškoti pirmajame argumente nurodyto lauko pradžioje. Šis argumentas gali būti dvigubose („ “) kabutėse įrašytas tekstas arba lauko pavadinimas.
|
| string |
Grąžina argumentą kaip tekstą.
|
string(argument) argument Lauko, turinčio reikšmę, kurią reikia konvertuoti į tekstą, pavadinimas.
|
| string-length |
Grąžina argumento reikšmės simbolių skaičių.
|
string-length(argument) argument Lauko, kurio reikšmė yra jūsų norimas skaičiuoti tekstas, pavadinimas.
|
| substring |
Grąžina simbolius nuo nurodytos antrojo argumento vietos iki trečiajame argumente nurodyto skaičiaus. |
substring(argument1, argument2, argument3) argument1
Išraiška, turinti teksto, kurio ieškos funkcija. Funkcija ieško šio teksto ir grąžina visus simbolius, nuo antrajame argumente nurodytos vietos iki trečiajame argumente nurodyto simbolių skaičiaus arba iki teksto pabaigos, kas įvyksta anksčiau.
argument2 Pradinė teksto, kurį reikia nuskaityti iš pirmojo argumento, padėtis.
argument3 Simbolių skaičius, kurį norite nuskaityti, pradedant nuo pradinės padėties, nurodytos antrajame argumente.
|
| substring-after |
Grąžina pirmojo argumento tekstą, kuri yra po teksto, nurodyto antrajame argumente. Antrajame argumente pateiktas tekstas neįtraukiamas į grąžinamą tekstą. |
substring(argument1, argument2) argument1 Išraiška, turinti teksto, kurio ieškos funkcija. Funkcija ieško teksto šiame argumente ir grąžina visus simbolius, kurie yra po antrajame argumente nurodyto teksto.
argument2
Išraiška, kurioje yra teksto. Funkcija ieško šio teksto pirmajame argumente ir grąžina visus simbolius, kurie yra šiame argumente nurodyto teksto.
|
| substring-before |
Grąžina visą pirmojo argumento tekstą, kuris yra iki teksto, nurodyto antrajame argumente. Antrajame argumente pateiktas tekstas neįtraukiamas į grąžinamą tekstą. |
substring-before(argument1, argument2) argument1 Išraiška, turinti teksto, kurio ieškos funkcija. Funkcija ieško teksto šiame argumente ir grąžina visus simbolius, kurie yra iki antrajame argumente nurodyto teksto.
argument2 Išraiška, kurioje yra teksto. Funkcija ieško teksto pirmajame argumente ir grąžina visus simbolius, kurie yra iki šiame argumente nurodyto teksto.
|
| translate |
Grąžina tekstą, kuris yra kiekvieno antrojo argumento simbolio keitimo simboliais iš trečiojo argumento rezultatas. |
translate(argument1, argument2, argument3) argument1 Lauko, turinčio teksto, kurio simboliai bus pakeisti, pavadinimas.
argument2
Išraiška, lygi simboliui, kuris bus pakeistas trečiojo argumento išraiška.
argument3
Išraiška, lygi simboliui, kuris pakeis kiekvieną simbolių egzempliorių antrajame argumente.
|
Puslapio pradžia
Kitos funkcijos
Jei norite, kad ši funkcija būtų rodoma sąraše Funkcijos, dialogo lango Funkcijos įterpimas sąraše Kategorijos spustelėkite Visi.
| Funkcija |
Aprašas |
Sintaksė |
| userName |
Grąžina formą pildančio vartotojo el. pašto pseudonimą. El. pašto pseudonimas gaunamas iš Active Directory katalogų tarnybos. Pastaba Jei vartotojas pildo su naršykle suderinamą formos šabloną, el. pašto pseudonimas gaunamas iš Microsoft Windows SharePoint Services 3.0.
|
userName() Ši funkcija nenaudoja argumentų
|
|