サードパーティ配送業者アプリケーション用の統合スクリプトインクルードの作成
インスタンスとServiceNow統合するには、サードパーティの配送業者アプリケーションに、インスタンスの ServiceNow基底クラス ITAMShipmentIntegration スクリプトを拡張するスクリプトインクルードを用意して、顧客のServiceNowインスタンスから出荷追跡番号を受信し、配送業者関連の詳細で応答できるようにする必要があります。
スクリプトインクルードを作成するときは、次の点を考慮してください。
- アプリケーションリソースレコードの次の設定を調整して、共通アプリケーションスコープから 資産管理 スクリプトインクルードにアクセスできることを確認します。
- [ アクセス可能 ] フィールドを [すべてのアプリケーションスコープ] に設定します。
- [ 発信者アクセス ] フィールドを [ なし ] に設定して、発信者アクセスが制限されないようにします。
- 追跡番号に基づいて顧客の 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 関数
注:
IT Asset Managementアプリケーションはこの関数内でビジネスロジックを定義しており、変更しないでください。
processResponse 関数は、配送業者 API からの応答を受信し、配送業者に関連する次の詳細で出荷レコードを更新します。
- 配送業者リンク
- 配送業者ステータス
- 配送業者ステータスの詳細
- 配送業者の集荷日
- 配送業者配送日
- 通貨
- 配送サービスコスト
- パーセルの重み付け