機械翻訳について

移動先

• リクエスト
• レスポンス
• 例

所有の承認タスクのリストの取得

get

/access-governance/access-controls/20250331/approvals/me

ページ区切りをサポートする自分の使用可能な承認タスクの詳細を返します。 このAPIにはパスワード資格証明が必要です。

リクエスト

問合せパラメータ

• accessRequestId: string
  フィルタするアクセス・リクエストID。 assigneeIdが指定されていない場合、このパラメータは必須です。
• assigneeScope: string
  フィルタする割当先スコープ。 割当先IDまたは認証済ユーザーが直接割当先であるタスクをフィルタするには「DIRECT」、割当先に間接承認権限があるタスクをフィルタするには「INDIRECT」です。

  許容値: [ "DIRECT", "INDIRECT" ]
• dueBefore: string(date-time)
  指定した日付より前の期限のタスクのみを返します。
• instanceTags: array[boolean]
  コレクション形式: multi

  使用するタグ・フィルタのリスト。 配列内の各位置は、同じ位置にあるInstanceTags列挙内のタグにマップされます。 タグを保持するインスタンスを含めるには、値をtrueに設定します。 タグを持つインスタンスを除外するには、値をfalseに設定します。 フィルタを適用しないように、値をnullに設定します。
• keywordContains: string
  リクエスト者および受取人の名前に対してフィルタするために使用するキーワード。
• limit: integer
  最小値: 1

  最大値: 1000

  返されるアイテムの最大数。

  デフォルト値: 10
• page: string
  最小長: 1

  結果の取得を開始する位置を表すトークン。 これは、前のレスポンスの`opc-next-page`ヘッダー・フィールドから取得する必要があります。
• requestedAfter: string(date-time)
  指定された日付より後に作成されたインスタンスのみを返します。
• sortBy: string
  ソートの基準となるフィールド。 デフォルトのソート基準は'dueDate'です。

  許容値: [ "requestor", "beneficiary", "dueDate", "access" ]
• sortOrder: string
  使用するソート順(ASCまたはDESC)。

  許容値: [ "ASC", "DESC" ]
• status: array[string]
  コレクション形式: multi

  フィルタするタスク・ステータスのリスト。

  • 許容値: [ "PENDING_APPROVAL", "APPROVED", "ASSIGNED", "MODIFIED", "REJECTED", "REMOVED", "DELETED", "INFO_REQUESTED", "ESCALATED", "ERROR", "CANCELLED" ]

ヘッダー・パラメータ

• opc-request-id: string
  トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。

トップに戻る

レスポンス

サポートされているメディア・タイプ

• application/json

200レスポンス

タスク・オブジェクトのページ。

ヘッダー

• opc-next-page: string
  アイテム・リストのページ区切り。 リストをページングする際、このヘッダーがレスポンスに表示される場合は、部分的なリストが返されている可能性があります。 この値を後続のGETリクエストの`page`パラメータとして含め、次のアイテム・バッチを取得します。
• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : TaskCollection

型: object

タスク検索の結果。

ソースを表示

• items(必須): array items
  タスクのリスト

{
    "type":"object",
    "required":[
        "items"
    ],
    "properties":{
        "items":{
            "type":"array",
            "description":"List of tasks.",
            "items":{
                "$ref":"#/definitions/Task"
            }
        }
    },
    "description":"Results of a task search."
}

ネストされたスキーマ: items

型: array

タスクのリスト

ソースを表示

• Array of: object Task
  プロセス・インスタンス・タスクの詳細。

{
    "type":"array",
    "description":"List of tasks.",
    "items":{
        "$ref":"#/definitions/Task"
    }
}

ネストされたスキーマ : タスク

型: object

プロセス・インスタンス・タスクの詳細。

ソースを表示

• assignee: string
  タスクに割り当てられているユーザー。
• context: object InstanceContext
  プロセス・インスタンスに関連するコンテキスト・データ。
