IMS Web Service Reference

Method: SetCategory

Description

Edit a category. If the supplied category key does not exist a new category will be created. Otherwise the corrsponding category will be updated accordingly. Use GetNewCategoryKey to obtain a new category key. The category key identifies the category.                 Required privilege: "security.set_category".

Action

http://ims.lyngsoesystems.com/administration/SetCategory

Input

The input of this method is the document element tns:SetCategory having the structure defined by the following table.

Element  Type  Occurs  Description 
    1..1 
tns:Token  common:TokenType  1..1 
tns:CategoryKey  common:CategoryKeyType  1..1 
tns:Name  common:NameType  1..1 
tns:Description  common:DescriptionType  1..1 
tns:Disabled  xsd:boolean  1..1 
tns:CategoryDistributionRuleKey  common:CategoryDistributionRuleKeyType  1..1 
tns:Parameter  common:CategoryParameterType  0..1 
tns:ParameterIsPct  xsd:boolean  0..1 
Output

The output of this method is the document element tns:SetCategoryResponse that is always empty.

Faults
Name  Content  Description 
InternalError  common:InternalErrorExceptionInfo 
InvalidArgument  common:InvalidArgumentExceptionInfo 
InvalidTokenException  common:InvalidTokenExceptionInfo 
InsufficientPrivileges  common:InsufficientPrivilegesExceptionInfo 
DuplicateRecordFound  common:DuplicateRecordFoundExceptionInfo 
ParentNotFound  common:ParentNotFoundExceptionInfo