機械翻訳について
  1. Oracle Fusionサービスでのナレッジ管理のREST API
  2. タスク
  3. コンテンツ(IM)
  4. ユーザー・キー値

ユーザー・キー値の更新

put

/km/api/v1/users/{userId}/userKeyValues/{id}

このメソッドは、指定されたユーザー・キー値IDを持つUserKeyValueオブジェクトを更新します。

URIの例

このメソッドのURIの例は、次のとおりです:

  • http://<IM_REST_API_HOST>/km/api/latest/users/{userId}/userKeyValues/{id}

    このリクエストは、指定されたユーザー・キー値IDを持つUserKeyValueオブジェクトを更新します。

レスポンス・エラー

このメソッドの考えられるエラー・レスポンスは次のとおりです:

  • OK-GEN0024

    このエラーは、サービス・リクエストに指定されたUserKeyValueのレコードIDがuserKeyValue.recordIdパラメータ値と一致しない場合に発生します。

  • OK-GEN0005

    次のいずれかの場合にエラーが発生します:

    • 指定されたIDのユーザー・レコードが存在しません。
    • userKeyValue.key、ユーザー情報またはuserinformation.reocrdIdのパラメータ値はnullです。

  • OK-GEN0012

    このエラーは、userKeyValue.keyパラメータ値が以前に格納された値と異なる場合に発生します。

  • OKDOM-USERKV0002

    このエラーは、指定したユーザー・レコードIDがuserinformation.recordIdパラメータ値と一致しない場合に発生します。

リクエスト

サポートされるメディア・タイプ
パス・パラメータ
  • 更新するオブジェクトの一意の識別子。
本文( )
更新するオブジェクト。
ルート・スキーマ : UserKeyValue
タイプ: object
タイトル: UserKeyValue
ソースを表示
ネストされたスキーマ : UserKey
タイプ: object
タイトル: UserKey
ソースを表示
  • ユーザー・オブジェクトの電子メール
  • ExternalIdは、外部システムからの対応するユーザーのIDです。 ExternalTypeとともに、このシステムからのユーザーと外部システムのユーザーとの間のギャップを埋めるために使用できます。
  • ExternalTypeは、外部システムからの対応するユーザーのタイプです。 ExternalIdとともに使用すると、このシステムからのユーザーと外部システムのユーザーとの間のギャップを埋めることができます。
  • links
  • ユーザーのフルネーム
  • ユーザー・オブジェクトの一意のレコードID。
トップに戻る

レスポンス

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

200 レスポンス

「OK」をクリックします。
本文( )
ルート・スキーマ : UserKeyValue
タイプ: object
タイトル: UserKeyValue
ソースを表示
ネストされたスキーマ : UserKey
タイプ: object
タイトル: UserKey
ソースを表示
  • ユーザー・オブジェクトの電子メール
  • ExternalIdは、外部システムからの対応するユーザーのIDです。 ExternalTypeとともに、このシステムからのユーザーと外部システムのユーザーとの間のギャップを埋めるために使用できます。
  • ExternalTypeは、外部システムからの対応するユーザーのタイプです。 ExternalIdとともに使用すると、このシステムからのユーザーと外部システムのユーザーとの間のギャップを埋めることができます。
  • links
  • ユーザーのフルネーム
  • ユーザー・オブジェクトの一意のレコードID。
トップに戻る

例

次の例は、cURLを使用してRESTリソースに対するポスト・リクエストを発行することによって、指定したユーザーIDのユーザー・キー値オブジェクトを更新する方法を示しています。

curl -X POST "https://<IM_REST_API_HOST>/km/api/latest/users/{userId}/userKeyValues/{id}" -u "<username:password>" -H "Accept: application/json" -H "Content-Type: application/json" -d "@<FilePath/RequestBody.json>"

リクエスト本文の例

次の例は、JSON形式のリクエスト本文のコンテンツを示しています:

{
  "recordId" : "75F56044C4D94DC181CDA898D0F0B3E2",
  "userInformation" : {
    "recordId" : "62AE91CBB23A49668BC7B9A220B696C7",
    "name" : "User Name",
    "externalId" : 12345,
    "externalType" : "CONTACT",
    "links" : [ {
      "rel" : "canonical",
      "href" : "http://IM_REST_API_HOST/km/api/{version}/{resourceURI}",
      "mediaType" : "application/json, application/xml",
      "templated" : true,
      "method" : "GET",
      "profile" : "http://IM_REST_API_HOST/km/api/{version}/metadata-catalog/{resourceName}"
    } ]
  },
  "links" : [ {
    "rel" : "canonical",
    "href" : "http://IM_REST_API_HOST/km/api/{version}/{resourceURI}",
    "mediaType" : "application/json, application/xml",
    "templated" : true,
    "method" : "GET",
    "profile" : "http://IM_REST_API_HOST/km/api/{version}/metadata-catalog/{resourceName}"
  } ],
  "dateAdded" : "2013-04-23T20:06:43-0500",
  "dateModified" : "2017-03-28T14:48:21-0500",
  "key" : "FAVORITES2",
  "value" : "FAQ1,FAQ23,FAQ44"
}

レスポンス本文の例

次の例は、JSON形式のレスポンス本文のコンテンツを示しています:

{
  "userInformation": {
    "recordId": "62AE91CBB23A49668BC7B9A220B696C7",
    "name": "User Name",
    "externalType": "ACCOUNT",
    "links": [
      {
        "rel": "canonical",
        "href": "http://IM_REST_API_HOST/km/api/latest/users/62AE91CBB23A49668BC7B9A220B696C7",
        "mediaType": "application/json, application/xml",
        "method": "GET"
      }
    ]
  },
  "recordId": "75F56044C4D94DC181CDA898D0F0B3E2",
  "links": [
    {
      "rel": "canonical",
      "href": "http://IM_REST_API_HOST/km/api/latest/users/62AE91CBB23A49668BC7B9A220B696C7/userKeyValues/75F56044C4D94DC181CDA898D0F0B3E2",
      "mediaType": "application/json, application/xml",
      "method": "GET"
    },
    {
      "rel": "collection",
      "href": "http://IM_REST_API_HOST/km/api/latest/users/62AE91CBB23A49668BC7B9A220B696C7/userKeyValues",
      "mediaType": "application/json, application/xml",
      "method": "GET"
    }
  ],
  "dateAdded": "2017-03-28T14:48:21-0500",
  "dateModified": "2017-03-28T14:48:21-0500",
  "key": "FAVORITES2",
  "value": "FAQ1,FAQ23,FAQ44"
}
「トップに戻る」