MobileTogether 拡張関数

www.altova.com すべてを展開/折りたたむ このトピックを印刷 前のページ 1つ上のレベル 次のページ

ホーム >  XPath/XQuery: 式、関数、変数 > XPath/XQuery 式と関数 >

MobileTogether 拡張関数

MobileTogether デザイン内での使用のために特別に作成された、以下の XPath 拡張関数を、デザイン内の任意の場所で使用することができます。 XPath のデフォルトの名前空間はこれらの関数を呼び出すために使用されます。

 

XPath 関数の戻り値の更新

XPath 関数は、 XPath 式が評価された場合のみ評価されます。これは通常 XPath 式を含むアクションが実行された場合、または、データが変更され XPath 式が評価される場合に発生します。

 

例えば、 mt-audio-is-playing 関数を含む XPath 式をサンプルとします。この関数は true または false. を返します。式がある特定の時間に評価されると、例えば戻り値が(オーディオが再生されているため) true の場合。この値がソリューション内で表示されると、オーディオの再生が停止されても、この値は自動的に変更されません。設定をこのようにするには、関数がもう一度呼び出され、新しい値が表示内の値を更新する必要があります。

 

このような値が更新される理由は使用されている特定のデザインメカニズムにより異なります。このような値を更新する方法のひとつとしては、表示の更新 アクションを使用した ページの更新時 イベントのタイマーなどが挙げられます。

 

 

メモ:Altova の一般的な XPath 拡張関数ライブラリの機能に関しての詳細は、Altova 拡張関数のセクションを参照してください。 (通常の拡張関数は、 MobileTogether を含むすべての Altova 製品で使用することができます。)

 

 

Click to expand/collapsemt-audio-get-current-position

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

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

 

使用方法

mt-audio-get-current-position()

 

Click to expand/collapsemt-audio-get-duration

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

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

 

使用方法

mt-audio-get-duration()

 

Click to expand/collapsemt-audio-is-playing

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

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

 

使用方法

mt-audio-is-playing()

 

Click to expand/collapsemt-audio-is-recording

説明

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

 

使用方法

mt-audio-is-recording()

 

Click to expand/collapsemt-available-db-connection-names

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

データベース構造を読み取るために使用することのできるソリューション内のデータベース接続の名前を返します。

 

mt-available-db-connection-names(true()) は、例えば、"MyCars" を返します。  

 

Click to expand/collapsemt-available-languages

説明

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

 

ローカライズダイアログ内では、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

 

Click to expand/collapsemt-base64-to-hexBinary

mt-base64-to-hexBinary(Base64Image を xs:base64Binary として ) を xs:string として 

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

 

使用法

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

 

Click to expand/collapsemt-cache-update-dateTime

説明

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

 

使用法

mt-cache-update-dateTime($XML1)

 

Click to expand/collapsemt-called-by-enter-key

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

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

 

Click to expand/collapsemt-called-by-escape-key

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

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

 

Click to expand/collapsemt-change-image-colors

mt-change-image-colors(Base64Image を xs:base64Binary として、 SourceColors を xs:string+ として、 TargetColors を xs:string+ として、 Quality を xs:integer として) を xs:base64Binary として 

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

 

Base64Image は、 base64Binary でエンコードされる必要があります。そのようなテキストを返すノードを与えることができます。
ソースの色ターゲットの色 は、1つまたは複数の文字列アイテムのシーケンスである必要があります。両方のシーケンスのアイテムの数は同等である必要があります。
クオリティは、 1 から 100 の整数です。クオリティのレベルを指定し、 100 が最も高い数値です。

 

