Difference between revisions of "Pandora - Update Contact (One Record)"
From SmartWiki
m (Added example) |
m (→Example: - added further example, to append new role to user) |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 35: | Line 35: | ||
rset.addfieldvaluebyname(idx,"email","email@email.fake"); | rset.addfieldvaluebyname(idx,"email","email@email.fake"); | ||
| − | == | + | ==Examples== |
| − | This will | + | This will update the role with ID 12345, to the contact with ID 9876543. |
<pre>ss_developer_key="@system.dev_key@"; | <pre>ss_developer_key="@system.dev_key@"; | ||
var rs=new ssRecordSet(null); | var rs=new ssRecordSet(null); | ||
| Line 42: | Line 42: | ||
idx=rs.getnewrecnumber(); | idx=rs.getnewrecnumber(); | ||
rs.addfieldvaluebyname(idx,'userid',9876543); | rs.addfieldvaluebyname(idx,'userid',9876543); | ||
| − | rs.addfieldvaluebyname(idx,'rolelist',','+ | + | rs.addfieldvaluebyname(idx,'rolelist',',12345,'); |
| + | var rsnew=contact_update(false,"",rs,false);</pre> | ||
| + | |||
| + | This will append the role with ID 56789, to the contact with ID 9876543. | ||
| + | <pre>ss_developer_key="@system.dev_key@"; | ||
| + | // get users existing rolelist | ||
| + | filter='userid=9876543'; | ||
| + | var rs= contact_find(false ,"","rolelist",filter,"",0,1); | ||
| + | var roles = rs.getfieldbyname(1,"rolelist"); | ||
| + | // append new role | ||
| + | roles += "56789,"; | ||
| + | |||
| + | // now update the user with the new rolelist | ||
| + | var rs=new ssRecordSet(null); | ||
| + | rs.addfieldnames("userid,rolelist"); | ||
| + | idx=rs.getnewrecnumber(); | ||
| + | rs.addfieldvaluebyname(idx,'userid',9876543); | ||
| + | rs.addfieldvaluebyname(idx,'rolelist',roles); | ||
var rsnew=contact_update(false,"",rs,false);</pre> | var rsnew=contact_update(false,"",rs,false);</pre> | ||
[[Category: Pandora]] | [[Category: Pandora]] | ||
Latest revision as of 05:25, 2 April 2014
This function will update a single user record or create a new user record.
contact_update(flag,callbackfunc,rset,loginfornew)
| Parameter | Description |
|---|---|
| Flag | Asynchronous processing Flag
Set to False for synchronous processing. Set to True for asynchronous processing. |
| Callbackfunc | User created Java function to manage the callback from an asynchronous function. |
| rset | ssRecordSet object containing data to be updated to the system. |
| loginfornew | Set to true to enable user access. |
| Returns |
Notes
- Loginfornew = true to initiate a user session for this contact when creating a new user.
- Rolelist = "2345,5665"
- Usertype = 10=User (default), 30=Local User Administrator, 50=Global User Administrator
- active: 0=No access, 1=Administration or Portal Interface, 3=User Centric or Applicant Interface
- CompanyID needs to be set
- IsExternal: 1=External, 0=Internal - driven by company ID
- sendpassword: including sendpassword with value "1" will trigger the new user password e-mail (you must also include the email address in the recordset):
rset.addfieldvaluebyname(idx,"active",1); rset.addfieldvaluebyname(idx,"sendpassword",1); rset.addfieldvaluebyname(idx,"email","email@email.fake");
Examples
This will update the role with ID 12345, to the contact with ID 9876543.
ss_developer_key="@system.dev_key@";
var rs=new ssRecordSet(null);
rs.addfieldnames("userid,rolelist");
idx=rs.getnewrecnumber();
rs.addfieldvaluebyname(idx,'userid',9876543);
rs.addfieldvaluebyname(idx,'rolelist',',12345,');
var rsnew=contact_update(false,"",rs,false);
This will append the role with ID 56789, to the contact with ID 9876543.
ss_developer_key="@system.dev_key@";
// get users existing rolelist
filter='userid=9876543';
var rs= contact_find(false ,"","rolelist",filter,"",0,1);
var roles = rs.getfieldbyname(1,"rolelist");
// append new role
roles += "56789,";
// now update the user with the new rolelist
var rs=new ssRecordSet(null);
rs.addfieldnames("userid,rolelist");
idx=rs.getnewrecnumber();
rs.addfieldvaluebyname(idx,'userid',9876543);
rs.addfieldvaluebyname(idx,'rolelist',roles);
var rsnew=contact_update(false,"",rs,false);
