Altova MobileTogether Designer

mt-audio-get-current-position(ChannelNumber als xs:integer) als xs:decimal

Erhält als Argument die Nummer des Kanals, auf dem die Audiozieldatei wiedergegeben wird. Gibt eine Ganzzahl zurück, die die aktuelle Audiowiedergabeposition in Sekunden angibt. Beachten Sie, dass Informationen über die aktuellen Position erst nach Beginn der Wiedergabe zur Verfügung stehen. Die Funktion sollte daher erst nach Beginn der Wiedergabe verwendet werden.

Verwendung

mt-audio-get-current-position(2)

mt-audio-get-duration(ChannelNumber als xs:integer) als xs:decimal

Erhält als Argument die Nummer des Kanals, auf dem die Audiozieldatei wiedergegeben wird. Gibt eine Ganzzahl zurück, die die Dauer der aktuellen Audiodatei in Sekunden angibt. Beachten Sie, dass Informationen über die Dauer erst nach Beginn der Wiedergabe zur Verfügung stehen. Die Funktion sollte daher erst nach Beginn der Wiedergabe verwendet werden.

Verwendung

mt-audio-get-duration(5)

mt-audio-is-playing(ChannelNumber als xs:integer) als xs:boolean

Erhält als Argument die Nummer des zu überprüfenden Kanals. Gibt true()zurück, wenn das Client-Gerät eine Audiodatei wiedergibt. Gibt andernfalls false() zurück.

Verwendung

mt-audio-is-playing(3)

Beschreibung

Gibt true()zurück, wenn das Client-Gerät gerade Audio aufnimmt. Gibt andernfalls false() zurück.

Verwendung

mt-audio-is-recording()

mt-available-db-connection-names(FromSolution als xs:boolean) als item()*

Gibt die Namen aller verfügbaren Datenbankverbindungen zurück. Wenn FromSolution auf true(), gesetzt wurde, werden die Namen der Datenbankverbindungen in der Lösung zurückgegeben. Wenn FromSolution auf false() gesetzt wurde, werden die Namen der auf dem Server gespeicherten Datenbankverbindungen zurückgegeben. Das zurückgegebene Objekt ist eine Sequenz von Strings

Beispiele

Beschreibung

Gibt die Sprachen, die im Dialogfeld "Lokalisierung" definiert wurden, zurück.

Im Dialogfeld "Lokalisierung" wird jede Sprache durch ihren ISO-Sprachcode (Z.B.: en-US) und einen festgelegten Namen (z.B.: Englisch) definiert. Der Sprachcode der Standardsprache ist immer der leere String, der Name kann jedoch jeder beliebige definierte String sein.

Die Funktion gibt jede Sprache als Array von zwei Strings zurück, z.B.: [ "en-US", "Englisch" ]. Mehrere Sprachen werden als Sequenz von Array-Elementen zurückgegeben, z.B.: ( ["en-US", "Englisch"], ["de-DE", "Deutsch (DE)"] ). Das erste Array der Sequenz gibt immer die Standardsprache des Designs zurück. Wenn dh. (im Dialogfeld "Lokalisierung") kein Sprachenname für die Standardsprache definiert wurde, sind beide Strings des ersten Array leer; andernfalls enthält das erste Array-Element einen leeren String und den Namen, mit dem die Standardsprache bezeichnet wurde, (z.B: [ "", "MeineStandardsprache" ]).

Beachten Sie, dass die Rückgabesequenz als durch Leerzeichen getrennte Strings angezeigt werden.

Verwendung

mt-available-languages() könnte folgenden Anzeigewert zurückgeben:  en-US Englisch

mt-available-languages() könnte folgenden Anzeigewert zurückgeben:  en-US Englisch de-DE Deutsch (DE)

mt-available-languages()könnte folgenden Anzeigewert zurückgeben: MeineStandardsprache en-US Englisch

mt-base64-to-hexBinary(Base64Image als xs:base64Binary) als xs:string

Die Funktion konvertiert ein Base64-kodiertes Bild in einen hexBinary String. Das Argument Base64Image muss in base64Binary kodierter Text sein. Es kann ein Seitenquellen-Node, der solchen Text enthält, bereitgestellt werden.

Verwendung

mt-base64-to-hexBinary(\$XML1/Element1/@image) konvertiert ein Base64-Bild in hexBinay.

Beschreibung

Gibt die Uhrzeit zurück, zu der der Seitenquellen-Cache aktualisiert wurde. Wenn die Seitenquelle nicht im Cache gespeichert wurde, wird eine leere Sequenz zurückgegeben.

Verwendung

mt-cache-update-dateTime(\$XML1)

mt-called-by-enter-key() als xs:boolean

Gibt true() zurück, wenn der aktuelle Aktionsstapel durch Drücken der Eingabetaste ausgelöst wurde, andernfalls wird false() zurückgegeben. Zu wissen, dass der Benutzer die Eingabetaste und nicht z.B. die Esc-Taste gedrückt hat, würde Aufschluss über die Absicht des Benutzers geben. Anhand dieser Informationen kann eine bedingte Verarbeitung innerhalb des Aktionsstapels definiert werden.

mt-called-by-escape-key() als xs:boolean

Gibt true() zurück, wenn der aktuelle Aktionsstapel durch Drücken der Esc-Taste ausgelöst wurde, andernfalls wird false() zurückgegeben. Wenn der der Benutzer die Esc-Taste und nicht z.B. die Eingabetaste gedrückt hat, würde dies auf eine andere Absicht des Benutzers, als wenn er die Eingabetaste gedrückt hätte, hinweisen. Anhand dieser Informationen kann eine bedingte Verarbeitung innerhalb des Aktionsstapels definiert werden.

mt-change-image-colors(Base64Image als xs:base64Binary, SourceColors als xs:string+, TargetColors als xs:string+, Quality als xs:integer) als xs:base64Binary

Die Funktion erhält ein Base64-kodiertes Bild als erstes Argument, ändert die im Argument SourceColors (Quellfarben) angegebenen Bildfarben in die entsprechenden Zielfarben (TargetColors) und gibt das transformierte Bild als Base64-kodiertes Bild zurück.

•Base64Image muss ein in base64Binary kodierter Text sein. Ein Node, der solchen Text zurückgibt, kann verwendet werden.

•SourceColors und TargetColors müssen Sequenzen mit einem oder mehreren String-Einträgen sein. Die Anzahl der Einträge in den beiden Sequenzen muss dieselbe sein.

•Quality (Qualität) ist eine Ganzzahl von 1 bis 100. Damit wird die Qualität des Bilds definiert, wobei 100 für die höchste Qualität steht.

Beispiele

mt-client-ip-address() als xs:string

Gibt die IP-Adresse des Client, vom Server aus gesehen, zurück. Definieren Sie für Simulationen auf dem Register Simulation des Dialogfelds "Optionen" (Extras | Optionen) von MobileTogether Designer eine IP-Adresse.

Beispiel

mt-client-theme() als (xs:string, xs:string)

Gibt eine Sequenz von zwei Strings zurück. Der erste String ist das aktuell von der Lösung verwendete Design; dieser String kann den Wert light oder dark haben. Der zweite String ist die Designeinstellung der Lösung (welche in den Projekteigenschaften definiert wurde); sie kann den Wert light, dark oder default haben.

Beispiel

Beschreibung

Gibt true() zurück, wenn das Mobilgerät über LAN verbunden ist. Gibt andernfalls false() zurück.

Verwendung

mt-connected-via-lan()

Beschreibung

Gibt true() zurück, wenn das Mobilgerät über WLAN verbunden ist, gibt andernfalls false() zurück.

Verwendung

mt-connected-via-wifi()

mt-control-text-offset(ControlKind als xs:string) als xs:integer*

mt-control-text-offset(ControlKind als xs:string, Parameters als map) als xs:integer*

Gibt den Pixelwert des Versatzes nach links, oben, rechts und unten (in dieser Reihenfolge) des Inhalts des im Argument ControlKind angegebenen Steuerelements zurück. Das zweite Argument Parameters ist optional und ist eine Schlüssel-Wert-Zuordnung, die die Eigenschaften des Steuerelements definiert. Die verfügbaren Schlüssel und Werte sehen Sie in der Liste unten. Die Zuordnung filtert die in ControlKind angegebene Steuerelementart auf die Instanzen der Steuerelementart, die mit den Eigenschaftswerten in der Zuordnung übereinstimmen.

Anhand des Rückgabewerts dieser Funktion kann der Inhalt der ausgewählten Steuerelemente ausgerichtet werden. Siehe Beispiel unten.

Im Folgenden finden Sie die Schlüssel-Wert-Paare, die als Zuordnung des Arguments Parameters angegeben werden können. Die Reihenfolge der Schlüssel-Wert-Paare in der Zuordnung ist nicht festgelegt.

•"Text Size" : "small"|"medium"|"large"

•"Unit" : "px"|"dp"|"sp"|"" Standardwert ist "px". Informationen über das Verhältnis zwischen Pixel, dp (device-independent pixels) und sp (scale--independent pixels) finden Sie unter Größen: Pixel, DPI, DP, SP.

•"Bold Text" : "true"|"false"

•"Italic Text" : "true"|"false"

•"Underline Text" : "true"|"false"

•"Button Image" : Jede der Button Image (Schaltflächensymbol)-Optionen (z.B., "+"|"-"|">"|"Share")

