機械翻訳について

ジャンプ先

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

データ・フォームの取得

get

/km/api/v1/dataForms/{id}

このメソッドは、指定されたIDパラメータを持つDataFormオブジェクトを返します。

URIの例

このメソッドのURIの例を次に示します:

• http://<IM_REST_API_HOST>/km/api/latest/dataForms/{id}

  リクエストは、指定したIDパラメータをFULLモードで持つDataFormオブジェクトを返します。

• http://<IM_REST_API_HOST>/km/api/dataForms/{id}?mode=KEY

  このリクエストは、KEYモードで指定したIDパラメータを持つDataFormオブジェクトを返します。

レスポンス・エラー

• OKDOM-GEN0001

  このエラーは、無効なIDが指定されている場合に発生します。

リクエスト

パス・パラメータ

• id: string
  取得するオブジェクトの一意の識別子。

トップに戻る

レスポンス

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

• application/json
• application/xml

200 レスポンス

「OK」をクリックします。

本文( )

ルート・スキーマ : DataForm

タイプ: object

タイトル: DataForm

ソースを表示

• dateAdded(optional): string(date-time)
  DataFormオブジェクトが作成または追加された日付
• dateModified(optional): string(date-time)
  DataFormオブジェクトが最後に変更された日付。
• displayEndDate(optional): string(date-time)
  DataFormオブジェクトのDisplayEndDate
• displayStartDate(optional): string(date-time)
  DataFormオブジェクトのDisplayStartDate
• emailContent(optional): boolean
  DataFormオブジェクトのEmailContent
• links(optional): array links
• name(optional): string
  データ・フォームの名前。 名前フィールドはソートにのみ使用できます。
• questions(optional): array questions
  質問と多数の関係
• ratingType(optional): integer
  5つ星評価かY/Nタイプの評価かを決定

  • CUSTOM(0)
  • YES(1)
  • YES_NO(2)
  • THREE_STARS(3)
  • FIVE_STARS(4)
• recordId(optional): string
  DataFormオブジェクトの一意のレコードID。
• referenceKey(optional): string
  DataFormオブジェクトの参照キー。 DataFormオブジェクトは、複数の言語をサポートしています。 このフィールドを使用して、すべての言語の関連オブジェクトを識別できます。
• user(optional): object UserKey
  タイトル: UserKey
• views(optional): array views
  表示する関係が多すぎます

{
    "title":"DataForm",
    "properties":{
        "recordId":{
            "description":"The unique record ID of the DataForm object.",
            "type":"string"
        },
        "dateModified":{
            "description":"The date when the DataForm object was last modified.",
            "format":"date-time",
            "type":"string"
        },
        "displayStartDate":{
            "description":"DisplayStartDate of the DataForm object",
            "format":"date-time",
            "type":"string"
        },
        "referenceKey":{
            "description":"The reference key for the DataForm object. DataForm objects support multiple languages. This field can be used to identify the associated objects for all languages.",
            "type":"string"
        },
        "emailContent":{
            "description":"EmailContent of the DataForm object",
            "type":"boolean"
        },
        "views":{
            "items":{
                "$ref":"#/definitions/ViewKey"
            },
            "description":"To Many Relationship to View",
            "type":"array"
        },
        "name":{
            "description":"The name of the data form.  The name field can only be used for sorting.",
            "type":"string"
        },
        "displayEndDate":{
            "description":"DisplayEndDate of the DataForm object",
            "format":"date-time",
            "type":"string"
        },
        "dateAdded":{
            "description":"The date when the DataForm object was created or added",
            "format":"date-time",
            "type":"string"
        },
        "ratingType":{
            "description":"Determined whether it is a 5 star or Y/N type of rating <ul> <li>CUSTOM(0)</li> <li>YES(1)</li> <li>YES_NO(2)</li> <li>THREE_STARS(3)</li> <li>FIVE_STARS(4)</li> </ul>",
            "type":"integer"
        },
        "questions":{
            "items":{
                "$ref":"#/definitions/DataFormQuestion"
            },
            "description":"To Many Relationship to Question",
            "type":"array"
        },
        "links":{
            "items":{
                "$ref":"#/definitions/instanceLink"
            },
            "type":"array"
        },
        "user":{
            "description":"Relationship to User",
            "$ref":"#/definitions/UserKey"
        }
    }
}

