Altova MobileTogether Designer

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

ターゲットオーディオファイルが再生されているチャンネル番号を引数として取ります。現在のオーディオ再生のポジションを小数で表した数値(秒)で返します。 現在の再生箇所に関する情報は再生が開始してのみ、取得することができます。ですから、関数は、再生の開始の後に使用されることが奨励されます。

使用方法

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

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

ターゲットオーディオファイルが再生されているチャンネル番号を引数として取ります。 オーディオ再生の長さを小数で表した数値(秒)で返します。再生の長さに関する情報は再生が開始してのみ、取得することができます。ですから、関数は、再生の開始の後に使用されることが奨励されます。

使用方法

mt-audio-get-duration(5)

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

テストするチャンネルの番号を引数として取ります。そのチャンネルでオーディオファイルが再生されている場合は true() を返します、それ以外の場合は false() を返します。

使用方法

mt-audio-is-playing(3)

説明

デバイスがオーディオを録音している場合は true()を返します、それ以外の場合は false() を返します。

使用方法

mt-audio-is-recording()

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

全ての使用可能なデータベース (DB) 接続の名前を返します。FromSolution が true() に設定されている場合、ソリューション内の DB 接続の名前を返します。FromSolution が false() に設定されている場合、サーバー上に DB 接続の名前が保存されます。返されるオブジェクトは文字列のシーケンスです。

サンプル

説明

ローカライズ ダイアログで定義されている言語を返します。

ローカライズダイアログ内では、ISO 言語コードにより各言語 (例: en-US) 及び名前 (例: English)が指定されています。デフォルトの言語の言語コードは常に空の文字列ですが、名前には文字列を与えることが出来ます。

関数は各言語を2つの文字列の配列として返します。例: [ "en-US", "English" ]。複数の言語は配列アイテムのシーケンスとして返されます。例: ( ["en-US", "English"], ["de-DE", "German (DE)"] )。シーケンス内の最初の配列は常にデザインのデフォルトの言語を返します。ですから、言語名は(ローカライズダイアログ内で)デフォルトの言語のために指定されており、最初の配列アイテムの両方の文字列は空になります。それ以外の場合、最初の配列アイテムは空の文字列とデフォルトの言語に与えられた名前になります (例: [ "", "MyDefaultLanguage" ])。

返されるシーケンスはスペースで区切られた文字列として表示されます。

使用方法

mt-available-languages() は次の値を表示する可能性があります:  en-US English

mt-available-languages() は次の値を表示する可能性があります:  en-US English de-DE German (DE)

mt-available-languages() は次の値を表示する可能性があります: MyDefaultLanguage en-US English

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

関数は、 Base64 エンコードイメージを hexBinary 文字列に変換します。Base64Image 引数は base64Binary 内でエンコードされるテキストである必要があります。このようなテキストを与えるページソースノードを送信することができます。

使用方法

mt-base64-to-hexBinary($XML1/Element1/@image) は Base64 イメージを、hexBinay に変換します。

説明

ページソースのキャッシュが更新されると時刻を返します。ページソースがキャッシュされていない場合、空のシーケンスが返されます。

使用法

mt-cache-update-dateTime($XML1)

mt-called-by-enter-key() asxs:boolean

Enter キーを押すことにより現在のアクションスタックがトリガーされた場合 true() を返します。それ以外の場合は false() を返します。 現在のアクションスタックを開始するためにユーザーが Esc キーではなく、 Enter キーを押したことが既知の場合、アクションスタック内で条件付きの処理を有効化しようとするユーザーの意図が示されます。

mt-called-by-escape-key() asxs:boolean

Esc キーを押すことにより現在のアクションスタックがトリガーされた場合 true() を返します。それ以外の場合は false() を返します。 現在のアクションスタックを開始するためにユーザーが Enter キーではなく、 Esc キーを押したことが既知の場合、アクションスタック内で条件付きの処理を有効化しようとするユーザーの意図が示されます。

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

関数は、Base64-エンコードイメージを最初の引数として取り、ソースの色 引数として与えられたこれらのイメージの色を関連する ターゲットの色 として変換し、変換されたイメージを Base64-エンコードイメージとして返します。

•Base64Image は base64Binary でエンコードされる必要があります。そのようなテキストを返すノードを与えることができます。

•ソースの色 と ターゲットの色 は、1つまたは複数の文字列アイテムのシーケンスである必要があります。両方のシーケンスのアイテムの数は同等である必要があります。

•クオリティは、 1 から 100 の整数です。クオリティのレベルを指定し、 100 が最も高い数値です。

サンプル

mt-client-ip-address() を xs:string として

サーバーからみられるクライアントの IP アドレスを返します。 シミュレーションに関しては、 MobileTogether Designer のオプションダイアログの内のシミュレーション タブの IP アドレスを設定します(「ツール | オプション」)。

説明

説明

モバイルデバイスが LAN を使用して接続されている場合、 true()を返します、それ以外の場合は false() を返します。

使用方法

mt-connected-via-lan()

説明

WiFi によりモバイルデバイスが接続されている場合 true() を、それ以外の場合は、false() を返します。

使用法

mt-connected-via-wifi()

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

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

左側、上部、右側、および下部のオフセットのピクセル値を ControlKind 引数内のコントロール名のコンテンツを上記の順序で返します。2番目の引数 Parameters は任意でコントロールのプロパティを定義する key-value マップです。使用することのできるキーとその値は以下にリストされています。マップは ControlKind 内で名前の付けられたコントロールの種類をマップ内でリストされたプロパティ値に一致するコントロールのインスタンスに対してフィルターします。

この関数は戻り値は選択されたコントロールのコンテンツを配置するために使用することもできます。下のサンプルを参照してください。