• id(必須): string
  BPMNプロバイダが提供するタスクの一意の識別子。
• instanceId: string
  プロセス・インスタンスID
• lastAction: object TaskAction
  特定のタスクに対して実行できるアクション。
• processId: string
  プロセス定義ID
• requestId: string
  コール元によって生成されるリクエストID。
• status: string
  許容値: [ "PENDING_APPROVAL", "APPROVED", "ASSIGNED", "MODIFIED", "REJECTED", "REMOVED", "DELETED", "INFO_REQUESTED", "ESCALATED", "ERROR", "CANCELLED" ]

  タスクのステータスです。
• timeCompleted: string(date-time)
  タスクの完了日。
• timeCreated: string(date-time)
  タスクの作成日。
• timeDue: string(date-time)
  タスクの期日。

{
    "type":"object",
    "required":[
        "id"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"Unique identifier of the task provided by BPMN provider."
        },
        "processId":{
            "type":"string",
            "description":"Process definition ID."
        },
        "instanceId":{
            "type":"string",
            "description":"Process instance ID."
        },
        "requestId":{
            "type":"string",
            "description":"Request ID which is generated by the caller."
        },
        "assignee":{
            "type":"string",
            "description":"User who is assigned to the task."
        },
        "status":{
            "type":"string",
            "description":"The status of the task.",
            "enum":[
                "PENDING_APPROVAL",
                "APPROVED",
                "ASSIGNED",
                "MODIFIED",
                "REJECTED",
                "REMOVED",
                "DELETED",
                "INFO_REQUESTED",
                "ESCALATED",
                "ERROR",
                "CANCELLED"
            ],
            "x-obmcs-top-level-enum":"#/definitions/TaskStatus"
        },
        "lastAction":{
            "$ref":"#/definitions/TaskAction"
        },
        "context":{
            "$ref":"#/definitions/InstanceContext"
        },
        "timeDue":{
            "type":"string",
            "format":"date-time",
            "description":"The due date of the task."
        },
        "timeCreated":{
            "type":"string",
            "format":"date-time",
            "description":"The creation date of the task."
        },
        "timeCompleted":{
            "type":"string",
            "format":"date-time",
            "description":"The completion date of the task."
        }
    },
    "description":"The details of a process instance task."
}

ネストされたスキーマ : InstanceContext

型: object

プロセス・インスタンスに関連するコンテキスト・データ。

ソースを表示

• additionalAttributes: object additionalAttributes
  許可される追加のプロパティ: additionalProperties

  追加キーと値文字列のペアをマップします。
• assignmentAttributes: object assignmentAttributes
  許可される追加のプロパティ: additionalProperties

  追加キーと値文字列のペアをマップします。
• assignmentDescription: string
  リクエストされているアサイメントの摘要。
• assignmentName: string
  リクエストされているアサイメントの名前。
• assignmentTags: array assignmentTags
  割当タグ。
• assignmentType: string
  リクエストされるアサイメントのタイプ。
• beneficiary: string
  プロセス・インスタンス受取人の表示名。
• instanceVariables: array instanceVariables
  クライアント固有のコンテキスト。
• justification: string
  リクエストの理由。
• message: string
  相関メッセージ名。
• requestor: string
  プロセス・インスタンス・リクエスタの表示名。
• timeCreated: string(date-time)
  プロセス・インスタンスの作成日。
• timers: array timers
  更新するタイマー。

