ePublisher AutoMap User Interface

ePublisher AutoMap : ePublisher AutoMap User Interface

ePublisher AutoMap User Interface

This section describes how to start and work with the ePublisher AutoMap user interface. It contains the following sections:

Starting WebWorks ePublisher AutoMap

ePublisher AutoMap features an easy-to-use Graphical User Interface (GUI) that allows you to effortlessly set up ePublisher AutoMap conversions of your documents to run either immediately or at any time.

This section gives you the basic information you need in order to start using ePublisher AutoMap including:

Opening ePublisher AutoMap

The ePublisher AutoMap application can be started in the following ways:

Choose ePublisher AutoMap from the Start menu.

Choose the ePublisher AutoMap icon from the Windows Quick Launch bar.

Choose the ePublisher AutoMap icon from the Windows Desktop

The ePublisher AutoMap icons will only be available in the Windows Quick Launch bar and Windows Desktop if you chose to install them during installation. By default, these options were enabled in the installer.

To open ePublisher AutoMap:

Choose Start → All Programs → WebWorks → ePublisher AutoMap → WebWorks ePublisher AutoMap

When you open ePublisher AutoMap, you will be presented with the ePublisher AutoMap main window:

Configuring license keys

During installation, it was possible to enter license keys for each adapter including Adobe FrameMaker and Microsoft Word. It is possible to manage your installed license keys directly in the ePublisher AutoMap user interface.

ePublisher AutoMap no longer requires a separate License Manager application or server.

To add a license key:

1.	Choose Help → License Keys…

2.	Enter or paste a new license key into the Key field.

3.	Click the Add Key button.

4.	Repeat as necessary for other keys.

5.	Click OK to save your changes.

To delete a license key:

1.	Choose Help → License Keys…

2.	Select the existing license key from the list.

3.	Click the Delete Key button.

4.	Repeat for each key you want to delete.

5.	Click OK to save your changes.

Overview of the ePublisher AutoMap user interface

ePublisher AutoMap includes an updated user interface, making set up, and scheduling jobs easier than ever before.

The ePublisher AutoMap window gives you control of all aspects of your ePublisher AutoMap jobs. With ePublisher AutoMap, you can create, run, and modify your jobs quickly and easily. You can also see the status of each job, including when it last ran and when it will run again.

This section describes all of the controls in ePublisher AutoMap and includes the following sections:

ePublisher AutoMap menus

ePublisher AutoMap contains four menus for creating, editing, managing, and scheduling ePublisher AutoMap jobs. The following menu items will be discussed in more detail:

Depending on ePublisher AutoMap status, some menu items may be disabled. Only operations that are possible at a given time will be enabled.

File menu

Icon	Menu item	Description
	New Job	Creates a new job.
	Exit	Exits the ePublisher AutoMap application.

Edit menu

Icon	Menu item	Description
	Copy	Copy contents to the system clipboard.
	Paste	Paste contents from the system clipboard.
	Preferences...	Manage application preferences.

Job menu

Icon	Menu item	Description
	Run	Run the selected job(s).
	Stop	Cancel the selected job.
	Edit	Edit the selected job.
	Duplicate	Duplicate the selected job.
	Rename	Rename the selected job.
	Delete	Delete the selected job(s).
	Schedule Job	Schedule the selected job in the Windows Scheduler.
	Suspend Job Schedule	Suspend the selected job in the Windows Scheduler.
	Resume Job Schedule	Resume the selected job in the Windows Scheduler.
	View Log	Display the last log for the selected job in Windows Notepad.
	Explore Job Location	Opens the folder containing the selected job in the Windows file explorer.
	Explore Output for Target	Opens the folder containing the selected targets output in the Windows file explorer.
	Explore Jobs Folder	Opens the ePublisher AutoMap jobs folder as specified in the application preferences.

Help menu

Menu item	Description
License Keys…	Opens the license key configuration manager.
Contents	Displays the ePublisher AutoMap online user guide table of contents.
Index	Displays the ePublisher AutoMap online user guide index.
Search	Displays the ePublisher AutoMap online user guide search.
WebWorks.com	Go to the main WebWorks home page.
Technical Support	Go to the main WebWorks Support home page.
Update Center	Go to the WebWorks Update Center home page.
About AutoMap…	Displays the ePublisher AutoMap version information.

