ビジネスオブジェクトを作成する
変更、問題、インシデント、または任意のカスタム定義ビジネス オブジェクトなど、すぐに使用できるビジネス オブジェクトを作成できます。
ベース URL:
https://{tenant url}/api/odata/businessobject/{business object name}
ビジネス オブジェクト名の末尾に「s」が付いていることを確認します。
変更ビジネス オブジェクトを作成する例を次に示します。
例に従って、任意のビジネス オブジェクトを作成できますが、 URL の businessobject プレース ホルダーに、末尾に「s」が付いた適切なビジネス オブジェクト名を指定し、 Request Payloadに関連する詳細を入力するようにしてください。
メールアドレス | https://{tenant url}/api/odata/businessobject/changes |
|---|---|
方法 | 役職 |
ヘッダー名 | 認証: JWT トークン/セッション キー/REST API キー |
リクエストペイロード | { 「カテゴリー」:「コンピューター」、 "CreatedBy":"Admin", "RequestorLink_RecID":"FB884D18F7B746A0992880F2DFFE749C", "Description" : "test", 「オーナー」: 「BHeath」、 "オーナーチーム":"会計", "件名":"テスト", "OwnerTeam_Valid":"8D796372096546AC9008C0EDAB18EE5F", "Owner_Valid":"147098AD139247F6B177042064C5E39C", "ステータス":"ログに記録済み", "TypeOfChange": "マイナー" } |
ステータスコード | 201 |
レスポンスペイロード | { "@odata.context": "http://{tenant url}/api/odata/change/$metadata#changes/$entity", "AcceptanceDueDate": "0001-01-01T00:00:00Z", "AcceptTimeout": "0001-01-01T00:00:00Z", "BackoutPlanAttached": false, "BallotCount": null, "BusinessFunction_Valid": null, "BusinessFunction": null, "Category_Valid": "18FCF302685C41A9AB4D4E6C52123A56", 「カテゴリー」:「コンピューター」、 "ChangeNumber": 0, "ClosedBy": null, "ClosedCode_Valid": null, "ClosedCode": null, "ClosedDateTime": "0001-01-01T00:00:00Z", "CompletedBy": null, "CreatedBy": "Admin", "CreatedByRecID": "FB884D18F7B746A0992880F2DFFE749C", "CreatedDateTime": "2018-08-07T06:06:52+05:30", "DirectCost": 0, "Emergency": false, "EstimatedCost": 0, "ExternalCalendarLinkID": null, "ExternalTaskLinkID": null, "FinalState": "False", "Impact_Valid": null, "Impact": null, "最終更新者": "管理者", "LastModDateTime": "2018-08-07T11:36:52 05:30", "Owner_Valid": "147098AD139247F6B177042064C5E39C", 「オーナー」: 「BHeath」、 "OwnerTeam_Valid": "8D796372096546AC9008C0EDAB18EE5F", "オーナーチーム": "会計", 「オーナータイプ」: null、 "ParentLink_Category": null, "ParentLink_RecID": null, 「親リンク」: null、 「優先度」: null、 "理由有効": null、 「理由」: null、 "RecId": "67D90C9B57334F84A7B0EEEEA3FBC743", "RequestedBy": "管理者 管理者", "RequestorLink_Category": "Employee", "RequestorLink_RecID": "FB884D18F7B746A0992880F2DFFE749C", "リクエストリンク": "FB884D18F7B746A0992880F2DFFE749C", "予定終了日": "0001-01-01T00:00:00Z", "スケジュール開始日": "0001-01-01T00:00:00Z", "Service_Valid": null, 「サービス」: null、 "Status_Valid": "DED387BDB5D843B089246E22563F6446", 「ステータス」: 「ログに記録済み」 「件名」:「テスト」 「ターゲット違反」: false、 "ターゲット日付": "0001-01-01T00:00:00Z", "TypeOfChange_Valid": "B3DB5AAC881E4D88A97890232C867B4D", "TypeOfChange": "マイナー", "Urgency_Valid": null, 「緊急度」: null、 「投票数」: null、 "投票有効期限": "0001-01-01T00:00:00Z", "投票タイムアウト": "0001-01-01T00:00:00Z", "TempChangeTaskSubject": null、 「変更テスト済み」: false、 "DetailScreenName": null, 「LinkTargetComputer」: false、 "MsgPreExistInventoryItem": null、 "IsScheduledStartDateFilled": false, "リクエストメール": "[email protected]", "CABMeetingTime": "0001-01-01T00:00:00Z", 「計算されたリスクの質問」: false、 "カタログ名": null, "CMApprovedBy": null, "CMApprovedDateTime": "0001-01-01T00:00:00Z", "IsCIAdded": "0001-01-01T00:00:00Z", "IsStandardChange": false, "Justification_Valid": null, "Justification": null, "NoOfCILinked": 0, "NoOfTasks": 0, "NoOfTasksCompleted": 0, "オーナーメール": "[email protected]", "ReleaseCIJscriptHolder": null、 "RequestorFullName": "管理者 Admin", "RiskSum": 0, "SetChangeWindowJscriptHolder": null, "スポンサー有効": null, 「スポンサー」: null、 "RiskLevel_Valid": null, 「リスクレベル」: null、 "RiskCatalogLink_Category": null, "RiskCatalogLink_RecID": null, "RiskCatalogLink": null, "ReleaseLink_Category": null, "ReleaseLink_RecID": null, 「リリースリンク」: null、 "CIへのトリガー変更": "0001-01-01T00:00:00Z", "リクエスト者の所在地": "米国", "依頼者電話番号": "7195551254", "MCVoteExpirationDateTime": "0001-01-01T00:00:00Z", "ECABVoteExpirationDateTime": "0001-01-01T00:00:00Z", "CABVoteExpirationDateTime": "0001-01-01T00:00:00Z", "提出期限日時": "0001-01-01T00:00:00Z", "CABReviewDate": "0001-01-01T00:00:00Z", 「リスク合計スコア」: null、 「読み取り専用」: false、 "オーナーフルネーム": "Bo R Heath", "Cost": 0, "合計消費時間": 0, "IsUnRead": false } |
失敗した応答
シナリオ: リクエスト本文が空のビジネス オブジェクトを作成しようとしています。
ヘッダー名:
認証: セッションキー
コード | ISM_4000 |
|---|---|
説明 | 無効なリクエストペイロード |
メッセージ | { 「メッセージ本文は空にできません。」 } |
HTTP ステータス コード | 400 |
シナリオ: 無効なリクエスト本文でビジネス オブジェクトを作成しようとしています。
ヘッダー名:
認証: セッションキー
コード | ISM_4000 |
|---|---|
説明 | 無効なリクエストペイロード |
メッセージ | [ 「ビジネス オブジェクトが無効です。」 ], |
HTTP ステータス コード | 400 |
シナリオ: 必須フィールドが欠落しているビジネス オブジェクトを作成しようとしています。
ヘッダー名:
認証: セッションキー
コード | ISM_4000 |
|---|---|
説明 | 無効なリクエストペイロード |
メッセージ | [ 「必須フィールド「カテゴリ」の値を指定する必要があります。」 「必須フィールド「説明」の値を指定する必要があります。」 「必須フィールド「ステータス」の値を指定する必要があります。」 ] |
HTTP ステータス コード | 400 |
シナリオ: インシデントを作成または更新しようとすると、アプリケーションが保存に失敗し、API から適切な応答が返されません。
ヘッダー名:
認証: セッションキー
コード | ISM_5000 |
|---|---|
説明 | 内部サーバーエラー |
メッセージ | [ 「サーバーに内部エラーが発生しました。 リクエストを再試行してください。" ], |
HTTP ステータス コード | 500 |
