Tilføje formler og funktioner i InfoPath 2010
Gælder for
Formler gør det muligt at få mere ud af de regler, du opretter, end ved hjælp af grundlæggende, foruddefinerede regler. Formler bruges f.eks. til at beregne den aktuelle eller fremtidige dato eller endda sammenkæde tekst.
I denne artikel
Dato- og klokkeslætsfunktioner
Oversigt
En formel er et XPath-udtryk (XML Path Language), der består af værdier, felter eller grupper, funktioner og operatorer, der bruges til at beregne og vise andre værdier. Du kan bruge en formel til at oprette en ny værdi for et felt og få vist denne værdi i et kontrolelement, der er bundet til det pågældende felt. Formler kan bruges på følgende måde:
Beregn en matematisk værdi baseret på værdier, du angav, da du udformede skabelonen, eller baseret på værdier, som en bruger angiver, når formularskabelonen udfyldes.
Kør en regel baseret på en værdi, der beregnes ved hjælp af en formel.
Vise skrivebeskyttet tekst, der er beregnet ud fra andre kontrolelementer, eller vise værdien af et andet kontrolelement.
En funktion er et udtryk, der returnerer en værdi baseret på resultaterne af en beregning. De værdier, der bruges i funktionerne, kaldes argumenter. Du kan bruge de almindelige XPath 1.0-funktioner, der er inkluderet i InfoPath, ud over nogle InfoPath-specifikke funktioner. Funktionerne består af følgende tre dele:
- Navn Navnet på funktionen giver normalt et tip om den handling, funktionen skal udføre.
- Returværdi Resultatet af funktionen.
- Argumenter De værdier, der bruges af funktionen til at udføre beregningen.
En funktion kan kræve argumenter for at returnere en værdi. Hvis funktionen kræver argumenter, skal du vide, hvor mange argumenter der kræves, og datatypen for hvert argument. Funktionen fungerer ikke, hvis du angiver det forkerte antal eller typen af påkrævede argumenter.
Følgende illustration viser relationen mellem funktioner, udtryk og formler.
Tilføje et kontrolelement for beregnet værdi
Du kan bruge et beregnet værdikontrolelement til at vise skrivebeskyttet tekst, vise værdien af et andet kontrolelement i formularen og oprette formler, der er baseret på XPath-udtryk. Hvis du f.eks. udvikler en formularskabelon til sporing af udgifter, kan du tilføje et beregnet værdikontrolelement for at få vist de samlede udgifter, der er blevet angivet.
Bemærk
Et kontrolelement til beregnet værdi viser kun data og gemmer dem ikke, så du bør kun bruge et kontrolelement til beregnet værdi, hvis du ikke vil gemme værdien eller henvise til den i en anden formel.
Placer markøren det sted i formularskabelonen, hvor du vil indsætte kontrolelementet.
Klik på kontrolelementet til den beregnede værdi i gruppen Kontrolelementer under fanen Hjem.
Gør et af følgende i dialogboksen Indsæt beregnet værdi :
Hvis du vil skrive tekst eller et XPath-udtryk direkte i det beregnede værdikontrolelement, skal du skrive i feltet XPath .
Hvis du vil indsætte en formel, skal du klikke på Rediger formel
og derefter angive den ønskede formel i tekstfeltet Formel og gøre brug af følgende efter behov:- Hvis du vil indsætte et felt eller en gruppe i formlen, skal du klikke på Indsæt felt eller gruppe, klikke på feltet eller gruppen i dialogboksen Markér et felt eller en gruppe og derefter klikke på OK.
- Hvis du vil indsætte en funktion i formlen, skal du klikke på Indsæt funktion, vælge funktionen i dialogboksen Indsæt funktion og derefter klikke på OK.
Hvis funktionen kræver parametre, skal du vælge funktionen i dialogboksen Indsæt funktion , klikke på OK og derefter dobbeltklikke der, hvor det er angivet, i formelteksten og vælge den ønskede parameter, før du klikker på OK. - Hvis du vil indsætte en værdi eller en matematisk operator i formlen, skal du skrive værdien eller symbolet for den matematiske handling i feltet Formel .
Matematiske operatorer omfatter addering (+), subtraher (-), multiplicer (*) og divider (/).
Matematiske formler afhænger normalt af heltals- eller decimalværdier som argumenter. Hvis du vil undgå tomme værdier i formlen, skal du klikke på Formularindstillinger under fanen Filer og derefter vælge Avanceret og sørge for, at Opfat tomme værdier som nul er markeret.
Føje en formel til et kontrolelement
Selvom du kan bruge et kontrolelement til beregnet værdi til at vise resultaterne af en formel, er du ikke begrænset til at bruge et kontrolelement med beregnet værdi. Du kan også bruge en formel til at angive standardværdien for andre kontrolelementer, f.eks. tekstfelter. Du kan angive standardværdien for et kontrolelement på to måder. Du kan enten bruge en statisk standardværdi ved blot at angive den ønskede værdi i feltet Værdi i dialogboksen Felt- eller Gruppeegenskaber , eller du kan bruge en formel til at angive standardværdien for et felt baseret på andre værdier i formularen. Gør følgende for at angive standardværdien for et felt baseret på en formel:
Vælg det kontrolelement, du vil føje formlen til, og klik derefter på Standardværdi under Kontrolelementværktøjer under fanen Egenskaber i gruppen Egenskaber.
Klik på Indsæt formel
ud for feltet Værdi .Angiv den ønskede formel i tekstfeltet Formel , og gør brug af følgende efter behov:
Hvis du vil indsætte et felt eller en gruppe i formlen, skal du klikke på Indsæt felt eller gruppe, klikke på feltet eller gruppen i dialogboksen Markér et felt eller en gruppe og derefter klikke på OK.
Hvis du vil indsætte en funktion i formlen, skal du klikke på Indsæt funktion, vælge funktionen i dialogboksen Indsæt funktion og derefter klikke på OK.
Hvis funktionen kræver parametre, skal du vælge funktionen i dialogboksen Indsæt funktion , klikke på OK og derefter dobbeltklikke der, hvor det er angivet, i formelteksten og vælge den ønskede parameter, før du klikker på OK.Hvis du vil indsætte en værdi eller en matematisk operator i formlen, skal du skrive værdien eller symbolet for den matematiske handling i feltet Formel .
Matematiske operatorer omfatter addering (+), subtraher (-), multiplicer (*) og divider (/).Tip
Matematiske formler afhænger normalt af heltals- eller decimalværdier som argumenter. Du kan undgå tomme værdier i formlen ved at klikke på Formularindstillinger under fanen Filer og derefter vælge Avanceret. Sørg for, at Opfat tomme værdier som nul er markeret.
Hvis du vil redigere formlen som en XPath-formel, skal du markere afkrydsningsfeltet Rediger XPath (avanceret), hvilket ændrer formlen til XPath-udtryksversionen af formlen.
Hvis du vil kontrollere formlen for den korrekte syntaks, skal du klikke på knappen Bekræft formel . Hvis formlen indeholder fejl:
Klik på Vis detaljer i dialogboksen Microsoft InfoPath for at se fejlene i formlen. Følgende er nogle forslag til løsning af disse fejl:
- Hvis du bruger en funktion i formlen, skal du kontrollere, at du bruger de korrekte argumenter for funktionen. Nogle funktioner kræver felter eller grupper, mens andre funktioner kræver angivne værdier som argumenter.
- Hvis det er nødvendigt, kan du slette og skrive formlen igen for at sikre, at den er skrevet korrekt.
- Klik på OK.
- Hvis du vil opdatere standardværdien for feltet, når de værdier, det er baseret på ændring, skal du markere afkrydsningsfeltet Opdater værdi, når formlen genberegnes . Hvis du gør dette, skal du klikke på OK, og under Kontrolværktøjer på fanen Egenskaber i gruppen Egenskaber skal du klikke på Egenskaber for kontrolelement. Klik på fanen Vis , og markér derefter afkrydsningsfeltet Skrivebeskyttet .
Brug af en formel i en regel
Når du angiver betingelser i validerings-, formaterings- eller handlingsregler , er det muligt at bruge en formel til at styre betingelsen. Det kan du gøre ved at vælge Brug en formel på den tredje rulleliste i dialogboksen Betingelse , når du tildeler en regel til et kontrolelement eller formularskabelonen.
Dato- og klokkeslætsfunktioner
addDays
Lægger dage til en dato eller dato og et klokkeslæt.
Syntaks
addDays(dato;dage)
| Argument | Beskrivelse |
|---|---|
| date | Antallet af dage i det andet argument føjes til datoen i dette argument. Dette argument kan være datatypen Dato (dato) eller Dato og klokkeslæt (dateTime). |
| dage | Det antal dage, du vil føje til datoen i det første argument. Denne parameter skal være af datatypen Helt tal (heltal). Hvis du bruger et negativt tal i dette argument, er returværdien en tidligere dato. |
Eksempel
Du ønsker, at et felt i formularskabelonen skal indeholde en dato 60 dage fra dags dato. Din formularskabelon indeholder et felt med navnet fldToday med dags dato som standardværdi. Hvis du vil beregne den nye dato ved hjælp af denne funktion, skal du bruge følgende formel i det nye datofelt:
addDays(fldToday; 60)
addSeconds
Føjer sekunder til et klokkeslæt eller en dato og et klokkeslæt.
Syntaks
addSeconds(klokkeslæt; sekunder)
| Argument | Beskrivelse |
|---|---|
| tid | En dato- og klokkeslætsværdi eller en klokkeslætsværdi, der enten er en reference til et andet felt i formularskabelonen eller resultatet af en dato- eller klokkeslætsfunktion, f.eks. now() eller today(). Antallet af sekunder i det andet argument føjes til klokkeslæt i dette argument. Dette argument kan være datatypen Dato (dato) eller Dato og klokkeslæt (dateTime). Hvis det er datatypen Tid, returneres datatypen Tid. Hvis det er datatypen Dato, returneres datatypen Dato og klokkeslæt. |
| Sekunder | Det antal sekunder, du vil føje til dato- og klokkeslætsværdien eller klokkeslætsværdien i det første argument. Feltet i denne parameter skal være datatypen Heltal (heltal). Hvis du bruger et negativt tal i dette argument, er returværdien enten en tidligere dato og et tidligere klokkeslæt eller et tidligere klokkeslæt. |
Eksempel
Din formularskabelon indeholder et felt med navnet fldCurrentTime, der bruger det aktuelle klokkeslæt som standardværdi og et andet felt, der bruger funktionen addSeconds i en formel til at vise tiden 120 sekunder fra det aktuelle klokkeslæt. Hvis du vil beregne den nye tidsværdi ved hjælp af denne funktion, skal du angive følgende formel i det andet felt:
addSeconds(fldCurrentTime, 120)
Nwo
Returnerer den aktuelle systemdato og det aktuelle klokkeslæt.
Hvis du kun vil returnere dags dato, skal du bruge funktionen i dag.
Syntaks
nu()
Denne funktion bruger ikke argumenter.
Eksempel
Hvis du vil have dato og klokkeslæt for oprettelse af en formular, der er baseret på formularskabelonen, skal du bruge følgende formel i et felt:
nu()
i dag
Returnerer den aktuelle systemdato. For datofelter på SharePoint-lister skal du bruge funktionen now().
Hvis du vil returnere både dato og klokkeslæt, skal du bruge funktionen nu.
Syntaks
i dag()
Denne funktion bruger ikke argumenter.
Eksempel
Hvis du vil hente den dato, hvor en formular, der er baseret på din formularskabelon, blev oprettet, skal du bruge følgende formel i et felt:
i dag()
Feltfunktioner
tæl
Tæller antallet af forekomster af et felt eller en gruppe.
Syntaks
count(field)
| Argument | Beskrivelse |
|---|---|
| felt | Navnet på det gentagne felt eller den gentagende gruppe, der skal tælles, i formularen. |
Eksempel
Du designer en formularskabelon, hvis formularer skal bruges af leverandører til at rapportere deres produkter og lager. Formularskabelonen indeholder en gentagende gruppe med navnet grpProduct for de produkter, der sendes af leverandøren. Hver gruppe indeholder oplysninger om produktet og dets lagerniveau. Når en leverandør tilføjer et produkt i en formular, der er baseret på denne formularskabelon, opretter InfoPath en ny forekomst af den gentagende gruppe.
Din formularskabelon har et felt i datakilden, der indeholder antallet af produkter, der sendes af leverandøren. Hvis du automatisk vil tælle antallet af produkter, der sendes af leverandøren, hvilket er antallet af forekomster af den gentagende gruppe grpProduct, skal du bruge følgende formel i feltet Antal produkter:
count(grpProduct)
Sidste
Returnerer den sidste forekomst af et gentaget felt eller en gentaget gruppe.
Bemærk
Hvis du designer en browserkompatibel formularskabelon, vises denne funktion ikke på listen Funktioner i dialogboksen Indsæt funktion.
Syntaks
field_name[last()]
Selvom selve funktionen ikke har nogen påkrævede parametre, kan du bruge denne funktion som prædikat for et angivet feltnavn.
Eksempel
Du designer en formularskabelon, som leverandører udfylder for at rapportere deres produktbeholdninger. Formularskabelonen har en dataforbindelse til en webtjeneste, der har en metode, der kontrollerer, om produktoplysningerne for alle produkter fra en leverandør er fuldført. Metoden kræver det sidste produkt på listen over produkter, der blev indsendt af leverandøren.
Produktoplysningerne gemmes i forskellige felter i en gentaget gruppe, der hedder grpProduct. Når en leverandør føjer et produkt til formularen, tilføjer InfoPath en ny gentaget gruppe kaldet grpProduct. Hvis leverandøren rapporterer om flere produkter, indeholder datakilden for formularen flere forekomster af den gentagede grpProduct-gruppe.
For at sikre, at du sender de korrekte oplysninger til webtjenesten, skal du tilføje et felt, der indeholder oplysninger om det sidste produkt i gruppen af produkter fra leverandøren. Hvis du vil konfigurere dette felt til automatisk at hente det sidste produkt, skal du bruge følgende formel som standardværdi for det sidste produktfelt:
grpProduct[last()]
lokalt navn
Returnerer det lokale navn på et felt eller en gruppe.
Bemærk
- Hvis argumentet er et gentaget felt eller en gentaget gruppe, returnerer funktionen værdien af det første gentagende felt eller den første gentagende gruppe.
- Når en bruger udfylder en webbrowserformular, sender en formel, der bruger denne funktion, formulardata til serveren for at få returværdien for denne funktion.
Syntaks
local-name(felt)
| Argument | Beskrivelse |
|---|---|
| felt | Navnet på det felt, hvis lokale navneattribut du vil returnere. |
Eksempel
Du designer en formularskabelon, der bruges til tilladelsesprogrammer. Formularskabelonen har en dataforbindelse til en metode i en webtjeneste. Denne metode kræver værdien af lokalnavnattributten i feltet for entreprenørens licensnummer. Navnet på feltet licensnummer er fldLicenseNumber.
Du har et felt, der indeholder værdien af attributten lokalt navn. Hvis du automatisk vil hente værdien af attributten lokalt navn i feltet licensnummer, skal du bruge følgende formel som standardværdi for det felt, der skal indeholde værdien af attributten lokalt navn:
local-name(fldLicenseNumber)
navn
Returnerer et felts eller en gruppes navn og navneområdepræfiks.
Bemærk
- Hvis argumentet er et gentaget felt eller en gentaget gruppe, returnerer funktionen navnet og præfikset for det første gentagende felt eller den første gentagende gruppe i formularen.
- Når en bruger udfylder en formular baseret på en browseraktiveret formularskabelon, sender en formel, der bruger denne funktion, formulardata til serveren for at få returværdien for denne funktion.
Syntaks
name(field)
| Argument | Beskrivelse |
|---|---|
| felt | Navnet på det felt, hvis navneområdepræfiks og navn du vil returnere. |
Eksempel
Du designer en formularskabelon, der bruges til tilladelsesprogrammer. Formularskabelonen har en dataforbindelse til en metode i en webtjeneste. Denne metode kræver navneattributten i feltet for entreprenørens licensnummer. Navnet på feltet licensnummer er fldLicenseNumber.
Du har et felt, der skal indeholde værdien af navneattributten. For automatisk at hente værdien af navneattributten skal du bruge følgende formel som standardværdi for feltet:
name(fldLicenseNumber)
namespace-uri
Returnerer det fulde navneområde for et felt eller en gruppe.
Bemærk
- Hvis argumentet er et sæt felter eller grupper, returnerer funktionen navneområdet for det første felt eller den første gruppe i formularen.
- Når en bruger udfylder en webbrowserformular, sender en formel, der bruger denne funktion, formulardata til serveren for at få returværdien for denne funktion.
Syntaks
namespace-uri(felt)
| Argument | Beskrivelse |
|---|---|
| felt | Navnet på det felt, hvis navneområde-URI du vil hente. |
Eksempel
Du designer en formularskabelon, der bruges til tilladelsesprogrammer. Formularskabelonen sender data til en webtjeneste. For at behandle dataene fra en formular, der er baseret på din formularskabelon, kræver webtjenesten navneområdets URI fra et bestemt elementfelt i datakilden. Det felt i formularskabelonen, der indeholder navneområdets URI-data, kaldes fldComplete.
Du har et felt, der skal indeholde navneområde-URI'en for elementfeltet. Hvis du automatisk vil hente navneområde-URI'en, skal du bruge følgende formel som standardværdi for det felt, der skal indeholde navneområdets URI:
namespace-uri(fldComplete)
Position
Returnerer indekset (eller placeringen) for et felt eller en gruppe i forhold til de andre felter eller grupper i den samme overordnede gruppe.
Bemærk
Denne funktion er ikke tilgængelig i webbrowserformularskabeloner.
Syntaks
position()
Eksempel
Du designer en formularskabelon, som leverandører udfylder for at rapportere deres produktbeholdninger. Produktoplysningerne gemmes i felter i en gentaget gruppe. Den gentagende gruppe er bundet til en gentaget tabel, som giver en leverandør mulighed for at tilføje nye eller redigere eksisterende produktoplysninger.
I den første kolonne i den gentagende tabel skal rækkenummeret vises i et tekstfelt. Hvis rækkenummeret automatisk skal vises, når leverandøren føjer et nyt produkt til den gentagende tabel, skal du bruge følgende formel som standardværdi for tekstfeltet:
position()
Matematiske funktioner
Formler, der indeholder matematiske funktioner, kræver normalt argumenter, der er heltal eller decimalværdier. Hvis du vil sikre, at argumenterne er heltals- eller decimalværdier i stedet for null-værdier, skal du klikke påAvanceredeindstillinger for>filformular> og derefter sørge for, at afkrydsningsfeltet Opfat tomme værdier som nul er markeret.
Avg
Beregner gennemsnittet af de numeriske værdier i et felt, der er i en gentaget gruppe.
Bemærk
Det gentagende felt skal være en numerisk datatype og medtages i en gruppe.
Syntaks
avg(felt)
| Argument | Beskrivelse |
|---|---|
| felt | Navnene på det gentagne felt i den gruppe, du vil beregne gennemsnitsværdien for. |
Eksempel
Du designer en formularskabelon, hvis formularer skal bruges af leverandører til at rapportere deres produkter og lagerbeholdninger. Formularskabelonen indeholder et gentagende felt med navnet fldPrice, som findes i en gentaget gruppe, der indeholder data om hvert produkt, der sælges af leverandøren. Gruppen er bundet til et gentaget tabelkontrolelement.
Du har et felt i formularskabelonen, der indeholder gennemsnitsprisen for alle de produkter, der sælges af den pågældende leverandør. Hvis du vil beregne gennemsnitsprisen, skal du bruge følgende formel i feltet til gennemsnitsprisen:
avg(fldPrice)
Boolesk
Returnerer sand, hvis der findes et felt eller en gruppe. Ellers returneres falsk.
Dette returnerer sand, selvom et kontrolelement, der er knyttet til feltet, er blevet slettet, men feltet stadig findes.
Syntaks
boolesk(felt)
| Argument | Beskrivelse |
|---|---|
| felt | Et gentaget felt eller en gentaget gruppe, der skal kontrolleres af denne funktion. |
Eksempel
Du designer en formularskabelon, som leverandører skal bruge til at rapportere deres produktbeholdninger. Produktoplysningerne gemmes i forskellige felter i en gentaget gruppe, der hedder grpProduct. Hver gentaget gruppe indeholder felter, der indeholder oplysninger om hvert produkt. Hvis leverandøren indeholder oplysninger om syv produkter, indeholder formularen syv grupper, der gentages.
Den gentagende gruppe er bundet til et gentagende tabelkontrolelement, som gør det muligt for leverandøren at tilføje nye eller redigere eksisterende produktoplysninger. Leverandøren kan tilføje eller slette rækker fra den gentagende tabel.
Du vil have vist en dialogboks, hvis brugeren fjerner alle rækkerne i den gentagende tabel. Du føjer et felt til datakilden, der indeholder ordet "sand", hvis det gentagende tabelkontrolelement har mindst én række og ordet "falsk", hvis det gentagende tabelkontrolelement ikke har nogen rækker.
Du konfigurerer en regel i det gentagende tabelkontrolelement til at vise en dialogboks, hvis værdien i feltet er falsk. Hvis du automatisk vil afgøre, om den gentagende tabel indeholder mindst én række, skal du bruge følgende formel som standardværdi for feltet indeholder ordet "sand" eller "falsk":
boolesk(grpProduct)
Loft
Runder et tal op til nærmeste heltal.
Syntaks
loft(tal)
| Argument | Beskrivelse |
|---|---|
| antal | Navnet på feltet, som har en numerisk værdi. |
Eksempel
Du designer en formularskabelon til udgiftsrapporter for din virksomhed. Udgifterne sendes til en webtjeneste, der har en parameter, der kun accepterer heltal. Det udgiftsbeløb, der sendes til denne parameter, skal afrundes til den højere heltalsværdi. Udgiftsbeløbet gemmes i et felt, der hedder fldExpenseAmount, og heltalsværdien gemmes i et andet felt. Hvis du vil beregne den højere heltalsværdi, skal du bruge følgende formel som standardværdi for det andet felt:
loft(fldExpenseAmount)
Hvis en bruger opretter en formular baseret på formularskabelonen og skriver 145,87 i feltet fldExpenseAmount, bliver værdien i det felt, der indeholder formlen, 146.
Eval
Returnerer værdierne i et felt eller en gruppe. Det andet argument definerer det udtryk, der skal beregnes for feltet eller gruppen. Normalt er funktionen eval indlejret i en funktion, der fungerer på et felt eller en gruppe, f.eks. summen eller gns.
Syntaks
eval(felt, udtryk)
| Argument | Beskrivelse |
|---|---|
| felt | Navnet på det felt eller den gruppe, hvis værdier evalueres af udtrykket i det andet argument. |
| udtryk | Det udtryk, der skal anvendes på det første argument. Udtrykket kan enten være en XPath-funktion eller et udtryk, der er omsluttet af dobbelte anførselstegn (" "). |
Eksempel
Du designer en formularskabelon til udgiftsrapporter for din virksomhed. Formularskabelonen indeholder et felt med navnet fldTotal, der indeholder et udgiftsbeløb. FldTotal-feltet er en del af en gentaget gruppe med navnet grpExpenses. Et andet felt er bundet til et tekstfelt, der indeholder summen af alle udgifter. Hvis du vil have vist summen af alle udgifter, når brugeren angiver et udgiftsbeløb, skal du bruge følgende formel i feltet Samlede udgifter:
eval(grpExpenses,sum(fldTotal))
false
Returnerer falsk.
Syntaks
false()
Denne funktion bruger ikke argumenter.
Eksempel
Du designer en formularskabelon, hvis formularer skal bruges af entreprenører til at ansøge om byggetilladelser. Formularskabelonen har to sektioner: en sektion til kontaktoplysninger og en anden sektion til oplysninger om byggetilladelsen. Når du udfylder denne formular, skal entreprenører udfylde sektionen med kontaktoplysninger fuldstændigt, før de kan udfylde afsnittet om byggetilladelse.
For at gøre dette skal du oprette en regel til at angive værdien af et boolesk felt til falsk, hvis et af felterne i sektionen kontaktoplysninger er tomt. Et boolesk værdifelt kan have enten en boolesk sand værdi eller en boolesk falsk værdi. Du kan også konfigurere den betingede formatering til at skjule det sektionskontrolelement, der indeholder oplysninger om bygningstilladelsen, hvis værdien i det booleske felt er falsk.
Hvis du vil skjule det sektionskontrolelement, der indeholder felterne til oplysningerne om byggetilladelsen, skal du konfigurere en regel til at køre denne funktion i feltet Boolesk, hvis et af felterne i sektionen med kontaktoplysninger er tomt.
Gulvet
Nedrunder et tal til det nærmeste heltal.
Syntaks
etage(tal)
| Argument | Beskrivelse |
|---|---|
| antal | Navnet på feltet, som har en numerisk værdi. |
Eksempel
Du designer en formularskabelon til udgiftsrapporter for din virksomhed. Udgifterne sendes til en webtjeneste, der bruger en parameter, der kun accepterer heltal. Det udgiftsbeløb, der sendes til denne parameter, skal afrundes til det nederste heltal. Udgiftsbeløbet gemmes i et felt, der hedder fldExpenseAmount, og heltalsværdien gemmes i et andet felt. Hvis du vil beregne det nederste heltal, skal du bruge følgende formel som standardværdi for det andet felt:
gulv(fldExpenseAmount)
Maks
Returnerer det største tal i et felt eller en gruppe.
Syntaks
max(field)
| Argument | Beskrivelse |
|---|---|
| felt | Et gentaget felt i en gruppe eller et felt i en gentaget gruppe, du vil finde den højeste værdi for. |
Eksempel
Du designer en formularskabelon, hvis formularer skal bruges af leverandører til at rapportere deres produktbeholdninger. Formularskabelonen indeholder en gentaget gruppe, der indeholder flere felter, der indeholder data om leverandørernes produkter. Et felt med navnet fldPrice i den gentagende gruppe indeholder prisen på et produkt.
Et andet felt i datakilden til formularskabelonen indeholder den højeste pris for alle de produkter, der sælges af den pågældende leverandør. Hvis du vil returnere den højeste pris, skal du bruge følgende formel i det højeste prisfelt:
max(fldPrice)
Min
Returnerer det mindste tal i et felt eller en gruppe.
Syntaks
min(felt)
| Argument | Beskrivelse |
|---|---|
| felt | Et gentaget felt i en gruppe eller et felt i en gentaget gruppe, du vil finde den højeste værdi for. |
Eksempel
Du designer en formularskabelon, hvis formularer skal bruges af leverandører til at rapportere deres produktbeholdninger. Formularskabelonen indeholder en gentaget gruppe, der indeholder flere felter, der indeholder data om leverandørernes produkter. Et felt med navnet fldPrice i den gentagende gruppe indeholder prisen på et produkt.
Et andet felt i datakilden til formularskabelonen indeholder den laveste pris på alle de produkter, der sælges af den pågældende leverandør. Hvis du vil returnere den laveste pris, skal du bruge følgende formel i feltet laveste pris:
min(fldPrice)
ikke
Returnerer sand, hvis en boolesk værdi er falsk eller null. Returnerer falsk, hvis den booleske værdi er sand eller ikke null.
Syntaks
not(boolean_value)
| Argument | Beskrivelse |
|---|---|
| boolean_value | Et felt med en boolesk datatype. |
Eksempel
Du designer en formularskabelon, hvis formularer skal bruges af entreprenører til at ansøge om byggetilladelser. Formularskabelonen indeholder én sektion til kontaktoplysninger og en anden sektion til oplysninger, der er relateret til byggetilladelsen. Når du udfylder denne formular, skal entreprenører udfylde sektionen med kontaktoplysninger fuldstændigt, før de kan udfylde afsnittet om byggetilladelse.
For at gøre dette skal du oprette en regel, der angiver værdien af et boolesk felt til falsk, hvis et af felterne i sektionen kontaktoplysninger efterlades tomt. Et boolesk værdifelt kan have enten den booleske værdi sand eller den booleske værdi falsk. Du kan derefter bruge den samme formel til at skjule det sektionskontrolelement, der indeholder oplysninger om bygningstilladelse, hvis den booleske feltværdi er falsk. Hvis du vil angive denne regel, skal du bruge følgende formel til at angive det booleske felt til falsk:
not(true())
number
Konverterer en værdi til et tal.
Funktionen returnerer NaN, hvis værdien i argumentet ikke kan konverteres til et tal.
Syntaks
tal(værdi)
ArgumentDescription
værdiFeltet med en værdi, der skal konverteres til et tal.
Eksempel
Du designer en formularskabelon, hvis formularer skal bruges af entreprenører til at ansøge om byggetilladelser. Formularskabelonen indeholder en sektion, hvor entreprenøren kan angive sin forretningsadresse. For at bekræfte, at entreprenøren indtaster en gyldig adresse, skal du bruge en dataforbindelse til en webtjeneste, der kan bekræfte adressen. Hvis adressen er bekræftet, kan entreprenøren indsende formularen til en SQL-database. SQL-databasen bruger et tekstfelt til både adressenummeret og gadenavnet. Webtjenesten kræver, at adressenummeret er en numerisk datatype, og at gadenavnet er en tekstdatatype.
Hvis du vil sende data til både webtjenesten og SQL-databasen, skal adressen gemmes som to forskellige datatyper:
- Hvis du vil sende adressen til webtjenesten, skal adressenummeret være en numerisk datatype, og gadenavnet skal være en tekstdatatype.
- Hvis du vil sende adressen til SQL-databasen, skal både adressenummeret og gadenavnet være en tekstdatatype.
Du ønsker også, at entreprenøren kun indtaster sin adresse én gang. For at konvertere adressen til de korrekte datatyper og sikre, at entreprenøren kun indtaster sin adresse én gang, indeholder formularskabelonen et felt med navnet fldAddressNumber til angivelse af adressenummeret og et andet felt til angivelse af gadenavnet. Begge felter er konfigureret som tekstdatatyper.
Hvis du vil sende adressenummeret til webtjenesten, skal du konvertere dataene i feltet fldAddressNumber (gemt som en tekstdatatype) til en numerisk datatype. Værdien af det adressenummer, der konverteres til en numerisk datatype, gemmes i et andet felt, der er konfigureret til at gemme numeriske datatyper.
Hvis du vil konvertere adressenummeret fra en tekstdatatype til en numerisk datatype, skal du bruge følgende formel som standardværdi for feltet fldAddressNumber:
tal(fldAddressNumber)
nz
Returnerer et felt eller en gruppe, hvor alle tomme felter er erstattet med nul (0).
Syntaks
nz(felt)
| Argument | Beskrivelse |
|---|---|
| felt | Det felt, du vil kontrollere for en værdi. |
Eksempel
Du designer en formularskabelon, som leverandører udfylder for at rapportere deres produktbeholdninger. Leverandøren sender deres produktbeholdninger til en webtjeneste via en formular, der er baseret på din formularskabelon. Webtjenestens metode kræver, at alle elementer, der indeholder numeriske data, har en numerisk værdi. Webtjenesten afviser en formular, der indeholder et tomt numerisk element.
Formularskabelonen indeholder et felt med navnet fldTilgængelighed, der indeholder et tal, der svarer til leverandørens mulighed for at levere dette produkt. Leverandøren kan angive et nummer i dette felt. For at sikre, at leverandøren kan sende sin formular baseret på din formularskabelon til webtjenesten og automatisk indstille værdien i feltet til nul, hvis leverandøren ikke angiver et tal, skal du bruge følgende formel som standardværdi for dette felt:
nz(fldTilgængelighed)
Runde
Afrunder et tal til nærmeste heltal.
Hvis den ikke-heltalsværdi er nøjagtigt halvvejs mellem to afrundede heltalsværdier, er returværdien den næststørste heltalsværdi.
Syntaks
rund(tal)
| Argument | Beskrivelse |
|---|---|
| antal | Det felt, der indeholder det tal, der skal afrundes ved hjælp af denne formel. |
Eksempel
Du designer en formularskabelon, hvis formularer skal bruges af leverandører til at rapportere deres produktbeholdninger. Formularskabelonen indeholder en gentaget gruppe, der indeholder flere felter, der indeholder data om leverandørernes produkter. Et af felterne, kaldet fldPrice, i den gentagende gruppe indeholder prisen på et produkt.
Formularskabelonen har en dataforbindelse til afsendelse til en webtjeneste. Webtjenestemetoden kræver, at hver pris afrundes til en heltalsværdi. Hvis du vil sende den relevante værdi til webtjenestemetoden, skal du føje et gentaget felt til datakilden. I dette felt bruges følgende formel til at afrunde kursen i feltet fldPrice til en heltalsværdi:
round(fldPrice)
Summen
Returnerer summen af alle felter i et felt eller en gruppe. Hvert felt konverteres først til en talværdi.
Syntaks
sum(felt)
| Argument | Beskrivelse |
|---|---|
| felt | Navnet på et felt i en gentaget gruppe eller et gentaget felt i en gruppe, hvis værdier tilføjes. Hvis du vil tilføje felter fra to forskellige grupper, skal du bruge foreningsoperatoren (|) til at adskille argumenterne. Eksempel: sum( feltnavn 1 | feltnavn 2). |
Eksempel
Du designer en formularskabelon til en udgiftsrapport. Formularskabelonen indeholder en gruppe, der indeholder udgiftsvarer. Mængden af hvert element gemmes i et felt, der kaldes fldExpenseAmount. Gruppen er bundet til en gentaget tabel, der viser hvert udgiftselement som en række. Formularskabelonen indeholder et tekstfeltkontrolelement, der viser de samlede udgifter. Tekstfeltkontrolelementet indeholder følgende formel for at vise de samlede udgifter:
sum(fldExpenseAmount)
true
Returnerer sand.
Syntaks
sand()
Denne funktion bruger ikke argumenter.
Eksempel
Du designer en formularskabelon, hvis formularer skal bruges af entreprenører til at ansøge om byggetilladelser. Formularskabelonen indeholder én sektion til kontaktoplysninger og en anden sektion til oplysninger, der er relateret til byggetilladelsen. Når du udfylder denne formular, skal entreprenører udfylde sektionen med kontaktoplysninger fuldstændigt, før de kan udfylde afsnittet om byggetilladelse.
For at gøre dette skal du oprette en regel, der angiver værdien af et boolesk felt til sand, hvis alle felterne i sektionen med kontaktoplysninger indeholder data. Et boolesk værdifelt kan have enten den booleske værdi sand eller falsk. Hvis værdien i det booleske felt er sand, vises det sektionskontrolelement, der indeholder oplysningerne om bygningstilladelsen.
Hvis du vil have vist det sektionskontrolelement, der indeholder oplysningerne om byggetilladelsen, skal du konfigurere en regel til at køre denne funktion i feltet Boolesk, hvis alle felterne i sektionen kontaktoplysninger indeholder data.
Tekstfunktioner
Concat
Kombinerer to eller flere felter med tekststrenge til én tekststreng.
Syntaks
sammenkædning(tekst1; tekst2; ...)
| Argument | Beskrivelse |
|---|---|
| tekst1 | Et felt, der indeholder tekst, der skal kombineres til en enkelt tekstlinje med teksten i argument2. |
| tekst2; ... | Ore or more additional fields that contains text to be combined with the previous field. Adskil tekstfelter med et komma. |
Eksempel
Du designer en formularskabelon, der indeholder et felt med navnet fldFirstName og et felt med navnet fldLastName. Føj følgende formel til et tredje felt for at få den til at indeholde teksten "Denne formular blev udfyldt med <fornavn><> efternavn.":
concat("Denne formular blev udfyldt med ", fldFirstName, " ", fldLastName, ".")
Bemærk
Al faktisk tekst, der indtastes som et tekstargument, herunder mellemrum eller tegnsætning, skal indsættes i anførselstegn (").
Indeholder
Returnerer sand, hvis det første felt eller den første tekststreng indeholder det andet. Ellers returneres falsk.
Syntaks
indeholder(within_text, find_text)
| Argument | Beskrivelse |
|---|---|
| i_tekst | Det felt, der indeholder den tekst, der skal søges i. |
| find_tekst | Det felt, der indeholder den tekst eller tekst, der er omsluttet af dobbelte anførselstegn (" ") til at søge efter i det første argument. |
Eksempel
Du designer en formularskabelon med tre tekstfelter. Den første giver en bruger mulighed for at angive en lang tekstmængde i det første tekstkontrolelement, kaldet fldText. Den anden giver en bruger mulighed for at angive et kort tekstsegment og kaldes fldFindText. Det tredje tekstfelt sammenligner det andet tekstfelt med det første og angiver, om værdien i det andet felt findes i det første felt, og viser resultatet. Den ville have følgende formel som standardværdi:
contains(fldText,fldFindText)
normaliser mellemrum
Fjerner mellemrum fra en tekststreng.
Bemærk
Dette fjerner eventuelle foranstillede, efterstillede og gentagne tomme mellemrum fra et felt med en tekstdatatype.
Syntaks
normaliser-mellemrum(tekst)
| Argument | Beskrivelse |
|---|---|
| text | Den tekst, der indeholder de foranstillede, efterstillede eller gentagne tomme mellemrum, du vil fjerne. Sæt teksten i dobbelte anførselstegn (" "). |
Eksempel
Du designer en formularskabelon, der indeholder et felt med navnet fldText (som er bundet til et tekstfeltkontrolelement). Hvis du vil normalisere tekst, der er angivet i det første felt, og vise, hvad værdien i det første felt er uden ekstra blanktegn, skal du tilføje et andet felt med følgende formel som standardværdi:
normaliser-mellemrum(fldText)
starter med
Returnerer sand, hvis det første felt eller den første tekststreng starter med det andet. Ellers returneres falsk.
Syntaks
starter med(tekst, start_text)
| Argument | Beskrivelse |
|---|---|
| text | Navnet på det felt, der indeholder den tekst, der skal søges i. Adskil argumenter med et komma. |
| start_text | Den tekst, der skal søges i i starten af det felt, der er angivet i det første argument. Dette argument kan være enten et felt eller tekst, der er omsluttet af dobbelte anførselstegn (" "). |
Eksempel
Du designer en formularskabelon med tre tekstfelter. Den første giver en bruger mulighed for at angive en lang tekstmængde i det første tekstkontrolelement, kaldet fldText. Den anden giver en bruger mulighed for at angive et kort tekstsegment og kaldes fldFindText. Det tredje tekstfelt sammenligner det andet tekstfelt med det første og angiver, om værdien i det første felt starter med værdien i det andet felt og viser resultatet. Den ville have følgende formel som standardværdi:
starter med(fldText, fldFindText)
streng
Konverterer en værdi til en tekststreng.
Syntaks
string(value)
| Argument | Beskrivelse |
|---|---|
| værdi | Det felt, der indeholder den værdi, der skal konverteres til tekst. |
Eksempel
Du designer en formularskabelon, hvis formularer skal bruges af entreprenører til at ansøge om byggetilladelser. Formularskabelonen indeholder en sektion, hvor entreprenøren kan angive sin forretningsadresse. For at bekræfte, at entreprenøren indtaster en gyldig adresse, har formularskabelonen en dataforbindelse til en webtjeneste, der kan bekræfte adressen. Hvis adressen er bekræftet, kan entreprenøren indsende formularen til en SQL-database. SQL-databasen bruger et tekstfelt til postadressen. Webtjenesten kræver, at adressenummeret er en numerisk datatype, og at gadenavnet er en tekstdatatype.
Hvis du vil sende data til både webtjenesten og SQL-databasen, skal adressen gemmes i to forskellige datatyper:
- Hvis du vil sende adressen til webtjenesten, skal adressenummeret være af en numerisk datatype.
- Hvis du vil sende adressen til SQL-databasen, skal både adressenummeret og gadenavnet være en tekstdatatype.
Du ønsker også, at entreprenøren kun indtaster sin adresse én gang. For at konvertere adressen til de korrekte datatyper og sikre, at entreprenøren kun indtaster sin adresse én gang, indeholder formularen et felt til angivelse af det adressenummer, der hedder fldAddressNumber, og et andet felt til angivelse af gadenavnet. Feltet fldAddressNumber er en numerisk datatype, og feltet gadenavn er en tekstdatatype.
Hvis du vil sende den komplette adresse (både adressenummeret og gadenavnet) til SQL-databasen, skal du kombinere værdierne i feltet fldAddressNumber og feltet gadenavn til én værdi, der er en tekstdatatype. Du skal først konvertere de numeriske data i feltet fldAddressNumber, som gemmer dataene som en numerisk datatype, til en tekstdatatype. Du føjer et felt til datakilden, der indeholder hele adressen som en tekstdatatype.
Hvis du vil konvertere tekstdataene i feltet fldAddressNumber til en tekstdatatype, så du kan bruge webtjenesten, skal du konfigurere et andet felt, der indeholder adressenummeret som en tekstdatatype. Hvis du vil konvertere adressenummeret fra en numerisk datatype til en tekstdatatype, skal du bruge følgende formel som standardværdi for dette felt:
streng(fldAddressNumber)
strenglængde
Returnerer antallet af tegn i en tekststreng.
Syntaks
strenglængde(tekst)
| Argument | Beskrivelse |
|---|---|
| text | Det felt, hvis værdi er den tekst, du vil tælle. |
Eksempel
Du designer en formularskabelon, der indeholder et felt med navnet fldText, som er bundet til et tekstfeltkontrolelement. Formularskabelonen indeholder et andet felt, der bruges til at tælle antallet af tegn, der er indtastet i den første formular. For at gøre dette skal det andet felt indeholde følgende formel som standardværdi:
string-length(fldText)
Understreng
Returnerer en bestemt del af en tekststreng. Det andet argument angiver startpositionen, og det tredje argument angiver, hvor mange tegn der skal medtages.
Syntaks
understreng(tekst, start_position, char_count)
| Argument | Beskrivelse |
|---|---|
| text | Et felt med en tekstdatatype eller tekst, der er omsluttet af dobbelte anførselstegn (" "). Funktionen søger i denne tekst og returnerer alle tegn fra den position, der er angivet i det andet argument, op til det antal tegn, der er angivet i det tredje argument eller til slutningen af teksten, alt efter hvad der sker først. |
| start_position | Startpositionen for den tekst, der skal hentes fra det første argument. Dette argument skal være et helt tal eller en reference til et felt, der er konfigureret til at gemme heltalsdatatyper. |
| char_count | Det antal tegn, der skal hentes, startende fra den startposition, der er angivet i det andet argument. Dette argument skal være et helt tal eller en reference til et felt, der er konfigureret til at gemme heltalsdatatyper. |
Eksempel
Du designer en formularskabelon, der indeholder følgende felter og kontrolelementer:
- Et felt med navnet fldText, der er bundet til et tekstfeltkontrolelement. Dette felt indeholder den tekst, som funktionen søger efter.
- Et felt med navnet fldStartingPosition, der er bundet til et tekstfeltkontrolelement. Dette felt er konfigureret som en datatype med hele tal. Feltet indeholder funktionens startposition.
- Et felt med navnet fldNumberOfCharacters, der er bundet til et tekstfeltkontrolelement. Dette felt er konfigureret som en datatype med hele tal. Feltet indeholder det antal tegn, som funktionen returnerer.
- Et tekstfeltkontrolelement, der viser resultaterne af funktionen. Tekstfeltkontrolelementet indeholder følgende formel:
understreng(fldText, fldStartingPosition, fldNumberOfCharacters)
Hvis en bruger angiver "Denne formular blev oprettet ud fra en InfoPath-formularskabelon". i det første tekstfelt efterfulgt af 4 i det andet og 16 i det tredje, så ville det fjerde tekstfelt indeholde "s form was creat".
understreng-efter
Returnerer teksten i den første tekststreng, der følger efter den første forekomst af den anden tekststreng.
Syntaks
understreng efter(tekst, find_text)
| Argument | Beskrivelse |
|---|---|
| text | Et felt med en tekstdatatype eller tekst, der er omsluttet af dobbelte anførselstegn (" "). Funktionen søger i teksten i dette argument og returnerer derefter alle de tegn, der følger efter teksten i det andet argument. |
| find_tekst | Den tekst, der skal søges i teksten i det første argument. Teksten kan enten være værdien i feltet med en tekstdatatype eller tekst, der er omsluttet af dobbelte anførselstegn (" "). Funktionen søger efter teksten i det første argument for denne tekst og returnerer derefter alle de tegn, der følger efter teksten i dette argument. |
Eksempel
Du designer en formularskabelon, der indeholder følgende felter og kontrolelementer:
- Et felt med navnet fldText, der er bundet til et tekstfeltkontrolelement. Dette felt indeholder den tekst, som funktionen søger efter.
- Et felt med navnet fldSubstringText, der er bundet til et tekstfeltkontrolelement. Dette felt indeholder den tekst, der er det andet argument i funktionen.
- Et tekstfeltkontrolelement, der viser resultaterne af funktionen. Tekstfeltkontrolelementet indeholder følgende formel:
understreng-efter(fldText, fldSubstringText)
Hvis en bruger angiver "Denne formular blev oprettet ud fra en InfoPath-formularskabelon". i fldText-feltet og "InfoPath" i det andet, så ville det tredje tekstfeltelement indeholde "formularskabelon".
understreng-før
Returnerer teksten i den første tekststreng, der kommer før den første forekomst af den anden tekststreng.
Syntaks
understreng-før(tekst, find_text)
| Argument | Beskrivelse |
|---|---|
| text | Et felt med en tekstdatatype eller tekst, der er omsluttet af dobbelte anførselstegn (" "). Funktionen søger i teksten i dette argument og returnerer derefter alle tegn før teksten i det andet argument, find_text. |
| find_tekst | Den værdi, der skal søges efter i tekstargumentet. Denne værdi kan enten være værdien i et felt med en tekstdatatype eller tekst, der er omsluttet af dobbelte anførselstegn (" "). Funktionen søger efter teksten i det første argument (tekst) efter denne tekst og returnerer derefter alle tegn før teksten i dette argument. |
Eksempel
Du designer en formularskabelon med følgende felter og kontrolelementer:
- Et felt med navnet fldText, der er bundet til et tekstfeltkontrolelement. Dette felt indeholder den tekst, som funktionen søger efter.
- Et felt med navnet fldSubstringText, der er bundet til et tekstfeltkontrolelement. Dette felt indeholder den tekst, der er det andet argument i funktionen.
- Aa-tekstfeltkontrolelement, der viser resultaterne af funktionen. Tekstfeltkontrolelementet indeholder følgende formel:
understreng-før(fldText, fldSubstringText)
Hvis en bruger angiver "Denne formular blev oprettet ud fra en InfoPath-formularskabelon". i fldText-feltet og "oprettet" i det andet, så ville det tredje tekstfeltelement indeholde "Denne formular var".
oversæt
Returnerer den første tekststreng med hvert tegn i den anden tekststreng erstattet af tegnet på den tilsvarende position i den tredje tekststreng.
Syntaks
oversæt(tekst;find_chars;replace_chars)
| Argument | Beskrivelse |
|---|---|
| text | Navnet på det felt, der indeholder den tekst, hvis tegn skal erstattes. Adskil argumenter med et komma. |
| find_chars | Et tegn eller værdien af et felt med en tekstdatatype, der erstattes af tegnene i det tredje argument. Adskil argumenter med et komma. |
| replace_chars | Et tegn eller værdien af et felt med en tekstdatatype, der erstatter alle forekomster af tegnet i det andet argument. |
Eksempel
Du designer en formularskabelon, hvis formularer skal bruges af entreprenører til at ansøge om byggetilladelser. Formularskabelonen indeholder en sektion, hvor entreprenøren kan angive sin forretningsadresse. Sektionen indeholder et felt med navnet fldStreetAddress, der er bundet til et tekstfeltkontrolelement, hvor entreprenøren kan angive sin adresse.
For at bekræfte, at entreprenøren indtaster en gyldig adresse, har du en dataforbindelse til en webtjeneste, der kan bekræfte adressen. Webtjenesten kræver små bogstaver i adressen.
Hvis du vil konvertere alle store bogstaver i postadressen til små bogstaver, skal du føje et andet felt til datakilden, der skal indeholde den adresse, der konverteres til små bogstaver. Standardværdien for dette felt indeholder følgende formel:
translate(fldStreetAddress, ABCDEFGHIJKLMNOPQRSTUVWXYZ, abcdefghijklmnopqrstuvwxyz)
URL-funktioner
SharePointListUrl
Returnerer adressen på den SharePoint-liste eller det SharePoint-formularbibliotek, hvor formularen er hostet (kun InfoPath 2010).
Syntaks
SharePointListUrl()
Denne funktion bruger ikke argumenter.
Eksempel
Du designer en formularskabelon til en SharePoint-liste og vil føje et link til den placering, hvor listen er hostet, f.eks. "http://sharepointserver/site/list/". Det gør du ved at tilføje et linkkontrolelement og indstille det til Skrivebeskyttet og derefter angive standardværdien for det felt, som kontrolelementet er sammenkædet med, på følgende måde:
SharePointListUrl()
Bemærk
Hvis formularskabelonen ikke er hostet på en SharePoint-server, returnerer funktionen SharePointListUrl() kun "http://sharepointserver/site/list/".
SharePointServerRootUrl
Returnerer adressen på den SharePoint-server, hvor formularen er hostet (kun InfoPath 2010).
Syntaks
SharePointServerRootUrl()
Denne funktion bruger ikke argumenter.
Eksempel
Du designer en formularskabelon til en SharePoint-liste og vil føje et link til roden af den SharePoint-server, som listen hostes på, f.eks. "http://sharepointserver/site/list/". Det gør du ved at tilføje et linkkontrolelement og indstille det til Skrivebeskyttet og derefter angive standardværdien for det felt, som kontrolelementet er sammenkædet med, på følgende måde:
SharePointServerRootUrl()
Bemærk
Hvis formularskabelonen ikke er hostet på en SharePoint-server, returnerer funktionen SharePointListUrl() kun "http://sharepointserver/site/list/".
SharePointCollectionUrl
Returnerer adressen på den gruppe af SharePoint-websteder, hvor formularen er hostet (kun InfoPath 2010).
Syntaks
SharePointCollectionUrl()
Denne funktion bruger ikke argumenter.
Eksempel
Du designer en formularskabelon til en SharePoint-liste og vil føje et link til gruppen af websteder på SharePoint-serveren, hvor listen er hostet, f.eks. "http://sharepointserver/sitecollection/". Det gør du ved at tilføje et linkkontrolelement og indstille det til Skrivebeskyttet og derefter angive standardværdien for det felt, som kontrolelementet er sammenkædet med, på følgende måde:
SharePointCollectionUrl()
Bemærk
Hvis formularskabelonen ikke er hostet på en SharePoint-server, returnerer funktionen SharePointListUrl() kun "http://sharepointserver/sitecollection/".
SharePointSiteUrl
Returnerer adressen på det SharePoint-websted, hvor formularen er hostet (kun InfoPath 2010).
Syntaks
SharePointSiteUrl()
Denne funktion bruger ikke argumenter.
Eksempel
Du designer en formularskabelon til en SharePoint-liste og vil føje et link til det SharePoint-websted, hvor listen er hostet, f.eks. "http://sharepointserver/site/". Det gør du ved at tilføje et linkkontrolelement og indstille det til Skrivebeskyttet og derefter angive standardværdien for det felt, som kontrolelementet er sammenkædet med, på følgende måde:
SharePointSiteUrl()
Bemærk
Hvis formularskabelonen ikke er hostet på en SharePoint-server, returnerer funktionen SharePointListUrl() kun "http://sharepointserver/site/".
Funktionen userName
Brugernavn
Returnerer brugernavnet på den person, der udfylder formularen (Microsoft InfoPath 2007 og nyere).
Bemærk
Hvis brugeren udfylder en formular i en webbrowser, hentes brugernavnet fra Microsoft Windows SharePoint Services 3.0 eller nyere.
Syntaks
userName()
Denne funktion bruger ikke argumenter.
Eksempel
Du designer en formularskabelon til udgiftsrapporter for din virksomhed. Dit kreditkortfirma sender registreringer af dine medarbejderes udgifter elektronisk til en database, som virksomheden vedligeholder. For at hente udgiftsposterne for en medarbejder skal databasen have brugernavnet på den medarbejder, der udfylder en formular, der er baseret på din formularskabelon.
Du føjer et felt til datakilden for formularskabelonen for at gemme medarbejderens brugernavn. Du kan også oprette en forespørgselsdataforbindelse, der bruger værdien af dette felt i en forespørgsel til at hente udgifterne.
For at sikre, at den medarbejder, der udfylder udgiftsrapporten, bruger det korrekte brugernavn, skal du binde feltet til et tekstfeltkontrolelement. Hvis du vil have vist brugernavnet på den bruger, der opretter en formular baseret på denne formularskabelon, skal du bruge følgende formel som standardværdien for et felt, der er bundet til tekstfeltkontrolelementet:
userName()