以下がパラメーター 引数のマップとして送信可能な使用可能な キー-値 ペアです。マップ内のキー-値ペアの順序は固定されていません。

•"テキストのサイズ"        : "small"|"medium"|"large"

•"ユニット" : "px"|"dp"|"sp"|"" デフォルトは "px"です。ピクセル、dp (デバイスに依存しないピクセル)(device-independent pixels) と sp (スケールに依存しないピクセル) (scale-independent pixels)間のリレーションシップに関する情報に関しては以下を参照してください: サイズ: ピクセル、DPI、DP、SP。

•"太字": "true"|"false"

•"斜体" : "true"|"false"

•"下線" : "true"|"false"

•"ボタンイメージ" : ボタンイメージ オプション (例えば "+"|"-"|">"|"共有")

•「ボタンの外観」 : 「透過」|「非透過」.デフォルトは 「非透過」です。

サンプル

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

テキスト 文字列がコントロールの表示テキストの場合、最小の幅をピクセルで返します。テキスト 引数はコントロール内に表示される引数です。パラメーター 引数はコントロールのプロパティを定義する キー-値 マップです。使用することのできるキーとその値は以下にリストされています。提出されている テキスト 文字列が パラメーター 引数内で指定されているプロパティを使用して表示されている場合、返される整数が最小値です。この値はコントロールが表示されるテーブル列の幅などこのコントロールに関連した他のプロパティを計算し指定するために使用することができます。

メモ: この機能は Web クライアントでの表示には使用することができません。ウェブクライアントの表示のために メジャーコントロール アクションを使用します。

メモ:  この関数は、以下の場合でのみ使用することができます(i) デザインアクション、と (ii)   ページソースツリーノード のロード時に存在することを確認 (XPath 値)オプション。これらはスタイルプロパティの XPath 式では使用することは許可されていません。

以下がパラメーター 引数のマップとして送信可能な使用可能な キー-値 ペアです。マップ内のキー-値ペアの順序は固定されていません。コントロールプロパティがキー値ペアにより指定されている通り送信されていない場合、 ( ラベル または ボタン コントロールのために) そのプロパティのデフォルトの値が使用されます。この結果 コントロールの種類 パラメーターのみが必須です。

•「コントロールの種類」 : "ラベル"|"ボタン"

•"テキストのサイズ"        : "small"|"medium"|"large"

•"ユニット" : "px"|"dp"|"sp"|"" デフォルトは "px"です。ピクセル、dp (デバイスに依存しないピクセル)(device-independent pixels) と sp (スケールに依存しないピクセル) (scale-independent pixels)間のリレーションシップに関する情報に関しては以下を参照してください: サイズ: ピクセル、DPI、DP、SP。

•"太字": "true"|"false"

•"斜体" : "true"|"false"

•"下線" : "true"|"false"

•"ボタンイメージ" : ボタンイメージ オプション (例えば "+"|"-"|">"|"共有")

•「ボタンの外観」 : 「透過」|「非透過」.デフォルトは 「非透過」です。

例

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

Size 引数内で指定された長さの値を TargetUnit 引数により指定された単位内の値と同じ値に変換します。以下の2つの単位を変換することができます: px、dp および sp。両方の入力引数および値は文字列です。単位に関する詳細はサイズを参照してください : ピクセル、DPI、DP、SP。

例

説明

行要素が新しい、変更された、または削除された列を含む場合 true を返します。フィールドが変更されていない場合は false を返します。 関数は、指定された DB 行に変更が加えられたかテストします。

使用法

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

説明

(DB を表示する) $DB 変数が新しい、変更されたまたは削除された行を含む場合を true 返します。DB が変更されていない場合は false を返します。関数は DB に変更が加えられたかをテストします。そしてRowSets 要素が主キーを持たないかのように作動します。

使用法

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

説明

元の行要素からフィールド属性を返します:

•新しい行: フィールド属性ではありません。新しい行のために関数が呼び出された場合、空のリストを返します。

•変更された行: 削除されたフィールド属性。変更された行のために関数が呼び出された場合、行要素の下にリストされていない対応する OriginalRow 要素からこれらのフィールドを返します。

•削除された元の行: すべてのフィールド属性。関数が(対応する行要素が削除された) OriginalRow のために呼び出された場合、すべてのフィールドを返します。

使用法

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

説明

行要素の無いすべての OriginalRow 要素を返します。関数はデータベースから読み込まれたデータへの変更に使用することができます。ページソースで OriginalRowSet が有効化された場合のみ機能します!

使用法

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

説明

ページソース (変数) を単一のパラメーターとして取り、ページソースのファイルベースのデータベースのファイルパスを返します。ファイルパスはソリューションの作業ディレクトリに対して相対的になります。

メモ

•これはサーバー側の関数でサーバーでのみ実行されます。

•関数は SQLite と Access データベースのために作動します。

使用法

mt-db-file-path($DB1)

説明

指定された行要素の属性を返します:

•新しい行: すべてのフィールド属性。関数が新しい行のために呼び出された場合すべてのフィールドを返します。

•削除された元の行: すべてのフィールド属性。関数が(対応する行要素が削除された) OriginalRow のために呼び出された場合、すべてのフィールドを返します。

•変更された行: 変更されたフィールド属性。関数が変更された行のために呼び出されると、対応する OriginalRow 要素に保管された値と異なる値を持つフィールドを返します。

使用法

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

説明

変更されたすべての行要素の属性のリストを返します。 関数はデータベースから読み込まれたデータへの変更に使用することができます。ページソースで OriginalRowSet が有効化された場合のみ機能します!

使用法

mt-db-modified-rows($DB1)

