footprint-entity-expert

Footprint Entity Expert

OData メタデータだけでは導き出せない、Footprint WMS のドメイン知識を参照できます。ナビゲーションチェーン、ビジネスルールに基づくフィルター、重量計算など、既存のレポートからリバースエンジニアリングしなければ分からない情報を扱います。

このスキルは schema-explorer と datasource-creator の上位に位置します。これらのスキルがフィールドの検証や設定の生成といった機械的な作業を行う前に、どのエンティティを調べるべきか、どのような注意点があるかを示します。

このスキルを使うタイミング

作業内容…	このスキルを使いますか？
Tasks、Shipments、License Plates、Inventory、Materials、Lots などをクエリするレポートやフロー	はい — スキーマを調べる前に、まずここを確認してください
Archived... エンティティを使うデータソース（出荷または入荷の履歴）	はい — アーカイブエンティティには固有のナビゲーションチェーンがあります
重量または単位換算の計算（ケース重量、パレット重量、合計など）	はい — 固定重量とキャッチウェイトの分岐は分かりにくいためです
WMS データとは関係のないアプリやレポート（カスタム組織設定、汎用ダッシュボードなど）	いいえ — このスキルは適用されません
顧客が独自に追加したデータに関するレポート（カスタム Material 拡張フィールドなど）	一部適用 — 標準フィールドについてはエンティティリファレンスを使い、顧客の拡張フィールドは schema-explorer で確認してください

データが Footprint 固有のものかどうか分からない場合は、接続の apiConnectionTypeName が判断材料になります。FootPrintApi なら該当し、それ以外ならおそらく該当しません。

使い方（段階的な開示）

この SKILL.md はコンテンツそのものではなく、索引です。以下の内容をすべて把握しようとせず、表から必要なトピックを見つけて、該当するリファレンスファイルを読んでください。各リファレンスは単独で完結しており、エンティティの定義、ナビゲーションチェーン、注意点、OData クエリの例を掲載しています。

エンティティと横断的な考慮事項は分けて掲載しています。重量ロジックや所有者へのナビゲーションなど、一部のパターンは複数のエンティティで共通するためです。

エンティティリファレンス

エンティティ／分野	リファレンスファイル	確認するタイミング
ArchivedShippingLicensePlateContents（ASLPC）— 出荷済み在庫の履歴	references/archived-shipping-lpc.md	出荷履歴レポート、出荷量に基づく請求のクエリ、従来なら SQL の ShippingActivityRaw ビューを使っていたあらゆる作業を作成するとき
入荷に絞り込んだ Tasks	references/receiving-tasks.md	入荷作業レポート、ドックから在庫化までの指標、入荷した単位数／パレット数／重量を集計するものを作成するとき

横断的な参照情報

トピック	参照ファイル	参照するタイミング
所有者／プロジェクトのナビゲーションチェーン	references/owner-navigation.md	所有者またはプロジェクトでグループ化、フィルタリング、ラベル付けを行うレポート全般 — 経路はエンティティによって異なります
重量の計算（固定重量と変動重量）	references/weight-and-units.md	総重量または LP ごとの重量を計算する場合全般 — 計算式は Material.IsFixedWeight によって異なります
ステータスと操作コード（Order / Shipment / Wave / Task / OperationCodeId）	references/footprint-status-codes.md	状態に基づくフィルターやライフサイクルロジック全般 — メタデータには StatusId : Edm.Int32 が記載されていますが、各整数の意味は示されていません。また、補充が条件となるピッキング、作成時に完了済みとなるロードタスク、Task.Result／Notes のペイロードフィールドについても説明しています
エンティティ ID の予約（$api.ReserveEntityIdBatch）	references/entity-id-reservation.md	ID を事前予約する一括作成 — NewIdCeiling は予約範囲の上限です。ceiling - idx のマッピングが安全なのは、0 始まりの密なカウンターの場合に限られます
受注行の作成（create_sales_order_line_action と create_sales_order_lines_action）	references/order-line-creation.md	受注行を作成するフロー全般 — バッチアクションでは、すべての項目が指定された行（MaterialId、計算済みの Amount、梱包）が必要です（シリアル番号のみの指定は不可）。ウィザード／UI から作成する場合は、ロットから資材を導出する単数形アクションを繰り返し呼び出す必要があります

ここに記載しない内容（意図的なもの）

• 顧客ごとのビジネスルール — 除外する受注クラス ID、カスタムステータス、請求区分など。これらは顧客によって異なるため、ここではなく顧客固有のドキュメントに記載します。このスキルで除外条件（一般的な入庫受注クラスなど）に触れる場合は、「一般的ですが、顧客ごとに確認してください」と明記します。
• OData の仕組み — $expand、$filter、ページングの動作方法。これらについては、schema-explorer、datasource-creator、および「datex-studio-shared」スキルの flow-code-patterns.md を参照してください。
• 特記事項のない標準 CRUD エンティティ — Warehouse、Carrier、Pack など。schema-explorer を直接使用してください。これらに参照ページは必要ありません。
• UI／ハブの設定 — Footprint のハブとグリッドの接続方法。これは datex-studio/hub-editor を参照してください。

セッション中にエンティティに関する新たな注意点を見つけた場合は、知識をコミット履歴だけに残さず、ここに参照ファイルを追加してください。

他のスキルとの関係

[user asks for a Footprint report]
        |
[footprint-entity-expert]   ← THIS SKILL: which entities, what gotchas?
        |
[schema-explorer]           ← validate the entity exists on this connection,
        |                     confirm property names and types
[datasource-creator]        ← generate the OData/flow datasource using
        |                     the validated schema + the rules from this skill
[report-creator]            ← assemble the report

このスキルはクエリごとではなく、エンティティごとに 1 回参照します。出力はメンタルモデルです。つまり、ビジネス上の概念を裏付ける OData エンティティ、展開する項目、フィルター条件、重量の扱い方、所有者に到達するナビゲーションチェーンを把握します。その理解を datasource-creator に引き継ぎ、スキーマ検証の作業に方向性を与えてください。