mt-change-image-colors(Base64ImageNode, ('#000000'), ('#666666'), 90 ) は、 黒 (#000000)  が灰色 (#666666) に変えられた Base64 イメージを返します。
mt-change-image-colors(xs:base64Binary(Base64ImageNode), ('#000000', '#FF0000'), ('#666666', 'blue'), 90 ) は、黒 (#000000) が灰色 (#666666) に、赤 (#FF0000) が青に変えられた Base64 イメージを返します。  

 

Click to expand/collapsemt-client-ip-address

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

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

 

 

mt-client-ip-address() は、クライアント IP アドレスを返します。シミュレーション内では、 MobileTogether Designerのオプションタブ内で設定された値を返します。

 

Click to expand/collapsemt-connected-via-lan

説明

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

 

使用方法

mt-connected-via-lan()

 

Click to expand/collapsemt-connected-via-wifi

説明

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

 

使用法

mt-connected-via-wifi()

 

Click to expand/collapsemt-control-width

mt-control-width(Text as xs:string*Parameters as map(*))を xs:integer? として 

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

 

メモ: この機能は Web クライアントでの表示には使用することができません。

 

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

 

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

 

"コントロールの種類" : "ラベル"|"ボタン"
"テキストのサイズ" : "小"|"中"|"大"
"ユニット" : "px"|""  デフォルトは "px" です。
"太字" : "true"|"false"
"斜体" : "true"|"false"
"下線" : "true"|"false"
"ボタンの外観" : "+"|"-"|">"|"共有"

 

mt-control-width("Send", map{"Control Kind" : "Button", "Text Size" : "medium", "Unit" : "", "Bold Text" : true(), "Italic Text" : false(), "Underline Text" : false(), "Button Look" : "+"})    

 

Click to expand/collapsemt-db-any-changed-fields

説明

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

 

使用法

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

 

Click to expand/collapsemt-db-any-changed-rows

説明

(DB を表示する) $DB 変数が新しい、変更されたまたは削除された行を含む場合を true 返します。DB が変更されていない場合は false を返します。関数は DB に変更が加えられたかをテストします。

 

使用法

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

 

Click to expand/collapsemt-db-deleted-original-fields

説明

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

 

新しい行: フィールド属性ではありません。新しい行のために関数が呼び出された場合、空のリストを返します。
変更された行: 削除されたフィールド属性。変更された行のために関数が呼び出された場合、行要素の下にリストされていない対応する OriginalRow 要素からこれらのフィールドを返します。
削除された元の行: すべてのフィールド属性。関数が(対応する行要素が削除された) OriginalRow のために呼び出された場合、すべてのフィールドを返します。

 

使用法

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

 

Click to expand/collapsemt-db-deleted-original-rows

説明

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

 

使用法

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

 

Click to expand/collapsemt-db-modified-fields

説明

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

 

新しい行: すべてのフィールド属性。関数が新しい行のために呼び出された場合すべてのフィールドを返します。
削除された元の行: すべてのフィールド属性。関数が(対応する行要素が削除された) OriginalRow のために呼び出された場合、すべてのフィールドを返します。
変更された行: 変更されたフィールド属性。関数が変更された行のために呼び出されると、対応する OriginalRow 要素に保管された値と異なる値を持つフィールドを返します。

 

使用法

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

 

Click to expand/collapsemt-db-modified-rows

説明

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

 

使用法

mt-db-modified-rows($DB1)

 

Click to expand/collapsemt-db-new-fields

説明

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

 

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

 

使用法

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

 

Click to expand/collapsemt-db-new-rows

説明

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

 

使用法

mt-db-new-rows($DB1)

 

Click to expand/collapsemt-email-attachment

mt-email-attachment(Filename xs:string  を xs:string としてContent を item() として  ContentType を xs:string として  ) 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 クライアントのみで使用することができます。

mt-email-attachment('MTNewFeatures.txt', $XML2/Releases/Release[@date='2015-04-15']/Features, 'XML')は 機能ノード を返します。
mt-email-attachment('MTLogo.jpg', $XML4/Images/Image[@name='MTLogo'], 'Base64')は イメージファイル を返します。

 

Click to expand/collapsemt-external-error-code

説明

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

 

使用法

mt-external-error-code()

 

Click to expand/collapsemt-external-error-text

説明

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

 

使用法

mt-external-error-text()

 

Click to expand/collapsemt-extract-file-extension

mt-extract-file-extension(FilePath を xs:string として)  を xs:string? として 

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

 

hmtoggle_plus1サンプル

mt-extract-file-extension(/storage/emulated/0/Download/Myfile.xml) は、'xml' を返します。
mt-extract-file-extension(mt-last-file-path()) は、 mt-last-file-path() により返されたファイルパス内のファイル名のファイル名の拡張子を返します。

 

Click to expand/collapsemt-extract-file-name

mt-extract-file-name(FilePath を xs:string  として ) を xs:string? として ?

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

 

mt-extract-file-name(/storage/emulated/0/Download/MyFile.xml) は、'MyFile'  を返します。
mt(mt-last-file-path()) は、 mt-last-file-path()  により返されたファイルパス内のファイル名の一部である、 mt-last-file-path() により返されたファイルパス内のファイル名のみのファイル名の拡張子を返します。前のセクションを参照してください。

 

Click to expand/collapsemt-font-height

mt-font-height(TextSize を xs:string* として、 Unit を xs:string  として  ) を xs:string? として  

テキストサイズ 引数として提出された文字のサイズの高さをピクセルで返します。任意の ユニット 引数は、必要とされる返される数値の高さでユニットを指定します。現時点では、ピクセルの高さのみが返されます。返された値は同じコントロールまたは他の関連するコントロールの値を計算するために使用することができます。 テキストサイズ 引数に許可される値は、以下の通りです: 一番小さい|小さい|中|大きい|一番大きい。 ユニット 引数に許可される値は以下の通りです: "px" と空の文字列。

 

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

 

mt-font-height("small", "px") は、 33 を返します(値はクライアントにより異なります)
mt-font-height("smallest", "") は、 27 を返します(値はクライアントにより異なります)

 

Click to expand/collapsemt-format-number

mt-format-number(Number を xs:numeric として、 PictureString を xs:string として  ) を xs:string として

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

 

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

 

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

hmtoggle_plus0        サンプル

mt-format-number(12.3, '$#0.00')$12.30 を返します。
mt-format-number(12.3, '$00.00')$12.30 を返します。
mt-format-number(12.3, '$0,000.00')$0,012.30 を返します。
mt-format-number(12.3, '$#,000.00')$012.30 を返します。
mt-format-number(1234.5, '$#,##0.00')$1,234.50 を返します。
mt-format-number(1234.5, '$#0.00')$1234.50 を返します。
mt-format-number(123.4, '$0')$123 を返します。
mt-format-number(1234.5, '$0')$1235 を返します。
mt-format-number(1234.54, '$0.0')$1234.5 を返します。
mt-format-number(1234.55, '$0.0')$1234.6 を返します。

 

 

Click to expand/collapsemt-geo-map-marker

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

mt-geo-map-marker(id as xs:stringgeolocation as xs:stringpopup? as (xs:string*)) as map (*)

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

関数は位置情報マップコントロールのためのマーカーを作成するために使用される XPath マップコンストラクトを生成します*。関数の idgeolocation 引数は必須です。 popupcolor 引数は任意です。それぞれの文字列は、マップコンストラクタのキー値ペアの値内でテキストとして返されます (下のサンプルを参照してください)。返されたマップコンストラクトは、関数の対応する引数から値を受け取ります。これらの対応する引数は引数のインデックス番号により決定されます。例: 引数の最初の引数は 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つのマーカーを生成します。

 

Click to expand/collapsemt-geolocation-started

説明

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

 

使用法

mt-geolocation-started()

 

Click to expand/collapsemt-get-page-source-structure

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() に設定されている場合は、ノードのコンテンツも返されます。 EnsureValuesfalse() に設定されている場合、または、2番目の引数が与えられていない場合 (最初の署名を参照してください) ページソース構造はコンテンツ無しで返されます。

 

使用法

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

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

Click to expand/collapsemt-has-serveraccess

説明

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

 

使用法

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

 

Click to expand/collapsemt-hexBinary-to-base64

mt-hexBinary-to-base64(HexBinary を xs:string として ) を xs:base64Binary として 

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

 

使用法

mt-hexBinary-to-base64('48656C6C6F20576F726C64') は、 Base64 文字列 'SGVsbG8gV29ybGQ=' を返します。

 

 

Click to expand/collapsemt-hexBinary-to-string

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

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

 

mt-hexBinary-to-string('48656C6C6F20576F726C64', 'ASCII') は、'Hello World'  を返します。  
mt-hexBinary-to-string('48656C6C6F20576F726C64', '') は、'Hello World'  を返します。
mt-hexBinary-to-string('48656C6C6F20576F726C64') は、エラーを返します      

 

Click to expand/collapsemt-html-anchor

説明

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

MTDSendEmailWithLinkSoln

mt-html-anchor('Unregister from mailing list', 'http://www.altova.com/unregister.html'))<a href="http://www.altova.com/unregister.html">Unregister from mailing list</a> を返します。
mt-html-anchor('Unregister from mailing list', mt-run-solution-url('', '/public/unregister', ''))<a href="LinkTo-unregister.mtd">Unregister from mailing list</a>  を返します。

 

Click to expand/collapsemt-image-width-and-height

mt-image-width-and-height(Image を base64encoded-image として )  を xs:integer+ として 

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

 

mt-image-width-and-height($XML1/images/png) は、364 76   を返します。  

 

Click to expand/collapsemt-invert-color

mt-invert-color(Color を xs:string として  )を xs:string として  

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

 

mt-invert-color('#000000') は、を返します '#FFFFFF'  を返します。
mt-invert-color('#00FFFF') は、 '#FF0000'   を返します。
mt-invert-color('#AA0000') は、 '#55FFFF'  を返します。
mt-invert-color('#AA33BB') は、 '#55CC44' を返します。
mt-invert-color('#34A6D2') は、 '#CB592D'  を返します。  

 

Click to expand/collapsemt-is-server-purchased

説明

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

 

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

 

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

 

使用法

mt-is-server-purchased()

 

Click to expand/collapsemt-last-file-path

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

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

 

使用法

mt-last-file-path()

 

Click to expand/collapsemt-load-string

説明

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

 

使用法

mt-load-string('StringName')

 

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

MTDmt-load-string

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

 

Click to expand/collapsemt-localized-string-name

mt-localized-string-name(Text xs:string  として  ) を xs:string* として

mt-localized-string-name(Text を xs:string として、 Lang を xs:string として  ) を xs:string*として 

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

 

mt-localized-string-name('City')'CityButton'  を返します。
mt-localized-string-name('Stadt', 'DE')'CityButton' を返します。
mt-localized-string-name('Stadt')'CityButton'  を返します。
mt-localized-string-name('Stadt', 'ES')''  を返します。
mt-localized-string-name('Stadt', 'German')''  を返します。
mt-localized-string-name('Ciudad', 'ES')'CityButton'  を返します。

 

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

 

Click to expand/collapsemt-nfc-started

説明

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

 

使用法

mt-nfc-started()

 

Click to expand/collapsemt-refresh-userroles

説明

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

 

使用法

mt-refresh-userroles()

 

Click to expand/collapsemt-reload-dateTime

説明

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

 

使用法

mt-reload-dateTime($XML1)

 

Click to expand/collapsemt-run-appstoreapp-url

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-appstoreapp-url('myappscheme', 'myfirstapp', '') は、 URL myappscheme://myfirstapp を返します。モバイルデバイス上では、 URL は、スキームとホストで識別される AppStore App を開きます。URL には、クエリパラメーターはありません。
mt-run-solution-url('myappscheme', 'myfirstapp', 'in1=value1&in2=value2%3FAndMoreValue2') は、URL myappscheme://myfirstappを返します。モバイルデバイス上では、 URL は、スキームとホストで識別される AppStore App を開きます。 InputParameters 引数は既に URL クエリ文字列としてエンコードされた文字列として提出されます。

 

Click to expand/collapsemt-run-solution-url

mt-run-solution-url(ServerAddress? を xs:string として、SolutionName? を xs:string として InputParameters? as xs:string) as xs:string?

mt-run-solution-url(ServerAddress? を xs:string として、SolutionName? を xs:string として InputParameters? を xs:string として) を 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 関数は、正しくエンコードされた、パーセントを除いたクエリ文字列のエンコードのルールに従った URL のクエリ文字列 のパラメーター (名前と値) を含む文字列を返します。  結果文字列内のパラメーター名は、自動的に関数に( inputparameter1, inputparameter2 ... inputparameterN) より生成され、それぞれ関数の引数の文字列アイテムから、インデックス順に組み合わされた名前と値により値を割り当てられます。(更に、 InputParameters 引数は、既に URL の一部のクエリ文字列としてエンコードされている文字列として提供されます(下の4番目のサンプルを参照)。)

 

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

 

mt-run-solution-url('100.00.000.1', '/public/MyDesign', '') は、 IP アドレス 100.00.000.1. を持つ MyDesign ソリューションをポイントする  URL を返します。 URL には、クエリパラメータはありません。
mt-run-solution-url('', '/public/MyDesign', '') は、現在のサーバー上の MyDesign ソリューションをポイントする URL を返します。URL には、クエリパラメータはありません。
mt-run-solution-url('', '', mt-run-solution-url-parameters(('2015', 'USA', 'true'))) は、現在のサーバー上の現在のソリューションをポイントする URL を返します。 mt-run-solution-url-parameters 関数の引数は、クエリのパラメーターの値である文字列の値のシーケンスです。最初の文字列は、最初のパラメータの値です。第 2 の文字列は、第 2 のパラメーターの値です。 mt-run-solution-url-parameters 関数は関数は、正しくエンコードされ、パーセントを除いた URLクエリ文字列のエンコードのルールに従った文字列を返します。
mt-run-solution-url('', '', 'inputparameter1=value1&inputparameter2=value2%3FAndMoreValue2') は、現在のサーバー上の現在のソリューションをポイントする URL を返します。 InputParameters 引数は、 URL クエリ文字列として既にエンコードされた文字列として提出されます。

 

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

 

最初の引数 ServerAddress がクライアント上の名前/アドレスを送信したサーバーに関する情報を確認するために使用されています。サーバー名と関連付けられているポート番号、ユーザー名、ユーザーパスワードはサーバーに接続するために使用されています。クライアントが認識しないサーバー名を持つ URL が生成された場合、 URL は作動しません。
第 2 の引数 SolutionName は: (i) ソリューションがサーバー上で実行される場合、(サーバー上に) デプロイされたパスを生成します。 (ii) シミュレーション用のファイルパスを生成します。
第 3 の引数 InputParameters は、 mt-run-solution-url-parameters という名称の <%MT%>-特有の XPath 拡張関数を使用しクエリのパラメータの値のペアをエンコードします。(クエリのパラメーターをエンコードする)   mt-run-solution-url-parameters  関数と( URL 全体を生成する) mt-run-solution-url 関数を混同しないよう注意してください。

 

Click to expand/collapsemt-run-solution-url-parameters

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

mt-run-solution-url-parameters 関数は mt-run-solution-url 関数の 3 番目の関数と使用されることを目的としています。mt-run-solution-url-parameters 関数の引数は、文字列の値のシーケンスです。これらはクエリ文字列のパラメーターの値で mt-run-solution-url 関数により生成されます。 mt-run-solution-url-parameters 関数は、正しくエンコードされた、パーセントを除いたクエリ文字列のエンコードのルールに従った URL のクエリ文字列 のパラメーター (名前と値) を含む文字列を返します。結果文字列内のパラメーター名は、自動的に関数に ( inputparameter1, inputparameter2 ... inputparameterN) より生成され、それぞれ関数の引数の文字列アイテムから、インデックス順に組み合わされた名前と値により値を割り当てられます。

 

メモ:   Parameters 文字列が 2 重引用符を含む場合、これらを一重引用符に変更してください。この手順は、 MobileTogether がパラメーター文字列を作成するために 2 重引用符を使用するからです。 XPath replace 関数を使用して、 2 重引用符を一重引用符に変換することができます: replace(<string>, '"', "'").

 

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

 

mt-run-solution-url-parameters(('2015', 'USA', 'true'))'&inputparameter1=2015&inputparameter2=USA&inputparameter3=true' を返します。

 

Click to expand/collapsemt-run-web-url

mt-run-web-url(ServerAddress? を xs:string として、SolutionName? を xs:string として、InputParameters? を xs:string として) を xs:string? として 

mt-run-web-url(InputParameters? を xs:string として) を 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 グローバル変数を使用して、他のデザインコンポーネントでアクセスすることができます。

 

mt-run-web-url('100.00.000.1', '/public/MyDesign', '') ('100.00.000.1', '/public/MyDesign', '') は、 IP アドレス 100.00.000.1. を持つ MyDesign ソリューションをポイントする  URL を返します。 URL には、クエリパラメータはありません。
mt-run-web-url('', '/public/MyDesign', '') は、現在のサーバー上の MyDesign ソリューションをポイントする URL を返します。URL には、クエリパラメータはありません。
mt-run-web-url('', '', mt-run-solution-url-parameters(('2015', 'USA', 'true'))) は、現在のサーバー上の現在のソリューションをポイントする URL を返します。 mt-run-solution-url-parameters 関数の引数は、クエリのパラメーターの値である文字列の値のシーケンスです。最初の文字列は、最初のパラメータの値です。第 2 の文字列は、第 2 のパラメーターの値です。 mt-run-solution-url-parameters 関数は関数は、正しくエンコードされ、パーセントを除いた URLクエリ文字列のエンコードのルールに従った文字列を返します。
mt-run-web-url('', '', 'in1=value1&in2=value2%3FAndMoreValue2') は、現在のサーバー上の現在のソリューションをポイントする URL を返します。 InputParameters 引数は、 URL クエリ文字列として既にエンコードされた文字列として提出されます。

 

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

 

最初の引数 ServerAddress がクライアント上の名前/アドレスを送信したサーバーに関する情報を確認するために使用されています。サーバー名と関連付けられているポート番号、ユーザー名、ユーザーパスワードはサーバーに接続するために使用されています。クライアントが認識しないサーバー名を持つ URL が生成された場合、 URL は作動しません。
第 2 の引数 SolutionName は: (i) ソリューションがサーバー上で実行される場合、(サーバー上に) デプロイされたパスを生成します。 (ii) シミュレーション用のファイルパスを生成します。
第 3 の引数 InputParameters は、 mt-run-solution-url-parameters という名称の <%MT%>-特有の XPath 拡張関数を使用しクエリのパラメータの値のペアをエンコードします。(クエリのパラメーターをエンコードする)   mt-run-solution-url-parameters  関数と( URL 全体を生成する) mt-run-solution-url 関数を混同しないよう注意してください。

 

Click to expand/collapsemt-server-config-url

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

                    }

    }

)

 

