Customizing Loading
You can customize loading by either changing the data in the data files provided in the Windchill\loadFiles directory or by adding new methods to load locally customized classes.
Changing the data in the files loads local data into existing classes. For more information, see Modifying Data Files.
About the csvmapfile.txt File
The csvmapfile.txt file exists as an input to conversion utilities such as CSV2XML.
For more information about the CSV2XML utility, see Using the CSV2XML Utility and Validating the XML Format.
The csvmapfile.txt file is used to map the specific method call and the data fields to a line in the data file. Following is sample code from the map file:
#class,method,real method~attribute 1~attribute 2~….~attribute n
General~create~wt.doc.LoadDoc.createGeneral~user~name~title
~number~type~description~department~saveIn~path~format
~project~domain~lifecycletemplate
General~create~wt.doc.LoadDoc.createGeneral~user~name~title
~number~type~description~department~saveIn~path~format
~project~domain~lifecycletemplate
 |
The preceding is only one line, but wrapped here for readability. Continuation of lines is not accepted.
|
The first two fields, class and method, are the keys to the map file. Two keys are given to each line in the map file to allow multiple definitions for a given actual class in Windchill. This allows alternate names for one class, multiple functions for one class, or different input fields.
Both class and method are arbitrary strings. The class value matches the class in the data file. It is used only to match the map and data files so it can be any string as long as the same string is used in both. The method value matches the method variable passed either on the command line or as a parameter to doFileLoad.
The real method field is the fully qualified method name that load calls through introspection with the values from the data file. The attributes 1 through n match the text used in the real method. The order in the map file is used to retrieve the values from the data file.
The following are possible scenarios for modifying the csvmapfile.txt file:
• Data in the data file has the data fields in a different order. Edit the csvmapfile.txt to make the order the same as the data file. See Modifying Data Files.
• You want to add a new site class. Create a new line in the map file with a new class, real method, and new attribute list. See Creating New Methods for Loading.
Following is an example of a line added to the csvmapfile.txt file for a new class:
NewClass~create~wt.doc.LoadDoc.createNewClass~user~name~title
~number~type~description~department~my_new_attribute~saveIn
~path~format~project~domain~lifecycletemplate
~number~type~description~department~my_new_attribute~saveIn
~path~format~project~domain~lifecycletemplate
|
|
Do not put blank lines in the map file. One or more empty lines between entries causes the load to fail.
|