Wiki source code of Import - How to Use an Import Mapping Template (v12.x)
Version 5.1 by melanie@one-count_com on 2016/12/14 14:59
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 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 | === OPEN 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 | === LOCATE AND SELECT 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.) //** | ||
| 32 | The list has not been imported at this point but uploaded to the system in preparation for import.**// | ||
| 33 | |||
| 34 | //** | ||
| 35 | **// | ||
| 36 | |||
| 37 | **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..** | ||
| 38 | |||
| 39 | [[image:attach:media_1444247703023.png||align="center"]] | ||
| 40 | |||
| 41 | 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. | ||
| 42 | |||
| 43 | {{tip}} | ||
| 44 | 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. | ||
| 45 | Below the Product List, you will see a list of any existing Import Mappings (templates), if any. | ||
| 46 | {{/tip}} | ||
| 47 | |||
| 48 | ** | ||
| 49 | ** | ||
| 50 | |||
| 51 | **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".** | ||
| 52 | |||
| 53 | [[image:attach:media_1444247877482.png||align="center"]] | ||
| 54 | |||
| 55 | 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.) | ||
| 56 | |||
| 57 | 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. | ||
| 58 | |||
| 59 | [[image:attach:media_1358441601547.png||align="center"]] | ||
| 60 | |||
| 61 | 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. | ||
| 62 | |||
| 63 | If you wish to ignore those fields – or add any of them after selecting the template – continue with the mapping, click OK. | ||
| 64 | |||
| 65 | [[image:attach:media_1406491575447.png||align="center"]] | ||
| 66 | |||
| 67 | |||
| 68 | |||
| 69 | **4. Active Question Headers and Active CSV Headers will be automatically populated based on the import mapping template.** | ||
| 70 | |||
| 71 | [[image:attach:media_1358441791837.png||align="center"]] | ||
| 72 | |||
| 73 | 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.) | ||
| 74 | |||
| 75 | * If you add/remove fields to map and don't wish to save as a new template, continue with steps 5-7 below. | ||
| 76 | * 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. | ||
| 77 | |||
| 78 | [[image:attach:media_1406492917169.png||align="center"]] | ||
| 79 | |||
| 80 | To map additional fields: | ||
| 81 | |||
| 82 | * 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.) | ||
| 83 | * 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.) | ||
| 84 | |||
| 85 | To move more than one field at a time into the "Active Header" box, select multiple fields then click on "Activate". | ||
| 86 | |||
| 87 | 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. | ||
| 88 | |||
| 89 | 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.) | ||
| 90 | |||
| 91 | 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". | ||
| 92 | |||
| 93 | (% 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. | ||
| 94 | |||
| 95 | More detail on importing a .csv file and mapping headers can be found in the "How to Import a File" lesson. | ||
| 96 | |||
| 97 | |||
| 98 | |||
| 99 | **5. Select fields to check duplicates against.** | ||
| 100 | |||
| 101 | [[image:attach:media_1406493696569.png||align="center"]] | ||
| 102 | |||
| 103 | {{error}} | ||
| 104 | (% style="color: rgb(0,0,0);" %)**ALWAYS BE SURE TO CHECK FOR DUPLICATES. IF YOU DON'T, DUPLICATE RECORDS MAY BE ADDED TO THE ONECOUNT DATABASE.** | ||
| 105 | {{/error}} | ||
| 106 | |||
| 107 | {{error}} | ||
| 108 | **When saving a mapping template, only the Active Headers will be saved. Fields to check for duplicates WILL NOT be saved.** | ||
| 109 | {{/error}} | ||
| 110 | |||
| 111 | ** | ||
| 112 | ** | ||
| 113 | |||
| 114 | **6. Set Request Date field, Expiration Date field, and Media Files fields (all optional).** | ||
| 115 | |||
| 116 | [[image:attach:media_1444248236424.png||align="center"]] | ||
| 117 | |||
| 118 | 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). | ||
| 119 | |||
| 120 | **7. Review mapping and selections, then click "Set" at the bottom of the page.** | ||
| 121 | |||
| 122 | [[image:attach:media_1444248109116.png||align="center"]] | ||
| 123 | |||
| 124 | When "Set" is clicked on, the three buttons below will appear. | ||
| 125 | \\ | ||
| 126 | |||
| 127 | **8. Click "Import".** | ||
| 128 | |||
| 129 | [[image:attach:media_1444248408970.png||align="center"]] | ||
| 130 | |||
| 131 | ** | ||
| 132 | ** | ||
| 133 | |||
| 134 | **9. This will bring you to the Pre-Import Summary and Sample Mapping page. Continue your import as usual.** | ||
| 135 | |||
| 136 | [[image:attach:media_1341506188765.png||align="center"]] | ||
| 137 | |||
| 138 | For detailed instructions on how to import a file into the ONEcount system, see the "[[How to Import a File">>doc:Import - How to Import a File]] lesson. | ||
| 139 | |||
| 140 | |||
| 141 | |||
| 142 | {{id name="End ScreenSteps Content"/}} | ||
| 143 | {{/layout-cell}} | ||
| 144 | |||
| 145 | {{layout-cell}} | ||
| 146 | {{panel title="Search All Documentation:"}} | ||
| 147 | |||
| 148 | |||
| 149 | {{livesearch/}} | ||
| 150 | {{/panel}} | ||
| 151 | |||
| 152 | {{panel title="Search USER OPERATIONS Documentation:"}} | ||
| 153 | |||
| 154 | |||
| 155 | {{pagetreesearch rootPage="User Operations - Managing Your Data"/}} | ||
| 156 | {{/panel}} | ||
| 157 | |||
| 158 | {{panel title="On this page:"}} | ||
| 159 | |||
| 160 | |||
| 161 | {{toc/}} | ||
| 162 | {{/panel}} | ||
| 163 | |||
| 164 | {{panel title="More USER OPERATIONS Documentation"}} | ||
| 165 | {{expand}} | ||
| 166 | **Add Users | ||
| 167 | ** | ||
| 168 | |||
| 169 | (% style="margin-left: 60.0px;" %) | ||
| 170 | |||
| 171 | |||
| 172 | (% style="margin-left: 60.0px;" %) | ||
| 173 | [[Preparing for Data Import>>doc:Getting Started - Preparing for Data Import]] | ||
| 174 | |||
| 175 | (% style="margin-left: 60.0px;" %) | ||
| 176 | [[Pre-Import Checklist>>doc:Pre-Import Checklist]] | ||
| 177 | |||
| 178 | (% style="margin-left: 60.0px;" %) | ||
| 179 | |||
| 180 | |||
| 181 | (% style="margin-left: 60.0px;" %) | ||
| 182 | [[How to Create an Import Mapping Template>>doc:Import - How to Create an Import Mapping Template]] | ||
| 183 | |||
| 184 | (% style="margin-left: 60.0px;" %) | ||
| 185 | |||
| 186 | |||
| 187 | (% style="margin-left: 60.0px;" %) | ||
| 188 | [[Add Audience>>doc:Add Audience (v12\.x)]] | ||
| 189 | |||
| 190 | (% style="margin-left: 30.0px;" %) | ||
| 191 | **Batch Operations** | ||
| 192 | |||
| 193 | (% style="margin-left: 60.0px;" %) | ||
| 194 | [[Bulk Operation - How to Perform a Batch Delete>>doc:Bulk Operation - How to Perform a Batch Delete (v12\.x)]] | ||
| 195 | |||
| 196 | (% style="margin-left: 60.0px;" %) | ||
| 197 | [[Bulk Operation - How to Perform a Batch Product Change>>doc:Bulk Operation - How to Perform a Batch Product Change (v12\.x)]] | ||
| 198 | |||
| 199 | (% style="margin-left: 60.0px;" %) | ||
| 200 | [[Bulk Operation - How to Perform a Batch Status Change>>doc:Bulk Operation - How to Perform a Batch Status Change (v12\.x)]] | ||
| 201 | |||
| 202 | (% style="margin-left: 60.0px;" %) | ||
| 203 | [[Bulk Operation - How to Perform a Batch Suscribe>>doc:Bulk Operation - How to Perform a Batch Subscribe (v12\.x)]] | ||
| 204 | |||
| 205 | (% style="margin-left: 60.0px;" %) | ||
| 206 | [[Bulk Operation - How to Perform a Batch Unsubscribe>>doc:Bulk Operation - How to Perform a Batch UnsubscribeKill (v12\.x)]] | ||
| 207 | |||
| 208 | (% style="margin-left: 60.0px;" %) | ||
| 209 | [[Bulk Operation - How to Perform a Merge of Duplicate Users>>doc:Bulk Operation - How to Perform a Bulk Merge of Duplicate Users (v12\.x)]] | ||
| 210 | |||
| 211 | (% style="margin-left: 30.0px;" %) | ||
| 212 | **Target Audience Segments** | ||
| 213 | |||
| 214 | (% style="margin-left: 60.0px;" %) | ||
| 215 | (% style="color: rgb(0,51,102);" %) [[ Target Engine >>doc:Utilities - Target Engine]]__ | ||
| 216 | __ | ||
| 217 | |||
| 218 | |||
| 219 | |||
| 220 | |||
| 221 | {{/expand}} | ||
| 222 | {{/panel}} | ||
| 223 | |||
| 224 | |||
| 225 | |||
| 226 | |||
| 227 | |||
| 228 | |||
| 229 | |||
| 230 | |||
| 231 | |||
| 232 | |||
| 233 | |||
| 234 | |||
| 235 | {{/layout-cell}} | ||
| 236 | {{/layout-section}} | ||
| 237 | {{/layout}} |