Click to expand/collapsemt-string-to-hexBinary

mt-string-to-hexBinary(Text を xs:string, Encoding as xs:string として) を xs:string として 

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

 

mt-string-to-hexBinary('Hello World', 'ASCII') は、'48656C6C6F20576F726C64'  を返します。  
mt-string-to-hexBinary('Hello World', '') は、'48656C6C6F20576F726C64'  を返します。
mt-string-to-hexBinary('Hello World') は、エラーを返します

 

Click to expand/collapsemt-table-rowgroup-count

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

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

 

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

 

mt-table-rowgroup-count() は現在のテーブルの行グループの総数が 10 の場合、10  を返します。すべて表示されます。
mt-table-rowgroup-count() は現在のテーブル内の 10 行グループ外である場合、 7   を返します。7つは表示され、3つは非表示です。
mt-table-rowgroup-count(true()) は現在のテーブル内の 10 行グループ外である場合、 7 を返します。7つは表示され、3つは非表示です。
mt-table-rowgroup-count(false()) は現在のテーブル内の 10 行グループ外である場合、 7 を返します。 7つは表示され、3つは非表示です。

 

Click to expand/collapsemt-table-rowgroup-index

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

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

 

hmtoggle_plus0サンプル
mt-table-rowgroup-index() は、現在の行グループが現在のテーブル内の行グループの最初の 10 のグループである場合、 1   を返します。
mt-table-rowgroup-index() は現在の行グループが2番目の行グループで、最初の行グループが表示されていない場合、 1   を返します。
mt-table-rowgroup-index(true()) は現在の行グループが2番目の行グループで、最初の行グループが表示されていない場合、 1   を返します。
mt-table-rowgroup-index(false()) は現在の行グループが2番目の行グループで、最初の行グループが表示されている場合 2   を返します。

 