ネストされたスキーマ : リンク

タイプ: array

ソースを表示

• Array of: object instanceLink
  JSONインスタンス表現に表示される可能性があるリンク記述オブジェクトを記述するMetadata。

{
    "items":{
        "$ref":"#/definitions/instanceLink"
    },
    "type":"array"
}

ネストされたスキーマ : 質問

タイプ: array

質問と多数の関係

ソースを表示

• Array of: object DataFormQuestion
  タイトル: DataFormQuestion

{
    "items":{
        "$ref":"#/definitions/DataFormQuestion"
    },
    "description":"To Many Relationship to Question",
    "type":"array"
}

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

タイプ: object

タイトル: UserKey

ソースを表示

• email(optional): string
  ユーザー・オブジェクトの電子メール
• externalId(optional): integer
  ExternalIdは、外部システムからの対応するユーザーのIDです。 ExternalTypeとともに、このシステムからのユーザーと外部システムのユーザーとの間のギャップを埋めるために使用できます。
• externalType(optional): string
  ExternalTypeは、外部システムからの対応するユーザーのタイプです。 ExternalIdとともに使用すると、このシステムからのユーザーと外部システムのユーザーとの間のギャップを埋めることができます。
• links(optional): array links
• name(optional): string
  ユーザーのフルネーム
• recordId(optional): string
  ユーザー・オブジェクトの一意のレコードID。

{
    "title":"UserKey",
    "properties":{
        "recordId":{
            "description":"The unique record ID of the User object.",
            "type":"string"
        },
        "externalType":{
            "description":"The ExternalType is the type of the corresponding User from an external system.  It, along with ExternalId, can be used to bridge the gap between a User from this system and a User from an external system.",
            "type":"string"
        },
        "email":{
            "description":"Email of the User object",
            "type":"string"
        },
        "name":{
            "description":"User's full name",
            "type":"string"
        },
        "links":{
            "items":{
                "$ref":"#/definitions/instanceLink"
            },
            "type":"array"
        },
        "externalId":{
            "description":"The ExternalId is the Id of the corresponding User from an external system.  It, along with ExternalType, can be used to bridge the gap between a User from this system and a User from an external system.",
            "type":"integer"
        }
    }
}

ネストされたスキーマ : ビュー

タイプ: array

表示する関係が多すぎます

ソースを表示

• Array of: object ViewKey
  タイトル: ViewKey

{
    "items":{
        "$ref":"#/definitions/ViewKey"
    },
    "description":"To Many Relationship to View",
    "type":"array"
}

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

タイプ: object

JSONインスタンス表現に表示される可能性があるリンク記述オブジェクトを記述するMetadata。

ソースを表示

• href: string
  URI [RFC3986]またはURIテンプレート[RFC6570]。 値がURI Templateに設定されている場合、「templated」プロパティをtrueに設定する必要があります。
• mediaType(optional): string
  RFC 2046で定義された、リンク・ターゲットを説明するメディア・タイプ。
• method(optional): string
  リンクのターゲットをリクエストするためのHTTPメソッド。
• profile(optional): string
  ターゲット・リソースの参照解除時に予期されるリソースを記述する、JSONスキーマなどのリソースのメタデータへのリンク。
• rel: string
  リンクの詳細を取得するためにタイプ・プロパティに加えて使用できるリンク関係の名前。 たとえば、hrefやprofileです。
• templated(optional): boolean
  hrefプロパティがURIまたはURIテンプレートであることを指定するブール・フラグ。 プロパティがURIテンプレートの場合は、この値をtrueに設定します。 デフォルトでは、この値はfalseです。

