"listCodePackages"
JSON ADMIN "listCodePackages"
action returns a list of code packages that match all specified filters
The "listCodePackages" action returns a list of code packages that match all the specified filters.
Each returned item in the list contains all code package properties except the "code"
property. This action helps the user find the current code package. If you want to retrieve the source code, use the "describeCodePackages" action.
Request examples
{ "api": "admin", "action": "listCodePackages", "params": { "databaseName": "faircom", "ownerName": "admin", "partialName": "convert", "codeTypeFilter": [ "transform", "expression" ], "statusFilter": [ "developing", "deleted", "inactive", "deprecated", "testing", "active" ], "includeDeactivatedCode": true, "commentFilter": "words, phrases, NEAR, full-text search", "descriptionFilter": "words, phrases, NEAR, full-text search", "metadataFilter": "words, phrases, NEAR, full-text search", "skipRecords": 100, "maxRecords": 25 }, "authToken": "replaceWithAuthTokenFromCreateSession" }
{ "api": "admin", "action": "listCodePackages", "params": {}, "authToken": "replaceWithAuthTokenFromCreateSession" }
{ "api": "admin", "action": "listCodePackages", "params": { "codeTypeFilter": ["transform"], "statusFilter": ["developing"], "includeDeactivatedCode": true }, "authToken": "replaceWithAuthTokenFromCreateSession" }
Full-text filter expressions
Examples:
To constrain results to include the three words FairCom Edge rocks
anywhere in a comment, use "commentFilter": "FairCom Edge rocks"
.
To constrain results to include the exact phrase 'FairCom Edge rocks'
and the phrase 'around the clock'
in the description, use "descriptionFilter": "'FairCom Edge rocks' 'around the clock'"
. Notice that a phrase is enclosed in single quotation marks.
To constrain results to include the key value pair "myProperty": "myValue"
in the metadata, use the search string, "metadataFilter": "'myProperty' NEAR/0 'myValue'"
. Notice that NEAR/0 specifies no intervening words or phrases. If you want to allow a maximum of one intervening word, use NEAR/1. You can specify a maximum of any number of intervening words.
To constrain results to include the word FairCom
as the first word plus the word rocks
anywhere else in the description, use the search string, "descriptionFilter": "^FairCom rocks"
. The ^
operator followed by a word or phrase can only be included once in a full-text expression.
Use the listCodePackages API action to return a list of code packages that match all the specified filters
Property | Description | Default | Type | Limits (inclusive) | ||||||
---|---|---|---|---|---|---|---|---|---|---|
specifies the name of the database | Defaults to the session's | string | ||||||||
specifies the name of the owner | Defaults to the session's | string | ||||||||
returns code packages with names that match its value |
| string | ||||||||
returns code packages with a code type that matches one of the values in the array |
| array | ||||||||
returns code packages with statuses that match one of the values in the array |
| array |
| |||||||
specifies whether or not the results include deactivated code packages |
| Boolean |
| |||||||
returns code packages with descriptions that match the full-text search in |
| string | ||||||||
returns code packages with metadata that match the full-text search in the |
| string | ||||||||
returns code packages with comments that match the full-text search in |
| string | ||||||||
specifies the number of results to skip |
| integer | ||||||||
specifies the maximum number of results to return |
| integer |
"databaseName"
is an optional string specifying the database name of the code package. It defaults to the session's "defaultDatabaseName"
property when omitted or set to null
. The package's unique identifier is the combination of "databaseName"
, "ownerName"
, and "codeName"
.
"ownerName"
is an optional string specifying the account name that owns the code package. It defaults to the session's "defaultOwnerName"
property when omitted or set to null
. The package's unique identifier is the combination of "databaseName"
, "ownerName"
, and "codeName"
.
"partialName"
is an optional query filter that returns code packages with code names that match the value of "partialName"
. The match starts at the name's beginning, making it a "starts with" match instead of a "substring" match. If the partial name is empty, null
, or omitted, it matches all names.
"codeTypeFilter"
is an optional query filter with an array of code types. If the array is empty, null
, or omitted, it matches all code types; otherwise, it returns code packages with a code type that matches one of the array's values.
"statusFilter"
is an optional query filter consisting of an array of status values. If the array is empty, null
, or omitted, it matches all status values; otherwise, it returns code packages only when their status matches one of the values in the array. If "includeDeactivatedCode"
is set to true or false, it overrides conflicting status codes.
"includeDeactivatedCode"
is an optional query filter that is a Boolean value. It defaults to null
. The results include activated and deactivated code packages if this value is null
or omitted. If set to true
, the results only include deactivated code packages. If set to false
, the results only include activated code packages.
"commentFilter"
is an optional query filter that is a string value. It defaults to null
. If this value is not null
or omitted, the results only include code packages with comments that match the full-text search specified in the "commentFilter"
property. See Full-text filter expressions.
"descriptionFilter"
is an optional string value that defaults to null
. If the value is not null
or omitted, the results only include code packages with descriptions that match the full-text search specified in the "descriptionFilter"
property. See Full-text filter expressions.
"metadataFilter"
is an optional string value that defaults to null
. If the value is not null
or omitted, the results only include code packages with metadata that match the full-text search specified in the "metadataFilter"
property. See Full-text filter expressions. A code package's "metadata"
property contains a JSON object with user-defined key-value pairs.
"skipRecords"
is an optional string value that defaults to 0
. It is used with "maxRecords"
to paginate the results. If the value is not null or omitted, the server returns results from the beginning. If it is > 0, the server skips over the specified number of records and returns results starting from that point up until it returns the maximum number of results as defined by "maxRecords"
.
"maxRecords"
is an optional string value that defaults to 20
. It is used with "skipRecords"
to paginate the results. If the value is not null or omitted, the server returns the maximum number of results specified by "maxRecords"
.