Working with Inquiry Forms

Step 1: Create an Inquiry Site

1. Navigate to Setup and search for Sites.
2. Click New and enter the following information:
   • Site Label = Inquiry
   • Site Name = Inquiry
   • Active Site Home Page = InquiryForm
   • Default Web Address = Inquiry
   • Active = Checked
3. Save your changes.

Step 2: Generate Permission Set

Note: The following permission sets include only a small number of fields that are always used. Depending on your institution's business needs, you can EDIT the permission set to add additional fields.

1. Navigate to the Permission Scanner tab.
2. Select the Product/Feature and Version on which you want to base your Permission Set.
   • Inquiry Forms Site User for students/inquiries
   • Inquiry Forms Admin is for users who will be creating/editing inquiry forms.

Note: You must manually add Read access to the Inquiry Forms Admin permission set for any additional fields from the Contact and Inquiry objects admins need to use on your forms.

3. Select the checkbox for Use @Future to generate a Permission Set if you want to have the process run in the background.
4. Click the Generate Permission Set button.

Note: If you previously modified a Permission Set, generating a NEW permission set will overwrite any changes.

The ‘Result’ section will display the new Permission Set Name.

Note: If you selected Use @Future to generate Permission Set, the Result section will indicate where you can view the results of the Apex Job.

Step 3: Assign Permission Set

You’ll need to assign the permission set you generated to the Inquiry Site Guest User:

1. Navigate to Setup and search for Sites.
2. Click on the Inquiry Site you created.
3. Click on Public Access Settings
4. Click on Assigned Users
5. Click on Inquiry Site Guest User
6. Click on Permission Set Assignments
7. Click Edit Assignments
8. Select the name of the permission set you generated from the list of Available Permission Sets.
9. Save your changes.

Step 4: Create Sharing Rules

A Sharing Rule must be created on the Address Plus and Configuration objects for the Inquiry Site Guest User:

1. Navigate to Setup and search for Sharing Settings.
2. In Manage sharing settings, select Address Plus.
3. Under Sharing Rules Configurations Sharing Rules, select New.     
   1. In the Step 1: Rule Name, enter Label = Inquiry Site Guest User.  Rule Name will automatically populate with this value.
   2. In Step 2: Select your rule type, select the radio button option Guest User Access, Based on Criteria.
   3. In Step 3: Select which records to be shared enter the Created by ID starts with 005.
   4. In Step 4: Select the users to share with, select Inquiry Site Guest User.
   5. In Step 5: Select the level of access for the users, select Read Only.
4. Save your changes.
5. Repeat Steps 1-4 for the Configuration object.
6. Save your changes.

Step 5: Configure CAPTCHA

Option 1: If you already have CAPTCHA setup for Online Applications, you’ll need to add another domain for your inquiry form site:

1. Navigate to the Google Recaptcha site: https://www.google.com/recaptcha
2. Click/Login to the Admin Console
3. Click on Settings.
4. In the Domains section, click the Add a Domain option
5. You’ll need to add TWO domains:
   • Your Salesforce org URL (required for internal users to preview inquiry forms), for example, test--targetx-base.cs2.visual.force.com. You can find this URL by previewing one of your inquiry forms first (from the list view page or the form builder) -- grab the URL from your browser address bar.
   • Your Salesforce site URL (required for student form). This can be found on the Sites page under Setup. For example, targetxdemo-15c8879cfb3.cs2.force.com

Option 2: If you have NOT already configured reCAPTCHA for online app, the you need to register a new site:

Register for CAPTCHA keys

1. Navigate to: https://www.google.com/recaptcha/intro/v3.html
2. Click on Admin Console.     
3. Click the + to Register a New Site.     
4. Enter a Label.     
5. Select reCAPTCHA v2.     
6. Select the “I’m not a robot” Checkbox option.     
7. Add your Domain (this is your Site URL) WITHOUT the http:// portion:

Example: myorg-edition.na00.force.com

Note: Do NOT include anything AFTER the Base URL, such as /portal or /app

