Pandora - Remove a UTA Role (Company or Contact) and Associate Feature

This function is used to remove a single organisation , contact or provider with a UTA level 1, 2, or 3 record. This function is also used to 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)

Parameter	Description
Flag	Asynchronous processing Flag Set to False for synchronous processing. Set to True for asynchronous processing.
Callbackfunc	User created JavaScript function to manage the callback from an asynchronous function.
parenttype	Type of object to attach a child object (23 is Level 1; 26 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
Returns

Notes

Associate a company or a contact with a Level 1

Parent type could be level 1, 2 or 3 or company (for the associate)

Parentobject = ID of Level 1, 2 or 3 or company ID

Only company ID or User ID

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 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