📥idmp-workflow-data-import-export
- プラグイン
- idmp-plugin
- ソース
- GitHub で見る ↗
説明
IDMP データ(医薬品の情報管理データ)のインポートとエクスポート(出入力)に関するワークフロー(作業手順)です。 パッケージのインポートまたはエクスポートと、データソースの CSV ファイル(表計算データ形式)からのインポートを分けて管理します。データを読む際は最初に内容をしっかり確認してから、慎重に書き込みます。書き込み後は、記録内容に問題がないかを毎回読み直して検証します。
原文を表示
IDMP data import and export workflow. Separate package import or export from datasource CSV import, read first, write carefully, and reread records after every write.
ユースケース
- ✓医薬品情報をパッケージでインポートする
- ✓医薬品情報をパッケージでエクスポートする
- ✓CSVファイルからデータをインポートする
- ✓書き込み後のデータを検証する
本文(日本語訳)
ワークフロー: データのインポート・エクスポート
まず ../idmp-shared/SKILL.md をお読みください。
推奨される参考資料
最初に確認すべき情報
- ワークフローの種類
- 期待される成果物
- ユーザーがパッケージのエクスポート、パッケージのインポート、またはデータソースのCSVインポートのいずれを必要としているか
- どのルート(基点)またはレコードがすでに判明しているか
- 期待される成果物がレコードに保存されるのか、それとも直接stdout(画面出力)にストリーミング(流し出し)されるのか
実行時の制約
- 有効なエクスポート方式の両方に対応する
- 毎回の書き込み後に必ずレコードを再度確認する
- パッケージのインポート・エクスポートとデータソースのCSVインポートは異なるコマンド体系である
download getはレコードに保存された成果物が存在した後にのみ機能する- エクスポート方式によっては、ZIPファイルの内容が直接stdout にストリーミングされる場合があり、その場合そのファイルが最終成果物となる
実行フロー
-
idmp-cli data first-level-elements listとidmp-cli data records listを実行して、表示可能なルートと現在の成果物の履歴を確認する -
ルートとエクスポート方式が明確になってから、
idmp-cli data import-and-export export --ack-risk --dataを実行する -
idmp-cli data download get --paramsを試す前に、idmp-cli data records listを再度確認する -
パッケージのインポート前に
idmp-cli schema data.import-and-export.importを確認する -
idmp-cli schema datasource.csv.createを独立したデータソースCSV処理として扱い、idmp-cli datasource csv create --ack-risk --paramsをパッケージのインポート・エクスポート処理に含めない
例外処理
-
エクスポートレコードが存在しない場合、
download getの前で中断し、エクスポート方式がZIPを直接stdoutにストリーミングしたのかを説明する -
ユーザーがCSVインポートを求めているがパッケージインポートのみを説明した場合、混在させずに範囲を再度確認する
-
毎回の変更後にレコードを再度読み込み、成果物の履歴を明確にする
検証シナリオ
1. パッケージエクスポート(方式の判定付き)
idmp-cli data import-and-export export --ack-risk --data を実行し、idmp-cli data records list を再度確認する。結果は、処理方式がレコード保存型かstdout-ZIP型かを示す必要がある
2. スキーマ確認後のパッケージインポート
先に idmp-cli schema data.import-and-export.import を確認する。その後でのみ、パッケージインポートのペイロード(データ本体)に関する相談が有効になる
3. データソースのCSVインポート
idmp-cli schema datasource.csv.create を使ってCSVインポートをパッケージのインポート・エクスポートから分離する。パッケージの定義形式(DTO)の説明をここで使い回さない
4. ZIP stdout方式 対 レコード保存方式
レコードを再度確認した後でのみ、idmp-cli data download get --params を試す。レコードが存在しない場合は、stdout方式を明示的に記録する
5. 書き込み前に誤った処理が検出された場合
エクスポートとCSVインポートが混在している場合は早期に中断する。エクスポート、インポート、またはCSV書き込みのたびに data records list を再度確認する
原文(English)を表示
workflow: data import export
Read ../idmp-shared/SKILL.md first.
Recommended references
Missing context to resolve first
- Workflow type.
- Artifact expectation.
- Whether the operator needs package export, package import, or datasource CSV import.
- Which root or artifact record is already known.
- Whether the expected artifact is record-backed or streamed directly to stdout.
Constrained live behaviors
- Accept both valid export branches.
- Always reread records after every write.
- Package import/export and datasource CSV import are different command families.
download getonly works after a record-backed artifact exists.- Some export branches stream ZIP content directly; in that branch the streamed file is the final artifact.
Execution flow
- Start with
idmp-cli data first-level-elements listandidmp-cli data records listto prove the visible roots and current artifact history. - Use
idmp-cli data import-and-export export --ack-risk --dataonly after the root and export mode are clear. - Reread
idmp-cli data records listbefore tryingidmp-cli data download get --params. - Inspect
idmp-cli schema data.import-and-export.importbefore any package import. - Treat
idmp-cli schema datasource.csv.createas the separate datasource CSV chain, and keepidmp-cli datasource csv create --ack-risk --paramsout of package import/export payloads.
Exception paths
- If no export record exists, stop before
download getand explain whether the branch streamed a ZIP directly. - If the operator asked for CSV import but only described package import, stop and rescope instead of mixing workflows.
- After every mutation, reread records so the artifact history is explicit.
Validation scenarios
1. Package export with branch detection
Run idmp-cli data import-and-export export --ack-risk --data, then reread idmp-cli data records list. The result must say whether the branch is record-backed or stdout-ZIP.
2. Package import after schema inspection
Read idmp-cli schema data.import-and-export.import first. Only then is a package import payload discussion valid.
3. Datasource CSV import
Use idmp-cli schema datasource.csv.create to keep CSV import separate from package import/export. Do not reuse package DTO guidance here.
4. ZIP-stdout branch versus record-backed branch
Try idmp-cli data download get --params only after rereading records. If no record exists, record that stdout branch explicitly.
5. Wrong chain detected before write
If the request mixes export and CSV import, stop early. Reread data records list after every export, import, or CSV write.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。