{
    "description":"Metadata describing link description objects that MAY appear in the JSON instance representation.",
    "properties":{
        "templated":{
            "description":"Boolean flag that specifies that \"href\" property is a URI or URI Template. If the property is a URI template, set this value to true. By default, this value is false.",
            "type":"boolean"
        },
        "method":{
            "description":"HTTP method for requesting the target of the link.",
            "type":"string"
        },
        "rel":{
            "description":"Name of the link relation that, in addition to the type property, can be used to retrieve link details. For example, href or profile.",
            "type":"string"
        },
        "href":{
            "description":"URI [RFC3986] or URI Template [RFC6570]. If the value is set to URI Template, then the \"templated\" property must be set to true.",
            "type":"string"
        },
        "mediaType":{
            "description":"Media type, as defined by RFC 2046, describing the link target.",
            "type":"string"
        },
        "profile":{
            "description":"Link to the metadata of the resource, such as JSON-schema, that describes the resource expected when dereferencing the target resource..",
            "type":"string"
        }
    },
    "required":[
        "href",
        "rel"
    ],
    "type":"object"
}

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

タイプ: object

タイトル: DataFormQuestion

ソースを表示

• answers(optional): array answers
  回答との関連性が多すぎます
• dataForm(optional): object DataFormKey
  タイトル: DataFormKey
• dateAdded(optional): string(date-time)
  DataFormQuestionオブジェクトが作成または追加された日付
• dateModified(optional): string(date-time)
  DataFormQuestionオブジェクトが最後に変更された日付。
• isMasterIdentifier(optional): boolean
  DataFormQuestionオブジェクトのIsMasterIdentifier
• links(optional): array links
• name(optional): string
  DataFormQuestionオブジェクトの名前
• recordId(optional): string
  DataFormQuestionオブジェクトの一意のレコードID。
• referenceKey(optional): string
  DataFormQuestionオブジェクトの参照キー。 DataFormQuestionオブジェクトは、複数の言語をサポートしています。 このフィールドを使用して、すべての言語の関連オブジェクトを識別できます。
• required(optional): boolean
  DataFormQuestionオブジェクトの必須
• sortOrder(optional): integer
  DataFormQuestionオブジェクトのSortOrder
• specialTypeIndicator(optional): integer
  DataFormQuestionオブジェクトのSpecialTypeIndicator

{
    "title":"DataFormQuestion",
    "properties":{
        "recordId":{
            "description":"The unique record ID of the DataFormQuestion object.",
            "type":"string"
        },
        "dateModified":{
            "description":"The date when the DataFormQuestion object was last modified.",
            "format":"date-time",
            "type":"string"
        },
        "isMasterIdentifier":{
            "description":"IsMasterIdentifier of the DataFormQuestion object",
            "type":"boolean"
        },
        "specialTypeIndicator":{
            "description":"SpecialTypeIndicator of the DataFormQuestion object",
            "type":"integer"
        },
        "referenceKey":{
            "description":"The reference key for the DataFormQuestion object. DataFormQuestion objects support multiple languages. This field can be used to identify the associated objects for all languages.",
            "type":"string"
        },
        "sortOrder":{
            "description":"SortOrder of the DataFormQuestion object",
            "type":"integer"
        },
        "name":{
            "description":"Name of the DataFormQuestion object",
            "type":"string"
        },
        "answers":{
            "items":{
                "$ref":"#/definitions/DataFormAnswer"
            },
            "description":"To Many Relationship to Answer",
            "type":"array"
        },
        "dataForm":{
            "description":"Relationship to Rating",
            "$ref":"#/definitions/DataFormKey"
        },
        "dateAdded":{
            "description":"The date when the DataFormQuestion object was created or added",
            "format":"date-time",
            "type":"string"
        },
        "links":{
            "items":{
                "$ref":"#/definitions/instanceLink"
            },
            "type":"array"
        },
        "required":{
            "description":"Required of the DataFormQuestion object",
            "type":"boolean"
        }
    }
}

ネストされたスキーマ : 答え

タイプ: array

回答との関連性が多すぎます

ソースを表示

• Array of: object DataFormAnswer
  タイトル: DataFormAnswer

{
    "items":{
        "$ref":"#/definitions/DataFormAnswer"
    },
    "description":"To Many Relationship to Answer",
    "type":"array"
}

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

タイプ: object

タイトル: DataFormKey

ソースを表示

• links(optional): array links
• recordId(optional): string
  DataFormオブジェクトの一意のレコードID。
• referenceKey(optional): string
  DataFormオブジェクトの参照キー。 DataFormオブジェクトは、複数の言語をサポートしています。 このフィールドを使用して、すべての言語の関連オブジェクトを識別できます。

