コマンド

DataEaseでは、インポートファイルの各行にコマンドを含めることができます。このコマンドは、その行のデータに対してアプリが何をするかを指示します。既存のアイテムを更新したり、新しいものを作成したり、何かを削除したり、行を完全にスキップしたりすることができます。

DataEaseの各データタイプは、追加のカスタムコマンドをサポートしている場合があり、それらは特定のエンティティページで文書化されています。

---

⚙️ デフォルトコマンド: MERGE

• アプリは既存のアイテムを見つけて、その行のデータを使用して更新しようとします。
• アイテムが見つからない場合は、新しいものを作成します。

✅ これは最も一般的なコマンドで、新しいレコードの追加と更新の両方に機能します。

---

✳️ 作成コマンド: CREATE

• アプリは新しいアイテムを作成しようとします。
• 既にアイテムが存在する場合（同じIDまたはhandleを持つ）、その行は失敗します。

✅ 新しいデータのみをインポートする場合に使用してください。
❌ 既に存在する可能性のあるデータがある場合は使用しないでください。

---

🔁 更新コマンド: UPDATE

• アプリは既存のアイテムを検索し、更新します。
• 一致するものが見つからない場合、その行は失敗します。

✅ 既存のレコードのみを更新するのに最適です。
❌ 新しいアイテムを作成しません。

---

♻️ 置換コマンド: REPLACE

• アプリは既存のアイテムを探します。
• 見つかった場合、それを削除します。
• その後、その行のデータのみを使用して新しいものを作成します。

⚠️ 注意: 行にデータが欠けている場合、新しいアイテムにはそれが含まれません。

✅ クリーンなデータでレコードを完全に再構築するのに便利です。

---

❌ 削除コマンド: DELETE

• アプリはアイテムを見つけて削除します。
• アイテムが見つからない場合、その行は失敗します。

✅ 古いまたは不正確なレコードを削除するのに使用します。

---

⏭️ 無視コマンド: IGNORE

• アプリはこの行をスキップし、何もしません。

✅ インポートから行を一時的に削除するのに役立ちますが、ファイルから削除することはありません。

---

📝 コマンド概要表

Command	その機能	新しいアイテムを作成?	既存のものを更新?	既存のものを削除?
MERGE	アイテムが見つからない場合は更新または作成	✅	✅	❌
CREATE	新しいアイテムのみを作成	✅	❌	❌
UPDATE	アイテムが既に存在する場合のみ更新	❌	✅	❌
REPLACE	既存のものを削除し、現在の値で新しいものを作成	✅	❌	✅
DELETE	既存のアイテムを削除	❌	❌	✅
IGNORE	行を完全にスキップ	❌	❌	❌

---

💡 ファイルにコマンドを追加する方法

インポートファイルにcommandという名前の列を含め、サポートされている値（MERGE、CREATEなど）で埋めてください。

title,handle,price,command
"Red T-shirt","red-tee",19.99,MERGE
"Blue T-shirt","blue-tee",21.99,CREATE
"Old Product","old-handle",,DELETE