Wiki source code of Forms - How to Manage Forms

Last modified by caterina on 2021/09/24 14:08

Show last authors
1 {{layout}}
2 {{layout-section ac:type="two_right_sidebar"}}
3 {{layout-cell}}
4
5
6 {{id name="Start ScreenSteps Content"/}}
7 This lesson will describe how to use the Forms functionality to manage forms. This includes previewing a form; obtaining URL links to a form; viewing products that are available for subscription/purchase on a form; creating a QR code for a form; editing, copying, and deleting a form; and attaching products to a form.
8
9 Please refer to the Quick Start Guide - Forms for information on basic concepts and rules relating to forms.
10
11 === OPEN THE "MANAGE FORMS" WINDOW ===
12
13 === Select SETUP from the main menu. ===
14
15 [[image:attach:Screen Shot 2021-09-23 at 4.20.31 PM (2).png||thumbnail="true" height="250"]]
16
17 === Select "Forms" from the sub-menu. ===
18
19 [[image:attach:Screen Shot 2021-09-24 at 3.05.47 PM 1(2).png||thumbnail="true" height="250"]]
20
21 This will bring you to Manage Forms, displaying an alphabetical list of all forms with the option to create a new form and/or perform other functions on existing forms. (See below.)
22
23 To quickly find a form, use the Search functionality at the top of the page or use the page-through to move from page to page. (See below.)
24
25 [[image:attach:media_1432923104796.png||align="center"]]
26
27 To create a new form, click "Create Form" and follow directions in Forms - How to Create a Form (v. 11.x).
28 See below for more detail on managing forms.
29
30 === MANAGING FORMS ===
31
32 === Expanded View / Attach Product(s) ===
33
34 [[image:attach:media_1432923471947.png||align="center"]]
35
36 When the form view is expanded (by clicking on the down arrow to the right of the form name, you'll see the products attached to the form and have the options of changing the order of products and/or attaching or removing additional products.
37
38 Removing a product from a form DOES NOT delete the product. It only removes it from appearing on the form.
39
40 You cannot remove a product that has the form designated as PRIMARY. To change a product's primary form, you must do so in the Product Manager. Once the primary form has been changed, you can then remove it from the form by changing its position to "0" in the Product Manager (or by returning to the form manager and removing it).
41
42 To change the order products appear on the form, click on the dark gray bars to the left of the product name, drag and drop to desired position.
43
44 Select "Attach New Product" to attach a new product to the form. (See detail below.)
45
46 [[image:attach:media_1432924529884.png||align="center"]]
47
48 When you click on "Attach New Product", a blank field will appear. Clicking inside the field will bring up a drop-down list of products to choose from. Alternatively, you can begin typing in the name of the product to find it more quickly.
49
50 Once you've selected the name of the product, click the "Attach" button, or "Cancel" to cancel the action.
51
52 === Preview: To preview a form (see what it will look like to the user on the front end), click on the "preview" icon. ===
53
54 [[image:attach:media_1432924994095.png||align="center"]]
55
56 === Get Links: To view various links to the form, including links that can be used on your website or in a newsletter/email blast, click the "get links" icon. ===
57
58 [[image:attach:media_1432925017044.png||align="center"]]
59
60 A new window will open, showing various links to the form. See details on the links below. (Note important information on "Form Linkout" and "Renewal Link".)
61
62 [[image:attach:media_1404765596606.png||align="center"]]
63
64 In all of the above links, replace the DOMAIN_NAME variable with the domain name you want to link to. For example, if you want to link to a renewal form on gcnmedia.com, the link would be [[http:~~/~~/ocreg.gcnmedia.com/onecount/reg/registerForm.cgi?form=70&renewal=true>>url:http://ocreg.gcnmedia.com/onecount/reg/registerForm.cgi?form=70&renewal=true||rel="nofollow" shape="rect" class="external-link"]].
65
66 //**These links may be used on your website and/or in a newsletter or email blast to direct users to your form.**//
67 (% style="text-decoration: underline;" %)**Types of Links**(%%)**:**
68 **Form Linkout:** This is the URL of the form. If a user/subscriber's information is in the ONEcount database (and he/she is logged on to the site where the form is located) and this linkout is used, ALL fields/question responses (regardless of whether the question is designated to auto populate when creating or editing the form) for which there is data will be pre-populated. (See How to Create a Form for more information on designating questions to Auto Populate.)
69
70 //Example~:// Form #999 has the question "email" designated to auto populate but not the question "street address". If the Form Linkout is used and user/subscriber information is in the ONEcount database (and the user is logged on to the site where the form is located), then both "email" and "street address" will be pre-populated (even though "street address" was not designated to auto populate) when the user accesses the form.
71
72 **Renewal Link:** This is the same link construction as the Form Linkout described above but has "&renewal=true" appended to the end. (% style="color: rgb(0,0,0);" %)Per audit rules, you cannot pre-populate certain demographics, even if the information is in your database. (%%)Use the Renewal Link construction if you want only those fields/questions you designated to auto populate when creating or editing the form to be pre-populated. ~*~* If user's/subscriber's information is in the ONEcount database (and he/she is logged on to the site where the form is located), this URL will bring him/her to the form with only those fields designated to auto populate when creating or editing the form pre-populated. (See How to Create a Form for more information on designating questions to Auto Populate.) (% style="color: rgb(0,0,0);" %)Use this link construction in conjunction with the "Auto Populate" feature when creating/editing forms to be sure you are following BPA and/or other audit bureau reporting rules on what fields can be pre-populated in a form.
73
74 //Example~:// Form #999 has the question "email" designated to auto populate but not the question "street address". If the Renewal Link is used and user/subscriber information is in the ONEcount database (and the user is logged on to the site where the form is located), then only "email" will be pre-populated and not "street address".
75
76 (% style="text-decoration: underline; color: rgb(0, 0, 0)" %)//**Email Engine Links: You can place these smartlinks* anywhere in your newsletter/email message sent out through the ONEcount Email Engine to direct users to a personal renewal and/or personal edit profile/unsubscribe form.**//(%%)
77 **Personal Renewal Link**: The system will automatically replace OCVALIDATE with each user's email and ONEcount id when the message is sent out via email so that if a user clicks on the link, he/she will be automatically logged in and brought to his/her current account information to renew.
78
79 **Edit Profile/Unsubscribe Link**: The system will automatically replace OCVALIDATE with each user's email and ONEcount id when the message is sent out via email so that if a user clicks on the link, he/she will be automatically logged in and brought to his/her current account information to either edit or unsubscribe.
80
81 *A smartlink is any link that has parameters for identifying the user appended to the end of the URL. These parameters vary based on the email marketing platform you use (e.g. ONEcount's integrated Email Engine, Real Magnet/Magnet Mail, Silverpop, etc.) Uponclicking on a smartlink, two things will happen: 1) the user will be authenticated automatically for access-controlled content; and 2) the user will be identified in the system as a ONEcount user and a cookie will be set, allowing you to track as a Known user all activities across your online properties.
82
83 **Appending a Source Code to a Link**
84 Overriding the source code of a form can be useful for tracking users from specific email/newsletter blasts.
85 //To do this~://
86 1) Create a new source code for the email/newsletter blast using the Source Codes tool under INVENTORY.
87 2) Once the code is created, copy the Code ID which is found to the left of the Code name. (Get back to Manage Source Codes window by clicking the "back" button on your browser twice.)
88 3) Retrieve the URL of the form you wish to attach the code to as described above in Get Links > Form Linkout.
89 4) Attach the new source code by appending the following text to the end of the URL: &src_code=X . X is the Code ID. (e.g. &src_code=8)
90
91 **Example URL with source code:** (% style="text-decoration: underline; color: rgb(0, 0, 128)" %)[[http:~~/~~/www.gcnmedia.com/ONEcount/reg/registerForm.cgi?pid=21&src_code=8>>url:http://www.gcnmedia.com/ONEcount/reg/registerForm.cgi?pid=21&src_code=8||rel="nofollow" shape="rect" class="external-link"]]
92
93 === Get QR Code: Click the "QR CODE" icon to create a QR Code that will store the URL of the form. ===
94
95 [[image:attach:media_1432925092448.png||align="center"]]
96
97 Mobile devices can capture the QR Code, which stores the URL of the form and, when read by the mobile device, brings the user directly to the form on your web site.
98
99 === Edit: Click the "edit" icon to edit the form. ===
100
101 [[image:attach:media_1432925131781.png||align="center"]]
102
103 Editing the form will bring you to the same screen used when you created the form, with the header "Edit Form" where you can then change the form (e.g. change the form name, header text, change or add a source code, change the order of questions, set questions as required or auto-populated, change the question text, edit the Response Type and/or possible responses, duplicate questions, create/change question aliases, create/change report headers, and/or add new questions as described in How to Create a Form).
104
105 === Copy: Click the "copy" icon to copy a form. ===
106
107 [[image:attach:media_1432925141998.png||align="center"]]
108
109 Copying a form DOES NOT create duplicate data fields/questions. It only creates an identical form using the same data fields/questions from the pool of data fields/questions, in the same order, with the same settings as the original form.
110
111 After clicking the "copy" icon the Form Builder window will appear, as shown below. You will know it is a copied form by addition of "(copy)" in the Form Builder header and in the Form Name.
112
113 [[image:attach:media_1432925247320.png||align="center"]]
114
115 Here you can give the form a new Form Name, Description, Source Code, etc. and edit any of the questions, and/or add new questions. (See How to Create a Form for more detail.)
116
117 Copying a form is useful if you want to modify a form slightly but keep the original as well...you don't have to go through the entire process of creating a new form this way.
118
119 === Delete: To delete a form, click the "delete" link. (See explanation and warning below.) ===
120
121 [[image:attach:media_1432925398933.png||align="center"]]
122
123 A confirmation window will appear as shown below.
124
125 [[image:attach:media_1432925447026.png||align="center"]]
126
127 Select "OK" to delete or "Cancel" to cancel the operation.
128
129 **Delete** will delete the form but will not delete the questions or, if the form has been in use, user information in the ONEcount database that has already been collected by the form.
130
131 (% style="color: rgb(255,0,0);" %)**Warning: Be sure that the form is not being used by any products before deleting it. If you delete the form and it is attached to a product/is being used to subscribe to a product, the form will not be available for users to subscribe.**
132
133
134
135 {{id name="End ScreenSteps Content"/}}
136 {{/layout-cell}}
137
138 {{layout-cell}}
139 {{panel title="Search all Documentation:"}}
140
141
142 {{livesearch/}}
143 {{/panel}}
144
145 {{panel title="Search INVENTORY Documentation:"}}
146
147
148 {{pagetreesearch rootPage="Create and Manage Your Inventory"/}}
149 {{/panel}}
150
151 {{panel title="More INVENTORY Documentation:"}}
152 {{expand}}
153 (% style="margin-left: 30.0px;" %)
154 [[Inventory - Getting Started>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66180||shape="rect"]]
155
156 (% style="margin-left: 30.0px;" %)
157 [[Quick Start Guide - Products & Resources>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66207||shape="rect"]]
158
159 (% style="margin-left: 30.0px;" %)
160 [[Products - How to Create a Product Part 1: Create, Name, Attach Forms>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66214||shape="rect"]]
161
162 (% style="margin-left: 30.0px;" %)
163 [[Products - How to Create a Product Part 2: Product Terms>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66234||shape="rect"]]
164
165 (% style="margin-left: 30.0px;" %)
166 [[Products - How to Create a Product Part 3: Attach/Remove/Create a Resource>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66253||shape="rect"]]
167
168 (% style="margin-left: 30.0px;" %)
169 [[Products - How to Manage Products>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66294||shape="rect"]]
170
171 (% style="margin-left: 30.0px;" %)
172 [[Quick Start Guide - Questions and Forms>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66310||shape="rect"]]
173
174 (% style="margin-left: 30.0px;" %)
175 [[Question Builder - Create and Manage Questions>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66312||style="text-decoration: underline;" shape="rect"]]
176
177 (% style="margin-left: 30.0px;" %)
178 [[Forms - How to Create a Form>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66345||shape="rect"]]
179
180 (% style="margin-left: 30.0px;" %)
181 [[Forms - How to Manage Forms>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66370||shape="rect"]]
182
183 (% style="margin-left: 30.0px;" %)
184 [[Forms - How to Enable/Disable Lookup/Login Page>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66386||shape="rect"]]
185
186 (% style="margin-left: 30.0px;" %)
187 [[Brand - How to Create and Manage Brands>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66391||shape="rect"]]
188
189 (% style="margin-left: 30.0px;" %)
190 [[Resources - How to Create a Resource>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66411||shape="rect"]]
191
192 (% style="margin-left: 30.0px;" %)
193 [[Resources - How to Manage Resources>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66435||shape="rect"]]
194
195 (% style="margin-left: 30.0px;" %)
196 [[Promo Codes - How to Create and Manage Promo Codes>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66445||shape="rect"]]
197
198 (% style="margin-left: 30.0px;" %)
199 [[Product Status - How to Create and Manage Product Statuses>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66479||shape="rect"]]
200
201 (% style="margin-left: 30.0px;" %)
202 [[Source Codes - How to Create and Manage Source Codes>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66463||shape="rect"]]
203 {{/expand}}
204 {{/panel}}
205
206 \\
207
208 \\
209
210 **
211 **
212
213 \\
214
215 \\
216
217 \\
218
219 \\
220
221 \\
222 {{/layout-cell}}
223 {{/layout-section}}
224 {{/layout}}