| | Produktinformationen Hilfe und Anleitungen Schulung Ähnliche Produkte und Technologien Vorlagen Support und Feedback Technische Ressourcen Zusätzliche Ressourcen |
Sie können in Microsoft Office InfoPath-Formularvorlagen Funktionen verwenden, um Aufgaben wie Ermitteln der Anzahl von Feldern oder Berechnen der Summe einer Spalte in einer wiederholten Tabelle auszuführen. Sie verwenden Funktionen in Formeln (Formel: Ein XPath-Ausdruck aus Werten, Feldern oder Gruppen, Funktionen und Operatoren. Formeln können zur Berechnung mathematischer Werte, Anzeige von Datum und Uhrzeit und zum Referenzieren von Feldern verwendet werden.), die Sie im Dialogfeld Formel einfügen für Steuerelemente oder Felder auf der Formularvorlage eingeben. Inhalt dieses Artikels
Übersicht über Funktionen
Eine InfoPath-Funktion ist ein Ausdruck, der einen Wert auf der Grundlage einer Berechnung zurückgibt. Sie können eine Funktion in einer Formel verwenden, die Sie im Dialogfeld Formel einfügen eingeben. Funktionen setzen sich aus den folgenden drei Teilen zusammen:
Name Der Name der Funktion. Der Name enthält in der Regel einen Hinweis auf die Aktion, die die Funktion ausführt.
Rückgabewert Das Ergebnis der Funktion.
Argumente Die Werte, die die Funktion für die Berechnung benötigt.
Eine Funktion benötigt möglicherweise Argumente, um einen Wert zurückgeben zu können. Wenn die Funktion Argumente benötigt, müssen Sie wissen, wie viele Argumente erforderlich sind, und Sie müssen den Datentyp der einzelnen Argumente kennen. Die Funktion kann nicht verwendet werden, wenn die falsche Anzahl an Argumenten oder der falsche Datentyp angegeben wird.
Ein Argument in einer Funktion ist ein XPath-Ausdruck, bei dem es sich um eine Kombination aus Werten, Funktionen und Operatoren handelt, mit denen ein einzelner Wert ausgewertet wird. In der folgenden Abbildung ist die Beziehung zwischen Funktionen, Ausdrücken und Formeln dargestellt.
 Seitenanfang
