Configuration and Content API Guide

Get CAL Packages

post

/config/sim/v2/setup/cal/getPackages

Gets a list of all CAL Packages in the specified organization

Request

Supported Media Types

application/json
multipart/form-data

The input Body model that needs to be given.

Root Schema : schema

Type: object

Show Source

include: string

If specified, limits the data returned to these fields.

Example: hierUnitId, objectNum, name
includeAll: string

If this value is specified, the include parameter is ignored.

Value Description

basic Forces the response to include all fields except option string details

detailed Forces the response to include all fields including option string details

Example: detailed
langIds: string

If specified, limits translated strings returned

Example: 1,2,3
limit: integer

If using paging, number of results returned in this page.

Example: 100
offset: integer

Starting resource record index. Not required if paging parameters are not supported

Example: 0
orderBy: string

Sorts the response by the specified field name and sort order.

Example: hierUnitId:asc
searchCriteria: string

If specified, returns records that match the criteria.

Example: where equals(hierUnitId, 7)

{
    "type":"object",
    "properties":{
        "searchCriteria":{
            "type":"string",
            "example":"where equals(hierUnitId, 7)",
            "description":"If specified, returns records that match the criteria."
        },
        "include":{
            "type":"string",
            "example":"hierUnitId, objectNum, name",
            "description":"If specified, limits the data returned to these fields."
        },
        "includeAll":{
            "type":"string",
            "example":"detailed",
            "description":"If this value is specified, the include parameter is ignored.\n<table>\n<tr>\n  <td><b>Value</b></td>\n  <td><b>Description</b></td>\n</tr>\n<tr>\n  <td>basic</td>\n  <td>Forces the response to include all fields except option string details</td>\n</tr>\n<tr>\n  <td>detailed</td>\n  <td>Forces the response to include all fields including option string details</td>\n</tr>\n</table>\n"
        },
        "langIds":{
            "type":"string",
            "description":"If specified, limits translated strings returned",
            "example":"1,2,3"
        },
        "offset":{
            "type":"integer",
            "description":"Starting resource record index. Not required if paging parameters are not supported",
            "example":0
        },
        "limit":{
            "type":"integer",
            "description":"If using paging, number of results returned in this page.",
            "example":100
        },
        "orderBy":{
            "type":"string",
            "description":"Sorts the response by the specified field name and sort order.",
            "example":"hierUnitId:asc"
        }
    }
}

Response

Supported Media Types

application/json

200 Response

A collection of CAL Packages.

Root Schema : schema

Type: object

Show Source

count: integer

Current response record count.

Example: 9
hasMore: boolean

Flag indicating if there are more objects to fetch.

Example: true
items: array items

Array of CAL Package objects of the organization.
limit: integer

Server page size

Example: 10
offset: integer

Starting resource record index

Example: 0
totalResults: integer

Total number of rows (excluding the paging parameters)

Example: 100

{
    "type":"object",
    "properties":{
        "totalResults":{
            "type":"integer",
            "example":100,
            "description":"Total number of rows (excluding the paging parameters)"
        },
        "hasMore":{
            "type":"boolean",
            "example":true,
            "description":"Flag indicating if there are more objects to fetch."
        },
        "count":{
            "type":"integer",
            "example":9,
            "description":"Current response record count."
        },
        "items":{
            "type":"array",
            "description":"Array of CAL Package objects of the organization.",
            "items":{
                "$ref":"#/definitions/CalPackage"
            }
        },
        "offset":{
            "type":"integer",
            "example":0,
            "description":"Starting resource record index"
        },
        "limit":{
            "type":"integer",
            "example":10,
            "description":"Server page size"
        }
    }
}

Nested Schema : items

Type: array

Array of CAL Package objects of the organization.

Show Source

Array of: object CalPackage

Model for an CAL Package Object

{
    "type":"array",
    "description":"Array of CAL Package objects of the organization.",
    "items":{
        "$ref":"#/definitions/CalPackage"
    }
}

Nested Schema : CalPackage

Type: object

Model for an CAL Package Object

Show Source

deploymentOrder: integer

Deployment Order of the package. Enter a number that prioritizes the order of package downloads. CAL Packages with a value of 0 are loaded before packages with a value of 1.

Example: 20
limitOptions: string

A string value of 0s & 1s of length 8 representing the deployment of the CAL package to service hosts. If no service host is specified, then the package gets deployed to all service hosts

Example: 00000000
limitOptionsExt: object limitOptionsExt

An object containing the descriptive service hosts list where the package can be deployed
packageId: integer

Unique reference of the CAL package

Example: 1
packageName: string

Name of the package

Example: CAPSOnISS
platformType: integer

The type of platform that receives the CAL Package

Example: 20
version: string

Version of the package

Example: 19.3.3