{
    "type":"object",
    "properties":{
        "requestor":{
            "type":"string",
            "description":"Display name of the process instance requestor."
        },
        "beneficiary":{
            "type":"string",
            "description":"Display name of the process instance beneficiary."
        },
        "assignmentName":{
            "type":"string",
            "description":"Name of the assignment that is being requested."
        },
        "assignmentType":{
            "type":"string",
            "description":"Type of the assignment that is being requested."
        },
        "assignmentDescription":{
            "type":"string",
            "description":"Description of the assignment that is being requested."
        },
        "assignmentAttributes":{
            "type":"object",
            "description":"Map for additional key, value string pairs.",
            "additionalProperties":{
                "type":"object",
                "properties":{
                }
            }
        },
        "additionalAttributes":{
            "type":"object",
            "description":"Map for additional key, value string pairs.",
            "additionalProperties":{
                "type":"string"
            }
        },
        "assignmentTags":{
            "type":"array",
            "description":"Assignment tags.",
            "items":{
                "type":"string",
                "enum":[
                    "SOD_VIOLATIONS",
                    "EXPIRES_SOON",
                    "EXTENSION_REQUEST"
                ],
                "x-obmcs-top-level-enum":"#/definitions/InstanceTags"
            }
        },
        "justification":{
            "type":"string",
            "description":"Reason for the request."
        },
        "timeCreated":{
            "type":"string",
            "format":"date-time",
            "description":"The creation date of the process instance."
        },
        "instanceVariables":{
            "type":"array",
            "description":"Client specific context.",
            "items":{
                "$ref":"#/definitions/InstanceVariable"
            }
        },
        "message":{
            "type":"string",
            "description":"Correlation message name."
        },
        "timers":{
            "type":"array",
            "description":"Timers to update.",
            "items":{
                "$ref":"#/definitions/InstanceTimer"
            }
        }
    },
    "description":"Context data pertaining to the process instance."
}

ネストされたスキーマ : TaskAction

型: object

特定のタスクに対して実行できるアクション。

ソースを表示

• action(required): string
  許容値: [ "REQUEST_INFO", "PROVIDE_INFO", "APPROVE", "MODIFY", "REASSIGN", "ASSIGN", "REMOVE", "REJECT", "CANCEL", "EXTENSION_REQUEST", "EXPIRE", "ACCESS_REQUEST" ]

  処理タイプ。
• approvalTimeLimit: object ApprovalTimeLimit
  承認時間制限に関する詳細(該当する場合)。 daysLimit、hoursLimitまたはtimeRangeLimitのいずれか1つのみを定義する必要があります。
• approvalTimeLimitType: string
  許容値: [ "INDEFINITELY", "NUMBER_OF_HOURS", "NUMBER_OF_DAYS", "DATE_TIME_RANGE", "EXTENSION" ]

  承認時間制限タイプ。
• comment: string
  処理の事由。
• extensionTimeLimit: object ExtensionTimeLimit
  承認延長時間制限定義を終了時間として指定します。
• id: string
  タスク処理の一意識別子。
• parentId: string
  親処理の識別子(存在する場合)。
• timeCreated: string(date-time)
  タスクの作成日。
• user: string
  アクションを実行しているユーザー。

{
    "type":"object",
    "required":[
        "action"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"Unique identifier of the task action."
        },
        "parentId":{
            "type":"string",
            "description":"Identifier of the parent action, if one exists."
        },
        "action":{
            "type":"string",
            "description":"The action type.",
            "enum":[
                "REQUEST_INFO",
                "PROVIDE_INFO",
                "APPROVE",
                "MODIFY",
                "REASSIGN",
                "ASSIGN",
                "REMOVE",
                "REJECT",
                "CANCEL",
                "EXTENSION_REQUEST",
                "EXPIRE",
                "ACCESS_REQUEST"
            ],
            "x-obmcs-top-level-enum":"#/definitions/TaskActionType"
        },
        "user":{
            "type":"string",
            "description":"User who is performing the action."
        },
        "comment":{
            "type":"string",
            "description":"Reason for the action."
        },
        "timeCreated":{
            "type":"string",
            "format":"date-time",
            "description":"The creation date of the task."
        },
        "approvalTimeLimitType":{
            "type":"string",
            "description":"The approval time limit type.",
            "enum":[
                "INDEFINITELY",
                "NUMBER_OF_HOURS",
                "NUMBER_OF_DAYS",
                "DATE_TIME_RANGE",
                "EXTENSION"
            ],
            "x-obmcs-top-level-enum":"#/definitions/ApprovalTimeLimitType",
            "x-default-description":"INDEFINITELY"
        },
        "approvalTimeLimit":{
            "$ref":"#/definitions/ApprovalTimeLimit"
        },
        "extensionTimeLimit":{
            "$ref":"#/definitions/ExtensionTimeLimit"
        }
    },
    "description":"An action which can be performed for a given task."
}

