サードパーティのキャリアアプリケーション用の統合スクリプトインクルードの作成
ServiceNowインスタンスと統合するには、サードパーティの配送業者アプリケーションに、顧客のServiceNowインスタンスから出荷追跡番号を受信して配送業者関連の詳細で応答するように、ServiceNowインスタンスで基本クラス ITAMShipmentIntegration スクリプトを拡張するスクリプトインクルードが必要です。
スクリプトインクルードを作成するときは、次の点を考慮してください。
- アプリケーションリソースレコードの次の設定を調整して、 資産管理 共通アプリケーションスコープからスクリプトインクルードにアクセスできることを確認します。
- [アクセス可能] フィールドを [すべてのアプリケーションスコープ] に設定します。
- [ 申請者アクセス ] フィールドを [なし ] に設定して、申請者のアクセスが制限されていないことを確認します。
- 追跡番号に基づいて顧客の ServiceNow インスタンスと通信するためのコードは、 fetchShipmentInfo 関数内に含める必要があります。
- 顧客の ServiceNow インスタンスとの接続を検証するために API がテストモードで呼び出された場合、 fetchShipmentInfo メソッドからの返される応答は、次のように HTTP 応答コードと応答メッセージを含む JSON オブジェクトである必要があります。
{ httpResponseCode: 200, httpResponseMessage: ‘SUCCESS’ } - テストモードでない場合は、出荷を照会し、次の応答形式で processResponse メソッドを呼び出します。
[ { trackingNumber: ‘’, deliveryDate: ‘’, pickupDate: ‘’, packageStatus: ‘’. statusDetail: ‘’, trackingURL: ‘’, parcelWeight: ‘’, deliveryServicesCost: ‘’, currency: ‘’ } ]
ITAMShipmentIntegration スクリプトインクルードのサンプルコード
fetchShipmentInfo 関数
fetchShipmentInfo 関数は、顧客の ServiceNow インスタンスから追跡番号を受け取り、配送会社 API を呼び出して、すべての追跡番号の出荷の詳細を取得します。この機能内で、顧客が追跡番号に基づいて配送業者 API と通信できるようにするビジネスロジックを定義する必要があります。この関数は、キャリア API から受信した応答を処理し、後処理関数を呼び出します。
processResponse 関数
processResponse 関数は、配送業者 API からの応答を受信し、配送業者関連の次の詳細情報で出荷レコードを更新します。
- 配送業者リンク
- 配送業者ステータス
- 配送業者ステータスの詳細
- 配送業者の集荷日
- 配送業者配送日
- 通貨
- 配送サービスコスト
- パーセルの重み付け
デフォルトの processResponse 関数を使用するか、カスタムロジックを定義して出荷レコードを更新することができます。