Jump to

• Request
• Response

Get a book

get

/epm/rest/v1/books/{id}

Request

Path Parameters

• id(required): string
  The Book UUID being requested.

Query Parameters

• fields(required): array
  A comma separated list of fields to return for each Book. If no fields are specified, the default fields (bookId, name, description, createdBy, creationDate, modifiedDate, pathName) will be included.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Request successful

Body ()

Root Schema : Book

Type: object

Management Reporting Book

Show Source

• bookId: string
  Read Only: true
• createdBy: string
  Read Only: true
• creationDate: string (date-time)
  Read Only: true
• datasourceNames: array datasourceNames
  Read Only: true

  The list of datasources referenced by this Book instance.
• description: string
  Read Only: true
• globalPov: object ItemCollectionPOVDimension
• lastAccessed: string (date-time)
  Read Only: true
• links: array links
  Read Only: true
• modifiedDate: string (date-time)
  Read Only: true
• name: string
  Read Only: true
• output: array output
  Read Only: true

  A link to generate Book output in pdf or xlsx.
• pathName: string
  Read Only: true
• primaryDatasource: string
  Read Only: true
• systemPath: string
  Read Only: true
• validationMessages: array validationMessages
  Read Only: true

  The errors found when trying to validate the Book.

{
    "type":"object",
    "properties":{
        "bookId":{
            "type":"string",
            "readOnly":true
        },
        "name":{
            "type":"string",
            "readOnly":true
        },
        "description":{
            "type":"string",
            "readOnly":true
        },
        "createdBy":{
            "type":"string",
            "readOnly":true
        },
        "creationDate":{
            "type":"string",
            "format":"date-time",
            "readOnly":true
        },
        "modifiedDate":{
            "type":"string",
            "format":"date-time",
            "readOnly":true
        },
        "lastAccessed":{
            "type":"string",
            "format":"date-time",
            "readOnly":true
        },
        "pathName":{
            "type":"string",
            "readOnly":true
        },
        "systemPath":{
            "type":"string",
            "readOnly":true
        },
        "output":{
            "type":"array",
            "description":"A link to generate Book output in pdf or xlsx.",
            "readOnly":true,
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        },
        "primaryDatasource":{
            "type":"string",
            "readOnly":true
        },
        "validationMessages":{
            "type":"array",
            "description":"The errors found when trying to validate the Book.",
            "readOnly":true,
            "items":{
                "type":"string"
            }
        },
        "datasourceNames":{
            "type":"array",
            "description":"The list of datasources referenced by this Book instance.",
            "readOnly":true,
            "items":{
                "type":"string"
            }
        },
        "globalPov":{
            "$ref":"#/components/schemas/ItemCollectionPOVDimension"
        },
        "links":{
            "type":"array",
            "readOnly":true,
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        }
    },
    "description":"Management Reporting Book"
}

Nested Schema : datasourceNames

Type: array

Read Only: true

The list of datasources referenced by this Book instance.

Show Source

• Array of: string

{
    "type":"array",
    "description":"The list of datasources referenced by this Book instance.",
    "readOnly":true,
    "items":{
        "type":"string"
    }
}

Nested Schema : ItemCollectionPOVDimension

Type: object

Show Source

• count: integer (int32)
  Read Only: true
• hasMore: boolean
  Read Only: true
• items: array items
  Read Only: true
• limit: integer (int32)
• links: array links
  Read Only: true
• offset: integer (int32)
  Read Only: true
• totalResults: integer (int32)

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "readOnly":true,
            "items":{
                "$ref":"#/components/schemas/POVDimension"
            }
        },
        "offset":{
            "type":"integer",
            "format":"int32",
            "readOnly":true
        },
        "limit":{
            "type":"integer",
            "format":"int32"
        },
        "count":{
            "type":"integer",
            "format":"int32",
            "readOnly":true
        },
        "hasMore":{
            "type":"boolean",
            "readOnly":true
        },
        "totalResults":{
            "type":"integer",
            "format":"int32"
        },
        "links":{
            "type":"array",
            "readOnly":true,
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        }
    }
}