{
    "title":"DataFormKey",
    "properties":{
        "recordId":{
            "description":"The unique record ID of the DataForm object.",
            "type":"string"
        },
        "referenceKey":{
            "description":"The reference key for the DataForm object. DataForm objects support multiple languages. This field can be used to identify the associated objects for all languages.",
            "type":"string"
        },
        "links":{
            "items":{
                "$ref":"#/definitions/instanceLink"
            },
            "type":"array"
        }
    }
}

ネストされたスキーマ : リンク

タイプ: array

ソースを表示

• Array of: object instanceLink
  JSONインスタンス表現に表示される可能性があるリンク記述オブジェクトを記述するMetadata。

{
    "items":{
        "$ref":"#/definitions/instanceLink"
    },
    "type":"array"
}

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

タイプ: object

タイトル: DataFormAnswer

ソースを表示

• dataFormQuestion(optional): object DataFormQuestionKey
  タイトル: DataFormQuestionKey
• dateAdded(optional): string(date-time)
  DataFormAnswerオブジェクトが作成または追加された日付
• dateModified(optional): string(date-time)
  DataFormAnswerオブジェクトが最後に変更された日付。
• defaultAnswer(optional): boolean
  DataFormAnswerオブジェクトのDefaultAnswer
• links(optional): array links
• name(optional): string
  DataFormAnswerオブジェクトの名前
• numberValue(optional): integer
  DataFormAnswerオブジェクトのNumberValue
• recordId(optional): string
  DataFormAnswerオブジェクトの一意のレコードID。
• referenceKey(optional): string
  DataFormAnswerオブジェクトの参照キー。 DataFormAnswerオブジェクトは、複数の言語をサポートしています。 このフィールドを使用して、すべての言語の関連オブジェクトを識別できます。
• sortOrder(optional): integer
  DataFormAnswerオブジェクトのSortOrder

{
    "title":"DataFormAnswer",
    "properties":{
        "recordId":{
            "description":"The unique record ID of the DataFormAnswer object.",
            "type":"string"
        },
        "dateModified":{
            "description":"The date when the DataFormAnswer object was last modified.",
            "format":"date-time",
            "type":"string"
        },
        "referenceKey":{
            "description":"The reference key for the DataFormAnswer object. DataFormAnswer objects support multiple languages. This field can be used to identify the associated objects for all languages.",
            "type":"string"
        },
        "sortOrder":{
            "description":"SortOrder of the DataFormAnswer object",
            "type":"integer"
        },
        "numberValue":{
            "description":"NumberValue of the DataFormAnswer object",
            "type":"integer"
        },
        "name":{
            "description":"Name of the DataFormAnswer object",
            "type":"string"
        },
        "dateAdded":{
            "description":"The date when the DataFormAnswer object was created or added",
            "format":"date-time",
            "type":"string"
        },
        "links":{
            "items":{
                "$ref":"#/definitions/instanceLink"
            },
            "type":"array"
        },
        "defaultAnswer":{
            "description":"DefaultAnswer of the DataFormAnswer object",
            "type":"boolean"
        },
        "dataFormQuestion":{
            "description":"Relationship to Question",
            "$ref":"#/definitions/DataFormQuestionKey"
        }
    }
}

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

タイプ: object

タイトル: DataFormQuestionKey

ソースを表示

• links(optional): array links
• recordId(optional): string
  DataFormQuestionオブジェクトの一意のレコードID。
• referenceKey(optional): string
  DataFormQuestionオブジェクトの参照キー。 DataFormQuestionオブジェクトは、複数の言語をサポートしています。 このフィールドを使用して、すべての言語の関連オブジェクトを識別できます。

{
    "title":"DataFormQuestionKey",
    "properties":{
        "recordId":{
            "description":"The unique record ID of the DataFormQuestion object.",
            "type":"string"
        },
        "referenceKey":{
            "description":"The reference key for the DataFormQuestion object. DataFormQuestion objects support multiple languages. This field can be used to identify the associated objects for all languages.",
            "type":"string"
        },
        "links":{
            "items":{
                "$ref":"#/definitions/instanceLink"
            },
            "type":"array"
        }
    }
}

ネストされたスキーマ : リンク

タイプ: array

ソースを表示

• Array of: object instanceLink
  JSONインスタンス表現に表示される可能性があるリンク記述オブジェクトを記述するMetadata。