Datums- und Uhrzeitfunktionen
| Funktion |
Beschreibung |
Syntax |
|
| addDays |
Gibt ein Datum zurück, das sich aus der Addition des zweiten Arguments zum ersten Argument ergibt. Der Datentyp des Rückgabewerts hängt vom Datentyp des ersten Arguments ab.
- Datum (date)-Datentyp gibt den Datentyp Datum (date) zurück.
- Datum und Zeit (dateTime)-Datentyp gibt den Datentyp Datum und Zeit (dateTime) zurück.
|
addDays(Argument1, Argument2)
Argument1 Das zweite Argument wird zu diesem Datum addiert. Dieses Argument kann Daten vom Typ Datum (date) oder vom Typ Datum und Zeit (dateTime) enthalten.
Argument2 Die Anzahl der Tage, die Sie zum ersten Argument addieren möchten. Dieser Parameter muss Daten vom Typ Ganze Zahl (integer) enthalten.
|
| addSeconds |
Gibt eine Zeit zurück, die sich aus der Addition des zweiten Arguments zum ersten Argument ergibt. Der Datentyp des Rückgabewerts hängt vom Datentyp des ersten Arguments ab.
- Zeit (time)-Datentyp gibt den Datentyp Zeit (time) zurück.
- Datum (date)- oder Datum und Zeit (dateTime)-Datentyp gibt den Datentyp Datum und Zeit (dateTime) zurück.
|
addSeconds(Argument1, Argument2)
Argument1 Das zweite Argument wird zu dieser Zeit addiert. Dieses Argument kann Daten vom Typ Zeit (time), Datum (date) oder Datum und Zeit (dateTime) enthalten.
Argument2 Die Anzahl der Sekunden, die Sie zum ersten Argument addieren möchten. Das Feld in diesem Parameter muss Daten vom Typ Ganze Zahl (integer) enthalten.
|
| now |
Gibt das Datum und die Uhrzeit als Daten vom Typ Datum und Zeit (dateTime) zurück, wenn das Formular zum ersten Mal geöffnet wird. |
now() Zu dieser Funktion gibt es keine Argumente.
|
| today |
Gibt das Datum als Daten vom Typ Datum (date) zurück, wenn das Formular zum ersten Mal geöffnet wird. |
today() Zu dieser Funktion gibt es keine Argumente.
|
Seitenanfang Feldfunktionen
| Funktion |
Beschreibung |
Syntax |
|
|
name |
Gibt den erweiterten Namen des im Argument angegebenen Feldnamens zurück. Der erweiterte Name enthält das vorhandene Namespacepräfix und den Namen des angegebenen Felds oder der angegebenen Gruppe. Wenn das Argument aus Feldern oder Gruppen besteht, gibt die Funktion den Namen und das Präfix des ersten Felds oder der ersten Gruppe im Formular zurück. Wenn ein Benutzer ein Formular in einer für Browser geeigneten Formularvorlage ausfüllt, sendet eine Formel, die diese Funktion verwendet Daten an den Server, um den Rückgabewert dieser Funktion zu erfahren.
|
name(Argument) Argument Der Name des Felds, dessen Namespacepräfix und Name Sie abrufen möchten.
|
|
position |
Gibt den Index oder die Position des Felds oder der Gruppe hinsichtlich anderer Felder und Gruppen innerhalb derselben Gruppe zurück. Diese Funktion gibt immer 1 zurück, wenn sie entweder in einer Formel mit einer Berechnung oder in einer Formel in einer Regel verwendet wird. Hinweis Diese Funktion wird nicht in der Liste Funktionen des Dialogfelds Funktion einfügen angezeigt, wenn Sie eine browserkompatible Formularvorlage entwerfen.
|
position() Zu dieser Funktion gibt es keine Argumente.
|
| count |
Gibt die Anzahl der Instanzen des Felds oder der Gruppe in einem Formular zurück. |
count(Argument) Argument Der Name des Felds oder der Gruppe, das bzw. die im Formular gezählt werden soll.
|
| current |
Gibt das aktuelle Feld oder die aktuelle Gruppe in einer Gruppe zurück. Sie können diese Funktion verwenden, um auf eine aktuelle Zeile in einer wiederholten Tabelle oder in einem wiederholten Abschnitt in einem größeren Ausdruck zu verweisen. Hinweis Diese Funktion ist im Dialogfeld Funktion einfügen nicht verfügbar. Wenn Sie diese Funktion verwenden möchten, geben Sie sie im Dialogfeld Formel einfügen als XPath-Ausdruck im Feld Formel ein.
|
current() Zu dieser Funktion gibt es keine Argumente.
|
| id |
Gibt den XPath-Ausdruck für die Felder oder Gruppen zurück, die den angegebenen Wert im ID-Attribut eines Felds enthalten.
Wenn ein Benutzer ein Formular in einer für Browser geeigneten Formularvorlage ausfüllt, sendet eine Formel, die diese Funktion verwendet Daten an den Server, um den Rückgabewert dieser Funktion zu erfahren.
Hinweis Diese Funktion ist im Dialogfeld Funktion einfügen nicht verfügbar. Wenn Sie diese Funktion verwenden möchten, geben Sie sie im Dialogfeld Formel einfügen als XPath-Ausdruck im Feld Formel ein.
|
id("Argument") Argument Der Wert des ID-Attributs für das Feld oder die Gruppe. Dieser Wert muss in doppelten Anführungszeichen (" ") stehen.
|
| last |
Gibt den Wert des letzten Vorkommens des Felds zurück. Hinweis Diese Funktion wird nicht in der Liste Funktionen des Dialogfelds Funktion einfügen angezeigt, wenn Sie eine browserkompatible Formularvorlage entwerfen.
|
field name[last()] Die Funktion erfordert keine Parameter. Sie können diese Funktion jedoch als Prädikat für einen angegebenen Feldnamen verwenden.
|
| local-name |
Gibt den Namen des Felds ohne Namespace oder den letzten Namen des XPath-Ausdrucks zurück. Wenn der Parameter aus Feldern oder Gruppen besteht, wird der Wert des ersten Felds oder der ersten Gruppe zurückgegeben. Wenn ein Benutzer ein Formular in einer für Browser geeigneten Formularvorlage ausfüllt, sendet eine Formel, die diese Funktion verwendet Daten an den Server, um den Rückgabewert dieser Funktion zu erfahren.
|
local-name(Argument) Argument Der Name des Felds, dessen lokalen Namen Sie abrufen möchten.
|
| namespace-uri |
Gibt den vollständigen Namespace URI (Uniform Resource Identifier) (Uniform Resource Identifier (URI): Eine Zeichenfolge, die zum Identifizieren einer Ressource im Internet anhand von Typ und Speicherort dient.) des Arguments zurück. Wenn das Argument aus Feldern oder Gruppen besteht, gibt die Funktion den Namespace des ersten Felds oder der ersten Gruppe im Formular zurück. Wenn ein Benutzer ein Formular in einer für Browser geeigneten Formularvorlage ausfüllt, sendet eine Formel, die diese Funktion verwendet Daten an den Server, um den Rückgabewert dieser Funktion zu erfahren.
|
namespace-uri(Argument) Argument Der Name des Felds, dessen Namespace-URI (Universal Resource Identifier) Sie abrufen möchten.
|
Seitenanfang Mathematische Funktionen
Hinweis Formeln, die mathematische Funktionen enthalten, benötigen in der Regel Argumente, die ganze Zahlen oder Dezimalwerte sind. Um sicherzustellen, dass es sich bei den Argumenten nicht um Nullwerte, sondern um ganze Zahlen oder Dezimalwerte handelt, aktivieren Sie im Menü Extras im Dialogfeld Formularoptionen die Kategorie Erweitert das Kontrollkästchen Leere Werte als Null behandeln.
| Funktion |
Beschreibung |
Syntax |
|
|
avg |
Gibt den Durchschnittswert des Felds in einer Gruppe zurück. Jedes Feld nuss einen numerischen Datentyp aufweisen und in einer Gruppe enthalten sein.
|
avg(Argument) Argument Die Namen der Felder in der Gruppe, für die Sie den Durchschnittswert abrufen möchten.
|
|
boolean |
Gibt den Wert "True" zurück, wenn das Argument eine positive Zahl ist, oder "False", wenn das Argument Null oder eine negative Zahl ist. |
boolean(Argument) Argument Der Ausdruck, der von der Funktion ausgewertet werden soll.
|
|
ceiling |
Gibt die kleinste ganze Zahl zurück, die gleich groß oder größer als der Wert im Argument ist. Ein Wert, der keine ganze Zahl ist, wird auf den nächsthöchsten ganzzahligen Wert gerundet.
|
ceiling(Argument) Argument Der Name des Felds mit einem numerischen Wert.
|
|
eval |
Gibt das Ergebnis nach dem Anwenden des angegebenen Ausdrucks im zweiten Argument auf das erste Argument an. |
eval(Argument1, Argument2 ) Argument1 Der Name des Felds oder der Gruppe, dessen bzw. deren Werte vom Ausdruck im zweiten Argument ausgewertet werden.
Argument2 Der Ausdruck in doppelten Anführungszeichen (" "), der auf das erste Argument angewendet wird.
|
|
false |
Gibt den booleschen Wert "false" zurück. Verwenden Sie diese Funktion als Teil einer Reihe von Regeln, die ausgeführt werden, wenn eine Bedingung nicht erfüllt ist. |
false() Zu dieser Funktion gibt es keine Argumente.
|
|
floor |
Gibt die kleinste ganze Zahl zurück, die gleich groß oder kleiner als der Wert im Argument ist. Ein Wert, der keine ganze Zahl ist, wird auf den nächstkleinsten ganzzahligen Wert gerundet.
|
floor(Argument) Argument Der Name des Felds, das einen numerischen Wert enthält.
|
|
min |
Gibt den kleinsten Wert eines Felds in einer Gruppe zurück.
|
min(Argument) Argument Der Name der Gruppe, die die Felder enthält, für die der kleinste Wert ermittelt werden soll.
|
|
not |
Gibt den Wert "True" zurück, wenn der Ausdruck als Null, kleiner als Null oder falsch ausgewertet wird. Gibt den Wert "False" zurück, wenn der Ausdruck als größer als Null, wahr oder nicht Null ausgewertet wird. |
not(Argument) Argument Der Ausdruck, der von der Funktion ausgewertet wird.
|
|
number |
Gibt das Ergebnis aus der Umwandlung des Ausdrucks im Argument in eine Zahl zurück. |
number(Argument) Argument Der Ausdruck, der von der Funktion ausgewertet wird.
|
|
nz |
Gibt "Null" zurück, wenn der Wert im Argument leer ist, oder gibt den Wert des Arguments zurück.
|
nz(Argument) Argument Der Name des Felds, das von der Funktion ausgewertet wird.
|
|
round |
Gibt eine auf einen ganzzahligen Wert gerundete Zahl zurück. Wenn der nicht ganzzahlige Wert genau in der Mitte zwischen zwei gerundeten ganzzahligen Werten liegt, ist der Rückgabewert der nächsthöhere ganzzahlige Wert.
|
round(Argument) Argument Der Ausdruck, der von der Funktion ausgewertet wird.
|
|
sum |
Gibt die Summe der Werte in den Feldern in einer Gruppe zurück. |
sum(Argument) Argument Die Namen der Felder in der Gruppe, deren Werte addiert werden. Wenn Sie Felder in zwei verschiedenen Gruppen addieren möchten, verwenden Sie den UNION-Operator (|), um die Argumente zu trennen. Beispiel: sum( Feldname 1 | Feldname 2).
|
|
true |
Gibt den booleschen Wert "true" zurück. Verwenden Sie diese Funktion als Teil einer Reihe von Regeln, die ausgeführt werden, wenn eine Bedingung erfüllt ist. |
true() Zu dieser Funktion gibt es keine Argumente.
|
| max |
Gibt den höchsten Wert eines Felds in einer Gruppe zurück. |
max(Argument) Argument Der Name der Gruppe, die die Felder enthält, für die der höchste Wert ermittelt werden soll.
|
Seitenanfang Textfunktionen
| Funktion |
Beschreibung |
Syntax |
|
|
contains |
Gibt den Wert "true" zurück, wenn der Wert im ersten Argument den im zweiten Argument angegebenen Text enthält, oder gibt den Wert "false" zurück, wenn der Text im zweiten Argument nicht im Wert im ersten Argument enthalten ist. |
contains(Argument1, Argument2)
Argument1 Der Name des Felds, das den gesuchten Text enthält.
Argument2 Der Ausdruck, der den Text enthält, nach dem im ersten Argument gesucht wird.
|
| concat |
Gibt Text zurück, der sich aus der Kombination der Argumente ergibt. |
concat(Argument1, Argument2, ...) Argument Mindestens zwei Ausdrücke mit Text, die zu einem Text kombiniert werden. Ausdrücke werden mit Kommas voneinander getrennt.
|
| normalize-space |
Gibt Text zurück, bei dem alle führenden, abschließenden und wiederholten Leerzeichen entfernt wurden. Wenn ein Benutzer ein Formular in einer für Browser geeigneten Formularvorlage ausfüllt, sendet eine Formel, die diese Funktion verwendet Daten an den Server, um den Rückgabewert dieser Funktion zu erfahren.
Hinweis Bei Feldern mit dem Datentyp Text werden führende, abschließende und wiederholte Leerzeichen automatisch aus dem Wert entfernt.
|
normalize-space(Argument) Argument Der Text, der die führenden, abschließenden und wiederholten Leerzeichen enthält, die Sie entfernen möchten. Setzen Sie den Text in doppelte Anführungszeichen (" ").
|
| starts-with |
Gibt den Wert "true" zurück, wenn der Text im ersten Argument mit dem Text im zweiten Argument beginnt, oder gibt den Wert "false" zurück, wenn der Text im zweiten Argument nicht am Textanfang im ersten Argument steht.
|
starts-with(Argument1, Argument2) Argument1 Der Name des Felds, das den gesuchten Text enthält.
Argument2 Der Text, der am Anfang des im ersten Argument angegebenen Felds gesucht wird. Dieses Argument kann entweder ein in doppelte Anführungszeichen (" ") gesetzter Text oder ein Feldname sein.
|
| string |
Gibt das Argument als Text zurück.
|
string(Argument) Argument Der Name des Felds, das den Wert enthält, der in Text umgewandelt wird.
|
| string-length |
Gibt die Anzahl der Zeichen im Wert des Arguments zurück.
|
string-length(Argument) Argument Der Name des Felds, dessen Wert den zu zählenden Text darstellt.
|
| substring |
Gibt die Zeichen ab der im zweiten Argument angegebenen Stelle bis zu der im dritten Argument angegebenen Anzahl zurück. |
substring(Argument1, Argument2, Argument3) Argument1 Ein Ausdruck, der den Text enthält, der mit der Funktion gesucht wird. Die Funktion sucht diesen Text und gibt alle Zeichen ab der im zweiten Argument angegebenen Stelle bis zu der im dritten Argument angegebenen Anzahl an Zeichen oder bis zum Textende (je nachdem, was früher auftritt) zurück.
Argument2 Gibt die Startposition des Texts zurück, der aus dem ersten Argument abgerufen wird.
Argument3 Die Anzahl an Zeichen, die abgerufen werden soll, beginnend an der im zweiten Argument angegebenen Startposition.
|
| substring-after |
Gibt den Text im ersten Argument zurück, der nach dem im zweiten Argument angegebenen Text steht. Der Text im zweiten Argument ist nicht im zurückgegebenen Text enthalten. |
substring(Argument1, Argument2) Argument1 Ein Ausdruck, der den Text enthält, der mit der Funktion gesucht wird. Die Funktion sucht den Text in diesem Argument und gibt dann alle Zeichen nach dem Text im zweiten Argument zurück.
Argument2 Ein Ausdruck, der Text enthält. Die Funktion sucht im Text im ersten Argument nach diesem Text und gibt dann alle Zeichen nach dem Text in diesem Argument zurück.
|
| substring-before |
Gibt den gesamten Text im ersten Argument zurück, der vor dem im zweiten Argument angegebenen Text steht. Der Text im zweiten Argument ist nicht im zurückgegebenen Text enthalten. |
substring-before(Argument1, Argument2) Argument1 Ein Ausdruck, der den Text enthält, der mit der Funktion gesucht wird. Die Funktion sucht den Text in diesem Argument und gibt dann alle Zeichen vor dem Text im zweiten Argument zurück.
Argument2 Ein Ausdruck, der Text enthält. Die Funktion sucht den Text im ersten Argument und gibt dann alle Zeichen vor dem Text in diesem Argument zurück.
|
| translate |
Gibt den Text zurück, der sich ergibt, wenn alle Zeichen im zweiten Argument durch die Zeichen im dritten Argument ersetzt werden. |
translate(Argument1, Argument2, Argument3) Argument1 Der Name des Felds, das den Text enthält, dessen Zeichen ersetzt werden.
Argument2 Ein Ausdruck, der ein Zeichen auswertet, das vom Ausdruck im dritten Argument ersetzt wird.
Argument3 Ein Ausdruck, der ein Zeichen auswertet, das die einzelnen Instanzen der Zeichen im zweiten Argument ersetzt.
|
Seitenanfang Weitere Funktionen
Klicken Sie zum Anzeigen dieser Funktion in der Liste Funktionen im Dialogfeld Funktion einfügen in der Liste Kategorien auf Alle.
| Funktion |
Beschreibung |
Syntax |
|
| userName |
Gibt den E-Mail-Alias des Benutzers zurück, der das Formular ausfüllt. Der E-Mail-Alias stammt aus dem Active Directory-Verzeichnisdienst. Hinweis Wenn der Benutzer eine browserkompatible Formularvorlage ausfüllt, stammt der E-Mail-Alias aus Microsoft Windows SharePoint Services (Version 3).
|
userName() Zu dieser Funktion gibt es keine Argumente.
|
|
Deutschland
Druckversion
Freigabe
Alle anzeigen
Alle ausblenden
