ファイルをロード/保存

www.altova.com このトピックを印刷 前のページ 1つ上のレベル 次のページ

ホーム >  アクション > ページ ソース >

ファイルをロード/保存

アクションを以下のとおり設定することができます: (i) ファイルからロードする、または (ii) ファイルへデータを保存する。実行されるアクションが、ロードアクションまたは保存アクションかを指定するには、適切なラジオボタンを選択してください (下のスクリーンショット参照)。

 

ファイルからロード

ファイルからロード アクションでは、アクションコンボボックスからページソースを選択することができます (下のスクリーンショット参照)。代わりに、ページソース (例: $XML1) ノードのルートノードを検索する XPath 式を使用することができます。イベントがトリガーされるとそのページソースのためにデータがロードされるファイルを指定することができます。イベントがトリガーされた際にそのページソースのためにどのデータがロードされるかを指定することができます。

MTDLoadFromFile

イベントがトリガーされた際に、複数の ページソースからデータをロードするには、上のスクリーンショットに表示されるように、  複数の LoadFromFile アクションを追加します。

 

 

エラーの処理

エラー時 オプションはエラーが発生すると何が行われるかを決定する事ができます:

 

スクリプトの中断: エラーの発生後、トリガーされたイベントの後全てのアクションは終了されます。これがエラーが発生した時のデフォルトのアクションです。 エラーに関わらず継続する場合は、継続またはスローオプションを選択します。
継続: アクションは終了されません。その代わりに、以下のイベントの際に何が起こるかを選択する事ができます: エラーが発生しない場合 (成功時)、 またはエラーが発生する場合 (エラー時)。例えば、ページのロードが成功したかを示すメッセージを表示することができます。
スロー: エラーが検出されると、このオプションは トライ/キャッチ アクションの変数内に保管された例外をスローします。 トライ/キャッチ アクション の キャッチ 部分は、エラーが発生した時、どのアクションが起こるかを指定します。エラーが発生しない場合は、次のアクションが処理されます。詳細に関しては、 トライ/キャッチ アクションのセクションを参照してください。

 

ファイルに保存

(最初の XPath 式により選択されている)選択されているページソース、または、ページソースノードからデータをサーバーファイルパス フィールドで指定されている XML ファイルに保存します (下のスクリーンショットを参照)。XML ファイルのエンコードはエンコード フィールド内で指定されています。複数のデータソースのためにデータを保存するには、ファイルに保存 アクションを追加します。 ページソース全体 (ページソースの使用) またはページソース(ソースノードの使用)のサブツリーを選択するオプションがあります。

MTDSaveToFile

メモ:ファイルに保存 アクションは DB に保存するために使用されます。 DB に保存するには、保存 アクションを使用して、保存する DB ページソース を選択します、または、DB の実行 アクションを使用します。

 

エラーの処理

エラー時 オプションはエラーが発生すると何が行われるかを決定する事ができます:

 

スクリプトの中断: エラーの発生後、トリガーされたイベントの後全てのアクションは終了されます。これがエラーが発生した時のデフォルトのアクションです。 エラーに関わらず継続する場合は、継続またはスローオプションを選択します。
継続: アクションは終了されません。その代わりに、以下のイベントの際に何が起こるかを選択する事ができます: エラーが発生しない場合 (成功時)、 またはエラーが発生する場合 (エラー時)。例えば、ページのロードが成功したかを示すメッセージを表示することができます。
スロー: エラーが検出されると、このオプションは トライ/キャッチ アクションの変数内に保管された例外をスローします。 トライ/キャッチ アクション の キャッチ 部分は、エラーが発生した時、どのアクションが起こるかを指定します。エラーが発生しない場合は、次のアクションが処理されます。詳細に関しては、 トライ/キャッチ アクションのセクションを参照してください。

 

ファイルの場所

ファイルからロード保存ファイルアクションのファイルパスフィールドの (上のスクリーンショット参照)[追加ダイアログ] ボタンが押されると、ファイルの指定ダイアログが表示されます。このダイアログ内で、ファイルがサーバーまたはクライアント上に存在するかを指定します (下のスクリーンショット参照)。

 

 

ファイルがサーバーに存在する場合

ファイルがサーバーに存在する場合、ファイルの場所(絶対/相対 パス)を参照、 またはグローバルリソース(ファイルエイリアスまたはフォルダーエイリアス )によりファイルを指定します。必要なオプションを選択します。

MTDSpecifyFileServer