ネストされたスキーマ: additionalAttributes

型: object

使用可能なその他のプロパティ

ソースを表示

• string

{
    "type":"object",
    "description":"Map for additional key, value string pairs.",
    "additionalProperties":{
        "type":"string"
    }
}

追加キーと値文字列のペアをマップします。

ネストされたスキーマ : assignmentAttributes

型: object

使用可能なその他のプロパティ

ソースを表示

• object additionalProperties

{
    "type":"object",
    "description":"Map for additional key, value string pairs.",
    "additionalProperties":{
        "type":"object",
        "properties":{
        }
    }
}

追加キーと値文字列のペアをマップします。

ネストされたスキーマ : assignmentTags

型: array

割当タグ。

ソースを表示

• Array of: string
  許容値: [ "SOD_VIOLATIONS", "EXPIRES_SOON", "EXTENSION_REQUEST" ]

{
    "type":"array",
    "description":"Assignment tags.",
    "items":{
        "type":"string",
        "enum":[
            "SOD_VIOLATIONS",
            "EXPIRES_SOON",
            "EXTENSION_REQUEST"
        ],
        "x-obmcs-top-level-enum":"#/definitions/InstanceTags"
    }
}

ネストされたスキーマ : instanceVariables

型: array

クライアント固有のコンテキスト。

ソースを表示

• Array of: object InstanceVariable
  プロセス・インスタンスの変数

{
    "type":"array",
    "description":"Client specific context.",
    "items":{
        "$ref":"#/definitions/InstanceVariable"
    }
}

ネストされたスキーマ : タイマー

型: array

更新するタイマー。

ソースを表示

• Array of: object InstanceTimer
  プロセス・インスタンスのタイマー

{
    "type":"array",
    "description":"Timers to update.",
    "items":{
        "$ref":"#/definitions/InstanceTimer"
    }
}

ネストされたスキーマ: additionalProperties

型: object

ソースを表示

{
    "type":"object",
    "properties":{
    }
}

ネストされたスキーマ : InstanceVariable

型: object

プロセス・インスタンスの変数

ソースを表示

• name: string
  変数名
• value: object value
  変数に割り当てられた値
• valuetype: string
  変数の値タイプ。 string、boolean、integer、long、doubleを使用できます

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"variable name"
        },
        "value":{
            "type":"object",
            "description":"value assigned to the variable",
            "properties":{
            }
        },
        "valuetype":{
            "type":"string",
            "description":"The value type of the variable. It can be string, boolean, integer, long , double"
        }
    },
    "description":"Variable of process instance"
}

ネストされたスキーマ: value

型: object

変数に割り当てられた値

ソースを表示

{
    "type":"object",
    "description":"value assigned to the variable",
    "properties":{
    }
}

ネストされたスキーマ : InstanceTimer

型: object

プロセス・インスタンスのタイマー

ソースを表示

• id: string
  タイマーID
• value: string
  タイマー値

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Timer id"
        },
        "value":{
            "type":"string",
            "description":"Timer value"
        }
    },
    "description":"Timers of process instance"
}

ネストされたスキーマ : ApprovalTimeLimit

型: object

承認時間制限に関する詳細(該当する場合)。 daysLimit、hoursLimitまたはtimeRangeLimitのいずれか1つのみを定義する必要があります。

ソースを表示

• daysLimit: integer
  最小値: 1

  最大値: 365

  承認時間制限の定義(日数)。
• hoursLimit: integer
  最小値: 1

  最大値: 24

  承認時間制限の定義(時間)。