8. Add additional Owners by entering the appropriate Email address.    
9. Click Accept the reCAPTCHA Terms of Service box.
10. Click Submit.
11. You will then see your Site Key and Secret Key. COPY these values for the next step.

Enter Keys into CAPTCHA Setup

1. Note your Salesforce URL up to the salesforce.com. Example: https://na10.salesforce.com
2. Append /apex/TargetX_Base__CaptchaSetup to the URL. Example: https://na10.salesforce.com/apex/TargetX_Base__CaptchaSetup     
3. Paste in your Site Key and Secret Key from the previous step.
4. Click Save Keys.

Note: The CAPTCHA Setup page will NOT display your old values to keep them locked down. Save will overwrite your old values with the new ones.

Step 6: Implement TX Forms

Refer to the article Implementing TX Forms for next steps.

Benefits

When a student submits an inquiry form, he/she may select an "anticipated major" from a list of available options. This inquiry is recorded in the CRM on an Inquiry record associated to the Contact record for the student via a lookup relationship. A year later, the same student may make another inquiry with the institution but due to interests changing, may select a different "anticipated major". Rather than overwrite the initial inquiry data, a new Inquiry record will be created with the updated data. 

Using multiple inquiries, institutions can track, over time, changes in inquiry data for a given contact, as well as report on overall inquiry data over time. 

Using Multiple Inquiries

When collecting inquiry data from contacts, either from data import files or forms, integrations must be designed to map data to the Inquiry object and its accompanying fields, not the Contact object.

For example, an inquiry form built in FormAssembly might include two connections:

1. Contact Object Connection - data mappings specific to the Contact, such as biographical information
2. Inquiry Object Connection - data mappings specific to the given Inquiry, such as intended major, anticipated start term/year, etc

Note: The Inquiry Object connection would include a lookup to the previously created Contact record to ensure the inquiry record is properly associated. 

Displaying Most Recent Inquiry Data on the Contact Object

In addition to tracking and managing individual inquiries for contacts, it is possible to define a "Master" inquiry record to roll the data up to fields on the Contact record. This master inquiry data can be driven from both Inquiry and Application records. To learn more about defining master logic, please see Using the Profile Builder for Student/Contacts.

Step 1: Add an iframe to your Web Page 

Add an iframe tag to your web page, and set the src to the Site URL for the particular Inquiry Form you want to use. For example, replace the items in red with YOUR inquiry form link:

<iframe
    src="https://targetxuni-15c8879cfb3.cs2.force.com/Inquiry#?formId=a1MR0000006xJnpMAE""
    width="550px"
    height="650px">
</iframe>

Note: TargetX recommends that you select a Width of 550 or lower. Setting the width higher than 550 can produce unexpected results.

• src: use the site URL where you want to host the inquiry form
• formId: use the ID for the Inquiry Form you want to use
• Set other attributes of the iframe as needed, such as the height and width so it fits into your host page.

Step 2: Configure Session Settings 

1. Navigate to Setup and search for Session Settings.
2. In the Trusted Domains section, click Add Domain.
3. Add the following:
   • Domain = the website (that is hosting your embedded form)
   • IFrame Type = Visualforce Pages
4. Save your changes.
5. In the Clickjack Protection section, enable the following:
   • Enable clickjack protection for customer Visualforce pages with standard headers
   • Enable clickjack protection for customer Visualforce pages with headers disabled in session settings
6. Save your changes.

Step 3: Add the Domain to the Site Detail page

1. Navigate to Setup and search for Sites.
2. Select your Inquiry Form site.
3. In the Trusted Domains for Inline Frames section, click Add Domain.
4. Add the following: Domain =  website that is hosting your embedded form.
5. Save your changes.

How to iFrame an Inquiry Form 

Once you have the URL for your form, you may publish it on your webpage as a link, or you can iFrame the form if desired.

Below is sample HTML code that can be used on your website to iFrame a form. Please note you will want to replace the "Form URL" with the one created in the steps above. 

<iframe src="Form URL" height="800" width="600"
frameborder="0" ></iframe>

Additional HTML properties can be added if desired.