•"Button Background" : "transparent"|"non-transparent". Standardwert ist "non-transparent".

Beispiel

mt-control-width(Text als xs:string*, Parameters als map(*)) als xs:integer?

Gibt die Mindestbreite des Steuerelements in Pixel zurück, wenn der Text-String der Anzeigetext des Steuerelements ist. Das Argument Text ist der Text, der auf dem Steuerelement angezeigt wird. Das Argument Parameters ist eine Schlüssel-Wert-Zuordnung, die die Eigenschaften des Steuerelements definiert. Die verfügbaren Schlüssel und Werte sehen Sie in der Liste unten. Die Ganzzahl, die zurückgegeben wird, ist die Mindestbreite des Steuerelements in Pixel, wenn der angegebene Text-String mit den im Argument Parameters definierten Eigenschaften angezeigt wird. Anhand dieses Werts können anschließend andere im Zusammenhang mit diesem Steuerelement stehenden Eigenschaften, wie z.B. die Breite von Tabellenspalten, in denen das Steuerelement vorkommt, berechnet und definiert werden.

Anmerkung: Diese Funktion steht nicht für die Darstellung auf dem Webclient zur Verfügung. Verwenden Sie zur Darstellung auf Webclients die Steuerelemente abmessen-Aktion.

Anmerkung: Diese Funktion kann nur in XPath-Ausdrücken von (i) Designaktionen und (ii) in der Option Beim Laden auf Vorhandensein überprüfen (XPath-Wert) von Seitenquellen-Struktur-Nodes verwendet werden. Sie ist in den XPath-Ausdrücken von Stileigenschaften nicht zulässig.

Im Folgenden finden Sie die Schlüssel-Wert-Paare, die als Zuordnung des Arguments Parameters angegeben werden können. Die Reihenfolge der Schlüssel-Wert-Paare in der Zuordnung ist nicht festgelegt. Wenn eine Steuerelementeigenschaft nicht in Form eines Schlüssel-Wert-Paars bereitgestellt wird, so wird der Standardwert dieser Eigenschaft (für das Steuerelement Beschriftung bzw. Schaltfläche)verwendet. Folglich ist nur der Parameter Control Kind obligatorisch.

•"Control Kind" : "Label"|"Button"

•"Text Size" : "small"|"medium"|"large"

•"Unit" : "px"|"dp"|"sp"|"" Standardwert ist "px". Informationen über das Verhältnis zwischen Pixel, dp (device-independent pixels) und sp (scale--independent pixels) finden Sie unter Größen: Pixel, DPI, DP, SP.

•"Bold Text" : "true"|"false"

•"Italic Text" : "true"|"false"

•"Underline Text" : "true"|"false"

•"Button Image" : Jede der Button Image (Schaltflächensymbol)-Optionen (z.B., "+"|"-"|">"|"Share")

•"Button Background" : "transparent"|"non-transparent". Standardwert ist "non-transparent".

Beispiele

mt-convert-units(Size als xs:string, TargetUnit als xs:string) als xs:string

Konvertiert den im Argument Size definierten Längenwert in den entsprechenden Wert in der durch das Argument TargetUnit definierten Einheit. Konvertiert kann zwischen jeweils zwei der folgenden Einheiten werden: px, dp und sp. Sowohl die Input-Argumente als auch der Ausgabewert sind Strings. Nähere Informationen zu Einheiten und der Konvertierung zwischen diesen Einheiten finden Sie unter Größen: Pixel, DPI, DP, SP.

Beispiele

Beschreibung

Gibt true zurück, wenn das Zeilenelement neue, geänderte oder gelöschte Spalten enthält. Gibt false zurück, wenn die Felder nicht geändert wurden. Die Funktion überprüft, ob Änderungen an der angegebenen Datenbankzeile vorgenommen wurden. Anmerkung: Damit diese Funktion korrekt funktioniert, muss das Element OriginalRowSet in der DB-Seitenquelle aktiviert sein.

Verwendung

mt-db-any-changed-fields(\$DB1/DB/RowSet/Row[3])

Beschreibung

Gibt true zurück, wenn die Variable \$DB (die eine DB-Quelle repräsentiert) neue, geänderte oder gelöschte Zeilen enthält. Gibt false zurück, wenn die DB nicht geändert wurde. Die Funktion überprüft, ob Änderungen an der angegebenen DB vorgenommen wurden und funktioniert auch, wenn das Element RowSets keinen Primärschlüssel hat. Anmerkung: Damit diese Funktion korrekt funktioniert, muss das Element OriginalRowSet in der DB-Seitenquelle aktiviert sein.

Verwendung

mt-db-any-changed-rows(\$DB1)

Beschreibung

Erhält als Input ein RowSet und gibt Feld-Attribute aus dem ursprünglichen Row-Element zurück.

•Bei neuen Zeilen: Die Funktion gibt keine Feldattribute zurück. Wenn die Funktion für eine neue Zeile aufgerufen wird, wird eine leere Liste zurückgegeben.

•Bei geänderten Zeilen: Die Funktion gibt deleted-field-Attribute zurück. Wenn die Funktion für eine geänderte Zeile aufgerufen wird, werden diejenigen Felder aus dem entsprechenden Originalzeilenelement zurückgegeben, die nicht unter dem Element RowSet aufgelistet werden.

•Bei gelöschten Originalzeilen: Die Funktion gibt alle Feldattribute zurück. Wenn die Funktion für eine Zeile, die in RowSet gelöscht wurde, aufgerufen wird, werden alle Felder der gelöschten Originalzeile zurückgegeben.

Anmerkung: Damit diese Funktion korrekt funktioniert, muss das Element OriginalRowSet in der DB-Seitenquelle aktiviert sein.

Verwendung

mt-db-deleted-original-fields(\$DB1/DB/RowSet/Row[1])

Beschreibung

Gibt alle OriginalRow-Elemente zurück, für die kein Row-Element vorhanden ist. Mit Hilfe der Funktion können Änderungen an Daten, die aus der Datenbank gelesen wurden, ermittelt werden. Anmerkung: Damit diese Funktion korrekt funktioniert, muss das Element OriginalRowSet in der DB-Seitenquelle aktiviert sein.

Verwendung

mt-db-deleted-original-rows(\$DB1)

Beschreibung

Erhält als einzigen Parameter eine Seitenquelle (Variable) und gibt den Dateipfad der dateibasierten Datenbank der Seitenquelle zurück. Der Dateipfad wird relativ zum Arbeitsverzeichnis der Lösungen angegeben.

Anmerkung

•Dies ist eine serverseitige Funktion, die nur auf dem Server ausgeführt werden kann.

•Die Funktion funktioniert mit SQLite- und Access-Datenbanken.

Verwendung

mt-db-file-path(\$DB1)

Beschreibung

Erhält als Input ein RowSet und gibt geänderte Feldattribute des angegebenen Row-Elements zurück.

•Bei neuen Zeilen: alle Feldattribute. Wenn die Funktion für eine neue Zeile aufgerufen wird, werden alle Felder zurückgegeben.

•Bei gelöschten Originalzeilen: alle Feldattribute. Wenn die Funktion für ein OriginalRow-Element (eines, dessen entsprechendes Row-Element gelöscht wurde) aufgerufen wird, werden alle Felder zurückgegeben.

•Bei geänderten Zeilen: Die Funktion gibt die geänderten Feldattribute zurück. Wenn die Funktion für eine geänderte Zeile aufgerufen wird, werden diejenigen Felder zurückgegeben, die einen anderen Wert als das entsprechende OriginalRow-Element enthalten.

Anmerkung: Damit diese Funktion korrekt funktioniert, muss das Element OriginalRowSet in der DB-Seitenquelle aktiviert sein.

Verwendung

mt-db-modified-fields(\$DB1/DB/RowSet/Row[3])

Beschreibung

Erhält als Input eine Datenbankquelle und gibt eine Sequenz geänderter Row-Elemente zurück, d.h. alle Row-Elemente unter dem Element RowSet, die sich vom ensprechenden Row-Element unter OriginalRowSet unterscheidet. Mit Hilfe dieser Funktion können Änderungen an aktuellen Zeilendaten im Vergleich zu den ursprünglichen aus der Datenbank ausgelesenen Zeilendaten ermittelt werden. Anmerkung: Damit diese Funktion korrekt funktioniert, muss das Element OriginalRowSet in der DB-Seitenquelle aktiviert sein.

Beachten Sie, dass Zeilen für diese Funktion anhand ihrer Primärschlüssel identifiziert werden. Diese Funktion überprüft nur, ob sich der Inhalt der Zeile geändert hat. Um die Datenbank auf neue Zeilen zu überprüfen, verwenden Sie die Funktion mt-db-new-rows. Um die Datenbank auf gelöschte Zeilen zu überprüfen, verwenden Sie die Funktion mt-db-deleted-original-rows. Eine Neuanordnung von Zeilen gilt nicht als Änderung.

Verwendung

mt-db-modified-rows(\$DB1)

Beschreibung

Erhält als Input ein RowSet und gibt neue Feldattribute des angegebenen Row-Elements zurück.

•Bei neuen Zeilen: alle Feldattribute. Wenn die Funktion für eine neue Zeile aufgerufen wird, werden alle Felder zurückgegeben.

