jigx-acumatica

Jigx Acumatica

このスキルは汎用の jigx スキルと併用してください。画面、フォーム、データソース、タブ、メディア、PDF のパターンについては、汎用 Jigx のリファレンスをお読みください。このスキルは Acumatica 固有の統合ルールにのみ使用してください。

ワークフロー

1. references/recipe-index.md を読みます。
2. 新しい統合では、まず references/acumatica-discovery.md を読みます。インスタンスのビルドから顧客のリリースを特定し、ジョブに応じてチャネルを選び、すべてのセッションでログアウトして終了します。SOAP/UI プローブはエージェント側での調査と Acumatica の設定にのみ使用します。Jigx モバイルは SOAP 呼び出しを実行できないため、調査で判明した画面の情報を Generic Inquiries/OData、contract REST、または明示的に提供されたサーバー側ブリッジを通じて使用する必要があります。
3. 画面上で何かを設計する前に、references/acumatica-screen-logic.md を読み、jigx-acumatica-kb を使用します。接続がある場合は実際のインスタンスと照合し、顧客が追加したフィールドと未解決のフィールドはスキーマ情報としてのみ扱います。
4. タスクが受信ルックアップ同期、ローカルファーストの送信同期、直接送信、ファイルアップロード、リトライ／エラー処理のいずれに当たるかを確認します。オフライン／バッチでの作成または更新を行う場合は、テーブルやアクションを設計する前に references/acumatica-sync.md を読みます。
5. REST と OData のどちらを使うかを確認します。可能であれば REST を優先します。
6. ネストされたデータが必要なルックアップを実装する前に、必要な $expand 値を確認します。
7. Acumatica の設定では、大文字と小文字を正確に維持します。acumaticaURL と acumaticaOdataURL を使用します。
8. 型／値が acuerp の accessToken を使用します。アクセストークンをハードコードしないでください。
9. アプリで明示的に直接送信を使用している場合を除き、ローカルファーストの動作を維持します。
10. すべてのセレクターとすべての書き込みについて、references/acumatica-selectors-and-cascades.md と references/integration-verification.md を読みます。実行時にのみ解決できるセレクターはインスタンス上で解決し、ルックアップ値を読み書き可能なエンドポイントで往復検証します。書き込みが完了したと判断する前に、ハードニングの一連の検証を実行します。
11. references/acumatica-reads-and-sync-contract.md に従い、すべてのリスト読み取りを明示します。Inquiry に基づくこと、変更フィールドによる差分であること、結合行の行識別子を備えること、住所または親を必要とする読み取りには必須パラメーターを設定することが必要です。

リファレンスマップ

• references/recipe-index.md - Acumatica の各リファレンスを読むタイミング。

• references/acumatica-discovery.md - インスタンスのプローブ、Jigx モバイルでの SOAP/UI プローブの境界、ジョブ別の 3 つのチャネル、ビルドからのリリース特定、セッションとライセンスの適切な管理、Acumatica のエラーの読み方。

• references/acumatica-screen-logic.md - 画面ナレッジベースに含まれる情報、リリースルール、実際のインスタンスとの照合、情報の出所、把握できない内容。

• references/acumatica-selectors-and-cascades.md - 保存列の契約、所有者セレクターと ContactID、連動セレクターの確認、値が拒否された場合の診断、往復検証、ハードニングの一連の検証、値のセマンティクス、ワークフローアクション。

• references/acumatica-reads-and-sync-contract.md - リスト用の Inquiry、Inquiry の作成、差分同期、住所指定および親主導の読み取り、行識別子、行数の上限。

• references/acumatica-endpoints-and-files.md - フォールバックとしての contract REST、詳細コレクション、不足しているエンドポイントの作成、レコードへのファイル添付。

• references/acumatica-rest.md - REST 関数、パラメーター、ペイロード、エラー。

• references/acumatica-sync.md - ローカルファースト同期、Remote の状態、コマンドキュー、親子の検索／置換、リトライ。

• references/acumatica-lookups-expands.md - ルックアップ同期、OData/REST の違い、$expand、強制同期、ドロップダウンフィールド。

• references/acumatica-files-submit.md - ファイルアップロード、PDF 添付、サービスオーダーの送信パターン。

• references/integration-verification.md - 生成されたリクエストを通じたアプリ入力データのテスト、承認済みの実環境への書き込みとリモート側での読み戻し。

ガードレール

• Acumatica のリリースを推測したり、デフォルト値で補ったりしないでください。ビルドから特定するか、確認してください。ナレッジベースでカバーされていないリリースの場合は、隣接するリリースではなく、実環境のスキーマから設計します。
• SOAP、WSDL 呼び出し、Acumatica SOAP セッションを実行する Jigx モバイルコードを生成しないでください。SOAP／UI プローブを使って Acumatica を理解し、設定してから、Generic Inquiries／OData、コントラクト REST、ファイル／アクション、または明示的に利用可能なサーバーサイドブリッジを使ってモバイル連携を実装します。
• 画面 API やコントラクト REST 経由で大量のリストを同期しないでください。リストには Generic Inquiry を使います。
• Acumatica セッションを開いたままにしないでください。ログインし、作業し、ログアウトします。失敗した場合も同様です。
• ドロップダウンの行、列挙値、カスケードを捏造しないでください。行のソースを再現し、インスタンスから列挙値を収集し、読み取りによってカスケードを検証します。
• 書き込み可能なエンドポイントとの往復検証が済んでいないルックアップをリリースしないでください。
• ユーザーごとのフィールドに、そのテーブルの全体同期データを入力しないでください。
• ワークフローのステータスをフィールドとして書き込まないでください。画面のアクションを使って変更します。
• セレクター値が拒否されても、保存先の列とデータの分布を確認する前に不正なデータと判断しないでください。
• 環境名を明示し、明確な合意を得ることなくカスタマイズパッケージを公開しないでください。まず検証し、本番前にテストします。
• Acumatica のアクセストークンをハードコードしないでください。
• acumaticaURL または acumaticaOdataURL の大文字・小文字を変更しないでください。
• $expand なしでネストされたフィールドが存在すると想定しないでください。
• Jigx の内部フィールドを Acumatica に送信しないでください。
• 画面の保存アクションでキューに入れる Acumatica ペイロードを構築しないでください。識別子を渡し、キューの処理時にローカルテーブルからリクエスト本文を構築します。
• ローカルファーストの作成／更新で、同じエンティティ用の別個のキューテーブルを作成しないでください。ビジネスフローで別のテーブルが明示的に必要な場合を除きます。デフォルトでは、エンティティのローカルテーブルと Remote: "new" | "dirty" | "remote" を使います。
• 失敗したコマンドを失わないでください。コマンドキューの再試行、または明示的なエラーレコードを使います。
• キューに一時 ID が残っている場合、子レコードのローカル ID を置き換える際に、キューに入った参照も置き換えずに残さないでください。