Képletek és függvények hozzáadása az InfoPath 2010-ben

Hatókör
InfoPath 2010

Fontos

A Microsoft InfoPath 2013 támogatása 2026. július 14-én megszűnt. Azt javasoljuk, hogy telepítse át a meglévő InfoPath-űrlapokat és -munkafolyamatokat a támogatott Microsoft 365 megoldásokba. További információ az InfoPath kivonásáról.

A képletek az alapvető, előre definiált szabályoknál többet hoznak ki a szabályokból. A képletekkel például kiszámíthatja az aktuális vagy jövőbeli dátumokat, vagy akár összefűzheti a szöveget.

A témakör tartalma

Áttekintés

Dátum- és időfüggvények

Mezőfüggvények

Matematikai függvények

Szövegfüggvények

URL-függvények

A userName függvény

Áttekintés

A képlet egy XPath- (XML Path Language) kifejezés, amely értékekből, mezőkből vagy csoportokból, függvényekből és egyéb értékek kiszámítására és megjelenítésére használható. Képletek használatával létrehozhat egy új értéket egy mezőhöz, és megjelenítheti ezt az értéket egy, az adott mezőhöz kötött vezérlőben. A képletek az alábbiak szerint használhatók:

Matematikai értékeket számíthat ki a sablon tervezésekor megadott vagy a felhasználó által az űrlap kitöltésekor megadott értékek alapján.

Szabály futtatása képlet segítségével számított érték alapján.

Más vezérlőkből számított írásvédett szöveg megjelenítése vagy egy másik vezérlő értékének megjelenítése

A függvény olyan kifejezés, amely egy számítás eredménye alapján ad vissza egy értéket. A függvényekben használt értékeket argumentumoknak nevezzük. Az InfoPath-specifikus függvények mellett használhatja az InfoPath szokásos XPath 1.0 formátumú függvényeit is. A függvények az alábbi három részből állnak:

  • Name (Név) A függvény neve általában utal arra, hogy a függvény milyen műveletet fog végrehajtani.
  • Visszatérési érték A függvény eredménye.
  • Argumentumok A függvény által a számítás végrehajtásához használt értékek.

A függvények egy érték visszaadásához szükség lehet argumentumokra. Ha a függvényhez argumentumok szükségesek, ismernie kell a szükséges argumentumok számát, valamint az egyes argumentumok adattípusát. A függvény nem fog működni, ha helytelen számú vagy típusú kötelező argumentumot ad meg.

A következő ábra a függvények, kifejezések és képletek közötti kapcsolatot mutatja be.

046C2CB3-2A43-40C6-AF65-5F7EE9C0E1A4

Számított érték vezérlőelem hozzáadása

Számított érték vezérlőelemmel írásvédett szöveget jeleníthet meg, megjelenítheti az űrlap egy másik vezérlőelemének értékét, és XPath-kifejezéseken alapuló képleteket hozhat létre. Ha például egy kiadásokat nyilvántartó űrlapsablont fejleszt, hozzáadhat egy számított érték vezérlőelemet, amely megjeleníti a megadott kiadások összegét.

Megjegyzés

A Számított Érték vezérlőelem csak adatokat jelenít meg, amiket nem tárol, így a Számított Érték vezérlőelemet csak akkor érdemes használni, ha nem szeretné menteni az értéket, vagy másik képletben hivatkozni rá.

  1. Az űrlapsablonon helyezze a kurzort arra a helyre, ahová be szeretné szúrni a vezérlőt.

  2. A Kezdőlap lap Vezérlők csoportjában kattintson a számított érték vezérlőelemre.

  3. A Számított érték beszúrása párbeszédpanelen tegye az alábbiak valamelyikét:

    • Ha szöveget vagy XPath-kifejezést szeretne közvetlenül beírni a számított érték vezérlőelembe, írja be a szöveget az XPath mezőbe.

    • Képlet beszúrásához kattintson a Képlet szerkesztése6aeee2be-ff9c-4a64-a987-2db942c81046 elemre, majd írja be a kívánt képletet a Képlet szövegmezőbe az alábbiakat igény szerint:

      • Ha mezőt vagy csoportot szeretne beszúrni a képletbe, kattintson a Mező vagy csoport beszúrása lehetőségre, a Mező vagy csoport kijelölése párbeszédpanelen kattintson a mezőre vagy csoportra, és kattintson az OK gombra.
      • Ha függvényt szeretne beszúrni a képletbe, kattintson a Függvény beszúrása gombra, jelölje ki a függvényt a Függvény beszúrása párbeszédpanelen, és kattintson az OK gombra.
        Ha a függvényhez paraméterekre van szükség, jelölje ki a függvényt a Függvény beszúrása párbeszédpanelen, kattintson az OK gombra, majd a Képlet szövegében kattintson duplán a jel helyére, és jelölje ki a kívánt paramétert, mielőtt az OK gombra kattintana.
      • Értéket vagy matematikai operátort úgy szúrhat be a képletbe, hogy beírja a matematikai művelet értékét vagy szimbólumát a Képlet mezőbe.
        A matematikai operátorok közé tartozik az összeadás (+), a kivonás (-), a szorzás (*) és az osztás (/).
        A matematikai képletek argumentumai általában egész számokra vagy tizedes értékekre támaszkodnak. Ha el szeretné kerülni a képletben előforduló üres értékeket, kattintson a Fájl lap Űrlapbeállítások gombjára, majd válassza a Speciális lehetőséget, és győződjön meg arról, hogy az Üres értékek kezelése nullaként jelölőnégyzet be van jelölve.

Képlet hozzáadása vezérlőelemhez

Számított érték vezérlőelemekkel megjeleníthetők ugyan a képletek eredményei, de nem korlátozódnak a számított érték vezérlők használatára. Képlet használatával megadhatja más vezérlőelemek, például szövegmezők alapértelmezett értékét is. Kétféleképpen állíthatja be egy vezérlő alapértelmezett értékét. Használhat statikus alapértelmezett értéket úgy, hogy egyszerűen beírja a kívánt értéket a Mező vagy csoport tulajdonságai párbeszédpanel Érték mezőjébe, vagy képlettel beállíthatja egy mező alapértelmezett értékét az űrlap egyéb értékei alapján. A mező képleten alapuló alapértelmezett értékének beállításához tegye a következőket:

  1. Jelölje ki azt a vezérlőelemet, amelyhez hozzá szeretné adni a képletet, majd a Vezérlőeszközök, Tulajdonságok lap Tulajdonságok csoportjában kattintson az Alapértelmezett érték elemre.

  2. Kattintson az Érték mező melletti Képlet beszúrásagombra: 6aeee2be-ff9c-4a64-a987-2db942c81046.

  3. Írja be a kívánt képletet a Képlet szövegmezőbe, igény szerint az alábbiakat felhasználva:

    • Ha mezőt vagy csoportot szeretne beszúrni a képletbe, kattintson a Mező vagy csoport beszúrása lehetőségre, a Mező vagy csoport kijelölése párbeszédpanelen kattintson a mezőre vagy csoportra, és kattintson az OK gombra.

    • Ha függvényt szeretne beszúrni a képletbe, kattintson a Függvény beszúrása gombra, jelölje ki a függvényt a Függvény beszúrása párbeszédpanelen, és kattintson az OK gombra.
      Ha a függvényhez paraméterekre van szükség, jelölje ki a függvényt a Függvény beszúrása párbeszédpanelen, kattintson az OK gombra, majd a Képlet szövegében kattintson duplán a jel helyére, és jelölje ki a kívánt paramétert, mielőtt az OK gombra kattintana.

    • Értéket vagy matematikai operátort úgy szúrhat be a képletbe, hogy a matematikai művelet értékét vagy szimbólumát beírja a Képlet mezőbe.
      A matematikai operátorok közé tartozik az összeadás (+), a kivonás (-), a szorzás (*) és az osztás (/).

      Tipp:

      A matematikai képletek argumentumai általában egész számokra vagy tizedes értékekre támaszkodnak. Ha el szeretné kerülni, hogy a képletben üres értékek jelenjenek meg, a Fájl lapon kattintson az Űrlapbeállítások elemre, majd válassza a Speciális lehetőséget. Győződjön meg arról, hogy az Üres értékek kezelése nullaként jelölőnégyzet be van jelölve.

  4. Ha a képletet XPath-képletként szeretné szerkeszteni, jelölje be az "XPath szerkesztése (haladó)" jelölőnégyzetet, ezzel módosítva a képletet a képlet XPath-kifejezést tartalmazó verziójára.

  5. A képlet helyes szintaxisának ellenőrzéséhez kattintson a Képlet ellenőrzése gombra. Ha a képlet hibákat tartalmaz:

