Adding other information to the sample table
You use the Additional Fields tab to view or change the default mappings for fields in your participants text file that do not correspond to the required columns in the sample table. Participants automatically maps these fields to additional columns, and sets the column name to be the same as the field name. The upload process will subsequently copy the value of that field to that column.
For example, for telephone interviewing projects, you might want to upload the participant’s name and address. In addition, for projects whose participants speak different languages, you might want to upload the participant’s language so that you can use interviewer qualifications to match interviewers to participants. For more information about interviewer qualifications, see
Adding properties to user property groups.
The Additional Fields tab lists all fields in the file you are uploading. However, you can change the settings only for those fields that are not already mapped to required columns.
Note If you want to use the “Call Outcome by Segment” and “Calls by Segment” reports in the Interviewing activity to display data about segments (that is, groups or categories of your choice), you must upload segment information from your text file into a column called “Segment” in the sample table. For more information about segments, see
About segments.
Fields
Original field name
The name of a field in the participants text file.
Upload
Whether to upload the field into a column in the sample table.
New field name
The name for the corresponding column in the sample table. If the field has already been mapped to a required column, this is noted here and you are not able to change the field’s settings on this tab.
Default
The default value for this column if the record in the text file does not contain a corresponding value for this column.
Type
The data type for this column. Based on the data in the text file, Participants suggests the best data type to use.
Length
The maximum size of this column. This can be set for some data types only.
Field names that cannot be used
Microsoft SQL Server reserved words cannot be used as field names. The current list of SQL Server reserved words is as follows:
ADD, EXTERNAL, PROCEDURE, ALL, FETCH, PUBLIC, ALTER, FILE, RAISERROR, AND, FILLFACTOR, READ, ANY, FOR, READTEXT, AS, FOREIGN, RECONFIGURE, ASC, FREETEXT, REFERENCES, AUTHORIZATION, FREETEXTTABLE, REPLICATION, BACKUP, FROM, RESTORE, BEGIN, FULL, RESTRICT, BETWEEN, FUNCTION, RETURN, BREAK, GOTO, REVERT, BROWSE, GRANT, REVOKE, BULK, GROUP, RIGHT, BY, HAVING, ROLLBACK, CASCADE, HOLDLOCK, ROWCOUNT, CASE, IDENTITY, ROWGUIDCOL, CHECK, IDENTITY_INSERT, RULE, CHECKPOINT, IDENTITYCOL, SAVE, CLOSE, IF, SCHEMA, CLUSTERED, IN, SECURITYAUDIT, COALESCE, INDEX, SELECT, COLLATE, INNER, SEMANTICKEYPHRASETABLE, COLUMN, INSERT, SEMANTICSIMILARITYDETAILSTABLE, COMMIT, INTERSECT, SEMANTICSIMILARITYTABLE, COMPUTE, INTO, SESSION_USER, CONSTRAINT, IS, SET, CONTAINS, JOIN, SETUSER, CONTAINSTABLE, KEY, SHUTDOWN, CONTINUE, KILL, SOME, CONVERT, LEFT, STATISTICS, CREATE, LIKE, SYSTEM_USER, CROSS, LINENO, TABLE, CURRENT, LOAD, TABLESAMPLE, CURRENT_DATE, MERGE, TEXTSIZE, CURRENT_TIME, NATIONAL, THEN, CURRENT_TIMESTAMP, NOCHECK, TO, CURRENT_USER, NONCLUSTERED, TOP, CURSOR, NOT, TRAN, DATABASE, NULL, TRANSACTION, DBCC, NULLIF, TRIGGER, DEALLOCATE, OF, TRUNCATE, DECLARE, OFF, TRY_CONVERT, DEFAULT, OFFSETS, TSEQUAL, DELETE, ON, UNION, DENY, OPEN, UNIQUE, DESC, OPENDATASOURCE, UNPIVOT, DISK, OPENQUERY, UPDATE, DISTINCT, OPENROWSET, UPDATETEXT, DISTRIBUTED, OPENXML, USE, DOUBLE, OPTION, USER, DROP, OR, VALUES, DUMP, ORDER, VARYING, ELSE, OUTER, VIEW, END, OVER, WAITFOR, ERRLVL, PERCENT, WHEN, ESCAPE, PIVOT, WHERE, EXCEPT, PLAN, WHILE, EXEC, PRECISION, WITH, EXECUTE, PRIMARY, WITHIN, GROUP, EXISTS, PRINT, WRITETEXT, EXIT, PROC
Changing the mapping of a field to an additional column
1 Select the Additional Fields tab.
2 Click the Edit symbol (the pencil) on the right of the field whose mapping you want to change. Choose only a field that has not been mapped to a required column.
To change the mapping for a field that has been mapped to a required column, use the Required Fields tab (see
Mapping fields to required columns in the sample table).
3 If you do not want Participants to load this field into the sample table, clear the Upload check box.
4 If you do not want Participants to make the column name in the sample table the same as the field name in the text file, change the value of “New field name”.
Note Column names in the sample table must comply with the rules for SQL column names. In general, a column name must start with a letter or an underscore and be followed by any combination of letters, numbers, underscores, and the @, $, or # characters. For more information, use the search function in the UNICOM Intelligence Developer Documentation Library documentation to search for the text ‘Rules for Regular Identifiers’ and in the search results open the topic with that title.
5 If you do not want Participants to set the value of this column to Null when the record in the text file does not contain a corresponding value for this column, enter the new default value in “Default”.
The default value must be a valid for the data type of the column as specified in “Type”.
6 In Type, choose the data type that matches the type of data the field contains.
This column shows the UNICOM Intelligence Data Model data types. When Participants creates the columns in the database, it converts these data types into the data types used by your database application. Most database applications have a wider range of data types than the UNICOM Intelligence Data Model, so Participants chooses the database data type that best matches the data that it finds in the text field. For example, the UNICOM Intelligence Data Model classifies all whole numbers (integers) as Long, while an SQL database will classify them as either int or smallint depending on the length of the number. If it is important that the columns are created with particular data types in the database, you can examine and change the columns’ definitions using your database application’s tools once the participant records have been loaded.
7 In Length, enter the maximum size of this column in the sample table.
8 Click the Update symbol (the blue check mark) to save the change, or the Cancel symbol (the red cross) to cancel it.
See also