説明

指定された行要素の新しいフィールド属性を返します:

•新しい行: すべてのフィールド属性。関数が新しい行のために呼び出された場合、すべてのフィールドを返します。

•変更された行: 新しいフィールド属性。関数が変更された行のために呼び出されると、対応する OriginalRow 要素のためにリストされていないフィールドを返します。

•元の行: 空のリスト。関数が(対応する行要素が削除された) OriginalRow  要素のために呼び出された場合、空のリストを返します。

使用法

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

説明

OriginalRowSet ではなく RowSet 要素の下にリストされている、行要素のリストを返します。関数は DB から読み込まれるから読み込まれたデータへ加えられた変更を判別します。 ページソースで OriginalRowSet が有効化された場合のみ機能します!

使用法

mt-db-new-rows($DB1)

説明

DB 行の編集を有効化するために、変更内容は RowSet という名前の平行データ構造に保管されます。元の行セットのコピーは OriginalRowSet という名前の要素内の DB ページソース に保存されます。ページソース保存するには、 RowSet のコンテンツが OriginalRowSet にコピーされます。 mt-db-original-row 関数は関数の単一パラメーターとして提供されている ( RowSet データ構造の) Row 要素に対応する元の行を抽出するために使用されます。 詳細に関しては、see the sections DB データの編集 と DB にデータを保存する.のセクションを参照してください。

使用法

mt-db-original-row($DB1/DB/RowSet/Row[1]) は $DB1/DB/OriginalRowSet/Row[1] を返します。

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

Content 引数により与えられた XML、Base64 または、テキストをコンテンツを電子メールの添付として準備します。コンテンツが XML、Base64 または、テキスト として解析されるかは、値として、 XML、Base64、または テキストを受け入れる ContentType 引数により決定されます。 添付に関連したファイル名が Filename 引数により与えられます。

メモ: mt-email-attachment は、電子メールの送信と共有 アクションの動的な添付のオプションを使用する際の必要条件です。

メモ:  HTML として送信される電子メールに関しては、電子メールの内容が正確な HTML 、つまり、 html 要素から始まる、 HTML である必要があります。有効な内容は次の XPath/XQuery 構成により開始することができます: element html { element body { "Test" } }

メモ: 添付は Android および iOS クライアントのみで使用することができます。

サンプル

説明

最後の DB 、ロード、保存アクションのエラーテキストを返します。  「404 Web ページが見つかりません」などのOS またはデータベースのネイティブなエラーコードを返します。

使用法

mt-external-error-code()

説明

最後の DB 、ロード、保存アクションのエラーテキストを返します。エラーテキストは返されたエラーコードと共に提供されるテキストです。

使用法

mt-external-error-text()

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

FilePath 引数として与えられたファイルパス内のファイルの( xml などの)拡張子を返します。 FilePath 引数内に与えられた文字列は、絶対または相対パスの構文パターンを有する必要があります。 FilePath 引数として mt-last-file-path 関数を使用することができます。

サンプル

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

FilePath 引数として与えられたファイルパス内のファイルのファイル名 (ファイル型拡張子の前の部分) を返します。FilePath 引数内に与えられた文字列は、絶対または相対パスの構文パターンを有する必要があります。FilePath 引数として mt-last-file-path 関数を使用することができます。

サンプル

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

TextSize 引数として提出された文字のサイズの高さをピクセルで返します。TextSize 引数のために許可されている値は以下の通りです: 「一番小さい|小さい|中|大きい|一番大きい」。任意の Unit 引数は、必要とされる返される数値の高さでユニットを指定します。

各プラットフォーム/デバイスにはそれぞれの各文字のためのピクセルの高さが存在します。 The mt-font-height 関数はこのためにデバイスの各もの時の大きさに対応する数値を取得し、他の数値に計算することを可能にします。 例えば、デバイスの'一番大きい' に対応する数値よりも 120% 大きいサイズを表示する場合、次の XPath 式を使用します:mt-font-height('largest', 'px') * 1.2 。関数は '一番大きい' サイズに対応する数値 (ピクセル)を生成します。この値は、 '一番大きい'の 120% に対応する値を得るために1.2 倍されます。

メモ:  この関数は、以下の場合でのみ使用することができます(i) デザインアクション、と (ii)   ページソースツリーノード のロード時に存在することを確認 (XPath 値)オプション。これらはスタイルプロパティの XPath 式では使用することは許可されていません。

サンプル

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

