IMPORT SYLK

4D - Documentation   French   English   German   Spanish   日本語   4D v11 SQLコマンドテーマリスト   4D v11 SQLインデックス   4D v11 SQL定数テーマリスト   戻る   前   次

version 3


IMPORT SYLK ({aTable; }document)

引数説明
aTableテーブルデータを読み込むテーブル, または
省略した場合, デフォルトテーブル
document文字列データを読み込むSYLKドキュメント

説明

IMPORT SYLK コマンドは、WindowsまたはMacintoshの標準的なSYLK形式のドキュメントdocumentから aTableデータを読み込み、新しいレコードを作成します

データの読み込み処理は、カレント入力フォームを介して実行します。このデータ読み込み処理は、入力フォーム上のフィールドや変数をそのレイヤに従って行われます。このため、フォーム中のテキストオブジェクト (フィールドや変数) の重なり順を注意深く設定する必要があります。最初にデータが読み込まれるオブジェクトは、フォームの最背面に置きます。読み込むフィールド数とフォーム上のフィールドや変数の数が一致しない場合、余分なものは無視されます。サブフォームオブジェクトは無視されます。

Note: データが正しいオブジェクトに読み込まれることを確実にする方法のひとつは、読み込む最初のフィールドを選択しそれを最前面にします。引き続き順番にフィールドや変数を最前面に設定していきます。

読み込まれるレコードごとに、On Validateイベントがフォームメソッドに送られます。このイベントを利用して、変数からフィールドにデータをコピーできます。

documentにはボリューム名やフォルダ名等のパスを含めることができます。空の文字列を渡すと、標準のファイルを開くダイアログボックスが表示されます。ユーザがこのダイアログボックスをキャンセルすると、データ読み込み処理は中止され、システム変数OKには0がセットされます。

データの読み込み処理中には進捗インジケータが表示されます。インジケータの中止ボタンをクリックすると、処理を中断します。しかし既に読み込まれたレコードは取り除かれません。読み込みが正常に完了すると、システム変数OKに1がセットされ、エラーが発生、または処理が中断された場合には0がセットされます。インジケータを表示したくない場合には、MESSAGES OFFコマンドを使用してください。

Unicodeモード (標準モード) では、コマンドはデフォルトでUTF-8文字セットを使用します。USE CHARACTER SET コマンドを使用してこの文字セットを変更できます。

ASCII互換モードでは、事前にUSE CHARACTER SETコマンドを使用しない限り、インポート処理はプラットフォームのデフォルトASCIIマップを使用して行われます。

IMPORT SYLKを使用する際、デフォルトのフィールド区切り文字はタブ文字 (コード 9) です。デフォルトのレコード区切り文字はキャリッジリターン (コード 13) です。これらの値は2つのシステム変数FldDelimitRecDelimit に新しい値を代入して変更できます。ユーザはこれらのデフォルト値をデザインモードの読み込みダイアログで変更できます。テキストフィールドにはタブやキャリッジリターンを含めることができるので、これらの値を区切り文字として使用する際は注意が必要です。

例題

以下の例は、データをSYLKドキュメントファイルから読み込みます。まず、メソッドの最初で読み込みに使用する入力フォームを設定し、次にデータ読み込みを実行します:

   INPUT FORM([People]; "Import")
   IMPORT SYLK([People];"NewPeople.slk") `  “NewPeople.slk” から読み込みを実行

参照

EXPORT SYLK, IMPORT DIF, IMPORT TEXT, USE CHARACTER SET.

システム変数とセット

読み込み処理が正常に終了するとシステム変数OKに1が、それ以外の場合には0がセットされます。


4D - Documentation   French   English   German   Spanish   日本語   4D v11 SQLコマンドテーマリスト   4D v11 SQLインデックス   4D v11 SQL定数テーマリスト   戻る   前   次