•Bei geänderten Zeilen: Die Funktion gibt die neuen Feldattribute zurück. Wenn die Funktion für eine geänderte Zeile aufgerufen wird, gibt sie diejenigen Felder zurück, die unter dem entsprechenden OriginalRow-Element nicht aufgelistet sind.

•Für Originalzeilen: eine leere Liste. Wenn die Funktion für ein OriginalRow-Element (eines, dessen entsprechendes Row-Element gelöscht wurde) aufgerufen wird, wird eine leere Liste zurückgegeben.

Anmerkung: Damit diese Funktion korrekt funktioniert, muss das Element OriginalRowSet in der DB-Seitenquelle aktiviert sein.

Verwendung

mt-db-new-fields(\$DB1/DB/RowSet/Row[1])

Beschreibung

Erhält als Input eine Datenbankquelle und gibt eine Liste neuer Row-Elemente zurück, d.h. diejenigen Row-Elemente, die unter dem Element RowSet, nicht aber unter dem Element OriginalRowSet aufgelistet sind. Mit Hilfe der Funktion können Änderungen an Daten, die aus der Datenbank gelesen wurden, ermittelt werden. Anmerkung: Damit diese Funktion korrekt funktioniert, muss das Element OriginalRowSet in der DB-Seitenquelle aktiviert sein.

Verwendung

mt-db-new-rows(\$DB1)

Beschreibung

Damit Datenbankzeilen bearbeitet werden können, wird in der Datenbank-Seitenquelle in einem Element namens OriginalRowSet eine Kopie der Originalzeilengruppe gespeichert, während Änderungen in einer parallelen Datenstruktur namens RowSet gespeichert werden. Beim Speichern der Seitenquelle wird der Inhalt von RowSet in das Element OriginalRowSet kopiert.

Die Funktion mt-db-original-row erhält eine Zeile aus der RowSet-Datenstruktur und gibt die entsprechende Zeile aus der Originalstruktur zurück. Diese Funktion ist das Gegenteil der Funktion mt-db-row-from-original. Nähere Informationen dazu finden Sie in den Abschnitten Bearbeiten von DB-Daten und Speichern von Daten in der DB.

Anmerkung: Damit diese Funktion korrekt funktioniert, muss das Element OriginalRowSet in der DB-Seitenquelle aktiviert sein.

Verwendung

mt-db-original-row(\$DB1/DB/RowSet/Row[1]) gibt \$DB1/DB/OriginalRowSet/Row[1] zurück.

Beschreibung

Damit Datenbankzeilen bearbeitet werden können, wird in der Datenbank-Seitenquelle in einem Element namens OriginalRowSet eine Kopie der Originalzeilengruppe gespeichert, während Änderungen in einer parallelen Datenstruktur namens RowSet gespeichert werden. Beim Speichern der Seitenquelle wird der Inhalt von RowSet in das Element OriginalRowSet kopiert.

Die Funktion mt-db-row-from-original erhält eine Zeile aus Originalstruktur und gibt die entsprechende Zeile aus der RowSet-Datenstruktur zurück. Diese Funktion ist das Gegenteil der Funktion mt-db-original-row. Nähere Informationen dazu finden Sie in den Abschnitten Bearbeiten von DB-Daten und Speichern von Daten in der DB.

Anmerkung: Damit diese Funktion korrekt funktioniert, muss das Element OriginalRowSet in der DB-Seitenquelle aktiviert sein.

Verwendung

mt-db-row-from-original(\$DB1/DB/OriginalRowSet/Row[1]) gibt \$DB1/DB/RowSet/Row[1] zurück.

mt-email-attachment(Filename als xs:string, Content als item(), ContentType als xs:string) als array(*)

Bereitet den vom Argument Content bereitgestellten XML-, Base64- oder Textinhalt als E-Mail-Anhang auf. Ob der Inhalt als XML, Base64 oder Text geparst werden soll, ist vom Argument ContentType, welches als Wert entweder XML. Base64 oder text erhält, abhängig. Der Dateiname für den Anhang wird durch das Argument Filename bereitgestellt.

Anmerkung:  Die Funktion mt-email-attachment muss verwendet werden, wenn Sie die Option Dynamische Anhänge der Aktionen E-Mail senden an und Freigeben verwenden.

Anmerkung:  Bei E-Mails, die im HTML-Format gesendet werden, muss es sich beim E-Mail Body um korrekten HTML-Code handeln, d.h. er muss mit dem Element html beginnen. Ein gültiger Body könnte z.B. mit dem folgenden XPath/XQuery-Konstrukt erstellt werden: element html { element body { "Test" } }

Anmerkung: Anhänge können nur mit Android- und iOS-Clients versendet werden.

Beispiele

Beschreibung

Gibt den Fehlercode der letzten DB-, Lade- oder Speicher-Aktion zurück. Gibt den nativen Fehlercode des Betriebssystems oder der Datenbank zurück - z.B. 404, wenn eine Webseite nicht gefunden wurde.

Verwendung

mt-external-error-code()

Beschreibung

Gibt den Fehlertext der letzten DB-, Lade- oder Speicher-Aktion zurück. Der Fehlertext ist der Text, der zusammen mit dem Fehlercode zurückgegeben wird.

Verwendung

mt-external-error-text()

mt-extract-file-extension(FilePath als xs:string) als xs:string?

Gibt die Dateierweiterung (z.B. xml) der Datei zurück, deren Dateipfad im Argument FilePath angegeben ist. Der im Argument FilePath angegebene String muss das lexikalische Format eines absoluten oder relativen Pfads haben. Beachten Sie, dass die Funktion mt-last-file-path als FilePath-Argument verwendet werden kann.

Beispiele

mt-extract-file-name(FilePath als xs:string) als xs:string?

Gibt den Namen (den Abschnitt vor der Dateierweiterung) der Datei zurück, deren Dateipfad im Argument FilePath angegeben ist. Der im Argument FilePath angegebene String muss das lexikalische Format eines absoluten oder relativen Pfads haben. Beachten Sie, dass die Funktion mt-last-file-path als FilePath-Argument verwendet werden kann.

Beispiele

mt-font-height(TextSize als xs:string*, Unit als xs:string) als xs:string?

Gibt die als TextSize-Argument angegebene Höhe der Wörter in Pixel zurück. Zulässige Werte für das Argument Textgröße sind: smallest|small|medium|large|largest. Das optionale Argument Unit definiert die Einheiten, in denen die Höhe in Form einer Zahl zurückgegeben werden sollen; derzeit werden nur Werte in Pixel zurückgegeben.

Jede Plattform/Jedes Gerät hat eine eigene Pixelhöhe für die Größe in Wörtern. Mit Hilfe der Funktion mt-font-height können Sie daher den numerischen Wert ermitteln, der der Größe des Texts auf dem jeweiligen Gerät entspricht und anschließend einen anderen numerischen Wert berechnen. Um z.B. eine Größe zu erhalten, die 120% größer als die numerische Größe ist, die der Einstellung 'largest' auf einem Gerät entspricht, verwenden Sie für den Wert Textgröße den folgenden XPath-Ausdruck: mt-font-height('largest', 'px') * 1.2. Die Funktion generiert den numerischen (Pixel)wert, der der Größe 'largest' entspricht. Dieser Wert wird anschließend mit 1,2 multipliziert, um den numerischen Wert zu erhalten, der 120 % des Werts für 'largest' entspricht.

Anmerkung: Diese Funktion kann nur in XPath-Ausdrücken von (i) Designaktionen und (ii) in der Option Beim Laden auf Vorhandensein überprüfen (XPath-Wert) von Seitenquellen-Struktur-Nodes verwendet werden. Sie ist in den XPath-Ausdrücken von Stileigenschaften nicht zulässig.

Beispiele

mt-format-number(Number als xs:numeric, PictureString als xs:string) als xs:string