A képlet hibáinak megtekintéséhez kattintson a Microsoft InfoPath párbeszédpanel Részletek megjelenítése gombjára. Az alábbiakban néhány javaslatot talál a hibák megoldására:

  • Ha függvényt használ a képletben, ellenőrizze, hogy a megfelelő argumentumokat használja-e. Egyes funkciókhoz mezőkre vagy csoportokra van szükség, míg más funkciókhoz argumentumként meg kell adnia bizonyos értékeket.
  • Ha szükséges, törölheti és újra beírhatja a képletet, hogy biztosan helyesen íródott-e be.
  • Kattintson az OK gombra.
  • Ha frissíteni szeretné a mező alapértelmezett értékét, amikor a mező alapjául szolgáló értékek módosulnak, jelölje be az Érték frissítése a képlet újraszámításakor jelölőnégyzetet. Ha ezt választja, kattintson az OK gombra, majd a Vezérlőeszközök eszközcsoportTulajdonságok lapjának Tulajdonságok csoportjában a Vezérlő tulajdonságai gombra. Kattintson a Megjelenítés fülre, majd jelölje be az Írásvédett jelölőnégyzetet.

Képlet használata szabályban

Az érvényesítési, formázási és műveleti szabályokban megadott feltételek esetében képlet használatával is vezérelheti a feltételt. Ehhez válassza a Feltétel párbeszédpanel harmadik legördülő listájában szereplő képlet használata lehetőséget, amikor szabályt rendel egy vezérlőhöz vagy az űrlapsablonhoz.

Vissza a lap tetejére

Dátum- és időfüggvények

addDays

Napok hozzáadása a dátumhoz vagy dátumhoz és időponthoz.

Szintaxis

addDays(dátum; napok)

argumentumok Leírás
date A második argumentumban szereplő napok száma hozzáadódik az argumentumban lévő dátumhoz. Az argumentum lehet Dátum (dátum) vagy Dátum és idő (dátumIdő) adattípusú.
nap Az első argumentumban megadott dátumhoz hozzáadni kívánt napok száma. A paraméternek egész szám adattípusúnak kell lennie. Ha negatív számot használ ebben az argumentumban, akkor a visszatérési érték egy korábbi dátum.

Példa

Azt szeretné, hogy az űrlapsablon egyik mezőjében egy, az aktuális dátumtól számított 60. napra eső dátum legyen. Az űrlapsablon tartalmaz egy fldToday nevű mezőt, amelynek alapértelmezett értéke a mai dátum. Az új dátum kiszámításához használja a következő képletet az Új dátum mezőben:

addDays(fldToday, 60)

addSeconds

Másodperceket ad hozzá az időhöz vagy dátumhoz és időhöz.

Szintaxis

addSeconds(idő; másodperc)

