newRole

This method allows adding a new functional role. To insert each of these items, it is necessary to follow the standard documented below:

Java class
Request	web/wwwroot/ws/java/generic/NewRoleRequestType.java
Return	web/wwwroot/ws/java/generic/NewRoleResponseType.java

Request:

ID #	Required	Description
IdRole	X	Functional role ID #
NmRole	X	Functional role name
IdRoleOwner		Upper level functional role ID #
Description		Functional role description
Components		List with the code(s) of the components to be associated according to Suite shortcuts. Examples: Administration => ad Time Control => tc Process => pm Project => pr

Request structure:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:generic">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:newRole>
         <!--You may enter the following 5 items in any order-->
         <urn:IdRole>?</urn:IdRole>
         <urn:NmRole>?</urn:NmRole>
         <!--Optional:-->
         <urn:IdRoleOwner>?</urn:IdRoleOwner>
         <!--Optional:-->
         <urn:Description>?</urn:Description>
         <urn:Components>
            <!--1 to 100 repetitions:-->
            <urn:item>?</urn:item>
         </urn:Components>
      </urn:newRole>
   </soapenv:Body>
</soapenv:Envelope>

Return:

ID #	Description
Status	SUCCESS: SUCCESS FAILURE: FAILURE
Detail	SUCCESS: Record(s) added. FAILURE: message regarding the error that occurred.
Code	SUCCESS: 1. FAILURE: Code regarding the error that occurred.
RecordId	SUCCESS: Functional role ID #. FAILURE: N/A
RecordKey	SUCCESS: Functional role primary key. FAILURE: N/A

Code	Description
43	The ID # has no value
44	Name has no value
45	Existing record
46	The upper level functional role does not exist
47	Invalid component