Smartstaff, administrator
4,478
edits
Changes
no edit summary
This function is used to remove a single organisation , contact or contact provider with a UTA level 1, 2, or 3 record. This function is also used to associate disassociate a contact with an organisation record through the Associate/Association feature., remove parent-child relationships between 2 companies or to remove Consumer/Provider relationships
utarole_remove(flag,callbackfunc,parenttype,parentobject,childtype,childoject,roleid)
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 for is company association; 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
RoleID = Role
===Example - Remove Contact from Level 1===
function removeContact(userid,roleid){
var r=confirm("Are you sure you want to remove this contact from your application?");
if (r==true){
ss_developer_key="@system.ss_developer_key@";
utarole_remove(false ,"","23","@opportunityid@","40",userid,roleid);
alert("Contact has been removed.");
$("#savedraftbutton").click()
}
else
return false;
}
Put following in a read only that displays the contacts on Level 1
[#(?object=contact;criteria=(rolename in ("Research Body - Finance Officer","Research Body - Research Officer")))
<input type="button" class="ButtonSm" value="Remove" onclick="removeContact(~userid~,~roleid~)">#]
===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_remove(false,"",23,PROVIDER_OPPORTUNTYID,23,CONSUMER_OPPORTUNTYID,ROLEID);
Level 1 Provider to Level 2 Consumer:
utarole_remove(false,"",23,PROVIDER_OPPORTUNTYID,26,CONSUMER_EVENTID,ROLEID);
Level 2 Provider to Level 1 Consumer
utarole_remove(false,"",26,PROVIDER_EVENTID,23,CONSUMER_OPPORTUNTYID,ROLEID);
===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. The function will remove the relationship between the two organisations.
utarole_remove(false,"",30,COMPANYID,30,COMPANYID,ROLEID);
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. The function will disassociate the contact from the organisation record.
utarole_remove(false,"",30,COMPANYID,40,USERID,ROLEID);
==See Also==
* [[utarole_add]]
[[Category: Pandora]]