argumentumok Leírás
time Dátum- és időérték, illetve olyan időérték, amely vagy az űrlapsablon egy másik mezőjére mutató hivatkozás, vagy egy dátum- vagy időfüggvény (például most() vagy ma() eredménye. A második argumentumban megadott másodpercek száma hozzáadódik az argumentumban lévő időhöz. Az argumentum lehet Dátum (dátum) vagy Dátum és idő (dátumIdő) adattípusú. Ha az adattípus Idő, akkor a függvény Idő adattípust ad vissza. Ha ez Dátum adattípus, akkor Dátum és idő adattípust ad vissza.
másodperc Az első argumentumban megadott dátum- és időértékhez vagy időértékhez hozzáadni kívánt másodpercek száma. A paraméterben szereplő mezőnek egész szám adattípusúnak kell lennie. Ha negatív számot ad meg az argumentumban, akkor a visszatérési érték vagy egy korábbi dátum és időpont, vagy egy korábbi időpont.

Példa

Az űrlapsablon tartalmaz egy fldCurrentTime nevű mezőt, amely az aktuális időt használja alapértelmezett értékként, és egy másik mezőt, amely egy képletben az addSeconds függvény használatával az aktuális időponttól számított 120 másodperces időpontot jeleníti meg. Ha ezzel a függvénnyel szeretné kiszámítani az új időértéket, írja be a következő képletet a második mezőbe:

addSeconds(fldCurrentTime, 120)

most

Az aktuális rendszerdátumot és -időt adja eredményül.

Ha csak az aktuális dátumot szeretné visszakapni, használja a ma függvényt.

Szintaxis

most()

Ez a függvény nem használ argumentumokat.

Példa

Az űrlapsablonon alapuló űrlap létrehozási dátumának és időpontjának meghatározásához használja a következő képletet a mezőben:

most()

ma

Az aktuális rendszerdátumot adja eredményül. SharePoint-lista dátummezőihez használja a now() függvényt.

Ha egyszerre szeretné megjeleníteni a dátumot és az időt, használja a most függvényt.

Szintaxis

today()

Ez a függvény nem használ argumentumokat.

Példa

Az Ön űrlapsablonján alapuló űrlap létrehozási dátumának meghatározásához használja a következő képletet egy mezőben:

today()

Vissza a lap tetejére

Mezőfüggvények

darabszám

Egy mező vagy csoport példányainak számát számlálja meg.

Szintaxis

DARAB(mező)

argumentumok Leírás
mező Az űrlapon megszámlálni kívánt ismétlődő mező vagy ismétlődő csoport neve.

Példa

Egy olyan űrlapsablont tervez, amelynek űrlapjait a beszállítók a termékeik és készleteik jelentéséhez fogják használni. Az űrlapsablon tartalmaz egy dbpProduct nevű ismétlődő csoportot a szállító által beküldött termékekhez. Az egyes csoportok információkat tartalmaznak a termékről és annak készletszintjéről. Amikor egy szállító hozzáad egy terméket egy űrlapon, amely ezen az űrlapsablonon alapul, az InfoPath létrehozza az ismétlődő csoport egy új példányát.

Az űrlapsablon adatforrásában van egy mező, amely a szállító által beküldött termékek számát tartalmazza. A szállító által beküldött termékek számának automatikus megszámlálásához, amely az ismétlődő csoport előfordulásainak száma – használja a következő képletet a termékek száma mezőben:

count(grpProduct)

utolsó

Egy ismétlődő mező vagy csoport utolsó előfordulását adja vissza.

Megjegyzés

Ha böngészőkompatibilis űrlapsablont tervez, ez a függvény nem jelenik meg a Függvény beszúrása párbeszédpanel Függvények listájában.

Szintaxis

field_name[last()]

Bár maga a függvény nem rendelkezik kötelező paraméterekkel, a függvény predikátumként használható egy adott mezőnévhez.

Példa

Egy űrlapsablont tervez, amelyet a beszállítók töltenek ki a termékkészleteik jelentéséhez. Az űrlapsablon adatkapcsolatban áll egy webszolgáltatással, amely ellenőrzi, hogy az adott szállítótól származó összes termék termékinformációja kitöltődött-e. A módszerhez a szállító által beküldött terméklista utolsó termékére van szükség.

A termékinformációkat a program a grpProduct elnevezésű ismétlődő csoport különböző mezőiben tárolja. Amikor egy szállító hozzáad egy terméket az űrlaphoz, az InfoPath egy új, ismétlődő csoportot ad hozzá, melynek neve grpProduct lesz. Ha a szállító több termékről jelenti, az űrlap adatforrása a grpProduct ismétlődő csoport több példányát is tartalmazni fogja.

Annak érdekében, hogy a megfelelő információkat küldje el a webszolgáltatásnak, felvesz egy mezőt, amely a szállítótól kapott termékcsoport utolsó termékének adatait tartalmazza. Ha a mezőt úgy szeretné beállítani, hogy automatikusan beolvassa az utolsó terméket, a következő képletet használja alapértelmezett értékként az utolsó termék mezőhöz:

grpProduct[last()]

local-name

Egy mező vagy csoport helyi nevét adja vissza.

Megjegyzés

  • Ha az argumentum egy ismétlődő mező vagy ismétlődő csoport, akkor a függvény az első ismétlődő mező vagy ismétlődő csoport értékét adja eredményül.
  • Amikor egy felhasználó kitölt egy webböngésző űrlapot, egy képlet, amely ezt a függvényt használja, elküldi az űrlap adatait a kiszolgálónak, hogy megkapja a függvény visszatérési értékét.

Szintaxis

local-name(mező)

argumentumok Leírás
mező Annak a mezőnek a neve, amelynek helyi névattribútumát vissza szeretné kapni.

Példa

Egy engedélykérelmekhez használható űrlapsablont tervez. Az űrlapsablon adatkapcsolatban áll egy webszolgáltatás egyik metódusával. Ehhez a módszerhez meg kell adni a mező helyi név attribútumának értékét az alvállalkozó licencszámához. A licencszám mező neve ekkor fldLicenseNumber.

Rendelkezik egy mezővel, amely a helyi névattribútum értékét fogja tartalmazni. A licencszám mező helyi név attribútumának értékének automatikus beolvasásához használja alapértelmezett értékként azt a mezőt, amely a helyi név attribútum értékét fogja tartalmazni:

local-name(fldLicenseNumber)

név

Egy mező vagy csoport nevét és névtérelőtagját adja eredményül.

Megjegyzés

  • Ha az argumentum ismétlődő mező vagy ismétlődő csoport, akkor a függvény az űrlapon szereplő első ismétlődő mező vagy ismétlődő csoport nevét és előtagját adja eredményül.
  • Amikor egy felhasználó kitölt egy böngészőbarát űrlapsablonon alapuló űrlapot, egy képlet, amely ezt a függvényt használja, elküldi az űrlap adatait a kiszolgálónak, hogy megkapja a függvény visszatérési értékét.

Szintaxis

név(mező)

argumentumok Leírás
mező Annak a mezőnek a neve, amelynek a névtér előtagját és nevét vissza szeretné kapni.

Példa

Egy engedélykérelmekhez használható űrlapsablont tervez. Az űrlapsablon adatkapcsolatban áll egy webszolgáltatás egyik metódusával. Ehhez a módszerhez meg kell adni az alvállalkozó licencszámához tartozó mező "név" attribútumát. A licencszám mező neve ekkor fldLicenseNumber.

Rendelkezik egy mezővel, amely a névattribútum értékét fogja tartalmazni. A name attribútum értékének automatikus beolvasásához használja a következő képletet a mező alapértelmezett értékeként:

name(fldLicenseNumber)

namespace-uri

Egy mező vagy csoport teljes névterét adja vissza.

Megjegyzés

  • Ha az argumentum mezők vagy csoportok csoportja, a függvény az űrlapon szereplő első mező vagy csoport névterét adja vissza.
  • Amikor egy felhasználó kitölt egy webböngésző űrlapot, egy képlet, amely ezt a függvényt használja, elküldi az űrlap adatait a kiszolgálónak, hogy megkapja a függvény visszatérési értékét.

Szintaxis

névtér-uri(mező)

argumentumok Leírás
mező Annak a mezőnek a neve, amelynek névtér-URI-ját le szeretné kérni.

Példa

Egy engedélykérelmekhez használható űrlapsablont tervez. Az űrlapsablon elküldi az adatokat egy webszolgáltatásnak. Az űrlapsablonon alapuló űrlap adatainak feldolgozásához a webszolgáltatásnak szüksége van az adatforrás egy adott elemmezőjéből származó névtér URI-jára. Az űrlapsablon névtér URI-adatait tartalmazó mező neve fldComplete.

Rendelkezik egy mezővel, amely az elemmező névtér-URI-ját fogja tartalmazni. A névtér URI-jának automatikus beolvasásához használja a következő képletet alapértelmezett értékként arra a mezőre, amely a névtér URI-ját fogja tartalmazni:

namespace-uri(fldComplete)

pozíció

Egy mező vagy csoport indexét (vagy helyét) adja eredményül az ugyanazon szülőcsoporton belüli más mezőkhöz vagy csoportokhoz képest.

Megjegyzés

Ez a függvény nem érhető el webböngésző űrlapsablonokban.

Szintaxis

position()

Példa

Egy űrlapsablont tervez, amelyet a beszállítók töltenek ki a termékkészleteik jelentéséhez. A termékinformációkat a program ismétlődő csoport mezőiben tárolja. Az ismétlődő csoport egy ismétlődő táblázathoz van kötve, így a szállító új termékinformációkat vehet fel vagy módosíthatja a meglévőket.

Az ismétlődő táblázat első oszlopában meg szeretné jeleníteni a sor számát egy szövegmezőben. Ha automatikusan meg szeretné jeleníteni a sorok számát, amikor a szállító új terméket vesz fel az ismétlődő táblázatba, a következő képletet használja a szövegmező alapértelmezett értékeként:

position()

Vissza a lap tetejére

Matematikai függvények

A matematikai függvényeket tartalmazó képletek általában egész számokat vagy decimális értékeket tartalmaznak. Ha azt szeretné, hogy az argumentumok ne null értékek, hanem egész számok vagy decimális értékek legyenek, kattintson aSpeciális fájlűrlap-beállításokra>>, és győződjön meg arról, hogy be van jelölve az Üres értékek kezelése nullaként jelölőnégyzet.

Átlagos

Kiszámítja egy ismétlődő csoportba tartozó mező numerikus értékeinek átlagát.

Megjegyzés

Az ismétlődő mezőnek numerikus adattípusúnak kell lennie, és egy csoportnak kell lennie.

Szintaxis

ÁTLAG(mező)

argumentumok Leírás
mező Annak a csoportban szereplő ismétlődő mezőnek a neve, amelynek az átlagértékét ki szeretné számítani.

Példa

Olyan űrlapsablont tervez, amelynek űrlapjait a beszállítók a termékeik és készleteik jelentéséhez fogják használni. Az űrlapsablonban van egy fludPrice nevű ismétlődő mező, amely egy ismétlődő csoportban található, amely a szállító által értékesített összes termék adatait tartalmazza. A csoport egy ismétlődő táblázat vezérlőhöz kötött.

Van egy mező az űrlapsablonban, amely az adott szállító által értékesített összes termék átlagárát fogja tartalmazni. Az átlagár kiszámításához használja a következő képletet az átlagár mezőben:

átlag(fldPrice)

logikai változó

Igaz érték visszaadása, ha mező vagy csoport létezik. Ellenkező esetben hamis értéket ad vissza.

Ez akkor is igaz értéket ad vissza, ha a mezőhöz társított vezérlőelemet törölték, de a mező még létezik.

Szintaxis

logikai(mező)

argumentumok Leírás
mező A függvénnyel ellenőrizendő ismétlődő mező vagy ismétlődő csoport.

Példa

Egy olyan űrlapsablont tervez, amelyet a beszállítók a termékkészleteik jelentéséhez használnak. A termékinformációkat különböző mezők tárolják egy ismétlődő csoportban, amelynek neve grpProduct (grpProduct). Minden ismétlődő csoport az egyes termékekkel kapcsolatos információkat tartalmazó mezőket tartalmaz. Ha a szállító hét termékről ad információt, az űrlap hét ismétlődő csoportot fog tartalmazni.

Az ismétlődő csoport egy ismétlődő táblázat vezérlőhöz kötött, amely lehetővé teszi a szállító számára, hogy új termékinformációkat vegyen fel vagy ellenőrizze a meglévőket. A szállító hozzáadhat vagy törölhet sorokat az ismétlődő táblázatból.

Ha meg szeretne jeleníteni egy párbeszédpanelt, ha a felhasználó az ismétlődő táblázatból az összes sort eltávolítja. A "true" szót tartalmazó mezőt akkor kell hozzáadni az adatforráshoz, ha az ismétlődő táblázat vezérlő legalább egy sort tartalmaz, illetve a "hamis" szót, ha az ismétlődő táblázat vezérlőben nincsenek sorok.

Az ismétlődő táblázat vezérlőelemben beállíthat egy szabályt, amely akkor egy párbeszédpanelt jelenít meg, ha a mezőben hamis. Ha automatikusan meg szeretné állapítani, hogy az ismétlődő táblázat tartalmaz-e legalább egy sort, használja a következő képletet, mert a mező alapértelmezett értéke tartalmazza az "igaz" vagy a "hamis" szót:

logikai érték(grpProduct)

mennyezet

Egy számot a legközelebbi egész számra kerekít.

Szintaxis

PLAFON(szám)

argumentumok Leírás
szám A számértéket tartalmazó mező neve.

Példa

Egy költségelszámolási űrlapsablont tervez cége számára. A költségek egy olyan webszolgáltatáshoz lesznek elküldve, amelynek paramétere csak egész számokat fogad el. Az ennél a paraméternél megadott költségösszeget a nagyobb egész számra kell kerekíteni. A kiadás mennyiségét az fldExpenseAmount nevű mező tárolja, míg az egész értéket egy másik mező. A nagyobb egész érték kiszámításához a következő képletet használja a másik mező alapértelmezett értékeként:

plafon(fldExpenseAmount)

Ha a felhasználó létrehoz egy űrlapot az űrlapsablon alapján, és a 145,87 értéket adja meg az fldExpenseAmount mezőben, akkor a képletet tartalmazó mező értéke 146 lesz.

eval

Egy mező vagy csoport értékeit adja eredményül. A második argumentum a mezőre vagy csoportra kiszámítandó kifejezést határozza meg. Az eval függvény rendszerint egy mezőn vagy csoporton (például sum vagy avg) működő függvénybe van ágyazva.

Szintaxis

Eval(mező; kifejezés)

argumentumok Leírás
mező Annak a mezőnek vagy csoportnak a neve, amelynek értékeit a második argumentumban használt kifejezés kiértékeli.
kifejezés Az első argumentumra alkalmazandó kifejezés. A kifejezés lehet XPath-függvény vagy dupla idézőjelek (" ") közé zárt kifejezés.

Példa

Egy költségelszámolási űrlapsablont tervez cége számára. Az űrlapsablon tartalmaz egy fldTotal nevű mezőt, amely a kiadás összegét tartalmazza. Az fldTotal mező a grpExpenses nevű ismétlődő csoport része. Egy másik mező egy olyan beviteli mezőhöz van kötve, amely az összes kiadás összegét tartalmazza. Ha meg szeretné jeleníteni az összes kiadás összegét, amikor a felhasználó beírja a költség összegét, használja a következő képletet a teljes költség mezőben:

eval(grpExpenses;sum(fldTotal))

false

Hamis értéket ad vissza.

Szintaxis

HAMIS()

Ez a függvény nem használ argumentumokat.

Példa

Egy olyan űrlapsablont tervez, amelynek űrlapjait az alvállalkozók használják majd az építési engedélyek kérelmezéséhez. Az űrlapsablon két részből áll: az egyik részből a kapcsolattartási adatok, a másikból az építési engedéllyel kapcsolatos információk. Az űrlap kitöltésekor a vállalkozóknak teljesen ki kell tölteniük az elérhetőségi adatok részt, mielőtt kitölthetnék az építési engedély részt.

Ehhez létre kell hoznia egy szabályt, amely egy logikai mező értékét hamis értékre állítja, ha a kapcsolattartási adatok szakasz bármelyik mezője üres. A logikai értékmezők igaz vagy hamis logikai értéket is tartalmazhatnak. A feltételes formázást úgy is beállíthatja, hogy elrejtse az építési engedély adatait tartalmazó szakasz vezérlőelemet, ha a logikai mező értéke hamis.

Az építési engedély adatainak mezőit tartalmazó szakasz vezérlőelem elrejtéséhez állítson be egy szabályt, amely a logikai mezőben futtatja ezt a függvényt, ha a kapcsolattartási adatok szakasz bármelyik mezője üres.

padló

Egy számot lefelé kerekít a legközelebbi egészre.

Szintaxis

floor (szám)

argumentumok Leírás
szám A számértéket tartalmazó mező neve.

Példa

Egy költségelszámolási űrlapsablont tervez cége számára. A költségek egy olyan webszolgáltatáshoz lesznek elküldve, amely paramétert használ, amely csak egész számokat fogad el. A paraméternek megadott költségösszeget a kisebb egész értékre kell kerekíteni. A kiadás mennyiségét az fldExpenseAmount nevű mező tárolja, míg az egész értéket egy másik mező. A kisebb egész érték kiszámításához a másik mező alapértelmezett értéke a következő képlet:

floor (fldExpenseAmount)

max

Egy mező vagy csoport legnagyobb számát adja eredményül.

Szintaxis

max(mező)

argumentumok Leírás
mező Egy csoport vagy egy ismétlődő csoport mezője, amelynek a legmagasabb értékét keresi.

Példa

Egy olyan űrlapsablont tervez, amelynek űrlapjait a beszállítók a termékkészleteik jelentéséhez fogják használni. Az űrlapsablon egy ismétlődő csoportot tartalmaz, amely több mezőt tartalmaz, amelyek a szállítók termékeivel kapcsolatos adatokat tartalmazzák. Az ismétlődő csoportban található fldPrice nevű mező egy termék árát tartalmazza.

Az űrlapsablon adatforrásának egy másik mezője az adott szállító által értékesített termékek közül a legmagasabb árat fogja tartalmazni. A legmagasabb ár visszaadásához használja a következő képletet a legmagasabb ár mezőben:

max(fldPrice)

perc

Egy mező vagy csoport legkisebb számát adja meg.

Szintaxis

min(mező)

argumentumok Leírás
mező Egy csoport vagy egy ismétlődő csoport mezője, amelynek a legmagasabb értékét keresi.

Példa

Egy olyan űrlapsablont tervez, amelynek űrlapjait a beszállítók a termékkészleteik jelentéséhez fogják használni. Az űrlapsablon tartalmaz egy ismétlődő csoportot, amely több mezőt tartalmaz, amelyek a szállítók termékeivel kapcsolatos adatokat tartalmaznak. Az ismétlődő csoportban található fldPrice nevű mező egy termék árát tartalmazza.

Az űrlapsablon adatforrásának egy másik mezője az adott szállító által értékesített termékek közül a legalacsonyabb árat fogja tartalmazni. A legalacsonyabb ár visszaadásához használja a következő képletet a legalacsonyabb ár mezőben:

min(fldPrice)

ne

Igaz érték visszaadása, ha a logikai érték hamis vagy null. Hamis értéket ad vissza, ha a logikai érték igaz vagy nem null.

Szintaxis

nem(boolean_value)

argumentumok Leírás
boolean_value Logikai adattípusú mező.

Példa

Egy olyan űrlapsablont tervez, amelynek űrlapjait az alvállalkozók használják majd az építési engedélyek kérelmezéséhez. Az űrlapsablon külön részében találhatók a kapcsolattartási adatok, és egy másik rész az építési engedéllyel kapcsolatos információknak. Az űrlap kitöltésekor a vállalkozóknak teljesen ki kell tölteniük az elérhetőségi adatok részt, mielőtt kitölthetnék az építési engedély részt.

Ehhez létre kell hozni egy olyan szabályt, amely egy logikai mező értékét hamis értékre állítja, ha a névjegyadatok szakasz bármelyik mezője üresen marad. A logikai értékmezők logikai értéke igaz vagy hamis lehet. Ezután ugyanezzel a képlettel rejtse el az építési engedély adatait tartalmazó szakasz vezérlőelemet, ha a logikai mező értéke hamis. A szabály beállításához a következő képlettel állítsa a logikai mezőt hamis értékre:

not(true())

szám

Egy értéket számmá alakít.

A függvény NaN értéket ad vissza, ha az argumentum értéke nem alakítható számmá.

Szintaxis

szám(érték)

ArgumentumLeírása

értékA számmá konvertálandó értéket tartalmazó mező.

Példa

Egy olyan űrlapsablont tervez, amelynek űrlapjait az alvállalkozók használják majd az építési engedélyek kérelmezéséhez. Az űrlapsablon tartalmaz egy részt, ahová az alvállalkozó megadhatja a munkahelyi címét. Annak ellenőrzéséhez, hogy az alvállalkozó érvényes címet ad-e meg, adatkapcsolatot kell létesítenie egy webszolgáltatással, amely képes ellenőrizni a címet. Ha a cím ellenőrizve van, az alvállalkozó elküldheti az űrlapot egy SQL-adatbázisba. Az SQL-adatbázis egy szövegmezőt használ a címhez és a házszámhoz is. A webszolgáltatás megköveteli, hogy a címszám numerikus, az utcanév pedig szöveg adattípusú legyen.

Ahhoz, hogy a webszolgáltatásnak és az SQL-adatbázisnak is küldjön adatokat, a címet két különböző adattípusként kell tárolni:

  • A cím elküldéséhez a címnek numerikusnak, a ganév szöveg adattípusúnak kell lennie.
  • Ahhoz, hogy elküldhesse a címet az SQL-adatbázisba, a címszámnak és a utcanévnek is szöveg adattípusúnak kell lennie.

Azt is szeretné, hogy az alvállalkozó csak egyszer írja be a címét. A cím megfelelő adattípusúra való átalakításához és annak biztosításához, hogy az alvállalkozó csak egyszer írja be a címét, az űrlapsablon tartalmaz egy mezőt a címszám és az utcanév megadására. Mindkét mező szöveges adattípusúként van konfigurálva.

Ahhoz, hogy elküldhesse a címszámot a webszolgáltatásnak, numerikus adattípusúvá kell konvertálnia az fldAddressNumber mező adatait (szöveg adattípusként tárolva). A numerikus adattípusra konvertált címszám értékét egy másik mező tárolja, amely numerikus adattípusok tárolására van konfigurálva.

Ha szöveges adattípusúról numerikus adattípusra szeretné konvertálni a címszámot, az alábbi képletet használja az fldAddressNumber mező alapértelmezett értékeként:

szám(fldAddressNumber)

nz

Olyan mezőt vagy csoportot ad vissza, amelynek minden üres mezőjét nulla (0) értékre cseréli.

Szintaxis

nz(mező)

argumentumok Leírás
mező A mező, amelynek ellenőrizni szeretné az értékét.

Példa

Egy űrlapsablont tervez, amelyet a beszállítók töltenek ki a termékkészleteik jelentéséhez. A szállító a termékkészletét egy webszolgáltatásnak az Ön űrlapsablonján alapuló űrlapon keresztül küldi el. A webszolgáltatás metódusa megköveteli, hogy minden numerikus adatot tartalmazó elem numerikus értékkel rendelkezzen. A webszolgáltatás elutasítja az üres numerikus elemet tartalmazó űrlapokat.

Az űrlapsablon tartalmaz egy fldAvailability nevű mezőt, amely azt jelzi, hogy a szállító hogyan tudja biztosítani a terméket. A szállító megadhat egy számot ebben a mezőben. Ha szeretne gondoskodni arról, hogy a szállító elküldhesse az Ön űrlapsablonján alapuló űrlapját a webszolgáltatásnak, és automatikusan nullára állítsa a mező értékét, ha a szállító nem ír be számot, akkor használja a következő képletet a mező alapértelmezett értékeként:

nz(fldAvailability)

kerek

Egy számot a legközelebbi egészre kerekít.

Ha a nem egész szám pontosan félúton van két kerekített egész érték között, akkor a visszatérési érték a következő legnagyobb egész érték lesz.

Szintaxis

round(szám)

argumentumok Leírás
szám Az ezzel a képlettel kerekítendő számot tartalmazó mező.

Példa

Egy olyan űrlapsablont tervez, amelynek űrlapjait a beszállítók a termékkészleteik jelentéséhez fogják használni. Az űrlapsablon tartalmaz egy ismétlődő csoportot, amely több mezőt tartalmaz, amelyek a szállítók termékeivel kapcsolatos adatokat tartalmazzák. Az ismétlődő csoport egyik mezője, az fldÁr néven, egy termék árát tartalmazza.

Az űrlapsablon adatküldési kapcsolatban áll egy webszolgáltatással. A webszolgáltatási módszer megköveteli, hogy minden árat egész számra kerekítsenek. Ha a megfelelő értéket szeretné elküldeni a webszolgáltatási metódusnak, adjon hozzá egy ismétlődő mezőt az adatforráshoz. Ez a mező a következő képlettel egész értékre kerekíti az fldPrice mezőben lévő árat:

round(fldPrice)

összeg

Egy mező vagy csoport összes mezőjének összegét adja eredményül. A program először minden mezőt számértékké konvertál.

Szintaxis

szum(mező)

argumentumok Leírás
mező Mező neve egy ismétlődő csoportban vagy egy csoport egy ismétlődő mezőjében, amelynek értékei hozzá lesznek adva. Ha két különböző csoportból szeretne mezőket hozzáadni, az egyesítő operátorral (|) válassza el egymástól az argumentumokat. Például: szum( mezőnév 1 | mezőnév 2).

Példa

Egy költségelszámolási űrlapsablont tervez. Az űrlapsablonban van egy költségelemeket tartalmazó csoport. Az egyes tételek mennyiségét az fldExpenseAmount nevű mező tárolja. A csoport egy ismétlődő táblázathoz kötött, amely sorként jeleníti meg az egyes kiadási tételeket. Az űrlapsablon tartalmaz egy szövegmező vezérlőelemet, amely megjeleníti a teljes kiadást. A teljes kiadás megjelenítéséhez a beviteli mező vezérlőelem a következő képletet tartalmazza:

sum(fldExpenseAmount)

true

Igaz érték visszaadása.

Szintaxis

true()

Ez a függvény nem használ argumentumokat.

Példa

Egy olyan űrlapsablont tervez, amelynek űrlapjait az alvállalkozók használják majd az építési engedélyek kérelmezéséhez. Az űrlapsablon külön szakaszában találhatók az elérhetőségi adatok, egy másik pedig az építési engedéllyel kapcsolatos információk. Az űrlap kitöltésekor a vállalkozóknak teljesen ki kell tölteniük az elérhetőségi adatok részt, mielőtt kitölthetnék az építési engedély részt.

Ehhez létre kell hoznia egy olyan szabályt, amely egy logikai mező értékét Igaz értékre állítja, ha a névjegyadatok szakasz minden mezője tartalmaz adatokat. A logikai értékmezők logikai értéke igaz vagy hamis lehet. Ha a logikai mező értéke igaz, megjelenik az építési engedély adatait tartalmazó szakasz vezérlőelem.

Az építési engedély adatait tartalmazó szakasz vezérlőelem megjelenítéséhez konfiguráljon egy szabályt, amely a logikai mezőben futtatja a függvényt, ha a kapcsolattartási adatok szakasz minden mezője tartalmaz adatokat.

Vissza a lap tetejére

Szövegfüggvények

concat

Két vagy több szövegmezőt egyetlen szöveges karakterlánccá egyesít.

Szintaxis

FŰZ(szöveg1; szöveg2; ...)

argumentumok Leírás
szöveg1 Olyan mező, amely az argumentum2 argumentumában a szöveget egyetlen sorban egyesítendő szöveggé egyesíti.
szöveg2, ... Érm vagy több további mező, amely az előző mezővel egyesítendő szöveget tartalmazza. A szöveges mezőket vesszővel válassza el egymástól.

Példa

Egy olyan űrlapsablont tervez, amely tartalmaz egy fldFirstName és egy fldLastName nevű mezőt. Adja hozzá az alábbi képletet egy harmadik mezőhöz, hogy a következő szöveget tartalmazza: "Ez az űrlap a vezetéknév utónévvel <><>lett kitöltve":

concat("Ezt az űrlapot kitöltötte ", fldFirstName, " ", fldLastName, ".")

Megjegyzés

A szöveges argumentumként beírt szöveget (a szóközöket és az írásjeleket is beleértve) idézőjelek közé (") kell beszúrni.

Tartalma

Igaz érték visszaadása, ha az első mező vagy szöveges karakterlánc tartalmazza a másodikat Ellenkező esetben hamis értéket ad vissza.

Szintaxis

tartalmazza(within_text; find_text)

argumentumok Leírás
szöveg: A keresendő szöveget tartalmazó mező.
keres_szöveg: Az a mező, amely az első argumentumban keresendő szöveget vagy idézőjelek (" ") közé tett szöveget tartalmazza.

Példa

Egy három szövegmezőből álló űrlapsablont tervez. Az első lehetővé teszi, hogy a felhasználó hosszú szöveget írjon be az első (fldText) nevű szövegvezérlőbe. A második lehetővé teszi, hogy a felhasználó egy rövid szövegrészletet írjon be, melynek neve fldFindText. A harmadik szövegmező összehasonlítja a második szövegmezőt az elsővel, jelzi, hogy a második mező értéke megtalálható-e az első mezőben, és megjeleníti az eredményt. Alapértelmezésként a következő képletet használná:

contains(fldText,fldFindText)

normalize-space

Eltávolítja a szóközt a szövegből.

Megjegyzés

Ezzel eltávolítja a szöveg adattípusú mezőkből a kezdő, a záró és az ismétlődő üres szóközöket.

Szintaxis

normalize-space(szöveg)

argumentumok Leírás
text Az eltávolítani kívánt kezdő, záró vagy ismétlődő szóközöket tartalmazó szöveg. A szöveget foglalja kettős idézőjelek (" ") közé.

Példa

Olyan űrlapsablont tervez, amely tartalmaz egy fldText nevű mezőt (amely egy beviteli mező vezérlőhöz van kötve). Ha normalizálni szeretné az első mezőbe beírt szöveget, hogy felesleges térközök nélkül szeretné megjeleníteni az első mező értékét, vegyen fel egy második, a következő képletet használó mezőt alapértelmezett értékként:

normalize-space(fldText)

Kezdi vele

Igaz érték visszaadása, ha az első mező vagy szöveges karakterlánc a másodikkal kezdődik. Ellenkező esetben hamis értéket ad vissza.

Szintaxis

kezdete(szöveg, start_text)

argumentumok Leírás
text Annak a mezőnek a neve, amely a keresendő szöveget tartalmazza. Az argumentumokat vesszővel válassza el egymástól.
start_text A keresendő szöveg az első argumentumként megadott mező elején. Ez az argumentum lehet mező vagy idézőjelek (" ") közé zárt szöveg.

Példa

Egy három szövegmezőből álló űrlapsablont tervez. Az első lehetővé teszi, hogy a felhasználó hosszú szöveget írjon be az első (fldText) nevű szövegvezérlőbe. A második lehetővé teszi, hogy a felhasználó egy rövid szövegrészletet írjon be, melynek neve fldFindText. A harmadik szövegmező összehasonlítja a második szövegmezőt az elsővel, és jelzi, hogy az első mező értéke a második mező értékével kezdődik-e, és megjeleníti az eredményt. Alapértelmezésként a következő képletet használná:

kezdete(fldText, fldFindText)

karakterlánc

Értékeket szöveges karakterlánccá alakít.

Szintaxis

karakterlánc(érték)

argumentumok Leírás
érték A szöveggé alakítandó értéket tartalmazó mező.

Példa

Egy olyan űrlapsablont tervez, amelynek űrlapjait az alvállalkozók használják majd az építési engedélyek kérelmezéséhez. Az űrlapsablonban van egy rész, ahová az alvállalkozó megadhatja a munkahelyi címét. Annak ellenőrzéséhez, hogy az alvállalkozó érvényes címet ad-e meg, az űrlapsablon adatkapcsolatot létesít egy webszolgáltatással, amely képes a cím ellenőrzésére. Ha a cím ellenőrizve van, az alvállalkozó elküldheti az űrlapot egy SQL-adatbázisba. Az SQL-adatbázis egy szövegmezőt használ a házszámhoz. A webszolgáltatás megköveteli, hogy a címszám numerikus, az utcanév pedig szöveg adattípusú legyen.

Ahhoz, hogy a webszolgáltatásba és az SQL-adatbázisba is küldhessen adatokat, a címet két különböző adattípusban kell tárolnia:

  • Ahhoz, hogy a címet elküldhesse a webszolgáltatásnak, a címszámnak numerikus adattípusúnak kell lennie.
  • Ahhoz, hogy elküldhesse a címet az SQL-adatbázisba, a címszámnak és a utcanévnek is szöveg adattípusúnak kell lennie.

Azt is szeretné, hogy az alvállalkozó csak egyszer írja be a címét. A cím megfelelő adattípusúra való átalakításához és annak biztosításához, hogy az alvállalkozó csak egyszer írja be a címét, az űrlapon van egy mező a címszám beírására és az utcanév megadására szolgáló mező. Az fldAddressNumber mező numerikus adattípusú, a StreetName mező szöveg adattípusú.

Ahhoz, hogy a teljes címet (a címet és a házszámot is) elküldhesse az SQL-adatbázisba, egyesítenie kell az fldAddressNumber és a StreetName mező értékét egyetlen értékké, amely szöveg adattípusú. Először az adatokat numerikus típusúvá kell konvertálnia az fldAddressNumber mezőben lévő numerikus adatot, amely numerikus adattípusként tárolja az adatokat. Az adatforráshoz hozzá kell adni egy mezőt, amely szöveges adattípusként a teljes címet fogja tartalmazni.

Az fldAddressNumber mező szöveges adattípusúvá alakításához, hogy használni tudja a webszolgáltatást, konfiguráljon egy másik mezőt, amely a címet fogja tartalmazni szöveges adattípusként. Ha numerikus adattípusúról szöveges adattípusra szeretné átalakítani a címszámot, a mező alapértelmezett értékeként használja a következő képletet:

string(fldAddressNumber)

karakterlánc-hossz

Szöveg karakterekben mért hosszát adja eredményül.

Szintaxis

string-length(szöveg)

argumentumok Leírás
text Az a mező, amelynek értéke a megszámlálni kívánt szöveg.

Példa

Olyan űrlapsablont tervez, amely tartalmaz egy szövegmező vezérlőelemhez kötött fldText nevű mezőt. Az űrlapsablon tartalmaz egy második mezőt is, amely az első űrlapra írt karakterek számát számlálja. Ehhez a második mezőben alapértelmezettként a következő képletnek kell szerepelnie:

string-length(fldText)

karakterláncrész

Egy szöveges karakterlánc egy adott részét adja vissza. A második argumentum a kezdőpozíciót, a harmadik pedig a belefoglalandó karakterek számát adja meg.

Szintaxis

KARAKTERLÁNC RÉSZ(szöveg; start_position; char_count)

argumentumok Leírás
text Szöveg adattípusú mező, illetve idézőjelek (" ") közé zárt szöveg. A függvény a szövegben keres, és a második argumentumban megadott pozíciótól kezdve egészen a harmadik argumentumban megadott karakterszámig vagy a szöveg végéig (amelyik előbb bekövetkezik) visszaadja az összes karaktert.
start_position Az első argumentumból kinyerni kívánt szöveg kezdő pozíciója. Az argumentumnak egész számnak vagy egész szám (egész szám) tárolására konfigurált mezőre mutató hivatkozásnak kell lennie.
char_count A kiolvasni kívánt karakterek száma a második argumentumban megadott kezdőpozíciótól kezdődően. Az argumentumnak egész számnak vagy egész szám (egész szám) tárolására konfigurált mezőre mutató hivatkozásnak kell lennie.

Példa

Olyan űrlapsablont tervez, amely az alábbi mezőket és vezérlőelemeket tartalmazza:

  • Egy fldText nevű mező, mely egy beviteli mező vezérlőelemhez van kötve. Ez a mező tartalmazza azt a szöveget, amelyben a függvény keres.
  • Egy szövegmező vezérlőelemhez kötött fldStartingPosition nevű mező. Ez a mező egész szám adattípusként van konfigurálva. Ez a mező tartalmazza a függvény kezdőpozícióját.
  • Egy szövegmező vezérlőelemhez kötött fldNumberOfCharacters nevű mező. Ez a mező egész szám adattípusként van konfigurálva. A mező tartalmazza a függvény által eredményül adott karakterek számát.
  • A függvény eredményeit megjelenítő szövegmező vezérlőelem. A szövegmező vezérlőelem a következő képletet tartalmazza:

substring(fldText, fldStartingPosition, fldNumberOfCharacters)

Ha egy felhasználó beírja az "Ez az űrlap InfoPath-űrlapsablonból készült" szöveget. Az első szövegdobozban, amelyet a másodikban a 4, a harmadikban pedig a 16, ezután a negyedik szövegdobozban az "S alak volt létrehozva" szöveget kell tartalmaznia.

karakterlánc-után

A második karakterlánc első előfordulása utáni első szöveges karakterlánc szövegét adja vissza.

Szintaxis

Substring-after(szöveg, find_text)

argumentumok Leírás
text Szöveg adattípusú mező, illetve idézőjelek (" ") közé zárt szöveg. A függvény keresi az argumentum szövegét, majd a második argumentum szövegét követő összes karaktert visszaadja.
keres_szöveg: Az első argumentum szövegében keresendő szöveg. A szöveg lehet a szöveg adattípusú mező értéke, vagy dupla idézőjelek (" ") közé zárt szöveg. A függvény megkeresi ezt a szöveget az első argumentum szövegében, majd az argumentum szövegét követő összes karaktert visszaadja.

Példa

Olyan űrlapsablont tervez, amely az alábbi mezőket és vezérlőelemeket tartalmazza:

  • Egy fldText nevű mező, mely egy beviteli mező vezérlőelemhez van kötve. Ez a mező tartalmazza azt a szöveget, amelyben a függvény keres.
  • Egy szövegmező vezérlőelemhez kötött fldSubstringText nevű mező. Ez a mező tartalmazza a függvény második argumentumát alkotó szöveget.
  • A függvény eredményeit megjelenítő szövegmező vezérlőelem. A szövegmező vezérlőelem a következő képletet tartalmazza:

substring-after(fldText, fldSubstringText)

Ha egy felhasználó beírja az "Ez az űrlap InfoPath-űrlapsablonból készült" szöveget. és az "InfoPath" szót a másodikban, akkor a harmadik szövegmező vezérlő az "űrlapsablon" szót fogja tartalmazni.

karakterlánc-előtt:

A második karakterlánc első előfordulását megelőző első karakterlánc szövegét adja vissza.

Szintaxis

Substring-before(szöveg, find_text)

argumentumok Leírás
text Szöveg adattípusú mező, illetve idézőjelek (" ") közé zárt szöveg. A függvény megkeresi a szöveget az argumentumban, majd a második argumentum (find_text) szövege előtti összes karaktert visszaadja.
keres_szöveg: A szöveg argumentumban keresendő érték. Ez az érték lehet egy szöveg típusú mező értéke, vagy dupla idézőjel (" ") közé zárt szöveg. A függvény megkeresi ezt a szöveget az első argumentum (szöveg) szövegében, majd a szöveg előtti összes karaktert visszaadja.

Példa

Egy olyan űrlapsablont tervez, amely az alábbi mezőket és vezérlőelemeket tartalmazza:

  • Egy fldText nevű mező, mely egy beviteli mező vezérlőelemhez van kötve. Ez a mező tartalmazza azt a szöveget, amelyben a függvény keres.
  • Egy szövegmező vezérlőelemhez kötött fldSubstringText nevű mező. Ez a mező tartalmazza a függvény második argumentumát alkotó szöveget.
  • Aa szövegmező vezérlő, amely a függvény eredményeit jeleníti meg. A szövegmező vezérlőelem a következő képletet tartalmazza:

substring-before(fldText, fldSubstringText)

Ha egy felhasználó beírja az "Ez az űrlap InfoPath-űrlapsablonból készült" szöveget. és a "létrehozva" szót a másodikban, akkor a harmadik beviteli mező vezérlő az "Ez az űrlap volt" szöveget tartalmazná.

fordítás

Az első karakterláncot adja vissza, amelyben a második karakterlánc minden karakterét lecseréli a harmadik karakterlánc megfelelő pozíciójában lévő karakter.

Szintaxis

fordítás(szöveg; find_chars, replace_chars)

argumentumok Leírás
text Annak a szövegnek a neve, amelynek a karaktereit le szeretné cserélni. Az argumentumokat vesszővel válassza el egymástól.
find_chars Szöveg típusú mező karaktere vagy értéke, amelyet a harmadik argumentum karakterei helyettesítenek. Az argumentumokat vesszővel válassza el egymástól.
replace_chars A második argumentumban szereplő karakter vagy szöveges adattípusú mező értéke, amely a karakter minden előfordulását lecseréli.

Példa

Egy olyan űrlapsablont tervez, amelynek űrlapjait az alvállalkozók használják majd az építési engedélyek kérelmezéséhez. Az űrlapsablonban van egy rész, ahová az alvállalkozó megadhatja a munkahelyi címét. A szakasz tartalmaz egy fldStreetAddress nevű mezőt, amely egy szövegmező vezérlőelemhez van kötve, és amelybe az alvállalkozó megadhatja a lakcímét.

Ha ellenőrizni szeretné, hogy az alvállalkozó érvényes címet ad-e meg, adatkapcsolattal áll egy webszolgáltatással, amely képes ellenőrizni a címet. A webszolgáltatás kisbetűket követel meg a címben.

Ha az utcanévcím nagybetűit kisbetűssé szeretné alakítani, adjon hozzá az adatforráshoz egy további mezőt, amely a kisbetűkre átalakított utcacímet tartalmazza. A mező alapértelmezett értéke a következő képletet tartalmazza:

translate(fldStreetAddress, ABCDEFGHIJKLMNOPQRSTUVWXYZ, abcdefghijklmnopqrstuvwxyz)

Vissza a lap tetejére

URL-függvények

SharePointListUrl

Annak a SharePoint-listának vagy űrlaptárnak a címét adja vissza, ahol az űrlap található (csak az InfoPath 2010 esetén).

Szintaxis

SharePointListUrl()

Ez a függvény nem használ argumentumokat.

Példa

SharePoint-listához tervez űrlapsablont, és hozzá szeretne adni egy hivatkozást (például https://sharepointserver/site/list/), amely a lista tárolási helyére mutat. Ehhez vegyen fel egy hivatkozás vezérlőelemet, állítsa be írásvédettre, majd állítsa be a vezérlőelemhez csatolt mező alapértelmezett értékét az alábbiak szerint:

SharePointListUrl()

Megjegyzés

Ha az űrlapsablont nem SharePoint-kiszolgáló tárolja, akkor a SharePointListUrl() függvény csak a "https://sharepointserver/site/list/" értéket adja vissza.

SharePointServerRootUrl

Az űrlapot tároló SharePoint-kiszolgáló címét adja vissza (csak az InfoPath 2010 esetén).

Szintaxis

SharePointServerRootUrl()

Ez a függvény nem használ argumentumokat.

Példa

Egy SharePoint-listához tervez űrlapsablont, és hozzá szeretne adni egy hivatkozást (például "https://sharepointserver/site/list/") a listához használt SharePoint-kiszolgáló gyökérkönyvtárához. Ehhez vegyen fel egy hivatkozás vezérlőelemet, állítsa be írásvédettre, majd állítsa be a vezérlőelemhez csatolt mező alapértelmezett értékét az alábbiak szerint:

SharePointServerRootUrl()

Megjegyzés

Ha az űrlapsablont nem SharePoint-kiszolgáló tárolja, akkor a SharePointListUrl() függvény csak a "https://sharepointserver/site/list/" értéket adja vissza.

SharePointCollectionUrl

Az űrlapot tároló SharePoint-webhelycsoport címét adja vissza (csak InfoPath 2010 esetén).

Szintaxis

SharePointCollectionUrl()

Ez a függvény nem használ argumentumokat.

Példa

SharePoint-listához tervez űrlapsablont (például https://sharepointserver/sitecollection/). Ehhez vegyen fel egy hivatkozás vezérlőelemet, állítsa be írásvédettre, majd állítsa be a vezérlőelemhez csatolt mező alapértelmezett értékét az alábbiak szerint:

SharePointCollectionUrl()

Megjegyzés

Ha az űrlapsablont nem SharePoint-kiszolgáló tárolja, akkor a SharePointListUrl() függvény csak a "https://sharepointserver/sitecollection/" értéket adja vissza.

SharePointSiteUrl

Az űrlapot tároló SharePoint-webhely címét adja vissza (csak az InfoPath 2010 esetén).

Szintaxis

SharePointSiteUrl()

Ez a függvény nem használ argumentumokat.

Példa

SharePoint-listához tervez űrlapsablont, és hozzá szeretne adni egy hivatkozást (például "https://sharepointserver/site/") a listához használt SharePoint-webhelyre. Ehhez vegyen fel egy hivatkozás vezérlőelemet, állítsa be írásvédettre, majd állítsa be a vezérlőelemhez csatolt mező alapértelmezett értékét az alábbiak szerint:

SharePointSiteUrl()

Megjegyzés

Ha az űrlapsablont nem SharePoint-kiszolgáló tárolja, akkor a SharePointListUrl() függvény csak a "https://sharepointserver/site/" értéket adja vissza.

Vissza a lap tetejére

A userName függvény

felhasználónév

Az űrlapot kitöltő személy felhasználónevét adja vissza (Microsoft InfoPath 2007 vagy újabb verzió).

Megjegyzés

Ha a felhasználó egy webböngészőben tölt ki egy űrlapot, a felhasználónevet a Microsoft Windows SharePoint Services 3.0-s vagy újabb verziójából olvassa be a rendszer.

Szintaxis

userName()

Ez a függvény nem használ argumentumokat.

Példa

Egy költségelszámolási űrlapsablont tervez cége számára. A hitelkártyát kibocsátó vállalat az alkalmazottak kiadásait tartalmazó nyilvántartást elektronikus úton elküldi a vállalat által fenntartott adatbázisba. Egy alkalmazott költségrekordjainak beolvasásához az adatbázisnak annak az alkalmazottnak a felhasználónevét kell használnia, aki az űrlapsablonon alapuló űrlapot tölti ki.

Az űrlapsablon adatforrásához hozzáad egy mezőt, amelyben tárolja az alkalmazott felhasználónevét. Lekérdezési adatkapcsolat is létrehozható, amely a mező értékét használja egy lekérdezésben a költségek lekéréséhez.

Ha gondoskodni szeretne arról, hogy a költségelszámolást kitöltő alkalmazott a helyes felhasználónevet használja, a mezőt egy beviteli mezőhöz kötheti. Az ezen az űrlapsablonon alapuló űrlapot létrehozó felhasználó felhasználónevének megjelenítéséhez a következő képletet használja alapértelmezett értékként egy beviteli mezőhöz kötött mezőben:

userName()

Vissza a lap tetejére