{
    "description":"Model for an CAL Package Object",
    "type":"object",
    "properties":{
        "packageId":{
            "description":"Unique reference of the CAL package",
            "type":"integer",
            "example":1
        },
        "packageName":{
            "description":"Name of the package",
            "type":"string",
            "example":"CAPSOnISS"
        },
        "version":{
            "description":"Version of the package",
            "type":"string",
            "example":"19.3.3"
        },
        "deploymentOrder":{
            "description":"Deployment Order of the package. Enter a number that prioritizes the order of package downloads. CAL Packages with a value of 0 are loaded before packages with a value of 1.",
            "type":"integer",
            "example":20
        },
        "platformType":{
            "description":"The type of platform that receives the CAL Package",
            "type":"integer",
            "example":20
        },
        "limitOptions":{
            "description":"A string value of 0s & 1s of length 8 representing the deployment of the CAL package to service hosts. If no service host is specified, then the package gets deployed to all service hosts",
            "type":"string",
            "example":"00000000"
        },
        "limitOptionsExt":{
            "description":"An object containing the descriptive service hosts list where the package can be deployed",
            "type":"object",
            "properties":{
                "checkAndPosting":{
                    "description":"A Boolean flag indicating to deploy package to Check and Posting related service host",
                    "type":"boolean",
                    "example":false
                },
                "checkAndPostingBackup":{
                    "description":"A Boolean flag indicating to deploy package to Check and Posting Backup related service host",
                    "type":"boolean",
                    "example":false
                },
                "creditCard":{
                    "description":"A Boolean flag indicating to deploy package to Credit Card related service host",
                    "type":"boolean",
                    "example":false
                },
                "interfaces":{
                    "description":"A Boolean flag indicating to deploy package to interfaces related service host",
                    "type":"boolean",
                    "example":false
                },
                "kdsController":{
                    "description":"A Boolean flag indicating to deploy package to KDS Controller related service host",
                    "type":"boolean",
                    "example":false
                },
                "kdsControllerBackup":{
                    "description":"A Boolean flag indicating to deploy package to KDS Controller Backup related service host",
                    "type":"boolean",
                    "example":false
                },
                "sim":{
                    "description":"A Boolean flag indicating to deploy package to SIM related service host",
                    "type":"boolean",
                    "example":false
                },
                "workstation":{
                    "description":"A Boolean flag indicating to deploy package to Workstation related service host",
                    "type":"boolean",
                    "example":false
                }
            }
        }
    }
}

Nested Schema : limitOptionsExt

Type: object

An object containing the descriptive service hosts list where the package can be deployed

Show Source

checkAndPosting: boolean

A Boolean flag indicating to deploy package to Check and Posting related service host

Example: false
checkAndPostingBackup: boolean

A Boolean flag indicating to deploy package to Check and Posting Backup related service host

Example: false
creditCard: boolean

A Boolean flag indicating to deploy package to Credit Card related service host

Example: false
interfaces: boolean

A Boolean flag indicating to deploy package to interfaces related service host

Example: false
kdsController: boolean

A Boolean flag indicating to deploy package to KDS Controller related service host

Example: false
kdsControllerBackup: boolean

A Boolean flag indicating to deploy package to KDS Controller Backup related service host

Example: false
sim: boolean

A Boolean flag indicating to deploy package to SIM related service host

Example: false
workstation: boolean

A Boolean flag indicating to deploy package to Workstation related service host

Example: false

{
    "description":"An object containing the descriptive service hosts list where the package can be deployed",
    "type":"object",
    "properties":{
        "checkAndPosting":{
            "description":"A Boolean flag indicating to deploy package to Check and Posting related service host",
            "type":"boolean",
            "example":false
        },
        "checkAndPostingBackup":{
            "description":"A Boolean flag indicating to deploy package to Check and Posting Backup related service host",
            "type":"boolean",
            "example":false
        },
        "creditCard":{
            "description":"A Boolean flag indicating to deploy package to Credit Card related service host",
            "type":"boolean",
            "example":false
        },
        "interfaces":{
            "description":"A Boolean flag indicating to deploy package to interfaces related service host",
            "type":"boolean",
            "example":false
        },
        "kdsController":{
            "description":"A Boolean flag indicating to deploy package to KDS Controller related service host",
            "type":"boolean",
            "example":false
        },
        "kdsControllerBackup":{
            "description":"A Boolean flag indicating to deploy package to KDS Controller Backup related service host",
            "type":"boolean",
            "example":false
        },
        "sim":{
            "description":"A Boolean flag indicating to deploy package to SIM related service host",
            "type":"boolean",
            "example":false
        },
        "workstation":{
            "description":"A Boolean flag indicating to deploy package to Workstation related service host",
            "type":"boolean",
            "example":false
        }
    }
}

Value	Description
basic	Forces the response to include all fields except option string details
detailed	Forces the response to include all fields including option string details