0
edits
Changes
m
no edit summary
This function is used to associate a single organisation , contact or contact Provider with a UTA level 1, 2, or 3 record. This function is also used to associate a contact with an organisation record through the Associate/Association feature , create a parent-child relationships between 2 companies and to create Consumer/Provider relationships
utarole_add(flag,callbackfunc,parenttype,parentobject,childtype,childojectchildobject,roleid,rset)
{| border="1"
Set to True for asynchronous processing.
|-
|'''Callbackfunc''' || User created Java JavaScript function to manage the callback from an asynchronous function.
|-
|'''parenttype'''||Type of object to attach a child object (use 23 for is Level 1, ; 26 for is Level 2; 30 is company; 40 is user)
|-
|'''parentobject'''|| The ID of the parent object
|-
|'''childtype'''||Type of child object to be attached to the parent object (23 is Level 1; 26 is Level 2; 30: is company, ; 40: is user)
|-
|'''childobject'''||The ID of the child object
Parentobject = ID of Level 1, 2 or 3 or company ID
RoleID = Role
==Example (Add a contact to Level 1)==
function addOfficer(roleid){
ss_developer_key="@system.ss_developer_key@";
if (roleid==10901){
var lineItemSelectRO= document.getElementById("RoID");
var lineItemId= lineItemSelectRO.options[lineItemSelectRO.selectedIndex].value;
if(lineItemId=="0"){
alert("Please select a research officer.");
return;
}
}
utarole_add(false ,"","23","@opportunityid@","40",lineItemId,roleid);
alert("Research Officer has been added to the application");
}
<input class=ButtonSm type="Button" onclick="addOfficer(10901)" value="Add RO" />
===Consumer/Provider===
* To determine the ROLEID for Consumer/Provider relationships go to the '''UTA Connection Roles''' setting within the UTA, right-click or hover over the hyperlink for the relevant role. The ROLEID is the parameter listed as ''statusid'' in the URL.
Level 1 Provider to Level 1 Consumer:
utarole_add(false,"",23,PROVIDER_OPPORTUNTYID,23,CONSUMER_OPPORTUNTYID,ROLEID,rset);
===Companies===
Company Relationships are used to link one company in a hierarchical structure(i.e. parent and child relationship). In the syntax below the parent object is first company, while the child object is the second company.
utarole_add(false,"",30,COMPANYID,30,COMPANYID,,rset);
Company [[Association_Settings|Associations]] are used to link a company to a contact. In the syntax below the parent object is first company, while the child object is the user.
utarole_add(false,"",30,COMPANYID,40,USERID,ROLEID,rset);
==See Also==
* [[utarole_remove]]
[[Category: Pandora]]