Erhält als erstes Argument eine Zahl, formatiert diese entsprechend dem zweiten Argument (PictureString) und gibt die formatierte Zahl als String zurück. Diese Funktion eignet sich, um schwer lesbare Zahlen in einem lesbaren Format zu formatieren. Der Musterstring kann auch Zeichen wie z.B. Währungssymbole enthalten und kann auch verwendet werden, um Zeichen in die formatierte Ausgabe einzufügen. Wenn an einer Ziffernstelle, an der in der Input-Zahl keine Ziffer vorhanden ist, eine Null eingefügt werden soll, so verwenden Sie im Musterstring an dieser Ziffernstelle eine Null (siehe Beispiele unten). Wenn nicht zwingend eine Null (oder ein anderes Zeichen) eingefügt werden soll, verwenden Sie die Raute (#).

Ziffern vor dem Dezimaltrennzeichen werden nie gekürzt. Der Dezimalteil einer Zahl (rechts vom Dezimaltrennzeichen) sowie die Stelle für die Währung (erste Stelle links vom Dezimaltrennzeichen) werden abgerundet, wenn der Musterstring des Dezimalteils kürzer als die Anzahl der Dezimalstellen in der Input-Zahl sind.

Anmerkung: Das Gruppenstrennzeichen und das Dezimaltrennzeichen in der formatierten Ausgabe auf dem Mobilgerät entsprechen den Zeichen, die in der auf dem Mobilgerät eingestellten Sprache verwendet werden.

Beispiele

mt-geo-map-marker(id als xs:string, geolocation als xs:string) als map (*)

mt-geo-map-marker(id als xs:string, geolocation als xs:string, popup? als (xs:string*)) als map (*)

mt-geo-map-marker(id als xs:string, geolocation als xs:string, popup? als (xs:string*), color? as xs:string) als map (*)

Die Funktion erstellt ein XPath-Kartenkonstrukt*, anhand dessen ein Marker für das Steuerelement "Geolocation-Karte" erstellt wird. Die Argumente id und geolocation der Funktion sind obligatorisch, die Argumente popup und color optional. Jeder der bereitgestellten Strings wird als Text in einem Wert von einem der Schlüssel-Wert-Paare des Kartenkonstrukts zurückgegeben (siehe Beispiele unten). Jeder Schlüssel des zurückgegebenen Kartenkonstrukts erhält seinen Wert aus dem entsprechenden Argument der Funktion, wobei diese Entsprechungen anhand der Indexnummer des Arguments ermittelt werden. So liefert z.B. das erste Argument der Funktion den Wert des id-Schlüssels. Beachten Sie, dass das dritte Argument der Funktion eine Sequenz von Strings ist. Anhand dieser Strings werden der Titel und Text des Marker Popups generiert. Der erste String stellt den Titel des Popups bereit; die folgenden Strings werden miteinander verkettet und liefern den Text des Popups, wobei mit jedem String eine neue Zeile begonnen wird. Wenn kein Popup erstellt werden soll, stellen Sie eine leere Sequenz als drittes Argument bereit. Das Argument color (Farbe) kann in Form von Text (z.B. "green") oder als RGB-Wert (z.B. "#336699") angegeben werden. Wenn kein color -Argument definiert wurde, wird die Standard-Marker-Farbe des Geräts verwendet.

Beachten Sie, dass jede Funktion einen Marker zurückgibt. Um mehrere Marker zu generieren, verwenden Sie eine Sequenz mehrerer mt-geo-map-marker-Funktionen. Siehe Beispiele unten. Beachten Sie außerdem, dass Sie die Funktion mt-geo-map-marker, wie im dritten Beispiel unten gezeigt (in dem eine if-then-else-Konstruktion verwendet wird), in anderen XPath-Ausdrücken verwenden können.  

* XPath-Kartenkonstrukt: eine XPath-Datentypkonstruktion ähnlich einem XPath Array. Das Kartenkonstrukt ist eine Sequenz von Schlüssel-Wert-Paaren (siehe die im ersten Beispiel des Abschnitts "Verwendung" unten retournierte Beispielkarte). Beachten Sie, dass sich die Semantik von "map" in "XPath-Kartenkonstrukt" auf die Zuordnung von Schlüsseln zu Werten in XPath und nicht auf eine kartographische Zuordnung bezieht.

Verwendung

mt-geo-map-marker("vie","48.2143531 16.3707266", ("Vienna","Altova EU","European headquarters"), "green") gibt ein einzelnes XPath-Kartenkonstrukt zurück, welches wiederum einen einzigen Marker im Geolocation-Karten-Steuerelement generiert:

map {

    "id":"vie",

    "geolocation":(48.2143531, 16.3707266),

    "title":"Vienna",

    "text":"Altova EU

            European headquarters",

    "color":"green"

}

mt-geo-map-marker("vie","48.2143531 16.3707266", ("Vienna","Altova EU")), mt-geo-map-marker("bev","42.5584577 -70.8893334", ("Beverly","Altova US")) gibt zwei XPath-Kartenkonstrukte und somit zwei Marker für das Geolocation-Karten-Steuerelement zurück.

mt-geo-map-marker("vie","48.2143531 16.3707266", ("Vienna","Altova EU")),

mt-geo-map-marker("bev","42.5584577 -70.8893334",("Beverly","Altova US")),

if ( \$XML/MapMarkers/@withLondon = "1" ) then

    mt-geo-map-marker("lon","51.50939 -0.11832", ("London","No Altova") )

else

  ()

gibt zwei XPath-Kartenkonstrukte plus ein drittes XPath-Kartenkonstrukt für den Standort "London" zurück, wenn das Attribut @withLondon den Wert "1" hat, d.h. die Funktion generiert im Endeffekt zwei oder drei Marker für das Geolocation-Karten-Steuerelement.

Beschreibung

Gibt true() zurück, wenn in der Lösung die Standortverfolgung gestartet wurde, gibt andernfalls false() zurück.

Verwendung

mt-geolocation-started()

mt-get-page-source-from-name(PageSourceName als string) als document-node

Gibt den Dokument-Node der Seitenquelle, deren Name mit dem angegebenen String übereinstimmt, zurück. Sie können Nodes dadurch über einen XPath-Ausdruck aufrufen. Wenn keine Seitenquelle auf der aktuellen Seite einen Namen hat, der mit dem angegebenen String übereinstimmt, wird ein Fehler ausgelöst. Das bereitgestellte String-Argument muss das vorangestellte \$-Zeichen nicht enthalten.

Verwendung

mt-get-page-source-from-name("\$PERSISTENT") gibt den Dokument-Node der Seitenquelle \$PERSISTENT zurück.

mt-get-page-source-from-name("PERSISTENT") gibt den Dokument-Node der Seitenquelle \$PERSISTENT zurück.

mt-get-page-source-name(PageSource als node()) als xs:string

Gibt den Namen der mit dem Argument PageSource angegebenen Seitenquelle zurück. Der Name wird als String zurückgegeben.

Verwendung

mt-get-page-source-name(\$XML1) gibt den String "\$XML1" zurück.

mt-get-page-source-name(\$PERSISTENT) gibt den String "\$PERSISTENT" zurück.

mt-get-page-source-structure(PageSource als node() oder als xs:string) als xs:string

mt-get-page-source-structure(PageSource als node() oder als xs:string, EnsureValues als boolean) als xs:string

mt-get-page-source-structure(PageSource als node() oder als xs:string, EnsureValues als boolean, Path als xs:string) als xs:string

Gibt die Struktur der mit dem Argument PageSource angegebenen Seitenquelle zurück. Wenn das Argument EnsureValues auf true() gesetzt wurde, wird auch der Inhalt der Nodes zurückgegeben. Wenn EnsureValues auf false() gesetzt wurde oder wenn kein zweites Argument angegeben wird (siehe erste Signatur oben), wird die Seitenquelle ohne Inhalt zurückgegeben. Die Struktur und der Inhalt sind die zum Zeitpunkt des Ladens der Seite geladenen.

Wenn Sie eine bestimmte Substruktur der durch den ersten Parameter PageSource retournierten Struktur auswählen möchten, kann ein drittes Argument (Path) als String definiert werden. Der String wird als XPath Locator-Ausdruck im Kontext des durch PageSource zurückgegebenen Node ausgewertet. Wenn es sich beim durch diesen Ausdruck zurückgegebenen Node um ein Element handelt, wird das Element mit seinen Attributen, aber ohne Child-Elemente retourniert.

Verwendung

mt-get-page-source-structure(\$XML1) gibt die Datenstruktur der Seitenquelle \$XML1 zum Zeitpunkt des Ladens der Seitenquelle, jedoch ohne Werte zurück.

mt-get-page-source-structure(\$XML1, true()) gibt die Datenstruktur der Seitenquelle \$XML1 mit Werten zurück.

mt-get-page-source-structure(\$XML1/Companies/Company, false(), "Departments/Department) gibt das Element Department mit seinen Attributen, jedoch ohne Werte zurück.

for \$i in mt-get-page-source-structure(\$XML1, true()) return \$i//Product[1] gibt den Inhalt des ersten Product-Elements der Seitenquelle \$XML1 zum Zeitpunkt des Ladens der Seitenquelle zurück.

Beschreibung

Gibt true zurück, wenn Zugriff auf den Server besteht und gibt andernfalls false zurück. Die Funktion überprüft, ob innerhalb der durch das Argument TimeoutSeconds definierten Anzahl von Sekunden eine Verbindung zu MobileTogether Server hergestellt werden kann.

Verwendung

mt-has-serveraccess(TimeoutSeconds as integer)

mt-hexBinary-to-base64(HexBinary als xs:string) als xs:base64Binary

Die Funktion konvertiert einen hexBinary String in einen Base64-kodierten String (normalerweise ein Bild). Als das HexBinary-Argument kann ein Node, der den benötigten HexBinary-String enthält, bereitgestellt werden.

Verwendung

mt-hexBinary-to-base64('48656C6C6F20576F726C64') gibt den Base64-String 'SGVsbG8gV29ybGQ=' zurück.

mt-hexBinary-to-string(HexBinary als xs:string, Encoding als xs:string) als xs:string

Die Funktion konvertiert einen hexBinary String in einen Textstring, der mit der im Argument Encoding genannten Kodierung kodiert ist. Als das HexBinary-Argument kann ein Node, der den benötigten HexBinary-String enthält, bereitgestellt werden. Wenn der leere String als Encoding-Argument bereitgestellt wird, wird der Ergebnistextstring in der Standardkodierung 'UTF-8' generiert. Wenn kein Encoding-Argument angegeben wird, ist dies ein Fehler.

Beispiele

Beschreibung

Die Funktion mt-html-anchor erhält zwei Argumente: LinkText und TargetURL. Anhand dieser beiden Argumente wird ein HTML-Hyperlink-Element erstellt: <a href="TargetURL">LinkText</a>. Dieser Link kann in als HTML gesendete E-Mails eingefügt werden, die über die Aktion E-Mail senden an gesendet werden. Über den Link kann eine Internet-Seite oder eine MobileTogether-Lösung aufgerufen werden. Um einen Link zum E-Mail-Textkörper hinzuzufügen, verwenden Sie die Funktion mt-html-anchor im XPath-Ausdruck der Option Körper (siehe Abbildung unten).

Beispiele

mt-image-width-and-height(Image als base64encoded-image) als xs:integer+

Das Argument Image ist die Base64-Kodierung des Bilds, dessen Größe Sie kennen möchten. Das Argument muss vom Typ xs:base64Binary sein. Normalerweise würde das Argument den Pfad zu einem Node enthalten, der die Base64-kodierten Daten enthält. Die Funktion gibt eine Sequenz von zwei Ganzzahlen zurück: (i) die Breite des Bilds in Pixel, (ii) die Höhe des Bilds in Pixel.

Beispiele

mt-in-app-purchase-platform-to-product(PlatformID als xs:string) als xs:string

Das Argument PlatformID ist die ID eines Produkts auf einer bestimmten Plattform. Die Funktion gibt den laut Dialogfeld In-App-Kauf-Produkte auf diese Produkt-ID gemappten Produktnamen zurück. Siehe auch die Funktion mt-in-app-purchase-product-to-platform().

Beispiele

mt-in-app-purchase-product-to-platform(ProductName als xs:string) als xs:string

Das Argument ProductName ist der Name eines Produkts, so wie er im Dialogfeld "In-App-Kauf-Produkte" definiert wurde. Die Funktion gibt die ID des Produkts auf der aktuellen Plattform gemäß dem Mapping im Dialogfeld "In-App-Kauf-Produkte" zurück. Siehe auch die Funktion mt-in-app-purchase-platform-to-product().

Beispiele

mt-in-app-purchase-service-started() als xs:boolean

Überprüft, ob das Client-Gerät alle erforderlichen Voraussetzungen einschließlich eines laufenden Abrechnungsdiensts erfüllt, um im jeweiligen App Store In-App-Käufe durchzuführen. So wäre etwa auf Android ein Benutzerkonto für den App Store erforderlich, um einen In-App-Kauf durchführen zu können. Die Funktion gibt true() zurück, wenn der Dienst verfügbar ist und false(), falls dies nicht der Fall ist.

Beispiele

mt-invert-color(Color als xs:string) als xs:string

Das Argument Color ist der RGB-Farbcode (im Hexadezimalformat), z.B. "#00FFFF". Jede Farbkomponente (R, G und B) im Code wird invertiert und der neue Farbcode wird zurückgegeben.

Beispiele

Beschreibung

Gibt true zurück, wenn es sich bei allen MobileTogether Server zugewiesenen Lizenzen um gekaufte Lizenzen handelt. Gibt false zurück, wenn eine oder mehrere zugewiesene Lizenzen Testlizenzen sind. Tipp: Wenn eine Testlizenz nicht mehr benötigt wird, heben Sie die Zuweisung dieser Lizenz auf.

Beachten Sie die folgenden Punkte:

•Auf Clients gibt die Funktion standardmäßig false zurück. Nur wenn ein Request an einen Server gesendet wird, wird der Gekauft-Status der Serverlizenzen zurückgegeben

•Am Simulator gibt die Funktion immer false zurück. Mit Hilfe der entsprechenden Simulator-Option können Sie eine gekaufte Lizenz simulieren. Wenn Sie diese Option bei Simulationen im Designer und bei Testausführungen auf dem Client aktivieren, wird simuliert, dass MobileTogether Server-Lizenzen gekauft wurden. Bei Simulationen auf dem Server wird der tatsächliche Gekauft-Status der Lizenzen auf dem Server retourniert.

Verwendung

mt-is-server-purchased()

mt-last-file-path() als xs:string?

Gibt den vollständigen Dateipfad (auf Android z.B. storage/emulated/0/Download/MeineDatei.xml) der in einer der folgenden Aktionen zuletzt verwendeten (geladenen oder gespeicherten) Client-Datei zurück: Audioaufnahme, Videoaufnahme, Datei laden/speichern, Binärdatei laden/speichern, Bild laden. Beachten Sie, dass diese Funktion von einige Nicht-Android-Betriebssystemversionen eventuell nicht unterstützt wird.

Verwendung

mt-last-file-path()

mt-last-in-app-purchase-response-code() als xs:integer

Gibt den Erfolgs-/Fehlercode des letzten vom Client-Gerät an den App Store gesendeten Kauf-Request zurück. Wenn der Request erfolgreich ausgeführt wurde, ist der Code normalerweise 0, andernfalls wird eine Ganzzahl zurückgegeben. Die Funktion ist nützlich, um zu überprüfen, ob ein Schritt des Workflow korrekt durchgeführt wurde. Damit in Zusammenhang stehen die Funktionen mt-in-app-purchase-response-text() und mt-in-app-purchase-response-was-user-canceled().

Beispiele

mt-last-in-app-purchase-response-text() als xs:string

Gibt eine Textmeldung zurück, die den Erfolg/Fehler des letzten In-App-Kauf-Request beschreibt. Die Funktion ist besonders dann nützlich, wenn ein Fehler aufgetreten ist, da Sie damit eine Textbeschreibung des Fehlers erhalten. Damit in Zusammenhang stehen die Funktionen mt-in-app-purchase-response-was-user-canceled() und mt-in-app-purchase-response-code().

Beispiele

mt-last-in-app-purchase-response-was-user-canceled() als xs:boolean

Überprüft beim App Store, ob der letzte In-App-Kauf vom Benutzer abgebrochen wurde. Gibt true() zurück, wenn der letzte Kauf abgebrochen wurde, und gibt andernfalls false() zurück. Damit in Zusammenhang stehen die Funktionen mt-in-app-purchase-response-text() und mt-in-app-purchase-response-code(). Mit Hilfe dieser Funktion können Sie diese Art von fehlgeschlagenem Kauf-Request von anderen Arten von Fehlern, die dabei auftreten können, unterscheiden.

Beispiele

Beschreibung

Die Funktion erhält als Argument einen String in Form einer serialisierten JSON-Struktur. Die JSON-Struktur wird in XML konvertiert, in ein Element namens json verpackt und als Dokument-Node zurückgegeben. Wenn Sie z.B. das folgende JSON-Dokument in einem String (d.h. innerhalb von Anführungszeichen) als Argument der Funktion bereitstellen:

{

   "Root": {

      "user": "Altova",

      "message": "Hello",

      "A": {

         "B": "B Text",

         "C": "C Text",

         "D": {

         }

      }

   }

}

Daraufhin gibt die Funktion einen Dokument-Node zurück, der ein Dokument-Element namens json enthält, das wiederum die in XML konvertierte JSON-Struktur enthält. Das Child-Element von json ist Root.

Da von der Funktion ein Dokument-Node zurückgegeben wird, können Sie Teile des retournierten Dokuments durch Anhängen eines XPath-Locator-Ausdrucks an die Funktion aufrufen. Wenn Sie z.B. den folgenden Ausdruck auswerten (in dem der Locator-Ausdruck gelb markiert ist):

mt-load-json-from-string('{

      "A": {

         "B": "B Text",

         "C": "C Text",

         "D": {

         }

      }

}')/json/A/C

erhalten Sie als Ergebnis "C Text".

Verwendung

mt-load-json-from-string('{ "A": "A Text" }') gibt den Dokument-Node zurück, der ein Dokument-Element namens json hat, welches ein einziges Child-Element namens A hat.

mt-load-json-from-string('{ "A": "A Text" }')/* gibt alle Elemente des Dokuments zurück, d.h. das Element json mit einem einzigen Child-Element namens A.

Beschreibung

Gibt den durch das Argument StringName angegebenen benutzerdefinierten String zurück. Jeder dieser benutzerdefinierten Strings bildet Teil eines String-Pools, der im Dialogfeld "Lokalisierung" definiert wird. Jeder StringName ist im String-Pool mit mehreren lokalisierten Strings verknüpft. Welcher lokalisierte String ausgewählt wird, hängt von der Sprache ab, die auf dem Mobilgerät eingestellt ist bzw. welche Simulationssprache ausgewählt ist.

Verwendung

mt-load-string('StringName')

Bei Eingabe der Funktion mt-load-string im Dialogfeld "XPath/XQuery-Ausdruck bearbeiten" werden alle benutzerdefinierten Strings in einem Popup-Fenster angezeigt (siehe Abbildung unten). Um dieses Popup-Fenster zu sehen, platzieren Sie den Cursor innerhalb der umschließenden Apostrophe bzw. Anführungszeichen von 'StringName' und drücken Sie Strg+Leertaste.

Mit den Pfeiltasten der Tastatur können Sie durch die Liste springen. Der Wert des ausgewählten benutzerdefinierten String wird rechts vom Popup-Fenster angezeigt (siehe Abbildung oben). Die Sprache, in der der lokalisierte Wert angezeigt wird, ist diejenige, die aktuell in MobileTogether Designer als Simulationssprache ausgewählt ist. Um den Namen eines benutzerdefinierten String in den XPath-Ausdruck einzugeben, wählen Sie den String aus oder gehen Sie in der Liste der benutzerdefinierten Strings zum gewünschten String und drücken Sie die Eingabetaste.

mt-localized-string-name(Text als xs:string) als xs:string*

mt-localized-string-name(Text als xs:string, Lang als xs:string) als xs:string*

Die Funktion erhält als (erstes) Argument einen Textstringwert in der Standardsprache bzw. in einer lokalisierten Sprache und gibt den Namen des Steuerelements oder String zurück, der den bereitgestellten Textstringwert als Textwert hat. Nähere Informationen dazu finden Sie unter Lokalisierung und Projekt | Lokalisierung. Die Funktion hat zwei Signaturen. In der zweiten Signatur ist die Sprache des Textstring das zweite Argument (Lang). Das Argument Lang sollte mit den Namen einer lokalisierten Sprache übereinstimmen. Wenn Lang definiert ist, so werden nur die Strings dieser lokalisierten Sprache nach einem Textstring durchsucht, der mit dem im Argument Text bereitgestellten Textstring übereinstimmt.

Beispiele

Beschreibung

Gibt true() zurück, wenn in der Lösung NFC gestartet wurde, gibt andernfalls false() zurück.

Verwendung

mt-nfc-started()

Beschreibung

Gibt eine Liste geöffneter Seiten zurück. Dabei handelt es sich um eine String-Sequenz, d.h. sie besteht aus den Namen der Seiten, wobei die Namenspaare durch Leerzeichen getrennt sind.

Verwendung

mt-page-stack()

Beschreibung

Diese Funktion steht nur zur Verfügung, solange die Aktionen der Fortschrittsanzeige ausgeführt werden. Der Standardwert ist false(). Die Funktion gibt true() zurück, wenn die Aktion Fortschritt Abbruch senden ausgelöst wird, während eine Gruppe von Fortschrittsanzeigeaktionen ausgeführt wird. Der Wert dieser Funktion kann daher verwendet werden, um die Absicht des Client-Benutzers, die Aktionen abzubrechen, aufzunehmen und somit die Server-Aktionen abzubrechen.

Verwendung

Wenn mt-progress-cancelling()=true(), dann führe eine oder mehrere Aktionen zum Abbruch der Server-Aktionen aus und setze weitere eventuell erforderliche Aktionen (z.B. Zurücksetzen eines Node-Werts auf den Wert vor Ausführung der Aktion).

Beschreibung

Lädt die derzeit verfügbaren Benutzerrollen vom Server. Die Funktion aktualisiert die auf dem Server definierten Benutzerrollen, die mit Hilfe der globalen Variablen MT_UserRoles abgefragt werden können.

Verwendung

mt-refresh-userroles()

Beschreibung

Gibt die Uhrzeit zurück, um die die Seitenquelle neu geladen wurde. Wenn die Seitenquelle nicht geladen wurde, wird eine leere Sequenz zurückgegeben.

Verwendung

mt-reload-dateTime(\$XML1)

mt-run-appstoreapp-url(Scheme? als xs:string, Host? als xs:string, InputParameters? als xs:string) als xs:string?

mt-run-appstoreapp-url(InputParameters? als xs:string) als xs:string?

Generiert entweder (i) anhand der drei bereitgestellten Argumente oder (ii) anhand eines einzelnen InputParameters-Arguments die URL einer MobileTogether AppStore App. Bei Klick auf die normalerweise per E-Mail gesendete URL wird die AppStore App gestartet. Die URL muss das folgende Format haben: <url-scheme>://<url-host>. Die Manifest-Datei der App enthält die Schemainformationen, anhand derer das Gerät, weiß, dass URLs, die mit diesem Schema beginnen, über diese App geöffnet werden sollen. Nähere Informationen dazu finden Sie im Abschnitt AppStore Apps.

•Scheme: Der mit der App verknüpfte eindeutige Schemaname. Das Schema wird (in Bildschirm 1 des "Programmcode generieren"-Assistenten) bei der Generierung des App-Programmcodes zugewiesen. Wenn dieses Argument fehlt oder wenn ein leerer String bereitgestellt wird, so wird als Schema das der aktuell laufenden App verwendet.

•Host: Der mit der App verknüpfte eindeutige Host-Name. Der Host wird (in Bildschirm 1 des "Programmcode generieren"-Assistenten) bei der Generierung des App-Programmcodes zugewiesen. Wenn dieses Argument fehlt oder wenn ein leerer String bereitgestellt wird, so wird als Host-Name der der aktuell laufenden App verwendet.

•InputParameters: Erhält als Input die Funktion mt-run-solution-url-parameters. Das Argument der Funktion ist eine Sequenz von String-Werten, die die Werte der Abfrageparameter liefern. Die Funktion mt-run-solution-url-parameters gibt einen String mit den Parametern (Namen und Werten) des Abfragestring der URL zurück. Dieser String ist richtig kodiert und gemäß den Regeln zur Kodierung URL-Abfragestrings mit Escape-Zeichen versehen. Die Parameternamen im Ergebnisstring werden von der Funktion automatisch generiert (sie lauten: in1, in2 ... inN) und jedem Namen wird ein Wert aus den String-Elementen des Funktionsarguments zugewiesen, wobei die Namen-Wert-Paare in Indexreihenfolge angeordnet sind. (Zusätzlich dazu kann das Argument InputParameters als ein bereits für den Abfragestringteil einer URL kodierter String bereitgestellt werden (siehe zweites Beispiel unten).

Die Funktion mt-run-appstoreapp-url erstellt somit eine URL mit oder ohne Abfrageparameter. Diese URL öffnet eine MobileTogether AppStore App . Die Abfrageparameter werden an die App übergeben, wenn die App über die URL geöffnet wird. Die Werte dieser Parameter können mit Hilfe der globalen Variable \$MT_InputParameters in anderen Designkomponenten aufgerufen werden.

Beispiele

mt-run-solution-url(ServerAddress? als xs:string, SolutionName? als xs:string, InputParameters? als xs:string) als xs:string?

Generiert eine URL, über die die angegebene Lösung auf einem MobileTogether Client geöffnet wird. Wenn der Benutzer auf die URL tippt, wird die Altova MobileTogether Client App geöffnet und die Lösung wird in der App gestartet. Die URL wird entweder (i) anhand der drei in der Funktion bereitgestellten Argumente (siehe Liste unten) oder (ii) anhand des InputParameters-Arguments der Funktion generiert.

•ServerAddress: Erhält den Namen der IP-Adresse des MobileTogether Servers, auf dem die gewünschte Lösung bereitgestellt wurde.  Wenn dieses Argument fehlt oder wenn es sich um den leeren String handelt, wird der aktuelle Server verwendet.

•SolutionName: Erhält den Pfad der auf dem Server bereitgestellten Lösung. Zum Beispiel: /public/MySolution (Dieser Pfad würde auf die Datei MySolution.mtd im Container /Public verweisen). Wenn dieses Argument fehlt oder wenn es sich um den leeren String handelt, wird die aktuelle Lösung verwendet.

•InputParameters: Erhält die Funktion mt-run-solution-url-parameters als Input. Das Argument der Funktion mt-run-solution-url-parameters ist entweder (i) eine Sequenz von String-Werten, die die Werte der Abfrageparameter bilden oder (ii) eine Zuordnung von Schlüssel:Wert-Paaren, die den Namen und Wert des entsprechenden Parameters bereitstellen. Diese Funktion gibt einen gemäß den Regeln zum Kodieren von URL-Abfragestrings korrekt kodierten und mit Prozentzeichen als Escape Zeichen versehenen String zurück. Siehe Beschreibung der mt-run-solution-url-parameters-Funktion weiter unten. (Zusätzlich dazu kann das Argument InputParameters als bereits für den Abfragestringteil einer URL kodierter String bereitgestellt werden (siehe viertes Beispiel unten).)

Die Funktion mt-run-solution-url erstellt daher eine URL mit oder ohne Abfrageparameter, über die eine Lösung auf einem MobileTogether Server aufgerufen wird. Die Abfrageparameter werden an die Lösung übergeben, wenn die Lösung über die URL geöffnet wird. Die Werte dieser Parameter können mit Hilfe der globalen Variablen \$MT_InputParameters in anderen Designkomponenten aufgerufen werden.

Beispiele

Beachten Sie die folgenden Punkte:

•Das erste Argument, ServerAddress, wird verwendet, um auf dem Client Informationen über einen Server mit dem angegebenen Namen/der angegebenen Adresse abzurufen. Anschließend wird anhand der mit dem Servernamen verknüpften Portnummer, des Benutzernamens und des Benutzerpassworts eine Verbindung zum Server herzustellen. Wenn daher eine URL mit einem Servernamen, der vom Client nicht erkannt wird, generiert wird, so funktioniert die URL nicht.

•Das zweite Argument, SolutionName: (i) generiert den Bereitstellungspfad (auf dem Server), wenn die Lösung auf dem Server ausgeführt wird, (ii) generiert jedoch bei Simulationen einen Dateipfad.

•Im dritten Argument, InputParameters, werden mit Hilfe der MobileTogether-spezifischen XPath-Erweiterungsfunktion mt-run-solution-url-parameters die Parameter-Wert-Paare der Abfrage generiert und kodiert. Die Funktion mt-run-solution-url-parameters (welche die Abfrageparameter kodiert) darf nicht mit der Funktion mt-run-solution-url (welche die gesamte URL generiert) verwechselt werden.

mt-run-solution-url-parameters((Parameters*) als xs:string) als xs:string?

mt-run-solution-url-parameters(Map als map) als xs:string?

Die Funktion mt-run-solution-url-parameters ist für die Verwendung als drittes Argument der Funktion mt-run-solution-url gedacht. Das einzige Argument der Funktion ist entweder eine Sequenz von String-Werten oder eine Zuordnung von Schlüssel-Wert-Paaren. Das damit generierte Ergebnis ist ein einzelner String, der den Abfrage-String-Teil bildet, der (als Argument) für die Funktion mt-run-solution-url bereitgestellt wird. Es enthält die Parameter (Namen und Werte) des gemäß den Regeln zur Kodierung von URL-Abfragestrings korrekt kodierten und mit Prozentzeichen als Escape Zeichen versehenen Abfragestring.

Sequenz

Das Argument ist eine Sequenz von String-Werten, die die Parameterwerte des Abfragestring bereitstellen. Die Parameternamen im Ergebnisstring werden automatisch von der Funktion generiert (sie lauten: in1, in2 ... inN). Jedem Namen wird ein Wert aus den String-Elementen des Funktionsarguments zugewiesen, wobei die Namen und Werte einander in Indexreihenfolge zugeordnet werden. Siehe Sequenzbeispiele unten.

Zuordnung

Die Parameter (Namen und Werte) können auch als eine Zuordnung von Schlüssel:Wert-Paaren angegeben werden. Zum Beispiel: map{"key1":"value1", "key2":"value2"}. Die Reihenfolge von Parametern spielt keine Rolle, da jeder Parameterwert einem bestimmten Parameternamen mittels Schlüssel zugewiesen ist. Siehe Zuordnungsbeispiele unten.

Anmerkung:   Wenn der Parameter-String doppelte Anführungszeichen enthält, so ändern Sie diese in einfache Anführungszeichen, da in MobileTogether zum Erstellen des Parameterstrings doppelte Anführungszeichen verwendet werden. Sie können die doppelten Anführungszeichen mittels der XPath-Funktion replace in einfache Anführungszeichen ändern: replace(<string>, '"', "'"). Siehe auch die C'est la vie-Beispiele unten, in denen der Text durch doppelte (nicht einfache) Anführungszeichen getrennt werden muss.

Die Werte dieser Parameter können mit Hilfe der globalen Variablen \$MT_InputParameters in anderen Designkomponenten aufgerufen werden.

Beispiel

mt-run-web-url(ServerAddress? as xs:string, SolutionName? als xs:string, InputParameters? als xs:string) als xs:string?

mt-run-web-url(InputParameters? as xs:string) als xs:string?

Generiert eine URL, die in einen Webbrowser eingegeben wird, um die angegebene Lösung im Browser zu öffnen. Die URL wird entweder (i) anhand der drei in der Funktion bereitgestellten Argumente (siehe Liste unten) oder (ii) anhand des InputParameters-Arguments der Funktion generiert.

•ServerAddress: Erhält den Namen der IP-Adresse des MobileTogether Servers, auf dem die gewünschte Lösung bereitgestellt wurde. Wenn dieses Argument fehlt oder wenn es sich um den leeren String handelt, wird der aktuelle Server verwendet.

•SolutionName: Erhält den Pfad der auf dem Server bereitgestellten Lösung, z.B.: /public/MySolution (Dieser Pfad würde auf die Datei MySolution.mtd im Container /Public verweisen). Wenn dieses Argument fehlt oder wenn es sich um den leeren String handelt, wird die aktuelle Lösung verwendet.

•InputParameters: Erhält die Funktion mt-run-solution-url-parameters als Input. Das Argument der Funktion ist eine Sequenz von String-Werten, die die Werte der Abfrageparameter bereitstellen. Die Funktion mt-run-solution-url-parameters gibt einen String mit den Parametern (Namen und Werte) des gemäß den Regeln zur Kodierung von URL-Abfragestrings korrekt kodierten und mit Prozentzeichen als Escape Zeichen versehenen Abfragestring der URL zurück. Die Parameternamen im Ergebnisstring werden automatisch von der Funktion generiert (die Namen sind: in1, in2 ... i) und jedem Namen wird ein Wert aus den String-Elementen des Funktionsarguments zugewiesen, wobei die Namen-Wert-Paare in Indexreihenfolge angeordnet sind. (Zusätzlich dazu kann das Argument InputParameters als bereits für den Abfragestringteil einer URL kodierter String bereitgestellt werden (siehe viertes Beispiel unten).)

Die Funktion mt-run-web-url erstellt daher eine URL mit oder ohne Abfrageparameter, über die eine Lösung auf einem MobileTogether Server aufgerufen wird. Die Abfrageparameter werden an die Lösung übergeben, wenn die Lösung über die URL geöffnet wird. Die Werte dieser Parameter können mit Hilfe der globalen Variablen \$MT_InputParameters in anderen Designkomponenten aufgerufen werden.

Beispiele

Beachten Sie die folgenden Punkte:

•Wenn das erste Argument, ServerAddress, ein leerer String ist, so wird der aktuelle Server verwendet.

•Das erste Argument, ServerAddress, wird verwendet, um auf dem Client Informationen über einen Server mit dem angegebenen Namen/der angegebenen Adresse abzurufen. Anschließend wird anhand der mit dem Servernamen verknüpften Portnummer, des Benutzernamens und des Benutzerpassworts eine Verbindung zum Server herzustellen. Wenn daher eine URL mit einem Servernamen, der vom Client nicht erkannt wird, generiert wird, so funktioniert die URL nicht.

•Wenn das zweite Argument SolutionName ein leerer String ist, so wird die aktuelle Lösung verwendet.

•Das zweite Argument, SolutionName: (i) generiert den Bereitstellungspfad (auf dem Server), wenn die Lösung auf dem Server ausgeführt wird, (ii) generiert jedoch bei Simulationen einen Dateipfad.

•Im dritten Argument, InputParameters, werden mit Hilfe der MobileTogether-spezifischen XPath-Erweiterungsfunktion mt-run-solution-url-parameters die Parameter-Wert-Paare der Abfrage generiert und kodiert. Die Funktion mt-run-solution-url-parameters (welche die Abfrageparameter kodiert) darf nicht mit der Funktion mt-run-solution-url (welche die gesamte URL generiert) verwechselt werden.

Beschreibung

Erhält als einziges Argument einen JSON-Node und gibt den Inhalt des Node als im JSON-Format serialisierten String zurück. Als JSON-Node kann entweder ein ganzes JSON-Dokument oder ein Teil eines JSON-Dokuments angegeben werden. Angenommen, Sie haben das folgende JSON-Dokument, das mit einer JSON-Seite namens \$JSON1 verknüpft ist:

{

   "Root": {

      "user": "Altova",

      "message": "Hello",

      "A": {

         "B": "B Text",

         "C": "C Text",

         "D": {

         }

      }

   }

}

Wenn der Dokument-Node angegeben wird (d.h. \$JSON1, also der der virtuelle Node, der der Parent Node des Dokuments ist), so wird der Inhalt des gesamten Dokumentobjekts als String zurückgegeben. Wenn der \$JSON1/json//Root-Node als Argument angegeben wird, wird das Objekt, das den Wert des "Root"-Schlüssels bildet, als String zurückgegeben. Siehe auch Beispiele unten.

Verwendung

mt-save-json-to-string(\$JSON/json/Root/A/B) gibt '"B Text"' zurück.

mt-save-json-to-string(\$JSON/json/Root/A/D) gibt '{}' zurück.

mt-server-config-url(ServerSettings als map) als xs:string?

Die Funktion mt-server-config-url erhält eine Zuordnung als Argument und gibt einen String zurück, der eine URL ist. Wenn die URL als Link an Client-Geräte gesendet wird und der Benutzer dort auf den Link tippt, so werden die Server-Einstellungen auf dem Client automatisch aktualisiert. Die URL sieht in etwa folgendermaßen aus: mobiletogether://mt/change-settings?settings=<json encoded settings>

Die in der URL enthaltenen JSON-codierten Server-Einstellungen werden vom Argument ServerSettings der Funktion mt-server-config-url bereitgestellt. Unten sehen Sie die ServerSettings-Zuordnung. Um zu sehen, wie Sie diese Funktion verwenden, öffnen und testen Sie die Beispieldatei ClientConfiguration.mtd aus dem Ordner MobileTogetherExamples/SimpleApps.

mt-server-config-url(

map{

   "DelOthSrv": false(),   (: whether existing server list should be deleted before import :)

   "DetView": true(),     (: whether the details view should be used or the grid :)

   "Refresh": true(),     (: refresh solutions on start :)

   "RetToSln": true(),     (: Windows clients only :)

   "ActSrvURL": "",       (: the first server with this URL gets the active one :)

   "Servers": array{

      map{

        "Name": "",

        "URL": "",         (: if DelOthSrv is false then this property is used as key to merge the new settings with the existing ones :)

        "LoginProvider": map{

            "NameSuffix": "",

            "NamePrefix": "",

                            },

        "Port": "",

        "User": "",

        "StorePW": true(),

        "Password": "",

        "SSL": false()

        }                 (: , map {...} to add another server :)

                    }

    }

)

mt-server-variable(VariableName als xs:string) als xs:string

Gibt den Wert der im Argument VariableNameangegebenen Servervariablen zurück. Servervariablen sind Variablen, die in der Datei mobiletogetherserver.cfg gespeichert sind (siehe MobileTogether Server-Benutzerhandbuch). Die Servervariablen werden in dieser Datei, wie im Codefragment unten gezeigt, im Abschnitt [ServerVariables] gespeichert:

[ServerVariables]

Environment=Portal

Manual=AdminDocs

StartPage=Admin

Die Datei mobiletogetherserver.cfg befindet sich standardmäßig im MobileTogether Server Applikationsdatenordner. Sie können die .cfg-Konfigurationsdatei in einem Texteditor bearbeiten. Nähere Informationen dazu finden Sie im MobileTogether Server-Benutzerhandbuch.

 Informationen zur Simulation von Servervariablen finden Sie unter Simulation 2 (Register "Optionen").

Beispiele

mt-solution-path() als xs:string

Gibt den Pfad der aktuell ausgeführten Lösung zurück.

mt-string-to-hexBinary(Text als xs:string, Encoding als xs:string) als xs:string

Die Funktion konvertiert einen Textstring in einen hexBinary String. Als das Text-Argument kann ein Node, der den benötigten Textstring enthält, bereitgestellt werden. Die Funktion liest den Text String mit der im Argument Encoding definierten Kodierung aus. Wenn der leere String als Encoding-Argument bereitgestellt wird, wird der Ergebnistextstring in der Standardkodierung 'UTF-8' generiert. Wenn kein Encoding-Argument angegeben wird, ist dies ein Fehler.

Beispiele

mt-table-rowgroup-count(VisibleOnly? als xs:boolean) als xs:integer

Die Funktion muss innerhalb einer Zeilengruppe, die den Kontext der Funktion bildet, definiert werden. Das Ergebnis der Funktion ist die Anzahl der Zeilengruppen in der Tabelle, in der sich die Kontextzeilengruppe befindet. Das Argument VisibleOnly ist optional; es kann den Wert true() oder false() haben. Wenn es auf true() gesetzt ist, gibt die Funktion die Anzahl der sichtbaren Zeilengruppen in der Tabelle zurück; wenn es auf false() gesetzt ist, gibt sie die Anzahl aller Zeilengruppen (sichtbarer und nicht sichtbarer) zurück. (Sichtbare Zeilengruppen sind Zeilengruppen, deren Eigenschaft Visible auf true gesetzt ist; eine Beschreibung von Tabelleneigenschaften finden Sie hier.) Wenn das optionale Argument VisibleOnly nicht angegeben wird, wird die Anzahl der sichtbaren Zeilengruppen zurückgegeben; das Ergebnis ist dasselbe wie bei Angabe des Arguments VisibleOnly mit dem Wert true().

Anmerkung: Wenn die Eigenschaft Visible einer Zeilengruppe definiert wurde, kann die Funktion mt-table-rowgroup-count in einer untergeordneten Zeilengruppe nicht für sichtbare Zeilengruppen verwendet werden.

Beispiele

mt-table-rowgroup-index(VisibleOnly? als xs:boolean) als xs:integer

Die Funktion muss innerhalb einer Zeilengruppe, die den Kontext der Funktion bildet, definiert werden. Das Ergebnis der Funktion ist die Position (der Index) der Zeilengruppe innerhalb der Gesamtzahl der Zeilengruppen in der aktuellen Tabelle. Wenn das Argument VisibleOnly auf true() gesetzt ist, gibt die Funktion den Index der aktuellen Zeilengruppe innerhalb der Gruppe sichtbarer Zeilengruppen der Tabelle zurück; wenn es auf false() gesetzt ist, wird der Index innerhalb aller Zeilengruppen (sichtbarer und nicht sichtbarer) zurückgegeben. (Sichtbare Zeilengruppen sind Zeilengruppen, deren Eigenschaft Visible auf true gesetzt ist; eine Beschreibung von Tabelleneigenschaften finden Sie hier.) Wenn das optionale Argument VisibleOnly nicht angegeben wird, wird der Index innerhalb der sichtbaren Zeilengruppen zurückgegeben.

Beispiele

mt-test-case-run() als map(*)

Gibt eine Zuordnung mit Informationen über die gerade ausgeführte Testausführung zurück. Die Zuordnung enthält die folgenden Schlüssel:Wert-Paare: "name":<der Name des Testfalls>, "step":<der aktuelle Schritt>, "count":<die Gesamtanzahl der Schritte>. Wenn gerade keine Wiedergabe läuft, enthält der Schlüssel der Zuordnung leere Werte.

Beispiele

mt-text-to-speech-is-language-available(Language als xs:string) als xs:boolean

Das Argument Language kann String-Werte der Form en (Sprachcode) oder en-US (Sprache-Land-Code) erhalten. Wenn die im Argument Language definierte Sprache auf dem Mobilgerät zur  Verfügung steht, gibt die Funktion true() zurück, andernfalls false().

Verwendung

mt-text-to-speech-is-language-available("en") gibt true() zurück, wenn auf dem Mobilgerät en oder irgendeine en-<Land> Sprachvariante zur Verfügung steht. Andernfalls wird false() zurückgegeben.

mt-text-to-speech-is-language-available("en-US") gibt true() zurück, wenn auf dem Mobilgerät en-US zur Verfügung stehtn, andernfalls wird false() zurückgegeben..

mt-text-to-speech-is-speaking() als xs:boolean

Gibt true() zurück, wenn gerade eine Sprachwiedergabe von Text-Aktion ausgeführt wird. Andernfalls wird false() zurückgegeben.

Eine Beschreibung dieser Funktion finden Sie im Abschnitt Bildbezogene Funktionen der Altova-Erweiterungsfunktionen.

Beschreibung

Wenn der Benutzer die Zurück-Schaltfläche gedrückt oder versucht hat, die Lösung zu beenden, gibt die Funktion true()zurück. Andernfalls wird false() (der Standardwert) zurückgegeben.

Verwendung

mt-user-tried-to-cancel-actions()

mt-video-get-current-position(VideoControlName als xs:string) als xs:integer

Erhält den Namen eines Video-Steuerelements als Argument und gibt die aktuelle Wiedergabeposition (in Sekunden) des in diesem Video-Steuerelement abgespielten Videos zurück. Wenn im Steuerelement kein Video wiedergegeben wird, wird ein Fehler zurückgegeben. Beachten Sie, dass Informationen über die aktuelle Position erst nach Beginn der Wiedergabe zur Verfügung stehen, daher sollte die Funktion erst nach dem Beginn der Wiedergabe verwendet werden.

Verwendung

mt-video-get-current-position("Video-01") gibt die aktuelle Position des im Video-Steuerelement Video-01 wiedergegebenen Videos zurück.

mt-video-get-duration(VideoControlName als xs:string) als xs:integer

Erhält den Namen eines Video-Steuerelements als Argument und gibt die Dauer (in Sekunden) des in diesem Video-Steuerelement abgespielten Videos zurück. Wenn im Steuerelement kein Video wiedergegeben wird, wird ein Fehler zurückgegeben. Beachten Sie, dass Informationen über die Dauer erst nach Beginn der Wiedergabe zur Verfügung stehen, daher sollte die Funktion erst nach dem Beginn der Wiedergabe verwendet werden.

Verwendung

mt-video-get-duration("Video-01") gibt die Dauer des im Video-Steuerelement Video-01 wiedergegebenen Videos zurück.

mt-video-height(VideoControlName als xs:string) als xs:integer

Erhält den Namen eines Video-Steuerelements als Argument und gibt die Höhe (in Pixel) des in diesem Video-Steuerelement abgespielten Videos zurück. Wenn im Steuerelement kein Video wiedergegeben wird, wird ein Fehler zurückgegeben. Beachten Sie, dass Informationen über die Videohöhe erst nach Beginn der Wiedergabe zur Verfügung stehen, daher sollte die Funktion erst nach dem Beginn der Wiedergabe verwendet werden.

Verwendung

mt-video-height("Video-01") gibt die Höhe des im Video-Steuerelement Video-01 wiedergegebenen Videos zurück.

mt-video-is-playing(VideoControlName als xs:string) als xs:boolean

Erhält den Namen eines Video-Steuerelements als Argument und gibt true() zurück, wenn in diesem Video-Steuerelement ein Video wiedergegeben wird. Gibt andernfalls false() zurück.

Verwendung

mt-video-is-playing("Video-01") gibt true() zurück, wenn im Video-Steuerelement Video-01 ein Video abgespielt wird. Gibt andernfalls false() zurück.

mt-video-width(VideoControlName als xs:string) als xs:integer

Erhält den Namen eines Video-Steuerelements als Argument und gibt die Breite (in Pixel) des in diesem Video-Steuerelement abgespielten Videos zurück. Wenn im Steuerelement kein Video wiedergegeben wird, wird ein Fehler zurückgegeben. Beachten Sie, dass Informationen über die Videobreite erst nach Beginn der Wiedergabe zur Verfügung stehen, daher sollte die Funktion erst nach dem Beginn der Wiedergabe verwendet werden.

Verwendung

mt-video-width("Video-01") gibt die Breite des im Video-Steuerelement Video-01 wiedergegebenen Videos zurück.

Beschreibung

Gibt true() zurück, wenn auf dem Client-Gerät der Wartecursor angezeigt, wird, gibt andernfalls false() zurück.

Verwendung

mt-wait-cursor-shown()