データファイルに書き込む

オープンデータファイルにデータを書き込みます。

オプション 

• [ファイル ID] は、オープンデータファイルのファイル ID を指定する数式です。[データファイルを開く] スクリプトステップを参照してください。
• [データソース] は、ファイルに書き込むデータを格納するフィールドまたは変数です。
• [書き込み] は、FileMaker Pro ファイルで使用されるデフォルト UTF-16 (リトルエンディアン) 文字エンコードまたは UTF-8 を使用してファイルにデータを書き込みます。データソースがオブジェクトデータの場合、このオプションは無視され、データはバイナリとして書き込まれます。
• [改行を追加] は、ファイルに書き込まれたデータの終わりに改行文字を追加します。

起点バージョン 

18.0

説明 

ファイルの読み取り/書き込み位置にあるデータは、データソースのデータにより上書きされます。[データファイルの位置を設定] スクリプトステップを参照してください。

このスクリプトステップが一度に書き込むことができるデータの最大サイズは 64 MB です。書き込むデータが 64 MB よりも大きい場合は、このスクリプトステップを複数回実行して、毎回 64 MB 未満のデータを書き込むようにします。

メモ 

• 書き込むデータの量が 64 KB 未満の場合にパフォーマンスが最適になります。

例 1 

オープンデータファイル (ID が 2) に、変数の内容とその後に続く改行を UTF-8 エンコードテキストとして書き込みます。

データファイルに書き込む [ファイル ID: 2 ; データソース: $variable ; 書き込み: UTF-8 ; 改行を追加]

例 2 

ドキュメントフォルダに「change.log」ファイルが存在しているかどうかを確認し、存在していない場合には「change.log」ファイルを作成し、「アクティビティ::トランザクション」フィールドのデータをファイルの先頭に書き込み、ファイルを閉じます。

変数を設定 [$file ; 値: Get (ドキュメントパス) & "change.log"]
ファイルの存在を取得 [「$file」; ターゲット: $fileExists]
If [not $fileExists]
    データファイルを作成 [「$file」 ; フォルダを作成: オフ]
End If
データファイルを開く [「$file」; ターゲット: $fileID]
データファイルに書き込む [ファイル ID: $fileID ; データソース:アクティビティ::トランザクション ; 書き込み:UTF-8 ; 改行を追加]
データファイルを閉じる [ファイル ID: $fileID]

例 3 

フィールドのデータを、「dates.txt」という名前のファイルの特定の位置に書き込みます。スクリプトの実行前に、このファイルには 2024-11-30 が含まれており、「テーブル::月」フィールドには 12 が指定されています。スクリプトの実行後は、このファイルには 2024-12-30 が含まれます。

データファイルを開く [「dates.txt」; ターゲット: $fileID]
データファイルの位置を設定 [ファイル ID: $fileID ; 新しい位置: 5 ]
データファイルに書き込む [ファイル ID: $fileID ; データソース: テーブル::月 ; 書き込み: UTF-8]
データファイルを閉じる [ファイル ID: $fileID]

関連項目 

• [データファイルから読み取る] スクリプトステップ
• スクリプトステップリファレンス