ePublisher AutoMap contextual menus

ePublisher AutoMap also contains a contextual menu available by selecting a job or multiple jobs and right clicking. This menu contains the same options as the Job menu making it easier to select options when working with jobs.

Depending on the type and number of jobs selected, some contextual menu items may be disabled. Only operations that are possible for the current selection will be enabled.

Using the contextual menu

1.	Select the job(s) desired.

2.	Click the right mouse button.

3.	Select the job operation from the contextual menu.

ePublisher AutoMap toolbar

ePublisher AutoMap gives you quick access to most of the menu items via the tool bar. The following table describes each of the toolbar buttons.

Depending on the type and number of jobs selected, some toolbar buttons may be disabled. Only operations that are possible for the current selection will be enabled.

ePublisher AutoMap toolbar buttons

Tool bar button	Description
	Create a new job.
	Open the selected job for editing.
	Delete the selected job(s).
	Schedule the selected job.
	Open the log file for the selected job.
	Duplicate the selected job.
	Run the selected job.
	Cancel the selected job.
	Open the Preferences dialog.

ePublisher AutoMap status information

ePublisher AutoMap contains several columns that give you information about the status of your jobs. The following table describes each of these columns:

Column Name	Description
Name	Displays the name of each job.
Last Result	Displays the result of the last conversion. OK = Job completed successfully. WARNINGS = Job completed with warnings. ERROR = Job encountered general errors. DEPLOYMENT ERROR = The job could not deploy to the output location specified. LICENSE ERROR = Job attempted to run but could not locate a valid license key. ABORTED = The job was aborted by the user.
Status	Displays the current status of the job. Running = Job is currently running. Ready = Job is not currently running.
Last Run	Displays the date and time of the last conversion. “Never” means that the job has never converted.
Next Run	Displays the date and time the job will run next. “Never” means the job is not scheduled to run a conversion.
Scheduled	Displays whether the job is scheduled. Yes = Job is scheduled. No = Job is not scheduled. Suspended = Job is scheduled but currently suspended.

Setting application preferences

The Preferences dialog box lets you set application preferences. Application preferences are settings which affect the behavior globally for the entire application.

The application preferences that you can set from this panel include:

To open the application preferences:

1.	Select Edit → Preferences… or choose the Preferences… toolbar button.

General Preferences

The following sections describe each setting in the General tab:

Setting the Job Folder location

The Job Folder field specifies the directory path where ePublisher AutoMap stores its job information. The Job folder contains the log file and a job file.

The log file contains information concerning the last conversion. This is a plain text file (.txt) and can be viewed with any text editor. The job file is in a proprietary XML format and includes all information describing the job. The job filename will be the same as the job with a .waj (WebWorks AutoMap Job) extension.

The default Job Folder is located at:

\Documents and Settings\username\My Documents\WebWorks Automap\Jobs

username represents the login name of the current user and not the actual value as written.

ePublisher AutoMap creates the job file from information entered through the graphical user interface and utilizes this file in generating the online output. Do not edit the job file directly! Doing so can make the file unreadable by ePublisher AutoMap.

The log file will only exist after the job has run at least one conversion.

To set the default job folder:

1.	Open the application Preferences.

2.	If necessary, choose the General preferences tab.

3.	In the Job Folder: field, type the path to the directory or network share where you want ePublisher AutoMap to store job information, or click Browse and navigate to the directory or network share.

4.	Click OK to save your settings.

Setting the Staging Folder location

The Staging Folder field specifies the default directory path where jobs store information necessary for converting the job. This includes the automatically generated ePublisher project, intermediate data files, and the output files. In essence, the staging folder is a working directory for processing the job.

The output of your project will also be written to the target output destination specified when the project was created.

The default Staging Folder is located at:

\Documents and Settings\username\My Documents\WebWorks Automap\Staging

username represents the login name of the current user and not the actual value as written.

ePublisher AutoMap creates the staging folder contents from information entered through the graphical user interface and utilizes this information in generating the online output. Do not edit these files directly! Doing so may corrupt the ePublisher AutoMap job.

To set the default staging folder:

1.	Open the application Preferences.

2.	If necessary, choose the General preferences tab.

3.	In the Staging Folder field, type the path to the directory or network share where you want ePublisher AutoMap to store the Job projects and output created during your conversions, or click Browse and navigate to the directory or network share.