絶対/相対 パス: ファイルを参照するために、絶対および相対パスを入力します。ソリューションがデプロイされると、デフォルト ファイルの場所は、MobileTogether Server 設定で定義されているとおり、作業ディレクトリ への参照で解決されていることに注意してください。ファイル指定ダイアログのパスが相対の場合、作業ディレクトリ に対応して解決されます。ファイル指定ダイアログのパスが絶対の場合、デフォルト ファイルを含むフォルダーは作業ディレクトリ の子孫である必要があります。詳細はプロジェクト ファイルの場所を参照してください。パスを入力またはファイルを参照することができます。パスはデザインに対して相対または絶対であることができます。ファイルがデザインファイルと共にサーバーにデプロイされると、ダイアログで指定された相対/絶対パスがファイルにアクセスするために(サーバーのデータベース) 内部で使用されます。ファイルがデプロイされていない場合、ファイルは直接サーバーに保管される必要があります。 この場合: (i) ファイルの指定ダイアログで相対パスが選択されている場合、ランタイム時に、この相対パスはサーバー上で (MobileTogether Server 設定で定義された) 作業ディレクトリ  を参照して解決されます。 (ii) ファイルの指定ダイアログで絶対パスが選択されている場合、サーバー上でのファイルのフォルダーは作業ディレクトリ の子孫である必要があります。詳細に関してはプロジェクトファイルの場所のセクションを参照してください。ファイルを保存する場合、デフォルトのファイル拡張子を任意で指定することができます。この拡張子はファイル名と共に拡張子が指定されていない場合使用されます。

 

ファイルの保存時に自動的にサブフォルダーを作成する:ファイルパス内で中間フォルダーが存在しない場合、ファイルが保存される時に作成されます。 このオプションは保存する場合のみ関連性があります 。アクションがファイルのロードのみに制限される場合は、このオプションは、存在しません。

 

グローバル リソース ファイル エイリアス: コンボ ボックス内で使用可能なファイル エイリアスを選択します。使用可能なファイル エイリアスはグローバル リソース定義ファイルで定義されたものです。 各ファイル エイリアスは、異なるファイルリソースを( [ツール | アクティブな構成] により選択された) MobileTogether Designer で現在アクティブな構成に応じてマップします。 詳細は Altova グローバル リソースのセクションを参照してください。

 

 

パス断片化されたグローバル リソース フォルダ エイリアス: コンボ ボックスの使用可能なフォルダー エイリアスからフォルダー エイリアスを選択します (下のスクリーンショット参照)。
 
MTDSpecifyFileGRFolderAliases
 

使用可能なフォルダー エイリアスはグローバル リソース定義ファイルで現在定義されているものです。各フォルダー エイリアスは、( [ツール | アクティブな構成] コマンドにより選択された) MobileTogether Designer で現在アクティブな構成に応じて異なるフォルダー リソースをマップします。 パス断片化はリソース ファイルへの残りのパスを指定します。 詳細は Altova グローバル リソース のセクションを参照してください。

 

 

ファイルがクライアントに存在する場合

ファイルがクライアントに存在する場合、ファイルの場所を選択することによりパスを指定、または XPath 式を使用して式を作成します。更新ボタンを使用して現在のエントリを削除します。

MTDSpecifyFileClient

デザイナーがロード/保存するファイルを指定することができ、また、エンドユーザーもこれらのファイルを指定することができます。 ファイル指定すると、この情報はソリューションに保存され、ファイルはアクションがトリガーされると、ロードまたは保存されます。ユーザーがロードまたは保存されるファイルを選択する場合、アクションがトリガーされると、クライアントデバイスで参照ダイアログが開かれ、ユーザーがロード/保存するファイルを入力または選択することができます。

 

メモ:エンドユーザーがファイルをロードして保存するオプションは以下のアクションに対して使用することができます:印刷 (ソースファイルターゲットファイル オプションがあります)、ファイルのロード/保存、 イメージのロード/保存バイナリのロード/保存

 

メモ:クライアント上のファイルもモバイルデバイス上の SD カードに保存することができます。

 

ファイル名は(ソリューションのデザイナーにより)以下で定義されます

 

ファイルの保存のためのデフォルトのファイル拡張子: ファイルを保存する場合、デフォルトのファイル拡張子を任意で指定することができます。この拡張子はファイル名と共に拡張子が指定されていない場合使用されます。

 

ファイルの保存時に自動的にサブフォルダーを作成する:  ファイルパス内の中間のフォルダーが、クライアントで不在の場合、ファイルが保存される際に作成されます。 このオプションは、保存する際にのみ関連するオプションです。アクションがファイルのロードのみに制限されている場合、不在の場合があります。

 