Click to expand/collapsemt-test-case-run

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-test-case-run() は以下のような単純型マップを返します {"name":"MyTestCase", "step":"2", "count":"10"}
mt-test-case-run() は以下のような単純型マップを返します {"name":"", "step":"", "count":""}  

 

Click to expand/collapsemt-text-to-speech-is-language-available

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-avaialable("en") は、 en または en-<country> 言語のバリアントがモバイルデバイス上で使用することができる場合、 true() を返します。 それ以外の場合は、 false() を返します。

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

 

Click to expand/collapsemt-text-to-speech-is-speaking

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

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

 

Click to expand/collapsemt-transform-image

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

 

Click to expand/collapsemt-user-tried-to-cancel-actions

説明

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

 

使用方法

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

 

Click to expand/collapsemt-video-get-current-position

mt-video-get-current-position(VideoControlName xs:string  として) を xs:string? として 

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

 

使用方法

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

 

Click to expand/collapsemt-video-get-duration

mt-video-get-duration(VideoControlName  を xs:string として) を xs:integer として 

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

 

使用方法

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

 

Click to expand/collapsemt-video-height

mt-video-height(VideoControlName  を xs:string として) を xs:integer として 

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

 

使用方法

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

 

Click to expand/collapsemt-video-is-playing

mt-video-is-playing(VideoControlName  を xs:string として) を xs:boolean として 

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

 

使用方法

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

 

Click to expand/collapsemt-video-width

mt-video-width(VideoControlName を xs:string として) を xs:integer として 

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

 

使用方法

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

 

Click to expand/collapsemt-wait-cursor-shown

説明

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

 

使用方法

mt-wait-cursor-shown()

 

 


(C) 2019 Altova GmbH