This article explains how Custom Fields within an application such as the [[Universal Tracking Application]] can be used to create a Contact or User account within the system. {{DeprecatedPage}}
For example, if you have a See [[UTASignup_Page]] that has Level 1 fields that store a client First Name, Last Name, Address and Phone number, this procedure will allow you to create a button on the Level 1 record that will create a contact record that is passed the values in those fields automatically.
==Steps== 1. [[Creating a Company Sign Up Page]]. Remember to set (as required): * The mandatory and optional standard fields. * The company categories. * Insert the sample sign-up and confirmation template - required to save the page. * Click the Activate Page option button. * Set the Name Check field as appropriate (update profile or create new profile). * Click the Save button. Make note of the token reference in the standard URL. 2. [[Creating a Contact Sign Up Page]]. Remember to set (as required): * The mandatory and optional standard fields. * The contact roles. * Insert the sample sign-up and confirmation template - required to save the page. * Click the Activate Page option button. * Set the Email Check field as appropriate (update profile or create new profile). * Set the Enable Login - if required. * Click the Save button. Make note of the token reference in the standard URL. 3. Create a '''HTML''' document to act as the '''Combined Sign-up page'''. <pre><html><head><title>My combined signup</title></head><body>Put any instructions here ...... <form action="/s_cpsignup.jsp" method="POST" name=frmsignup onsubmit='return sb(this);'> <input type=hidden name='defaultrole' value=""><input type=hidden name='roleupdatetype' value="0"><input type=hidden name='accessrole' value="0"><input type=hidden name='enablelogin' value="0"><input type=hidden name='scope' value="1"><input type=hidden name='folderid' value="0"><input type=hidden name='companyid' value=""><input type=hidden name='rootcompanyid' value=""> <table border=0 cellpadding=0 cellspacing=0 class=Form><tr><th class=Form>Firstname:</th><td class=Form><input type=text value="" class='Large' name='firstname' id='firstname' ></td></tr><tr><th class=Form>Lastname:</th><td class=Form><input type=text class='Large' value="" name='lastname' id='lastname'></td></tr> <tr><td> </td><td><input type=submit class=Button value='Submit'></td></tr></table> <!-- this must be the company signup page token ---> <input type=hidden name=ctoken value=""> <!-- this must be the person signup page token ---> <input type=hidden name=ptoken value=""> </form> </body></html></pre> 4. Modify the token references to the two tokens noted in steps 1 and 2. <pre><!-- this must be the company signup page token ---> <input type=hidden name=ctoken value="XVtQHU12345678"> <!-- this must be the person signup page token ---> <input type=hidden name=ptoken value="XVtDRF98765432"> </pre> 5. Place the following function in the head of the HTML. <pre><script language="javascript"> function getParams(){ var idx = document.URL.indexOf('?');var params = new Array(); if (idx != -1) { var pairs = document.URL.substring(idx+1, document.URL.length).split('&'); for (var i=0; i<pairs.length; i++) {nameVal = pairs[i].split('='); params[nameVal[0]] = nameVal[1]; } } return params; } params = getParams(); </script></pre> 6. Place one of the following second functions within the body just prior to the closing body tag (</body>). '''Form Field Population''' <pre><script> var para1=document.getElementById('field1');var para2=document.getElementById('field2'); para1.value = unescape(params["parameter1"]);para2.value = unescape(params["parameter2"]); </script> </pre> '''HTML Element Population''' <pre><script> var para1=document.getElementById('element1');var para2=document.getElementById('element2'); para1.value = unescape(params["parameter1"]);para2.value = unescape(params["parameter2"]); </script> </pre> 7. Replace "field1" or "element1" etc. with the actual form or element id name and "parameter1" with the parameter name. <pre>var para1=document.getElementById('firstname'); <input type="text" value="" id="firstname"></pre> '''or''' <pre>var para1=document.getElementById('firstname'); <div id="firstname"></div> </pre> 8. '''Save''' the page. 9. Create a [[SmartFolder]] and upload the modified page to this folder. 10. Select the URL for this file through the File Options. [[Image:ViewURL.PNG]] 11. Select the ‘Settings’ option within the UTA that you wish to create the contact from. 12. You will require [[Custom Fields]] to hold information on the ‘Contact’ you wish to create (e.g. First Name, Last Name, Phone Number, etc). If these are not already present then these must be created. 13. Create a [[Custom Field Type: Read Only – System Variables]]. This is the field that will act as you button or link to create the contact on the system. Therefore it should be named appropriately (e.g. “Create Contact”). 14. In the Variables section paste in the following HTML tags . . . <pre><a href="Sign-Up Page URL?parameter1=@#Parameter 1 Custom Field Id#@¶meter2=@#Parameter 2 Custom Field Id#@&oppid=@opportunityid@" target="_blank">click here</a> </pre> 15. Modify the HTML so that it references . . . * the correct URL for the sign-up page in the SmartFolder, * the correct parameter names as used in step 7. * the correct custom field ids for the corresponding contact information as defined in step 12. NOTE: You will not need to use the full URL, only the section following on from the web alias. [[Image:CreateContact.PNG]] 16. Click '''Save'''. [[Category:Universal Tracking Application]][[Category:Sign-Up FeaturesDeprecated]]