デバイスに依存するリソース: ファイルが存在するディレクトリを選択します。  Windows Phone/RT と iOS デバイスでは、許可されるディレクトリは既に決まっています。Android デバイスでは、 Android コンボボックスのドロップダウンリスト内のディレクトリに追加して、ファイルを入力することができます。 Android と Windows Phone/RT で、デフォルトである、デフォルトを選択すると、 MobileTogether アプリのサンドボックスディレクトリが選択されます。 iOS デバイスでは、 MobileTogether は2つのディレクトリを作成します: (i)  iCloud に保存される再度ダウンロードすることのできるバックアップディレクトリ、 (ii) バックアップを必要としないファイルのためのバックアップしないディレクトリ。必要に応じてバックアップディレクトリまたはバックアップされないディレクトリを選択します。Web ブラウザー内では、ファイルはブラウザーのサンドボックスに相対して検索されます。

 

シミュレーションのためのファイルのロケーション: ファイルがクライアントに存在するため、シミュレーションに中に使用することはできず、シミュレーション中にクライアントフォルダー内でスタンドインするフォルダーを指定することができます。このスタンドインフォルダーは、もちろん、デザイン内で指定されたファイルと同じ名前を持つ必要があります。このフォルダーはオプションダイアログのシミュレーションタブ ( ツール | オプション)内で指定されていなければなりません。

 

メモ:  Web クライアント上では、ファイルは一時的にサーバーに保管されます。 サーバーセッションが完了すると削除されます。サーバーセッションは指定されるアイドル時間が終了するとさーバーセッションは完了します。この期間は、サーバー設定タブのその他ペイン内のセッション設定内で設定することができます ( MobileTogether Server ユーザーマニュアル を参照してください)。

 

エンドユーザーにより(クライアントデバイス上で)ファイル名が定義される場合

 

ファイルの保存のためのデフォルトのファイル拡張子: ファイルを保存する場合、デフォルトのファイル拡張子を任意で指定することができます。この拡張子はファイル名と共に拡張子が指定されていない場合使用されます。

 

任意のファイルフィルター: クライアントデバイス上で開かれる参照ダイアログは、定義された拡張子が許可されるように、ロードまたは保存されるファイルの型をフィルターします。以下を入力することが可能です: (i) カンマで区切られた、または、セミコロンで区切られた拡張子のリスト (例: txt,html;xml)、または (ii)各文字列アイテムがファイル型の拡張子である文字列アイテムのシーケンスを返す XPath 式 (例えば、ここでは以下の3つの文字列アイテムを含む1つのシーケンス: 'txt'、'html、'xml')

 

オプションのデフォルトのファイル: 直接または式を使用して、エンドユーザーを導くためにデフォルトのファイル名を入力します。

 

Web メッセージボックス: ファイルを 開く/保存 ダイアログが開かれる前に、メッセージボックスが表示されます。直接テキストを入力するか、または XPath 式を使用して、メッセージボックスのデフォルトのテキストを上書きするテキストを入力します。

 

ファイルの保存時に自動的にサブフォルダーを作成する: もし、ファイルパス内の中間フォルダーが不足している場合、ファイルが保存される際に作成されます。オプションは保存時に関係し、アクションがファイルのロードアクションの場合使用できません。

 

メモ:  iOS デバイス上では、 iCloud 上でインポート/エクスポートにする場合のみデバイス上でユーザーがファイルを選択することができます。ユーザーはバックアップ済みのフォルダー、または、バックアップされていないフォルダーを参照することはできません。

 

 

 

エラーの処理

エラー時 オプションはエラーが発生すると何が行われるかを決定する事ができます:

 

スクリプトの中断: エラーの発生後、トリガーされたイベントの後全てのアクションは終了されます。これがエラーが発生した時のデフォルトのアクションです。 エラーに関わらず継続する場合は、継続またはスローオプションを選択します。
継続: アクションは終了されません。その代わりに、以下のイベントの際に何が起こるかを選択する事ができます: エラーが発生しない場合 (成功時)、 またはエラーが発生する場合 (エラー時)。例えば、ページのロードが成功したかを示すメッセージを表示することができます。
スロー: エラーが検出されると、このオプションは トライ/キャッチ アクションの変数内に保管された例外をスローします。 トライ/キャッチ アクション の キャッチ 部分は、エラーが発生した時、どのアクションが起こるかを指定します。エラーが発生しない場合は、次のアクションが処理されます。詳細に関しては、 トライ/キャッチ アクションのセクションを参照してください。

 


(C) 2019 Altova GmbH