{
    "items":{
        "$ref":"#/definitions/instanceLink"
    },
    "type":"array"
}

ネストされたスキーマ : リンク

タイプ: array

ソースを表示

• Array of: object instanceLink
  JSONインスタンス表現に表示される可能性があるリンク記述オブジェクトを記述するMetadata。

{
    "items":{
        "$ref":"#/definitions/instanceLink"
    },
    "type":"array"
}

ネストされたスキーマ : リンク

タイプ: array

ソースを表示

• Array of: object instanceLink
  JSONインスタンス表現に表示される可能性があるリンク記述オブジェクトを記述するMetadata。

{
    "items":{
        "$ref":"#/definitions/instanceLink"
    },
    "type":"array"
}

ネストされたスキーマ : リンク

タイプ: array

ソースを表示

• Array of: object instanceLink
  JSONインスタンス表現に表示される可能性があるリンク記述オブジェクトを記述するMetadata。

{
    "items":{
        "$ref":"#/definitions/instanceLink"
    },
    "type":"array"
}

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

タイプ: object

タイトル: ViewKey

ソースを表示

• links(optional): array links
• name(optional): string
  ビューのローカライズ名
• recordId(optional): string
  ビュー定義を含むSITE表のGUID
• referenceKey(optional): string
  ビューのローカライズされていない参照キー
• stripeCD(optional): string

  ビューのストライプ

{
    "title":"ViewKey",
    "properties":{
        "recordId":{
            "description":"GUID of the SITE table containing the view definition",
            "type":"string"
        },
        "referenceKey":{
            "description":"Non localized reference key for the view",
            "type":"string"
        },
        "name":{
            "description":"Localized name of the view",
            "type":"string"
        },
        "links":{
            "items":{
                "$ref":"#/definitions/instanceLink"
            },
            "type":"array"
        },
        "stripeCD":{
            "description":"<p>Stripe of a view</p>",
            "type":"string"
        }
    }
}

ネストされたスキーマ : リンク

タイプ: array

ソースを表示

• Array of: object instanceLink
  JSONインスタンス表現に表示される可能性があるリンク記述オブジェクトを記述するMetadata。

{
    "items":{
        "$ref":"#/definitions/instanceLink"
    },
    "type":"array"
}

トップに戻る

例

次の例は、指定されたIDパラメータを持つDataFormオブジェクトを検索する方法を示しています:

curl -X "GET" "http://IM_REST_API_HOST/km/api/latest/dataForms/{id}"

リクエスト・ヘッダーの例

次に、リクエスト・ヘッダーの例を示します。

curl -X GET "https://<IM_REST_API_HOST>/km/api/latest/dataForms/{id}" -u "<username:password>" -H "Accept: application/json" -H "Content-Type: application/json"

レスポンス本文の例

次に、JSON形式のレスポンス本文の例を示します。

