5.2.5 画面作成時の注意事項
画面作成時の注意事項を次に示します。
-
取得できるユニットの情報は各APIで異なります。各APIで取得できるユニット情報の差異については，マニュアル「JP1/Automatic Job Management System 3 - Software Development Kit API リファレンス」のメソッドで取得できるユニット情報の差異について記載している個所を参照してください。
-
複数のAPIを使用して画面を実現する場合は，各APIで取得した情報を一時的に保持するなどして，情報をマージして表示してください。
-
複数のAPIを使用して画面を実現する場合は，APIを呼び出すタイミングによって，取得した情報が不一致になる可能性を考慮しておく必要があります。このため，情報に不一致が生じた場合のエラー処理や情報全体を再取得するなどの検討が必要です。特にジョブネットリリース機能を使用している場合は，運用中に定義情報が切り替わるため注意が必要です。
たとえば，getDefinitionsUnderJobnetメソッドで取得したユニットの定義情報と，getStatusesUnderJobnetメソッドで取得したユニットの状態情報が，定義情報が切り替わるなどの理由で，不一致になる可能性があります。ジョブネットリリース機能を使用している場合は，APIを呼び出すときに実行IDやリリースIDを指定して取得対象を特定することで，情報に不一致が生じることを回避できることがあります。