Skip to content

Latest commit

 

History

History
284 lines (165 loc) · 16.5 KB

File metadata and controls

284 lines (165 loc) · 16.5 KB

AnalysisTemplateApi

Method HTTP request Description
getByPath GET /analysistemplates Retrieve an analysis template by path.
createFromAnalysis POST /analysistemplates Create an Analysis template based upon a specified Analysis.
get GET /analysistemplates/{webId} Retrieve an analysis template.
update PATCH /analysistemplates/{webId} Update an analysis template by replacing items in its definition.
delete DELETE /analysistemplates/{webId} Delete an analysis template.
getCategories GET /analysistemplates/{webId}/categories Get an analysis template's categories.
getSecurity GET /analysistemplates/{webId}/security Get the security information of the specified security item associated with the analysis template for a specified user.
getSecurityEntries GET /analysistemplates/{webId}/securityentries Retrieve the security entries associated with the analysis template based on the specified criteria. By default, all security entries for this analysis template are returned.
createSecurityEntry POST /analysistemplates/{webId}/securityentries Create a security entry owned by the analysis template.
getSecurityEntryByName GET /analysistemplates/{webId}/securityentries/{name} Retrieve the security entry associated with the analysis template with the specified name.
updateSecurityEntry PUT /analysistemplates/{webId}/securityentries/{name} Update a security entry owned by the analysis template.
deleteSecurityEntry DELETE /analysistemplates/{webId}/securityentries/{name} Delete a security entry owned by the analysis template.
getAnalysisTemplatesQuery GET /analysistemplates/search Retrieve analysis templates based on the specified conditions. By default, returns all analysis templates.

getByPath

getByPath(String path, String selectedFields, String webIdType)

Retrieve an analysis template by path.

Parameters

Name Type Description Notes
path String The path to the analysis template.. [required]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

createFromAnalysis

createFromAnalysis(String analysisWebId, String name, String webIdType)

Create an Analysis template based upon a specified Analysis.

Parameters

Name Type Description Notes
analysisWebId String The ID of the Analysis, on which the template is created.. [required]
name String The name for the created template, which must be unique within the database's AnalysisTemplate collection. If the name ends with an asterisk (), then a unique name will be generated based on the supplied name. The default is the specified Analysis' name suffixed with an asterisk ().. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

get

get(String webId, String selectedFields, String webIdType)

Retrieve an analysis template.

Parameters

Name Type Description Notes
webId String The ID of the analysis template.. [required]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

update

update(String webId, PIAnalysisTemplate template)

Update an analysis template by replacing items in its definition.

Parameters

Name Type Description Notes
webId String The ID of the analysis template to update.. [required]
template PIAnalysisTemplate A partial analysis template containing the desired changes.. [required]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

delete

delete(String webId)

Delete an analysis template.

Parameters

Name Type Description Notes
webId String The ID of the analysis template to update.. [required]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

getCategories

getCategories(String webId, String selectedFields, String webIdType)

Get an analysis template's categories.

Parameters

Name Type Description Notes
webId String The ID of the analysis template.. [required]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

getSecurity

getSecurity(String webId, List userIdentity, Boolean forceRefresh, String selectedFields, String webIdType)

Get the security information of the specified security item associated with the analysis template for a specified user.

Parameters

Name Type Description Notes
webId String The ID of the analysis template for the security to be checked.. [required]
userIdentity List The user identity for the security information to be checked. Multiple security identities may be specified with multiple instances of the parameter. If the parameter is not specified, only the current user's security rights will be returned.. [required]
forceRefresh Boolean Indicates if the security cache should be refreshed before getting security information. The default is 'false'.. [optional]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

getSecurityEntries

getSecurityEntries(String webId, String nameFilter, String selectedFields, String webIdType)

Retrieve the security entries associated with the analysis template based on the specified criteria. By default, all security entries for this analysis template are returned.

Parameters

Name Type Description Notes
webId String The ID of the analysis template.. [required]
nameFilter String The name query string used for filtering security entries. The default is no filter.. [optional]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

createSecurityEntry

createSecurityEntry(String webId, PISecurityEntry securityEntry, Boolean applyToChildren, String webIdType)

Create a security entry owned by the analysis template.

Parameters

Name Type Description Notes
webId String The ID of the analysis template, where the security entry will be created.. [required]
securityEntry PISecurityEntry The new security entry definition. The full list of allow and deny rights must be supplied.. [required]
applyToChildren Boolean If false, the new access permissions are only applied to the associated object. If true, the access permissions of children with any parent-child reference types will change when the permissions on the primary parent change.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

getSecurityEntryByName

getSecurityEntryByName(String name, String webId, String selectedFields, String webIdType)

Retrieve the security entry associated with the analysis template with the specified name.

Parameters

Name Type Description Notes
name String The name of the security entry. For every backslash character () in the security entry name, replace with asterisk (). As an example, use domainusername instead of domain\username.. [required]
webId String The ID of the analysis template.. [required]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

updateSecurityEntry

updateSecurityEntry(String name, String webId, PISecurityEntry securityEntry, Boolean applyToChildren)

Update a security entry owned by the analysis template.

Parameters

Name Type Description Notes
name String The name of the security entry.. [required]
webId String The ID of the analysis template, where the security entry will be updated.. [required]
securityEntry PISecurityEntry The new security entry definition. The full list of allow and deny rights must be supplied or they will be removed.. [required]
applyToChildren Boolean If false, the new access permissions are only applied to the associated object. If true, the access permissions of children with any parent-child reference types will change when the permissions on the primary parent change.. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

deleteSecurityEntry

deleteSecurityEntry(String name, String webId, Boolean applyToChildren)

Delete a security entry owned by the analysis template.

Parameters

Name Type Description Notes
name String The name of the security entry. For every backslash character () in the security entry name, replace with asterisk (). As an example, use domainusername instead of domain\username.. [required]
webId String The ID of the analysis template, where the security entry will be deleted.. [required]
applyToChildren Boolean If false, the new access permissions are only applied to the associated object. If true, the access permissions of children with any parent-child reference types will change when the permissions on the primary parent change.. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

getAnalysisTemplatesQuery

getAnalysisTemplatesQuery(String databaseWebId, Integer maxCount, String query, String selectedFields, Integer startIndex, String webIdType)

Retrieve analysis templates based on the specified conditions. By default, returns all analysis templates.

Parameters

Name Type Description Notes
databaseWebId String The ID of the asset database to use as the root of the query.. [optional]
maxCount Integer The maximum number of objects to be returned per call (page size). The default is 1000.. [optional]
query String The query string is a list of filters used to perform an AFSearch for the analyses in the asset database. An example would be: "query= Name:=MyAnalysisTemplate1*".. [optional]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
startIndex Integer The starting index (zero based) of the items to be returned. The default is 0.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]