Nested Schema : links

Type: array

Read Only: true

Show Source

• Array of: object Link

{
    "type":"array",
    "readOnly":true,
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : output

Type: array

Read Only: true

A link to generate Book output in pdf or xlsx.

Show Source

• Array of: object Link

{
    "type":"array",
    "description":"A link to generate Book output in pdf or xlsx.",
    "readOnly":true,
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : validationMessages

Type: array

Read Only: true

The errors found when trying to validate the Book.

Show Source

• Array of: string

{
    "type":"array",
    "description":"The errors found when trying to validate the Book.",
    "readOnly":true,
    "items":{
        "type":"string"
    }
}

Nested Schema : items

Type: array

Read Only: true

Show Source

• Array of: object POVDimension
  A Dimension that has a set of members to select from for Report execution.

{
    "type":"array",
    "readOnly":true,
    "items":{
        "$ref":"#/components/schemas/POVDimension"
    }
}

Nested Schema : links

Type: array

Read Only: true

Show Source

• Array of: object Link

{
    "type":"array",
    "readOnly":true,
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : POVDimension

Type: object

A Dimension that has a set of members to select from for Report execution.

Show Source

• dimensionId: string
  Read Only: true
• fixedSelection: boolean
  Read Only: true
• hidden: boolean
  Read Only: true
• links: array links
  Read Only: true
• name: string
  Read Only: true
• suggestedMembers: array suggestedMembers
  Read Only: true

  The dimension's members suggested for use when executing the Report.

{
    "type":"object",
    "properties":{
        "dimensionId":{
            "type":"string",
            "readOnly":true
        },
        "name":{
            "type":"string",
            "readOnly":true
        },
        "suggestedMembers":{
            "type":"array",
            "description":"The dimension's members suggested for use when executing the Report.",
            "readOnly":true,
            "items":{
                "$ref":"#/components/schemas/POVMember"
            }
        },
        "links":{
            "type":"array",
            "readOnly":true,
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        },
        "hidden":{
            "type":"boolean",
            "readOnly":true
        },
        "fixedSelection":{
            "type":"boolean",
            "readOnly":true
        }
    },
    "description":"A Dimension that has a set of members to select from for Report execution."
}

Nested Schema : links

Type: array

Read Only: true

Show Source

• Array of: object Link

{
    "type":"array",
    "readOnly":true,
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : suggestedMembers

Type: array

Read Only: true

The dimension's members suggested for use when executing the Report.

Show Source

• Array of: object POVMember
  A member that can be selected as part of the point of view or as the value for a Report prompt.

{
    "type":"array",
    "description":"The dimension's members suggested for use when executing the Report.",
    "readOnly":true,
    "items":{
        "$ref":"#/components/schemas/POVMember"
    }
}

Nested Schema : Link

Type: object

Show Source

• href: string
• rel: string
  Allowed Values: [ "self", "next", "prev", "first", "canonical", "parent" ]

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "enum":[
                "self",
                "next",
                "prev",
                "first",
                "canonical",
                "parent"
            ]
        },
        "href":{
            "type":"string"
        }
    }
}

Nested Schema : POVMember

Type: object

A member that can be selected as part of the point of view or as the value for a Report prompt.

Show Source

• alias: string
  Read Only: true
• links: array links
  Read Only: true
• memberId: string
  Read Only: true
• name: string
  Read Only: true

{
    "type":"object",
    "properties":{
        "memberId":{
            "type":"string",
            "readOnly":true
        },
        "name":{
            "type":"string",
            "readOnly":true
        },
        "alias":{
            "type":"string",
            "readOnly":true
        },
        "links":{
            "type":"array",
            "readOnly":true,
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        }
    },
    "description":"A member that can be selected as part of the point of view or as the value for a Report prompt."
}

Nested Schema : links

Type: array

Read Only: true

Show Source

• Array of: object Link

{
    "type":"array",
    "readOnly":true,
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

400 Response

Invalid parameter

404 Response

Book UUID not found

500 Response

Service Error

Back to Top