4.	Click OK to save your settings.

Setting the User Formats Folder location

The User Formats Folder field specifies the default directory path that ePublisher AutoMap searches for custom user formats.

The default User Formats Folder is located at:

C:\Documents and Settings\username\My Documents\ePublisher Pro User Formats

username represents the login name of the current user and not the actual value as written.

To set the default user formats directory:

1.	Open the application Preferences.

2.	If necessary, choose the General preferences tab.

3.	In the User Formats Folder field, type the path to the directory or network share where you want ePublisher AutoMap to find the custom user formats you want to use for creating jobs, or click Browse and navigate to the directory or network share.

4.	Click OK to save your settings.

Automatic scanning for conditions, media types, and variables

The Always scan for variables and conditions checkbox specifies whether ePublisher AutoMap should automatically scan for updated conditions and variables when panels displaying these values are presented.

By default, ePublisher AutoMap does not automatically scan for conditions and variables. To manually scan your documents for these values, click the Scan Documents button in the corresponding panels. The initial setting is disabled to prevent time wasted scanning when conditions or variables may not have changed since last opening the conditions or variables panels.

If you prefer that these panels always display updated condition and variable values, you may enable this setting. Depending on the number and size of files included in the job enabling this setting could take up to several minutes to complete the scan whenever presenting the conditions and variables panels.

To set automatic scanning:

1.	Open the application Preferences.

2.	If necessary, choose the General preferences tab.

3.	Select the Always scan for variables and conditions checkbox.

4.	Click OK to save your settings.

Keeping/deleting temporary files

The Delete temporary files after generating checkbox tells ePublisher AutoMap whether it should retain or clean up files created in the Staging folder.

By default, this option is disabled and should be enabled only as a means for examining the actual project and intermediate files created and used during the conversion process. If you do not wish to examine these files, then you can disable this option and reduce the amount of disk space consumed.

To delete temporary files:

1.	Open the application Preferences.

2.	If necessary, choose the General preferences tab.

3.	Enable the Delete temporary files after generating checkbox.

4.	Click OK to save your settings.

File Mappings

ePublisher introduced the concept of file mappings to allow mapping a file through its extension to a source document adapter. This was done for several reasons including:

Determine which source application should process a file that can be handled by multiple source applications. For example, text files with a .txt extension can be processed with both Adobe FrameMaker and Microsoft Word. The File Mappings panel allows you to choose which application to use in cases where multiple applications can be used.

Use custom or proprietary file extensions. You may give your Adobe FrameMaker or Microsoft Word source file a non-standard file extension. For example, instead of using .doc for Microsoft Word files you may wish to use a more meaningful extension to your organization such as .word or .src. The File Mappings panel allows you to add your custom extension and map it to the appropriate source application adapter.

Facilitates new input formats in the future. Quadralay plans to add more input formats in the near future, including XML formats. Since XML is a common format, the source files are usually given unique and descriptive file extensions. The File Mappings panel ensures that your projects are ready to handle any future input sources.

Only the source application adapters installed will be shown in the File Mappings user interface.

A license key is required for converting files mapped to an adapter. ePublisher AutoMap will allow creating and managing jobs and projects to use an adapter; but if a valid key is not available, the files will not convert.

To add a new file mapping:

1.	Open the application Preferences.

2.	Choose the File Mappings preferences tab.

3.	Click the Add button.

4.	Type a file extension to be mapped into the File extension field.

5.	Select one of the installed source adapters from the Adapter (Tool) popup.

6.	Click OK to save the new mapping.

7.	Click OK to save your settings.

To modify an existing file mapping:

1.	Open the application Preferences.

2.	Choose the File Mappings preferences tab.

3.	Select a file extension from the File Extension column.

To open ePublisher AutoMap:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006691", false);

To add a license key:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006698", false);

To delete a license key:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006704", false);

Using the contextual menuWebWorks_WriteArrow(WebWorksRootPath, "wwdd10006191", false);

To open the application preferences:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006274", false);

To set the default job folder:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006294", false);

To set the default staging folder:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006306", false);

To set the default user formats directory:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006316", false);

To set automatic scanning:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006325", false);

To delete temporary files:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006333", false);

To add a new file mapping:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006346", false);

To modify an existing file mapping:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006354", false);