• rangeLimit: object ApprovalTimeLimitRange
  時間範囲としての承認時間制限定義。

{
    "type":"object",
    "properties":{
        "daysLimit":{
            "type":"integer",
            "description":"Approval time limit definition in days.",
            "minimum":1,
            "maximum":365
        },
        "hoursLimit":{
            "type":"integer",
            "description":"Approval time limit definition in hours.",
            "minimum":1,
            "maximum":24
        },
        "rangeLimit":{
            "$ref":"#/definitions/ApprovalTimeLimitRange"
        }
    },
    "description":"Details about the approval time limit, when applicable. \nOnly one of daysLimit, hoursLimit, or timeRangeLimit should be defined.\n"
}

ネストされたスキーマ : ExtensionTimeLimit

型: object

承認延長時間制限定義を終了時間として指定します。

ソースを表示

• timeExpires(required): string(date-time)
  RFC3339形式の日時文字列としての拡張有効期限。

{
    "type":"object",
    "required":[
        "timeExpires"
    ],
    "properties":{
        "timeExpires":{
            "type":"string",
            "format":"date-time",
            "description":"The extended expiration time as an RFC3339 formatted datetime string."
        }
    },
    "description":"Approval extension time limit definition as an end time."
}

ネストされたスキーマ : ApprovalTimeLimitRange

型: object

時間範囲としての承認時間制限定義。

ソースを表示

• timeExpires(required): string(date-time)
  RFC3339形式の日時文字列としての有効期限。
• timeStarts(required): string(date-time)
  RFC3339形式の日時文字列としての開始時間。

{
    "type":"object",
    "required":[
        "timeExpires",
        "timeStarts"
    ],
    "properties":{
        "timeStarts":{
            "type":"string",
            "format":"date-time",
            "description":"The start time as an RFC3339 formatted datetime string."
        },
        "timeExpires":{
            "type":"string",
            "format":"date-time",
            "description":"The expiration time as an RFC3339 formatted datetime string."
        }
    },
    "description":"Approval time limit definition as a time range."
}

400レスポンス

不正なリクエスト

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

401レスポンス

未認可

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

404レスポンス

見つかりません

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

429レスポンス

リクエストが多すぎます

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

500レスポンス

内部サーバー・エラー

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

デフォルト・レスポンス

不明なエラー

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

トップに戻る

例

次の例は、承認タスクのリストを取得する方法を示しています。

ノート:

grant_type = passwordまたは認可コードを使用してアクセス・トークンを生成します。

cURLリクエストの例

curl -i -X GET \
   -H "Authorization:Bearer <your access token>" \
 '${service-instance-url}/access-governance/access-controls/${version}/approvals/me

レスポンス・コードの例

{
    "items": [
        {
            "id": "d7ca932f-xxxx-xxxx-a4f0-ce0355309ad8",
            "processId": "user",
            "instanceId": "ae3a3688-xxxx-4503-bdea-67ea8404114b:d7937d92-xxxx-xxxx-a4f0-ce0355309ad8",
            "requestId": "d2756914-xxxx-xxxx-bd2a-a31f131ce533",
            "assignee": "Betty Cook",
            "status": "PENDING_APPROVAL",
            "lastAction": null,
            "context": {
                "requestor": "Amel Maclead",
                "beneficiary": "Bill Clark",
                "assignmentName": "Database Basic Access Privilege",
                "assignmentType": "ACCESS_BUNDLE",
                "assignmentDescription": null,
                "assignmentAttributes": null,
                "assignmentTags": [],
                "timeOfExpiration": null,
                "justification": "Database Basic Privilege Approvals Request",
                "timeCreated": "2025-04-21T21:51:53.008Z",
                "instanceVariables": null,
                "message": null,
                "timers": null
            },
            "timeDue": "2025-04-28T21:51:55.953Z",
            "timeCreated": "2025-04-21T21:51:55.952Z",
            "timeCompleted": null
        }
    ]
}

先頭に戻る