数値を第 1 の引数とし、第 2 (PictureString) の引数に従いフォーマットし、フォーマットされた数値を文字列として返します。これは読みにくい数値を読みやすい書式にフォーマットする際に役に立ちます。ピクチャ文字列は、通貨記号などの文字も含むことができ、フォーマットされた出力内に使用することができます。 その位置の入力数値に数値がない場合にゼロを数値の位置に入力する場合はゼロをピクチャ文字列の数値の位置に使用します(下のサンプルを参照)。ゼロ (または他の文字) の強制を希望しない場合は、番号記号 (#) を使用します。

小数識別子の前の数値は決して短縮化されません。数値の小数部分 (小数識別子の右側) および 単位数値(小数識別子の左側の最初の数値)は、ピクチャ文字列の数値の部分が入力数値の小数の位置よりも短い場合、四捨五入されます。

メモ: モバイルデバイス上のフォーマットされた出力内のグループ化識別子および小数識別子はモバイルデバイスで使用される言語のものです。

サンプル

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

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

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

関数は位置情報マップコントロールのためのマーカーを作成するために使用される XPath マップコンストラクトを生成します*。関数の id と geolocation 引数は必須です。popup と color 引数は任意です。それぞれの文字列は、マップコンストラクタのキー値ペアの値内でテキストとして返されます (下のサンプルを参照してください)。返されたマップコンストラクトは、関数の対応する引数から値を受け取ります。これらの対応する引数は引数のインデックス番号により決定されます。例: 引数の最初の引数は id キーの値を提供します。3番目の引数は文字列のシーケンスです。これらの文字列は、マーカーのポップアップのタイトルとテキストを生成するために使用されます。以下の文字列はポップアップのテキストを与えるために、結合され、それぞれが改行して表示されます。ポップアップの作成が必要ない場合、3番目の引数として空のシーケンスを提供します。color 引数を RGB 値 (例えば "#336699") のための ("green" などの) テキストとして提供することもできます。color 引数が指定されていない場合、デバイスのデフォルトのマーカー色が使用されます。

各関数は1つのマーカーを返します。複数のマーカーを生成するには、複数の mt-geo-map-marker 関数のシーケンスを使用します。下のサンプルを参照してください。( if-then-else コンストラクトを使用する) 3番目のサンプルに示されているとおり他の XPath 式内の mt-geo-map-marker 関数を使用することもできます。

* XPath マップコンストラクト: XPath データ型コンストラクトは、 XPath 列挙に類似しています。マップコンストラクトはキー値ペアのシーケンスです (下の使用法セクションの最初のサンプル内で返されているマップを参照してください)。「XPath マップコンストラクト」 内の「マップ」のセマンティクスは XPath 内の値へのキーのマッピングを参照しており、地図作製法マップを参照していません。

使用法

mt-geo-map-marker("vie","48.2143531 16.3707266", ("Vienna","Altova EU","European headquarters"), "green") は位置情報マップコントロール内に単一のマーカーを生成する単一の XPath マップコンストラクトを返します:

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"))

は2つの XPath マップコンストラクト (位置情報マップコントロールのために2つのマーカー)を返します。

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

  ()

は、ロンドンの位置情報のために、2つの XPath マップコンストラクト、および、 @withLondon 属性が "1" の値を持つ場合、 3番目の XPath マップコンストラクトを返します。関数は実質的には、位置情報マップコントロールのために2つ、または、3つのマーカーを生成します。

説明

ソリューションが 位置情報のトラッキングを開始すると、 true() を返します。それ以外の場合、 false() を返します。

使用法

mt-geolocation-started()

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

送信された文字列に一致する名前を持つページソースのルート要素を返します。結果、 XPath を使用してドキュメントツリー全体のノードにアクセスすることができます。現在のページのページソースが提供された文字列に一致する名前を持たない場合、エラーがスローされます。送信された文字列引数は先頭 $ 文字を含む必要はありません。

使用法

mt-get-page-source-from-name("$PERSISTENT") は $PERSISTENT ページソースのルート要素を返します。例えば、 $PERSISTENT/Orders

mt-get-page-source-from-name("PERSISTENT") は $PERSISTENT ページソースのルート要素を返します。例えば: $PERSISTENT/MyRootElement。

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

PageSource 引数を使用して提出されるページソースの名前を返します。名前は文字列として返されます。

使用法

mt-get-page-source-name($XML1) は文字列 "$XML1」 を返します。

mt-get-page-source-name($PERSISTENT) は文字列 "$PERSISTENT" を返します。

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

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

PageSource 引数を使用して提出されるページソースの構造を返します。EnsureValues 引数が true() に設定されている場合は、ノードのコンテンツも返されます。EnsureValues が false() に設定されている場合、または、2番目の引数が与えられていない場合 (最初の署名を参照してください) ページソース構造はコンテンツ無しで返されます。構造とコンテンツはページソースがロードされるときにロードされます。

使用方法

mt-get-page-source-structure($XML1) は $XML1 ページソースのデータ構造を返します。

for $i in mt-get-page-source-structure($XML1, true()) return $i//Product[1] は $XML1 ページソースの最初の Product 要素のコンテンツを返します。

説明

サーバーへのアクセスが可能な場合は true を返します。その他の場合は false を返します。 この関数は、 MobileTogether Server への接続が関数の タイムアウトの秒数 引数により定義されている秒数内に確立することができるかチェックします。

使用法

mt-has-serveraccess(TimeoutSeconds を整数として)

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

この関数は、 hexBinary 文字列を(通常はイメージである) Base64 エンコード 文字列に変換します。 必要とされる hexBinary 文字列を与えるノードは、 HexBinary 引数として送信することができます。

使用方法

mt-hexBinary-to-base64('48656C6C6F20576F726C64') returns the Base64 string 'SGVsbG8gV29ybGQ='

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

この関数は、 hexBinary 文字列を Encoding引数内のエンコード名を使用してエンコードされるテキスト文字列に変換します。hexBinary 文字列を与えるノードは、 HexBinary 引数。として送信されることができます。空の文字列が Encoding 引数として与えられると、デフォルトの 'UTF-8’ エンコード内で結果テキスト文字列が生成されます。 Encoding 引数が指定されていない場合、エラーが発生します。

サンプル

説明

mt-html-anchor 関数は以下の 2 つの引数を必要とします: LinkText および TargetURL。HTML ハイパーリンク要素を作成するには 2 つの引数を使用します: <a href="TargetURL">LinkText</a>. 電子メールの送信 アクションを使用して HTML として送信されている電子メールにリンクを入力することができます。インターネットページまたは MobileTogether ソリューションを開くことができます。電子メールの本文にリンクを追加するには、本文オプションの XPath 式の内の mt-html-anchor 関数を使用します (下のスクリーンショット参照)。

サンプル

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

引数 Image は、ディメンションを検索するイメージの Base64 エンコードです。引数は xs:base64Binary の型である必要があります。 通常、引数は、 Base64 エンコードされたデータを含むノードを検索します。 関数は2つの整数のシーケンスを返します: (i) 幅、 (ii) 高さ。

サンプル

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

引数 色 は、 RGB (16 進数フォーマット)カラーコードです。 例えば、 "#00FFFF" 。コード内の各色のコンポーネント (R、G、 および B) が反転され、新しいカラーコードが返されます。

サンプル

説明

MobileTogether Server に割り当てられているライセンスすべてが購入されている場合、 true を返します。割り当てられているライセンスの1つまたは複数がトライアルの場合、 false を返します。ヒント: トライアルのライセンスがもう必要ない場合、割り当てを解除してください。

以下の点に注意してください:

•クライアント上ではデフォルトで関数は false を返します。サーバーにリクエストがなされた際に、サーバーのライセンスの購入状況が返されます。

•シミュレーター内では、関数は常に false を返します。対応する シミュレーター を使用して、購入済みのライセンスをシミュレートしてください。デザイナー内のシミュレーション、および、クライアント上のトライアルランのシミュレーションの場合、シミュレーター上で MobileTogether Server ライセンスが購入されていることをシミュレートするためにこのオプションをオンに切り替えます。サーバー上でのシミュレーションに関しては、サーバー上の実際の購入状況が返されます。

使用法

mt-is-server-purchased()

mt-last-file-path() を xs:string? として 

以下のアクション内で最後に使用された(ロードされたまたは保存された)クライアントファイルのフルパスを返します。 (例えば、 Android では、: /storage/emulated/0/Download/MyFile.xml)   : オーディオの録音、 ビデオの録画、ファイルのロード/保存、 バイナリのロード/保存、 イメージのロード。 Android 以外のオペレーティングシステムの一部のバージョンでははこの関数をサポートしない場合があります。

使用法

mt-last-file-path()

説明

StringName 引数により識別されるカスタム文字列を返します。 各 カスタム文字列 はローカライズダイアログ内で定義されている文字列のプールの一部です。 各 StringName は文字列プール内で複数のローカライズされた文字列に関連しています。ローカライズ済みの文字列の言語はモバイルデバイスの言語、またはシミュレーションの言語で選択されています。

使用法

mt-load-string('StringName')

説明

StringName 引数により、識別されたカスタム文字列を返します。各カスタム文字列 はローカライズ ダイアログ内で定義された文字列のプールの一部です。各 StringName は、文字列プール内で複数のローカライズされた文字列と関連しています。選択されたローカライズされた文字列の言語は、 モバイルデバイスの言語、またはシミュレーションの言語です。

使用法

mt-load-string('StringName')

mt-load-string 関数が[XPath/XQuery 式の編集] ダイアログ内に入力されると、すべての使用可能なカスタム文字列がポップアップで表示されます(下のスクリーンショット参照) 。区切りアポストロフィ内、または 'StringName' の引用にカーソルをポイントして、[Ctrl+Space キー] をクリックします。

[上へ] および[下へ] キーボードボタンを使用して、リストを循環します。します。選択されたカスタム文字列の値は、 ポップアップの横に表示されます (下のスクリーンショット参照)。 表示された値のローカライズ言語は MobileTogether Designer で現在選択されているシミュレーションする言語 です。 XPath 式内のカスタム文字列の名前を入力するには、文字列を選択、またはカスタム文字列 リストを循環し文字列を検索し [Enter キー] を押します。

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

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

関数は、デフォルトの言語内またはローカライズされた言語の (最初の) 引数をテキスト文字列の値として、テキストの値として与えられたテキスト文字列の値を持つコントロールまたは文字列の名前を返します。詳細に関してはローカライズおよび 「プロジェクト| ローカライズ」 を参照してください。関数には 2 つの署名があります。第 2 の署名には、テキスト文字列の言語は第 2 の引数です (Lang)。 Lang 引数はローカライズされた言語の名前に一致する必要があります。Lang が指定されている場合、ローカライズされた言語の文字列のみを対象に、 Text 引数内で提出されたテキスト文字列に一致する文字列が検索されます。

サンプル

上のサンプルは、 CityButton という名前のボタンコントロールの文字列のためのサンプルです。文字列のデフォルトの言語は、英語で、 DE および ES という名前の言語にローカライズされています。

説明

ソリューションが NFC を開始すると、 true()を返します。 それ以外の場合、 false() を返します。

使用法

mt-nfc-started()

説明

開かれているページのリストを返します。このリストは文字列のシーケンスです。すなわち、名前のペアの間にスペースがあるページの名前により構成されています。

使用法

mt-page-stack()

説明

現在使用可能なユーザーロールをサーバーからロードします。この関数は、グローバル変数 MT_UserRoles からクエリすることのできるサーバーからユーザーロールを更新します。

使用法

mt-refresh-userroles()

説明

ページソースが再ロードされた時刻を返します。ロードされていない場合は、空のシーケンスを返します。

使用法

mt-reload-dateTime($XML1)

mt-run-appstoreapp-url(Scheme? を xs:string として、Host? を xs:string として、InputParameters? をxs:string  として) を xs:string? として  

MobileTogether AppStore App の URL を以下から生成します (i) 3つの提出された引数、または、(ii) 単一の InputParameters 引数。通常電子メールで送信される URL をクリックすると、 AppStore App が開始されます。URL は以下のフォーマットを必要とします: <url-scheme>://<url-host>。 アプリのマニフェストファイルには、スキームの情報が含まれており、デバイスに対してこのスキームで開始する URL はこのアプリで開かれるように命令します。AppStore Appsに関する詳細は、AppStore App を参照してください。

•Scheme:  アプリと関連する一意のスキーム名。スキームは、生成されるアプリのプログラムコードに割り当てられます ( [プログラムコード生成ウィザードのスクリーン 1] 内)。この引数が省略されている、または、空の文字列が送信された場合、 スキームは現在作動中のアプリのスキームに設定されます。

•Host:  アプリと関連する一意のホスト名。 ホストは、生成されるアプリのプログラムコードに割り当てられます ( [プログラムコード生成ウィザードのスクリーン 1] 内)。この引数が省略されている、または、空の文字列が送信された場合、 ホスト名は現在作動中のアプリに関連するホスト名に設定されます。

•InputParameters: は、関数 mt-run-solution-url-parameters を入力として取ります。関数の引数は、クエリのパラメーターの値を与える文字列のシーケンスです。 mt-run-solution-url-parameters 関数は、正確にエンコードされクエリ文字列のエンコードのルールに従いパーセントエスケープされた URL クエリ文字列のパラメーター(名前と値) を含む文字列を返します。 結果文字列内のパラメーター名は、関数 (例: in1, in2 ... inN) により自動的に生成され、関数の引数の文字列アイテムの値に、名前と値がインデックスの順序に従い組み合わされ、それぞれ割り当てられます。 (また、 InputParameters 引数は既に URL の一部のクエリ文字列のために文字列として与えられることができます(下の2番目のサンプルを参照してください)。)

mt-run-appstoreapp-url 関数は、ですから、 MobileTogether AppStore App   を開き、アプリが URL を使用して開かれた場合、アプリにパスされるクエリパラメータのあるまたはクエリパラメータ無しの URL を作成します。これらのパラメータの値は、 $MT_InputParameters グローバル変数を使用して、他のデザインコンポーネント内でアクセスすることができます。

サンプル

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

MobileTogether クライアント内で開かれる特定のソリューションへの URL を生成します。URL がタップされると、Altova MobileTogether Client アプリが開かれ、ソリューションはアプリ内で開始されます。URL は以下から生成されます (i) (下にリストされる) 関数の3つの提出されている引数、または、 (ii) 関数の InputParameters 引数を生成します:

•ServerAddress: 実行するソリューションがデプロイされる MobileTogether Server の IP アドレスまたは名前を使用します。  この引数が省略されている、または、空の文字列の場合、現在のサーバーが使用されます。

•SolutionName: サーバー上のソリューションのデプロイされたパスを使用します。例: /public/MySolution は /Public コンテナー内の MySolution.mtd ファイルをポイントします。この引数が省略されている、または、空の文字列の場合、現在のソリューションが使用されます。

•InputParameters: mt-run-solution-url-parameters を入力として使用します。mt-run-solution-url-parameters 関数の引数は (i) クエリのパラメーターの値になる文字列の値のシーケンス、または (ii) それぞれのパラメーターの名前と値を提供する key:value ペアのマップです。 この関数は関数は、正しくエンコードされ、パーセントを除いた URLクエリ文字列のエンコードのルールに従った文字列を返します。下の mt-run-solution-url-parameters 関数の詳細を参照してください 。(更に、 InputParameters 引数は、既に URL の一部のクエリ文字列としてエンコードされている文字列として提供されます(下の4番目のサンプルを参照)。)

mt-run-solution-url 関数はですから、 MobileTogether Server 上でソリューションにアクセスするクエリパラメーターを持つまたは持たない URL を作成します。クエリパラメーターは、ソリューションが URL を使用して開かれるとソリューションにパスされます。これらのパラメーターの値は、 $MT_InputParameters グローバル変数を使用して、他のデザインコンポーネントでアクセスすることができます。

例

以下の点に注意してください:

•最初の引数 ServerAddress がクライアント上の名前/アドレスを送信したサーバーに関する情報を確認するために使用されています。サーバー名と関連付けられているポート番号、ユーザー名、ユーザーパスワードはサーバーに接続するために使用されています。クライアントが認識しないサーバー名を持つ URL が生成された場合、 URL は作動しません。

•第 2 の引数 SolutionName は: (i) ソリューションがサーバー上で実行される場合、(サーバー上に) デプロイされたパスを生成します。 (ii) シミュレーション用のファイルパスを生成します。

•第 3 の引数 InputParameters は、 mt-run-solution-url-parameters という名称の MobileTogether-特有の XPath 拡張関数を使用しクエリのパラメータの値のペアをエンコードします。(クエリのパラメーターをエンコードする) mt-run-solution-url-parameters 関数と( URL 全体を生成する) mt-run-solution-url 関数を混同しないよう注意してください。

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

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

mt-run-solution-url-parameters 関数は mt-run-solution-url 関数の 3 番目の関数と使用されることを目的としています。単純引数は文字列の値のシーケンスまたはキー値ペアのマップです。生成された結果は mt-run-solution-url 関数に (引数として) 提出されるクエリ文字列の部分である単一の文字列です。 URL のクエリ文字列のエンコードのための正しくエンコードされた、パーセントを除いたクエリ文字列のエンコードのルールに従った クエリ文字列のパラメーター (名前と値) を含みます。

シーケンス

引数はクエリ文字列のパラメーター値である文字列の値のシーケンスです。結果文字列内のパラメーター名は自動的に関数により生成されます( :in1, in2 ... inN) より生成され、それぞれ関数の引数の文字列アイテムから、インデックス順に組み合わされた名前と値により値を割り当てられます。下のシーケンスのサンプルを参照してください。

マップ

パラメーター (名前と値) は key:value ペアのマップとして送信することができます。例: map{"key1":"value1", "key2":"value2"}.各パラメーターの値が特定のパラメーター名にキー付けされているためパラメーターの順序は重要ではありません。下のマップサンプルを参照してください。

メモ:   If the Parameters 文字列が 2 重引用符を含む場合、これらを一重引用符に変更してください。この手順は、 MobileTogether がパラメーター文字列を作成するために 2 重引用符を使用するからです。 XPath replace 関数を使用して、 2 重引用符を一重引用符に変換することができます: replace(<string>, '"', "'")。下のテキストが(一重引用符ではなく)二重引用符で囲まれている C'est la vie サンプルを参照してください。

これらのパラメーターの値は、 $MT_InputParameters グローバル変数を使用して、他のデザインコンポーネントでアクセスすることができます。

使用例

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

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

Web ブラウザー内で特定のソリューションを開くための ブラウザーに入力する URL を生成します。URL は以下から生成されます (i) (下にリストされる) 関数の3つの提出されている引数、または、 (ii) 関数の InputParameters 引数を生成します:

•ServerAddress: 実行するソリューションがデプロイされる MobileTogether Server の IP アドレスまたは名前を使用します。この引数が省略されている、または、空の文字列の場合、現在のサーバーが使用されます。

•SolutionName: サーバー上のソリューションのデプロイされたパスを使用します。例えば: /public/MySolution は /Public コンテナー内の MySolution.mtd ファイルをポイントします。この引数が省略されている、または、空の文字列の場合、現在のソリューションが使用されます。

•InputParameters: mt-run-solution-url-parameters を入力として使用します。この関数の引数は、クエリのパラメーターの値を与える文字列の値のシーケンスです。mt-run-solution-url-parameters 関数は、正しくエンコードされた、パーセントを除いたクエリ文字列のエンコードのルールに従った URL のクエリ文字列 のパラメーター (名前と値) を含む文字列を返します。結果文字列内のパラメーター名は、自動的に関数に( in1, in2 ... inN) より生成され、それぞれ関数の引数の文字列アイテムから、インデックス順に組み合わされた名前と値により値を割り当てられます。(代わりに、 InputParameters 引数は、既に URL の一部のクエリ文字列としてエンコードされている文字列として提供されます(下の4番目のサンプルを参照)。)

mt-run-web-url 関数はですから、 MobileTogether Server 上でソリューションにアクセスするクエリパラメーターを持つまたは持たない URL を作成します。クエリパラメーターは、ソリューションが URL を使用して開かれるとソリューションにパスされます。これらのクエリパラメーターの値は、 $MT_InputParameters グローバル変数を使用して、他のデザインコンポーネントでアクセスすることができます。

サンプル

以下の点に注意してください:

•最初の引数 ServerAddress がクライアント上の名前/アドレスを送信したサーバーに関する情報を確認するために使用されています。サーバー名と関連付けられているポート番号、ユーザー名、ユーザーパスワードはサーバーに接続するために使用されています。クライアントが認識しないサーバー名を持つ URL が生成された場合、 URL は作動しません。

•第 2 の引数 SolutionName は: (i) ソリューションがサーバー上で実行される場合、(サーバー上に) デプロイされたパスを生成します。 (ii) シミュレーション用のファイルパスを生成します。

•第 3 の引数 InputParameters は、 mt-run-solution-url-parameters という名称の MobileTogether-特有の XPath 拡張関数を使用しクエリのパラメータの値のペアをエンコードします。(クエリのパラメーターをエンコードする) mt-run-solution-url-parameters 関数と( URL 全体を生成する) mt-run-solution-url 関数を混同しないよう注意してください。

説明

StringName により識別されるカスタム文字列を返します。各 カスタム文字列 はローカライズダイアログ内で定義されている文字列のプールの一部です。  各 StringName は文字列プール内で複数のローカライズされた文字列に関連しています。ローカライズ済みの文字列の言語はモバイルデバイスの言語、またはシミュレーションの言語で選択されています。

使用法

mt-load-string('StringName')

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

mt-server-config-url 関数は、マップを引数として取り、 URL である文字列を返します。 クライアントデバイスへのリンクとして URL が送信された場合、そして、リンクがタップされた場合、 クライアント上のサーバー設定 は、自動的に更新されます。 URL は以下に類似した URL になります: mobiletogether://mt/change-settings?settings=<json encoded settings>

URL に含まれている、JSON-エンコード サーバー設定 mt-server-config-url 関数 (ここで説明されている) の ServerSettings 引数により提供されます。ServerSettings マップは以下に示されています。この関数の使用方法の例は、 MobileTogetherExamples/SimpleApps フォルダー <%内にあるサンプルファイル ClientConfiguration.mtd を開いてテストしてください。

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 as xs:string) as xs:string

