Help Center> FOUNDATION Help

Gilt für:

  • Winshuttle Foundation

Globale Hilfsfunktionen

JavaScript-Referenzleitfäden

Globale Hilfsfunktionen sind unscheinbare Funktionen, die allgemein verwendet werden, um Daten in Feldern zu bearbeiten und Aufgaben auszuführen, wie etwa die Konvertierung von Text von Groß- in Kleinbuchstaben, die Mittelwertberechnung eines Wertesatzes, die Ausgabe der Anzahl der Werte in einer wiederholten Gruppe usw. Dabei handelt es sich um Funktionen, die Sie eher dann einsetzen würden, wenn Sie Ihren eigenen JavaScript-Code schrieben, um eine bestimmte Funktion zu realisieren, die mit der grafischen Benutzeroberfläche von Winshuttle Composer nicht erstellt werden kann.

Klicken Sie auf eine der unten stehenden Funktionen, um eine Beschreibung, Parameter und ein grundlegendes Codebeispiel anzuzeigen.

addDays(date, days, ignoreWeekends)

Zurück zum Anfang

Gibt ein neues Datumsobjekt aus, das einen bestimmten Datumswert mit einer bestimmten Anzahl von hinzugefügten Tagen beinhaltet.

Parameter
  • dateValue – Datumsobjekt mit dem Originaldatum
  • days – Anzahl der dem Originaldatum hinzuzufügenden Tage
  • ignoreWeekends – ob Wochenenden (Sa./So.) ignoriert/nicht ignoriert werden sollen Auf „True“ oder „False“ setzen.
Beispiel

var date = addDays(today(), 10, false);
jQuery.alert('10 days from now is: ' + date);

addSeconds(dateValue, seconds)

Zurück zum Anfang

Gibt ein neues Datumsobjekt aus, das einen bestimmten Datumswert mit einer bestimmten Anzahl von hinzugefügten Sekunden beinhaltet.

Parameter
  • dateValue – Datumsobjekt mit der Originalzeit
  • seconds – Anzahl der dem Originaldatum hinzuzufügenden Sekunden
Beispiel

var rightNow = new Date();
var later = addSeconds(rightNow, 60);
jQuery.alert('60 seconds from now it will be: '+ later);

avg(field)

Zurück zum Anfang

Gibt den Mittelwert (sum/count) numerischer Werte in einer an ein bestimmtes Feld gebundenen, wiederholten Gruppe wieder.

Parameter
  • field – XPath eines numerischen Felds in einer wiederholten Gruppe
Beispiel

var avgCost = avg('/my:myFields/my:Repeating_Table_2/my:Repeating_Content/my:Cost');
jQuery.alert('Average cost is: ' + avgCost);

ceiling(value)

Zurück zum Anfang

Gibt die kleinste ganze Zahl wieder, die größer als der oder gleich dem angegebenen Zahlenwert ist (siehe Funktion JavaScript Math.ceil()).

Parameter
  • value – numerischer Wert zum Durchführen von Obergrenzenvorgängen
Beispiel

var decVal = $form.getValue('/my:myFields/my:decimalField');
var intCeil = ceiling(decVal);
jQuery.alert('Ceiling of ' + decVal + ' is: ' + intCeil);

concat()

Zurück zum Anfang

Gibt eine neue Zeichenfolge mit allen Argumenten als Kette aus. Falls das Argument einen XPath-Wert angegeben hat, wird der Wert des Felds verwendet, auf das verwiesen wird. Falls der XPath auf eine wiederholte Gruppe verweist, gibt er eine Kette mit allen Werten der wiederholten Gruppe aus.

Parameter

Variable Anzahl von Argumenten, die verkettet werden. Falls ein Argument einen XPath enthält, wird sein Formularwert ersetzt. Falls der XPath auf einen wiederholten Abschnitt verweist, werden alle Werte des Feldes im wiederholten Abschnitt verkettet.

Beispiel

var lStr = concat('/my:myFields/my:Repeating_Table_2/my:Repeating_Content/my:Text');
jQuery.alert('Concatenated value: ' + lStr);

