納入商品と設定項目の同期での例外とエラーの処理

主要な例外カテゴリ

同期エンジンでは、特定のカテゴリの例外を監視して、設定項目 (CI) とアセット間の不正なリンクやデータの破損を防止します。

例外のリンクと一致

• Multiple Asset Matches (複数のアセットの一致): 検出された CI が有効な一致ルールに基づいて複数のアセットレコードに一致する場合、システムはリンクプロセスをスキップします。この制限により、誤った関連付けを回避できます。エンジンは CI にレビューのフラグを設定し、自動ログエントリを生成します。
• 必須項目がない: CI が 1 つの納入商品に完全に一致するが、納入商品の作成に必要な項目がない場合、納入商品レコードは引き続き生成されます。フレームワークは、レコードを未完了としてマークし、管理レビュー用にフラグを設定します。

マッピングと値の例外

• 対応付けられていない項目値: CI 項目が、対応する対応付けられた納入商品値がない値に変更された場合、その特定の項目の更新はスキップされます。この安全機能により、無効なデータや不明なデータによるデータの破損を防止できます。
• マッピング設定がない: アセットまたは CI 項目が変更されたが、その属性の有効なマッピング設定が存在しない場合、更新がスキップされ、警告が記録されます。

システムおよび操作の例外

• システムおよび API エラー: これらのエラーには、設定管理データベース API タイムアウトやプラットフォーム接続の問題などの技術的な問題による障害が含まれます。
• 順序外イベント: データイベントが順序どおりでない場合、システムはタイムスタンプを使用して古い更新を識別し、破棄します。このエンジンでは、更新を再試行キューに入れる代わりに、古いデータが削除されます。

保護システムの動作

システムが例外を検出すると、プラットフォームの安定性を保護し、管理通知のオーバーヘッドを最小限に抑えるために特定のワークフローが実行されます。

バッチ通知

一括失敗時のアラート量を減らすために、失敗したレコードごとに個別のリアルタイムアラートが送信されるわけではありません。代わりに、通知は「Sync job failed with 5,000 errors (同期ジョブが 5,000 エラーで失敗しました)」などのサマリーに集計されます。

ログ重複排除

エラー数を明確にするために、1 つの納入商品で同じエラーが繰り返されても重複ログは作成されません。代わりに、フレームワークは既存のログレコードのログタイムスタンプを更新します。

ノンブロッキング操作

同期プロセスは部分的なバッチ処理に依存します。特定の CI またはアセットでエラーが発生しても、全体的な同期ジョブでバッチの残りの有効なレコードが処理されなくなります。

例外データモデル

すべての例外は、設定項目同期ログ内のレコードに入力されます。この構造化された監査履歴では、次のパラメーターを追跡します。

• ログタイトルとログ説明: 概要と詳細なデバッグコンテキスト。
• 状況: [成功]、[警告]、[エラー]、[アクションが必要] などの分類された状態。
• 識別子: 関連オブジェクト、設定項目 ID、および処理の失敗をトリガーした特定の設定項目変更イベントへの直接ルックアップ。