VariableName 引数内で名前が付けられているサーバー変数の値を返します。サーバー変数は mobiletogetherserver.cfg ファイル内に保管されている変数です。このファイル内ではサーバー変数はスニペットに表示されるように以下に [Server Variables] セクションに保管されます:

[Server Variables]

Environment=Admin

Manual=AdminDocs

StartPage=Admin

メモ:   mt-server-variable 関数は サーバー側の関数で MobileTogether Server でのみ実行されます。

Mobiletogetherserver.cfg ファイルはデフォルトでアプリケーションデータファイルに存在し、各アプリケーションのためにロケーションが下にリストされています。.cfg 構成ファイルをテキストエディターで編集することが可能です。

 サーバー変数をシミュレートする詳細に関しては、シミュレーション 2を参照してください。

例

mt-solution-path() as xs:string

現在実行中のソリューションのパスを返します。

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

関数は文字列を hexBinary 文字列に変換します。テキスト文字列を返すノードは Text 引数として送信することができます。関数は Text 文字列を Encoding 引数。内で指定されるエンコードを持つものとして読み取ります。空の文字列が Encoding 引数として与えられると、 デフォルトのエンコード 'UTF-8' が使用されます。Encoding 引数が指定されていない場合、エラーが発生します。

サンプル

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

関数は関数のコンテキストになる行グループ内にセットされる必要があります。関数は、コンテキスト行グループがロケートするテーブル内の行グループの数量 (カウント) を返します。VisibleOnly 引数は任意です。 true() または false()の値を持つことができます。 true() に設定されている場合、関数はテーブル内の表示される行グループのカウントを返します。false() に設定されている場合、関数は (表示されている、および、表示されていない) すべての行グループ(表示される行グループは 表示されている プロパティが true に設定されている行グループです。(表示される行グループは 可視性 プロパティが true; に設定されている行グループです。テーブルプロパティの詳細に関しては、ここここを参照してください。) 任意の VisibleOnly 関数が提出されていない場合、表示される行グループ のカウントが返されます。 true() の値を持つ VisibleOnly 引数が提出される場合と効果は同様です。

メモ:   行グループの 可視性 プロパティが定義されている場合、子行グループは可視行グループのための mt-table-rowgroup-count 関数を使用することはできません。

サンプル

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

関数は関数のコンテキストになる行グループ内にセットされる必要があります。関数は現在のテーブルの行グループの総数内の現在の行グループの位置 (またはインデックス) を返します。 任意の VisibleOnly 引数が true()に設定されている場合、関数は表示される行グループ 内のセット内の現在の行グループのインデックスを返します。false() に設定されている場合、(表示されている、および、表示されていない) 全ての行グループが返されます。 (表示される行グループは 可視性 プロパティが true; に設定されている行グループです。テーブルプロパティの詳細に関しては、ここここを参照してください。) 任意の VisibleOnly 引数が提出されていない場合、表示される行グループ間のインデックスが返されます。

サンプル

mt-test-case-run()を map(*) として

現在実行されているテストラン の情報が含まれてるマップを返します。マップには key:value ペアが含まれます: "name":<the name of the test case>、 "step":<the current step>、 "count":<the total number of steps>。 再生が現在実行されていない場合、マップのキーには空の値が含まれます。

サンプル

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

言語 引数はフォーム en (言語コード) または en-US (言語-国名コード)の値を取ることができます。言語 引数内で指定された言語がモバイルデバイス上で使用できる場合、関数が true() を返します。 それ以外の場合は、 false() を返します。

使用方法

mt-text-to-speech-is-language-available("en") は en または en-<country> 言語のバリアントがモバイルデバイス上で使用することができる場合、 true() を返します。それ以外の場合はfalse() を返します。

mt-text-to-speech-is-language-available("en-US") は en-US 言語のバリアントがモバイルデバイス上で使用することができる場合、 true() を返します。それ以外の場合は false() を返します。

mt-text-to-speech-is-speaking() を xs:boolean として

読み上げアクション の再生が実行中の場合は、 true() を返し、それ以外の場合は false() を返します。

Altova 拡張関数の イメージに関連した関数 セクション内のこの関数に関する説明を参照してください。

説明

ユーザーが [戻る] ボタンを押した場合、またはソリューションを終了しようとした場合、関数は、 true()を返します。 それ以外の場合は、 false() (デフォルトの値)を返します。

使用方法

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

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

ビデオの名前を引数として取り、 ビデオコントロール内でビデオが再生されている場合は現在の再生のポジションを (秒で) 返します。コントロール内でビデオが再生されていない場合エラーが返されます。現在の再生箇所に関する情報は再生が開始してのみ、取得することができます。ですから、関数は、再生の開始の後に使用されることが奨励されます。

使用方法

mt-video-get-current-position("Video-01") は Video-01 という名前のビデオコントロール内で再生されているビデオの現在の位置を返します。

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

ビデオの名前を引数として取り、 ビデオコントロール内でビデオが再生されている場合は幅を (秒で) 返します。コントロール内でビデオが再生されていない場合エラーが返されます。再生の長さに関する情報は再生が開始してのみ、取得することができます。ですから、関数は、再生の開始の後に使用されることが奨励されます。

使用方法

mt-video-get-duration("Video-01") は Video-01 という名前のビデオコントロール内で再生されているビデオの高さを返します。

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

ビデオの名前を引数として取り、 ビデオコントロール内でビデオが再生されている場合は高さを (ピクセルで) 返します。ビデオが再生されていない場合エラーが返されます。ビデオの高さに関する情報は再生が開始してのみ、取得することができます。ですから、関数は、再生の開始の後に使用されることが奨励されます。

使用方法

mt-video-height("Video-01") は Video-01 という名前のビデオコントロール内で再生されているビデオの高さを返します。

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

ビデオの名前を引数として取り、 ビデオコントロール内でビデオが再生されている場合は、 true() を返し、それ以外の場合は false() を返します。

使用方法

mt-video-is-playing("Video-01") は、 Video-01 という名前のビデオコントロール内でビデオが再生されている場合は、 true() を返し、それ以外の場合は、false() を返します。

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

ビデオの名前を引数として取り、 ビデオコントロール内でビデオが再生されている場合は幅を (ピクセルで) 返します。ビデオが再生されていない場合エラーが返されます。ビデオの幅に関する情報は再生が開始してのみ、取得することができます。ですから、関数は、再生の開始の後に使用されることが奨励されます。

使用方法

mt-video-width("Video-01") は Video-01 という名前のビデオコントロール内で再生されているビデオの高さを返します。

説明

クライアントデバイスが待機カーソルを表示する場合は、 true() を返し、それ以外の場合は、false() を返します。

使用方法

mt-wait-cursor-shown()