contains(text,find_text)

Zurück zum Anfang

Gibt „true“ aus, wenn der durch „find_text“ angegebene Zeichenfolgewert in dem durch den Text angegebenen Zeichenfolgewert gefunden wird.

Parameter
  • text – Zeichenfolge, deren Inhalte getestet werden
  • find_text – Zeichenfolge, nach der in „text“ gesucht wird
Beispiel

if (contains($form.getValue('/my:myFields/my:field_1', 'Needle')) {
jQuery.alert('Found Needle in the field');
}

count(fieldname, [regex])

Zurück zum Anfang

Gibt die Anzahl von Werten in einer wiederholten Gruppe aus.

Parameter
  • field – XPath eines Felds in der wiederholten Gruppe
  • regex (optional) – ein regulärer Ausdruck, um die Anzahl der übereinstimmenden Instanzen auszugeben
Beispiel

var rCount = count('/my:myFields/my:Repeating_Table_2/my:Repeating_Content/my:Cost');
jQuery.alert('Number of items in table is: '+rCount);

diffDays (date1, date2, weekdaysOnly)

Zurück zum Anfang

Gibt die Anzahl der Tage zwischen zwei Terminen aus, mit einer Option, nur Wochentage (keine Wochenenden) zu berücksichtigen.

Parameter
  • Date1 – Datumsobjekt mit dem Startdatum
  • Date2 – Datumsobjekt mit dem Enddatum
  • weekendsOnly – ob Wochenenden (Sa./So.) ignoriert/nicht ignoriert werden sollen Auf „True“ oder „False“ setzen.
Beispiel

var date1 = $form.getValue('/my:myFields/my:dateField_1');

var date2 = $form.getValue('/my:myFields/my:dateField_2');

var days = diffDays(date1, date2, false);

Die Variable „days“ wird eine Anzahl an Tagen zwischen den beiden Terminen (einschließlich Wochenenden) beinhalten.

first(field)

Zurück zum Anfang

Gibt den ersten Wert des angegeben XPath in einer wiederholten Gruppe aus.

Parameter
  • field – XPath eines Felds in der wiederholten Gruppe
Beispiel

var fItem = first('/my:myFields/my:Repeating_Table_2/my:Repeating_Content/my:Title');
jQuery.alert('First item in table has the Title: '+fItem);

floor(value)

Zurück zum Anfang

Gibt die größte ganze Zahl wieder, die kleiner als der oder gleich dem angegebenen Zahlenwert ist (siehe Funktion JavaScript Math.floor()).

Parameter
  • value – dezimaler Wert zum Durchführen von Untergrenzenvorgängen
Beispiel

var decVal = $form.getValue('/my:myFields/my:decimalField');
var intFloor = floor(decVal);
jQuery.alert('Floor of ' + decVal + ' is: ' + intFloor);

formatDate(dateString, pattern)

Zurück zum Anfang

Dadurch wird die erneute Formatierung einer Datumszeichenfolge durch ein bereitgestelltes Muster ermöglicht.

Parameter
  • dateString – eine Zeichenfolge in dem Format „jjjj-mm-tt“ oder eine Zeichenfolge, die ein RFC2822- oder ISO 8601-Datum darstellt (Es können auch andere Formate verwendet werden. Dies kann jedoch zu unerwarteten Ergebnissen führen.).
  • pattern - die Formatierungsmuster basieren auf java.text.SimpleDateFormat Siehe unten:
Beispiel

Um ein anderes Datenformat in einem neuen Feld festzulegen:

$form.setValue(‘/my:myFields/my:field_1’, formatDate($form.getValue(‘/my:myfields:my:date_field2’), “dd-mm-yyyy”));

Maske

Beschreibung

d

Tag des Monats als Ziffern; keine führende Null bei einstelligen Ziffern.

dd

Tag des Monats als Ziffern; führende Null bei einstelligen Ziffern.

ddd

Tag der Woche als eine Abkürzung mit drei Buchstaben.

dddd

Tage der Woche mit vollem Namen.

m

Monat als Ziffern; keine führende Null bei einstelligen Monaten.

mm

Monat als Ziffern; führende Null bei einstelligen Monaten.

mmm

Monat als eine Abkürzung mit drei Buchstaben.

mmmm

Monat mit vollem Namen.

yy

Jahr mit seinen letzten zwei Ziffern; führende Null bei Jahren kleiner als 10.

yyyy

Jahr mit vier Ziffern dargestellt.

h

Stunden; keine führende Null bei Stunden mit einer Ziffer (12-Stunden-Zeitraum).

hh

Stunden; führende Null bei Stunden mit einer Ziffer (12-Stunden-Zeitraum).

H

Stunden; keine führende Null bei Stunden mit einer Ziffer (24-Stunden-Zeitraum).

HH

Stunden; führende Null bei Stunden mit einer Ziffer (24-Stunden-Zeitraum).

M

Minuten; keine führende Null bei einstelligen Minuten.
Groß geschriebenes M, nicht wie das m im CF timeFormat, um Konflikte bei Monaten zu vermeiden.

MM

Minuten; führende Null bei einstelligen Minuten.
Großgeschriebenes MM, nicht wie das mm im CF timeFormat, um Konflikte bei Monaten zu vermeiden.

s

Sekunden; keine führende Null bei einstelligen Sekunden.

ss

Sekunden; führende Null bei einstelligen Sekunden.

l oder L

Millisekunden l führt zu drei Ziffern. L führt zu zwei Ziffern.

t

Kleingeschrieben, Zeitmarkierungszeichenfolge mit einem einzelnen Zeichen: a oder p.
Kein Gegenstück dazu in CF.

tt

Kleingeschrieben, Zeitmarkierungszeichenfolge mit einem doppelten Zeichen: am oder pm.
Kein Gegenstück dazu in CF.

T

Großgeschrieben, Zeitmarkierungszeichenfolge mit einem einzelnen Zeichen: A oder P.
Großgeschriebenes T, nicht wie das t in CF, um eine durch den Benutzer bestimmte Groß-/Kleinschreibung zu ermöglichen.

TT

Großgeschrieben, Zeitmarkierungszeichenfolge mit einem doppelten Zeichen: AM oder PM.
Großgeschriebenes TT, nicht wie das tt in CF, um eine durch den Benutzer bestimmte Groß-/Kleinschreibung zu ermöglichen.

Z

US-Zeitzonen-Abkürzung, z. B. EST oder MDT. Bei nicht-US-Zeitzonen oder im Opera-Browser wird der GMT/UTC-Offset ausgegeben, z. B. GMT-0500
Kein Gegenstück dazu in CF.

o

GMT/UTC-Zeitzonen-Offset, z. B. -0500 oder +0230.
Kein Gegenstück dazu in CF.

S

Das Ordnungssuffix des Datums (st, nd, rd oder th). Funktioniert gut mit „d“.
Kein Gegenstück dazu in CF.

'…'oder"…"

Wortwörtliche Zeichensequenz. Umgebene Anführungszeichen werden entfernt.
Kein Gegenstück dazu in CF.

UTC:

Muss die ersten vier Zeichen der Maske sein. Konvertiert das Datum von lokaler Zeit zu UTC-/GMT-/Zulu-Zeit, bevor die Maske angewendet wird. Das Präfix „UTC“ wird entfernt.
Kein Gegenstück dazu in CF.

Benannte Masken

Name

Maske

Beispiel

Standard

ddd mmm dd yyyy HH:MM:ss

Sat Jun 09 2007 17:46:21

shortDate

m/d/yy

6/9/07

mediumDate

mmm d, yyyy

Jun 9, 2007

longDate

mmmm d, yyyy

June 9, 2007

fullDate

dddd, mmmm d, yyyy

Saturday, June 9, 2007

shortTime

h:MM TT

5:46 PM

mediumTime

h:MM:ss TT

17:46:21

longTime

h:MM:ss TT Z

5:46:21 PM EST

isoDate

yyyy-mm-dd

09.06.2007

isoTime

HH:MM:ss

17:46:21

isoDateTime

yyyy-mm-dd'T'HH:MM:ss

2007-06-09T17:46:21

isoUtcDateTime

UTC:yyyy-mm-dd'T'HH:MM:ss'Z'

2007-06-09T22:46:21Z

getRepeatingValues(field)

Zurück zum Anfang

Gibt ein JavaScript-Array mit allen Werten in einer an ein bestimmtes Feld gebundenen, wiederholten Gruppe wieder.

Parameter
  • field – XPath eines Felds in einer wiederholten Gruppe
Beispiel

var vals = getRepeatingValues('/my:myFields/my:Repeating_Table_2/my:Repeating_Content/my:Values');

last(field)

Zurück zum Anfang

Gibt den letzten Wert des angegeben XPath in einer wiederholten Gruppe aus.

Parameter
  • field – XPath eines Felds in der wiederholten Gruppe
Beispiel

var lItem = first('/my:myFields/my:Repeating_Table_2/my:Repeating_Content/my:Title');
jQuery.alert('Last item in table has the Title: '+lItem);

max(field)

Zurück zum Anfang

Gibt den größten numerischen Wert in einem Wertesatz in einer wiederholten Gruppe aus.

Parameter
  • field – XPath eines numerischen Felds in einer wiederholten Gruppe
Beispiel

var high = max('/my:myFields/my:Repeating_Table_2/my:Repeating_Content/my:Cost');
jQuery.alert('Highest cost item is: '+high);

min(field)

Zurück zum Anfang

Gibt den kleinsten numerischen Wert in einem Wertesatz in einer wiederholten Gruppe aus.

Parameter
  • field – XPath eines numerischen Felds in einer wiederholten Gruppe
Beispiel

var low = min('/my:myFields/my:Repeating_Table_2/my:Repeating_Content/my:Cost');
jQuery.alert('Lowest cost item is: '+low);

normalize_space(text)

Zurück zum Anfang

Dadurch werden alle Leerzeichen aus dem „text“ entfernt.

Parameter
  • text – Zeichenfolge, aus der Leerzeichen entfernt werden
Beispiel

Um Leerzeichen automatisch aus einem Eingabefeld zu entfernen:

$form.setValue('/my:myFields/my:field_1',normalize_space($form.getValue('/my:myFields/my:field_1')));

now()

Zurück zum Anfang

Gibt ein neues Datumsobjekt mit dem aktuellen Datum und Zeitpunkt wieder.

Parameter

Keine

Beispiel

var currentTime = now();
jQuery.alert('The time is now: '+currentTime);

number(text)

Zurück zum Anfang

Konvertiert eine Zeichenfolge zu einem Nummernwert.

Parameter
  • text – Zeichenfolge mit einem numerischen Wert Wenn die Zeichenfolge keinen numerischen Wert beinhaltet, gibt diese Funktion „Number.NaN“ aus.
Beispiel

var stringVal = $form.getValue('/my:myFields/my:field_1');
var numberVal = number(stringVal);
jQuery.alert('The number value is: ' + numberVal);

nz(value)

Zurück zum Anfang

Gibt den numerischen Wert von „text“ aus oder 0, wenn keine Ziffer vorhanden ist.

Parameter
  • value – Zeichenfolgewert, der zu einer Ziffer oder 0 konvertiert wird
Beispiel

var nzVal = nz($form.getValue('/my:myFields/my:field_1'));
jQuery.alert('nz() returned: ' + nzVal);

pad(s,length,padChar,side)

Zurück zum Anfang

Gibt eine neue Zeichenfolge mit einer durch den Längenparameter definierten Länge aus. Eine Auffüllung wird entweder zur linken oder rechten Seite (oder gleichmäßig auf beiden Seiten) der Zeichenfolge hinzugefügt.

Parameter
  • s – Zeichenfolge, der eine Auffüllung hinzugefügt werden soll
  • length – Länge der auszugebenden Zeichenfolge
  • padChar – das Zeichen, das für das Auffüllen verwendet wird
  • side – welche Seite der Zeichenfolge aufgefüllt wird (möglich: links, rechts oder beide)
Beispiel

var paddedStr = pad($form.getValue('/my:myFields/my:field_1'), 20, ' ', 'left');

renderMap(mapname, desc, address, city, state, zip, country)

Zurück zum Anfang

Stellt das Kartenhilfselement durch Angeben einer Adresse dar. Falls das angegebene Argument ein XPath ist, wird der Wert des Feldes verwendet, auf das sich bezogen wird.

Parameter
  • mapname – Name des Kartenelements (verwenden Sie denselben Namen, wenn die Zuordnung in mehreren Ansichten verwendet wird)
  • desc – Beschreibung des Orts, die angezeigt wird, wenn die Markierung des Ortes auf der Karte ausgewählt wird
  • address – Adresse des Orts auf der Karte
  • city – Stadt des Orts auf der Karte (optional)
  • state – Bundesland des Orts auf der Karte (optional)
  • zip – Postleitzahl des Orts auf der Karte (optional)
  • country – Land des Orts auf der Karte (optional)
Beispiel

Dieses Beispiel verwendet alle Argumente, um den Ort auf der Karte anzugeben. Dies können alle in der Lösung definierten Felder sein (oder hartcodierte Werte).

$form.getValue('/my:myFields/my:city',$form.getValue('/my:myFields/my:state', form.getValue('/my:myFields/my:zip’, $form.getValue('/my:myFields/my:country')

Dieses Beispiel verwendet ein einzelnes Feld, das den vollständigen Ort beinhaltet:

(field winshuttlecorp = "20021 120th Ave. NE, Ste 101, Bothell, WA 98011") renderMap("BothellCorporate", "Corporate Office", $form.getValue('/my:myFields/my:winshuttlecorp', "", "", "", "")

round(value)

Zurück zum Anfang

Gibt den Wert einer auf die nächste ganze Zahl gerundeten Zahl aus (siehe Funktion JavaScript Math.round()).

Parameter
  • value – Dezimalwert, an dem der Rundungsvorgang durchgeführt wird
Beispiel

var decVal = $form.getValue('/my:myFields/my:decimalField');
var intRound = round(decVal);
jQuery.alert('Nearest integer of ' + decVal + ' is: ' + intRound);

starts_with(text,find_text)

Zurück zum Anfang

Gibt „true“ aus, wenn die angegebene Zeichenfolge mit Text mit der im Parameter „find_text“ angegebenen Zeichenfolge beginnt. Anderenfalls wird „true“ ausgegeben.

Parameter
  • text – Zeichenfolge, an der die Suche durchgeführt wird
  • find_text – Zeichenfolge, nach der am Anfang des Parameters „text“ gesucht wird
Beispiel

if (starts_with($form.getValue('/my:myFields/my:field_1', 'Prefix')) {
jQuery.alert('The field does begin with the string Prefix');
}

string(value)

Zurück zum Anfang

Gibt einen Wert als Zeichenfolge aus.

Parameter
  • value – jegliche JavaScript-Objekte, die zu einer Zeichenfolge konvertiert werden
Beispiel

var currentTime = now();
var stringVal = string(currentTime);
jQuery.alert('string value of currentTime is: '+stringVal);

string_length(value)

Zurück zum Anfang

Gibt eine ganze Zahl mit der Zeichenlänge einer durch einen Wert angegebenen Zeichenfolge aus.

Parameter
  • value – JavaScript-Zeichenfolge, aus der die Länge entnommen wird
Beispiel

var slen = string_length($form.getValue('/my:myFields/my:field_1');
jQuery.alert('Length of field_1 is: '+slen);

substring(text,pos,count)

Zurück zum Anfang

Gibt die Zeichen einer Zeichenfolge aus, beginnend am angegebenen Ort (pos) durch die angegebene Zeichenanzahl (count) (siehe Funktion JavaScript String.prototype.substr()).

Parameter
  • text – Zeichenfolge, aus der eine Unterzeichenfolge abgerufen wird
  • pos – Startposition der Unterzeichenfolge (Hinweis: Das erste Zeichen einer Zeichenfolge befindet sich bei Position 0.)
  • count (optional) – Länge der Unterzeichenfolge (falls nicht angegeben, werden alle Zeichen nach „pos“ ausgegeben)
Beispiel

var substr = substring($form.getValue('/my:myFields/my:field_1', 5);
jQuery.alert('substring of field_1,5 is: '+substr);

substring_after(text,find_text)

Zurück zum Anfang

Gibt alle Zeichen in einer Zeichenfolge nach der Zeichenfolge „find_text“ aus. Wenn „find_text“ nicht in der Zeichenfolge gefunden wird, gibt diese Funktion die vollständige Zeichenfolge aus, die durch „text“ angegeben wurde.

Parameter
  • text – Zeichenfolge, aus der die Unterzeichenfolge erhalten wird
  • find_text – Zeichenfolge, nach der im Parameter „text“ gesucht wird
Beispiel

var substrAfter = substring_after($form.getValue('/my:myFields/my:field_1', 'Needle');
jQuery.alert('substring after Needle of field_1 is: '+substrAfter);

substring_before(text,find_text)

Zurück zum Anfang

Gibt alle Zeichen in einer Zeichenfolge vor der Zeichenfolge „find_text“ aus. Wenn „find_text“ nicht in der Zeichenfolge gefunden wird, gibt diese Funktion die vollständige Zeichenfolge aus, die durch „text“ angegeben wurde.

Parameter
  • text – Zeichenfolge, aus der die Unterzeichenfolge erhalten wird
  • find_text – Zeichenfolge, nach der im Parameter „text“ gesucht wird
Beispiel

var substr = substring_before($form.getValue('/my:myFields/my:field_1', 'Needle');
jQuery.alert('substring before Needle of field_1 is: '+substr);

sum(field)

Zurück zum Anfang

Gibt die Summe der numerischen Werte in einer an ein bestimmtes Feld gebundenen, wiederholten Gruppe wieder.

Parameter
  • field – XPath eines numerischen Felds in einer wiederholten Gruppe
Beispiel

var total = sum('/my:myFields/my:Repeating_Table_2/my:Repeating_Content/my:SubTotal');
jQuery.alert('Total is: '+total);

today()

Zurück zum Anfang

Gibt ein Datumsobjekt mit dem aktuellen Tag und der Uhrzeit 00:00:00.000 aus.

Parameter

Keine

Beispiel

var todaysDate = today();
jQuery.alert('Today is: ' + date);

toLowerCase(text)

Zurück zum Anfang

Dadurch wird der „text“ zu nur kleingeschriebenen Zeichen konvertiert.

Parameter:
  • text – Zeichenfolge, die in Kleinbuchstaben konvertiert wird
Beispiel:

Um ein Eingabefeld automatisch in Kleinbuchstaben zu konvertieren:

$form.setValue('/my:myFields/my:field_1',toLowerCase($form.getValue('/my:myFields/my:field_1')));

toUpperCase(text)

Zurück zum Anfang

Dadurch wird der „text“ zu nur großgeschriebenen Zeichen konvertiert.

Parameter
  • text – Zeichenfolge, die in Großbuchstaben konvertiert wird
Beispiel

Um ein Eingabefeld automatisch in Großbuchstaben zu konvertieren:

$form.setValue('/my:myFields/my:field_1',toUpperCase($form.getValue('/my:myFields/my:field_1')));

translate(text,find_text,replace_text)

Zurück zum Anfang

Gibt eine neue Zeichenfolge aus, nachdem alle Instanzen von „find_text“ mit „replace_text“ in der Zeichenfolge „text“ ersetzt wurden.

Parameter
  • text – ursprünglicher Zeichenfolgenwert
  • find_text – Unterzeichenfolge, nach der in der ursprünglichen Zeichenfolge gesucht wird
  • replace_text – Unterzeichenfolge, mit der Instanzen von „find_text“ ersetzt werden
Beispiel

var modified = translate($form.getValue('/my:myFields/my:field_1'), 'this', 'that');
$form.setValue('/my:myFields/my:field_2', modified);