{
    "recordId": "45C98B085B044881821DE07F68DC14CF",
    "referenceKey": "YES_OR_NO_RATING",
    "links": [
        {
            "rel": "canonical",
            "href": "https://<IM_REST_API_HOST>/km/api/latest/dataForms/45C98B085B044881821DE07F68DC14CF",
            "mediaType": "application/json, application/xml",
            "method": "GET"
        },
        {
            "rel": "collection",
            "href": "https://<IM_REST_API_HOST>/km/api/latest/dataForms",
            "mediaType": "application/json, application/xml",
            "method": "GET",
            "profile": "https://<IM_REST_API_HOST>/km/api/latest/metadata-catalog/dataForms"
        }
    ],
    "dateAdded": "1970-01-01T23:11:11+0000",
    "dateModified": "1970-01-01T23:11:11+0000",
    "emailContent": false,
    "name": "Like/Dislike Rating",
    "displayEndDate": "4712-12-31T00:00:00+0000",
    "displayStartDate": "2000-01-01T00:00:00+0000",
    "ratingType": 2,
    "questions": [
        {
            "recordId": "94AEF5ABE53A4E609EFD0A208E9007C3",
            "referenceKey": "YES_OR_NO_RATING_Q1",
            "links": [
                {
                    "rel": "canonical",
                    "href": "https://<IM_REST_API_HOST>/km/api/latest/dataForms/45C98B085B044881821DE07F68DC14CF/questions/94AEF5ABE53A4E609EFD0A208E9007C3",
                    "mediaType": "application/json, application/xml",
                    "method": "GET"
                }
            ],
            "dateAdded": "1970-01-01T23:11:11+0000",
            "dateModified": "1970-01-01T23:11:11+0000",
            "isMasterIdentifier": true,
            "required": true,
            "sortOrder": 1,
            "specialTypeIndicator": -1,
            "name": "Does this document help you?",
            "answers": [
                {
                    "recordId": "874CF739B99F4D358050B6C5CCC819F6",
                    "referenceKey": "YES_OR_NO_RATING_A1",
                    "links": [
                        {
                            "rel": "canonical",
                            "href": "https://<IM_REST_API_HOST>/km/api/latest/dataForms/45C98B085B044881821DE07F68DC14CF/questions/94AEF5ABE53A4E609EFD0A208E9007C3/answers/874CF739B99F4D358050B6C5CCC819F6",
                            "mediaType": "application/json, application/xml",
                            "method": "GET"
                        }
                    ],
                    "dateAdded": "1970-01-01T23:11:11+0000",
                    "dateModified": "1970-01-01T23:11:11+0000",
                    "defaultAnswer": false,
                    "numberValue": 1,
                    "sortOrder": 1,
                    "name": "Dislike",
                    "dataFormQuestion": {
                        "recordId": "94AEF5ABE53A4E609EFD0A208E9007C3",
                        "referenceKey": "YES_OR_NO_RATING_Q1",
                        "links": [
                            {
                                "rel": "canonical",
                                "href": "https://<IM_REST_API_HOST>/km/api/latest/dataForms/45C98B085B044881821DE07F68DC14CF/questions/94AEF5ABE53A4E609EFD0A208E9007C3",
                                "mediaType": "application/json, application/xml",
                                "method": "GET"
                            }
                        ]
                    }
                },
                {
                    "recordId": "B73836830DC0401FA931120E4634408A",
                    "referenceKey": "YES_OR_NO_RATING_A2",
                    "links": [
                        {
                            "rel": "canonical",
                            "href": "https://<IM_REST_API_HOST>/km/api/latest/dataForms/45C98B085B044881821DE07F68DC14CF/questions/94AEF5ABE53A4E609EFD0A208E9007C3/answers/B73836830DC0401FA931120E4634408A",
                            "mediaType": "application/json, application/xml",
                            "method": "GET"
                        }
                    ],
                    "dateAdded": "1970-01-01T23:11:11+0000",
                    "dateModified": "1970-01-01T23:11:11+0000",
                    "defaultAnswer": false,
                    "numberValue": 2,
                    "sortOrder": 2,
                    "name": "Like",
                    "dataFormQuestion": {
                        "recordId": "94AEF5ABE53A4E609EFD0A208E9007C3",
                        "referenceKey": "YES_OR_NO_RATING_Q1",
                        "links": [
                            {
                                "rel": "canonical",
                                "href": "https://<IM_REST_API_HOST>/km/api/latest/dataForms/45C98B085B044881821DE07F68DC14CF/questions/94AEF5ABE53A4E609EFD0A208E9007C3",
                                "mediaType": "application/json, application/xml",
                                "method": "GET"
                            }
                        ]
                    }
                }
            ],
            "dataForm": {
                "recordId": "45C98B085B044881821DE07F68DC14CF",
                "referenceKey": "YES_OR_NO_RATING",
                "links": [
                    {
                        "rel": "canonical",
                        "href": "https://<IM_REST_API_HOST>/km/api/latest/dataForms/45C98B085B044881821DE07F68DC14CF",
                        "mediaType": "application/json, application/xml",
                        "method": "GET"
                    }
                ]
            }
        }
    ],
    "user": {
        "recordId": -999998,
        "name": "BatchJob User",
        "externalType": "ACCOUNT",
        "links": [
            {
                "rel": "canonical",
                "href": "https://<IM_REST_API_HOST>/km/api/latest/users/-999998",
                "mediaType": "application/json, application/xml",
                "method": "GET"
            }
        ]
    },
    "views": []
}

「トップに戻る」