This section describes how to use the copy map utility, including copying from map to map, map to directory, confirming the copy command, and viewing the copy map log.
Copying a map
In ECMap’s main menu, select Utilities > Copy Map. The Copy Map window displays.
On the Copy Map window, the program populates the Map Name and Project Name text boxes with the names of the currently selected map and the project in which it is stored.
You can accept the project and map names entered by the program or you can change them.
To accept the current settings click Run.
To change the project and its associated map do the following
Click the up arrow to the right of the Project Name text box. The Select Project and Map window displays.
Double-click the appropriate project and its associated map. The Select Project and Map window closes and populates the Project Name and Map Name text boxes in the Copy Map window.
In the Trade Partner Option group, choose one of the following:
Click Include Trade Partner Tables to copy all map-related files and databases, including trading partner tables (tp, tradstat, and wixset).
Click Exclude Trade Partner Tables to copy map-related files and databases, excluding trading partner tables.
You usually include the trading partner tables when you copy a map, but you may want to exclude them for various reasons. For example, if you are copying a map to use in a different project, that project might use an entirely different set of trading partner tables.
In the Map Copy Direction group, choose from one of four options and then click Run.
See the following procedures for information on choosing map direction:
See “Using the This Map to Map” to copy the map specified in the Project Name and Map Name text boxes at the top of the window to a different map in the same project or to a map in a different project
See “Using the This Map from Map option” to copy a different map in the same project or a map in a different project to the map specified in the Project Name and Map Name at the top of the window.
See “Using the This Map to Directory option” to copy the map specified in the Project Name and Map Name at the top of the window to a specified directory. You usually choose this option when you are creating a backup or sending a map to someone.
See “Using the This Map from Directory option” to copy from the map specified in the Project Name and Map Name at the top of the window to a different map in the same project or to a map in a different project.
You usually choose this option when you are restoring
from a backup or receiving a map from someone.
Using the This Map to Map
This option, which is the default, copies the map specified in the Project Name and Map Name text boxes at the top of the window to a different map in the same project or to a map in a different project.
Clicking this option activates a group in this window called Copy Map to. This is where you specify your destination.
In the Copy Map To group, type a name in the Project Name text box. If you want your map copy to go into the current project, simply accept the default.
In the Map Name text box, either type a new name or click the up arrow to search for the names in the Select Project and Map window.
On the Select Project and Map window, double-click the project and map to which you want to copy the map and select OK. When you return to the Copy Map window, you will notice that ECMap automatically populated the Project Name and Map Name text boxes with your choice.
Using the This Map from
Map option
If you choose to copy This Map from Map, the map you specified in the Project Name and Map Name text boxes at the top of the window is copied from another map, which you specify in the Copy Map From group.
In the Copy Map From group, type the Project Name and Map Name from which you want to copy the map or select the up arrow next to the Map Name text box to search for the names. The Select Project and Map window displays.
On the Select Project and Map window, double-click the project and map from which you want to copy the map and click OK. When you return to the Copy Map window, you will notice that ECMap automatically populated the Project Name and Map Name text boxes with your choice.
Using the This Map to Directory
option
If you choose to copy This Map to Directory, the map you in the Project Name and Map Name text boxes at the top of the window is copied to a directory, which you specify in the Copy Map To group.
In the Copy Map To group, type the name of the directory to which you are copying the map in the Directory text box. Alternatively, click Browse to navigate to the directory. The Select a Directory window displays.
On the Select a Directory window, double-click the directory to which you will copy the map and click OK. When you return to the Copy Map window, you will notice that ECMap automatically populated the Copy Map To text box with your choice.
If the program finds existing map files with the same names in the directory you select, the Databases Already Exist window displays.
To stop, click Cancel to return to the Copy Map window.
To proceed, click OK and ECMap asks you to confirm that you want to overwrite the existing databases. If you click Yes, ECMap copies the map files to the directory, overwriting the existing files.
If ECMap finds no existing files, a confirmation dialog displays.
Click No to return to the Copy Map window.
Click Yes and ECMap program copies the map files to the directory.
Using the This Map from
Directory option
If you choose to copy This Map from Directory, the map you specified in the text boxes at the top of the window is copied from a directory that you specify in the text boxes on the top right of the window. The Copy Map window displays as shown below:
In the Copy Map From group, type the name of the directory from which you are copying the map in the Directory text box. Alternatively, click Browse to navigate to the directory. The Select a Directory window displays.
On the Select a Directory window, double-click the directory from which you will copy the map and click OK. When you return to the Copy Map window, you will notice that ECMap automatically populated the Copy Map From text box with your choice.
When you choose to copy This Map from Directory, you have another option. The Create This Map Definition from Directory Copy button lets you automatically create a map definition, which is important if you share maps with other developers.
When using this button, be sure to identify one default
directory by selecting Change All on the Map Directories tab of
the New Map Definition window. This ensures that the map definition
files are all stored together.
Confirming the copy command
Now that you have set all the options, you are ready to create the copy of your map.
Click Run. The program displays a Confirm dialog box that restates the details of the copy map option you have chosen.
The program asks for your confirmation before the map is actually copied.
If you do not want to proceed or you want to change something, click No to return to the Copy Map window.
If you want to copy the map, click Yes. The map is copied and you return to the main ECMap window.
Viewing the copy map log
If you want to see a listing of the actions that took place during the copy process, click View Log. The View Log window displays.
The information on this window lists each of the databases that were copied. If any problems were encountered, it issues warnings and errors. You should look at all warnings, but they do not necessarily prevent the copied map from running correctly. You must look at errors since they indicate a condition that would prevent the map from running.
