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

version	line-number	content
4.1	1	{{layout}}
	2	{{layout-section ac:type="two_right_sidebar"}}
	3	{{layout-cell}}
3.1	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
5.1	11	=== OPEN THE "IMPORT" WINDOW ===
3.1	12
5.1	13	Select User Operations from the Main Menu.
3.1	14
	15	[[image:attach:media_1444247502716.png\|\|align="center"]]
	16
5.1	17	Click on "Import".
3.1	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
5.1	25	=== LOCATE AND SELECT A MAPPING TEMPLATE ===
3.1	26
5.1	27	~1. In the Import window choose your import file using the "Browse" button (1), and select "Upload File" (2).
3.1	28
	29	[[image:attach:media_1444247620819.png\|\|align="center"]]
	30
5.1	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.**//
3.1	33
5.1	34	//**
	35	**//
3.1	36
5.1	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
3.1	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
5.1	43	{{tip}}
3.1	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.
5.1	46	{{/tip}}
3.1	47
5.1	48	**
	49	**
3.1	50
5.1	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
3.1	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
5.1	67
3.1	68
5.1	69	4. Active Question Headers and Active CSV Headers will be automatically populated based on the import mapping template.
	70
3.1	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
5.1	97
3.1	98
5.1	99	5. Select fields to check duplicates against.
	100
3.1	101	[[image:attach:media_1406493696569.png\|\|align="center"]]
	102
5.1	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}}
3.1	106
5.1	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}}
3.1	110
5.1	111	**
	112	**
3.1	113
5.1	114	6. Set Request Date field, Expiration Date field, and Media Files fields (all optional).
	115
3.1	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
5.1	120	7. Review mapping and selections, then click "Set" at the bottom of the page.
3.1	121
	122	[[image:attach:media_1444248109116.png\|\|align="center"]]
	123
	124	When "Set" is clicked on, the three buttons below will appear.
5.1	125	\\
3.1	126
5.1	127	8. Click "Import".
3.1	128
	129	[[image:attach:media_1444248408970.png\|\|align="center"]]
	130
5.1	131	**
	132	**
3.1	133
5.1	134	9. This will bring you to the Pre-Import Summary and Sample Mapping page. Continue your import as usual.
	135
3.1	136	[[image:attach:media_1341506188765.png\|\|align="center"]]
	137
5.1	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.
3.1	139
	140
	141
	142	{{id name="End ScreenSteps Content"/}}
4.1	143	{{/layout-cell}}
	144
	145	{{layout-cell}}
5.1	146	{{panel title="Search All Documentation:"}}
4.1	147
	148
	149	{{livesearch/}}
5.1	150	{{/panel}}
4.1	151
5.1	152	{{panel title="Search USER OPERATIONS Documentation:"}}
4.1	153
	154
5.1	155	{{pagetreesearch rootPage="User Operations - Managing Your Data"/}}
	156	{{/panel}}
4.1	157
5.1	158	{{panel title="On this page:"}}
4.1	159
	160
5.1	161	{{toc/}}
	162	{{/panel}}
4.1	163
5.1	164	{{panel title="More USER OPERATIONS Documentation"}}
	165	{{expand}}
	166	**Add Users
4.1	167	**
	168
	169	(% style="margin-left: 60.0px;" %)
	170
	171
	172	(% style="margin-left: 60.0px;" %)
5.1	173	[[Preparing for Data Import>>doc:Getting Started - Preparing for Data Import]]
4.1	174
	175	(% style="margin-left: 60.0px;" %)
5.1	176	[[Pre-Import Checklist>>doc:Pre-Import Checklist]]
4.1	177
	178	(% style="margin-left: 60.0px;" %)
	179
5.1	180
4.1	181	(% style="margin-left: 60.0px;" %)
5.1	182	[[How to Create an Import Mapping Template>>doc:Import - How to Create an Import Mapping Template]]
4.1	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;" %)
5.1	215	(% style="color: rgb(0,51,102);" %) [[ Target Engine >>doc:Utilities - Target Engine]]__
4.1	216	__
	217
	218
	219
	220
	221	{{/expand}}
5.1	222	{{/panel}}
	223
	224
	225
	226
	227
	228
	229
	230
	231
	232
	233
	234
4.1	235	{{/layout-cell}}
	236	{{/layout-section}}
	237	{{/layout}}