Skip to Content
Version 4.1 by melanie@one-count_com on 2016/12/08 11:53
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 describes how to use an existing Import Mapping Template to expedite the import process. Detailed instructions on importing a file into the ONEcount system are found in the "How to Import a File" lesson.
8
9 Please refer to Quick Start Guide - User Operations for important information about basic concepts and rules relating to imports and bulk operations.
10
11 === OPENING THE "IMPORT" WINDOW ===
12
13 === Select User Operations from the Main Menu. ===
14
15 [[image:attach:media_1444247502716.png||align="center"]]
16
17 === Click on "Import". ===
18
19 [[image:attach:media_1444247544053.png||align="center"]]
20
21 This will open the Import window, as shown below.
22
23 [[image:attach:media_1444247573535.png||align="center"]]
24
25 === LOCATING AND USING A MAPPING TEMPLATE ===
26
27 === 1. In the Import window choose your import file using the "Browse" button (1), and select "Upload File" (2). ===
28
29 [[image:attach:media_1444247620819.png||align="center"]]
30
31 The list will be uploaded, and the Import window opened. You will see a confirmation that the list was uploaded successfully, along with the number of records uploaded. (See screen shot below.) //**The list has not been imported at this point but uploaded to the system in preparation for import.**//
32
33 === 2. Give your import an Import Title (1), Import Description (2), select a Source Code (3), select the product(s) from the Product List (4), and select a product status.. ===
34
35 [[image:attach:media_1444247703023.png||align="center"]]
36
37 Note that the product terms are what appear in the list of products (#4 above) in the Import Engine. Because all products have a term(s) and if a product has multiple terms (i.e. a free print subscription and a paid print subscription), each term needs to appear in the "product" list so that a user can be subscribed to that specific term.
38
39 You can select multiple products. Be aware that when selecting multiple products the same Source Code and Product Status will be applied to all selected products.
40 Below the Product List, you will see a list of any existing Import Mappings (templates), if any.
41
42 === 3. Below the Product List, you will see a list of any existing Import Mappings (templates). Find the template you wish to use and select "Use". ===
43
44 [[image:attach:media_1444247877482.png||align="center"]]
45
46 Note that prior to selecting "Use", there is no mapping in the mapping section below the template list (Active Question and Active CSV headers are blank.)
47
48 If the .csv import file you are using does not contain fields that are saved in the mapping template, those fields will be ignored and you will receive a notification as shown below. If you wish to ignore those fields – or add any of them after selecting the template – continue with the mapping, click OK.
49
50 [[image:attach:media_1358441601547.png||align="center"]]
51
52 If there are many fields mapped to the Mapping Template but not present in the import file, a message displaying the count of fields not present and not a complete listing of the fields will be displayed, as shown below.
53
54 If you wish to ignore those fields – or add any of them after selecting the template – continue with the mapping, click OK.
55
56 [[image:attach:media_1406491575447.png||align="center"]]
57
58 === 4. Active Question Headers and Active CSV Headers will be automatically populated based on the import mapping template. ===
59
60 [[image:attach:media_1358441791837.png||align="center"]]
61
62 You may add additional fields to be mapped at this point and either save as a new template or continue with the import. (See screenshot below for directions on how to map additional fields.)
63
64 * If you add/remove fields to map and don't wish to save as a new template, continue with steps 5-7 below.
65 * If you add/remove fields to map and wish to save as a new template, follow steps 4-7 in the "How to Create an Import Mapping Template" lesson.
66
67 [[image:attach:media_1406492917169.png||align="center"]]
68
69 To map additional fields:
70
71 * Select data fields/questions to map from the ONEcount database (1) then select "Activate" (2). Selected questions/data fields will appear in the "Active Question Headers" column (3). (Move from left to right.)
72 * Select the data fields/columns to map from the CSV import file (4) then select "Activate" (5). Selected data fields/columns will appear in the "Active CSV Headers" column (6). (Move from right to left.)
73
74 To move more than one field at a time into the "Active Header" box, select multiple fields then click on "Activate".
75
76 To remove a field from the Active column, select the field and click on "Deactivate". Be sure to remove the same field from the other Active column.
77
78 When mapping fields, Active Question Headers and Active CSV Headers must match, ie the fields must be in the same order. (See purple arrows in screenshot above.)
79
80 Question Header and CSV Header field names don't need to be identical, e.g. a Question Header may be "Email Address" and CSV Header "Email".
81
82 (% style="color: rgb(255,0,0);" %)If you plan on completing an import after modifying the template, select field(s) against which to check for duplicates.
83
84 More detail on importing a .csv file and mapping headers can be found in the "How to Import a File" lesson.
85
86 === 5. Select fields to check duplicates against. ===
87
88 [[image:attach:media_1406493696569.png||align="center"]]
89
90 (% style="color: rgb(223,0,0);" %)**ALWAYS BE SURE TO CHECK FOR DUPLICATES. IF YOU DON'T, DUPLICATE RECORDS MAY BE ADDED TO THE ONECOUNT DATABASE.**
91
92 (% style="color: rgb(223,0,0);" %)When saving a mapping template, only the Active Headers will be saved. Fields to check for duplicates WILL NOT be saved.
93
94 === 6. Set Request Date field, Expiration Date field, and Media Files fields (all optional). ===
95
96 [[image:attach:media_1444248236424.png||align="center"]]
97
98 Select the column in your import file to set the Request Date (1), select expiration date field to specify expiration date (2), select the column with media file filenames/paths to link media files (3).
99
100 === 7. Review mapping and selections, then click "Set" at the bottom of the page. ===
101
102 [[image:attach:media_1444248109116.png||align="center"]]
103
104 When "Set" is clicked on, the three buttons below will appear.
105
106 === 8. Click "Import". ===
107
108 [[image:attach:media_1444248408970.png||align="center"]]
109
110 === 9. This will bring you to the Pre-Import Summary and Sample Mapping page. Continue your import as usual. ===
111
112 [[image:attach:media_1341506188765.png||align="center"]]
113
114 For detailed instructions on how to import a file into the ONEcount system, see the "How to Import a File" lesson.
115
116
117
118 {{id name="End ScreenSteps Content"/}}
119 {{/layout-cell}}
120
121 {{layout-cell}}
122 **Search all Documentation:**
123
124
125
126 {{livesearch/}}
127
128
129
130 **Search USER OPERATIONS Documentation:**
131
132
133
134 {{pagetreesearch rootPage="User Operations - Managing Your Data"/}}
135
136
137
138 {{expand title="More USER OPERATIONS Documentation"}}
139 (% style="margin-left: 30.0px;" %)
140 **Add Users
141 **
142
143 (% style="margin-left: 60.0px;" %)
144
145
146 (% style="margin-left: 60.0px;" %)
147 [[Preparing for Data Import>>doc:Getting Started - Preparing for Data Import (v12\.x)]]
148
149 (% style="margin-left: 60.0px;" %)
150 [[Pre-Import Checklist>>doc:Pre-Import Checklist (v12\.x)]]
151
152 (% style="margin-left: 60.0px;" %)
153 [[How to Import a File>>doc:Import - How to Import a File (v12\.x)]]
154
155 (% style="margin-left: 60.0px;" %)
156 [[How to Create an Import Mapping Template>>doc:Import - How to Create an Import Mapping Template (v12\.x)]]
157
158 (% style="margin-left: 60.0px;" %)
159
160
161 (% style="margin-left: 60.0px;" %)
162 [[Add Audience>>doc:Add Audience (v12\.x)]]
163
164 (% style="margin-left: 30.0px;" %)
165 **Batch Operations**
166
167 (% style="margin-left: 60.0px;" %)
168 [[Bulk Operation - How to Perform a Batch Delete>>doc:Bulk Operation - How to Perform a Batch Delete (v12\.x)]]
169
170 (% style="margin-left: 60.0px;" %)
171 [[Bulk Operation - How to Perform a Batch Product Change>>doc:Bulk Operation - How to Perform a Batch Product Change (v12\.x)]]
172
173 (% style="margin-left: 60.0px;" %)
174 [[Bulk Operation - How to Perform a Batch Status Change>>doc:Bulk Operation - How to Perform a Batch Status Change (v12\.x)]]
175
176 (% style="margin-left: 60.0px;" %)
177 [[Bulk Operation - How to Perform a Batch Suscribe>>doc:Bulk Operation - How to Perform a Batch Subscribe (v12\.x)]]
178
179 (% style="margin-left: 60.0px;" %)
180 [[Bulk Operation - How to Perform a Batch Unsubscribe>>doc:Bulk Operation - How to Perform a Batch UnsubscribeKill (v12\.x)]]
181
182 (% style="margin-left: 60.0px;" %)
183 [[Bulk Operation - How to Perform a Merge of Duplicate Users>>doc:Bulk Operation - How to Perform a Bulk Merge of Duplicate Users (v12\.x)]]
184
185 (% style="margin-left: 30.0px;" %)
186 **Target Audience Segments**
187
188 (% style="margin-left: 60.0px;" %)
189 (% style="color: rgb(0,51,102);" %) [[ Target Engine >>doc:Utilities - Target Engine (v12\.x)]]__
190 __
191
192
193
194
195 {{/expand}}
196 {{/layout-cell}}
197 {{/layout-section}}
198 {{/layout}}