ePublisher AutoMap User Interface

Support Central

Latest Release (2011.3)

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.

4.	Choose the appropriate source application adapter from the Adapter column.

5.	Click OK to save your settings.

To delete a file mapping:

1.	Open the application Preferences.

2.	Choose the File Mappings preferences tab.

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

4.	Click the Delete button.

5.	Click OK to save your settings.

Output Destinations

ePublisher AutoMap allows managing and editing output locations independent of a job. This gives the ability to set up some or all of your output locations and then select the one that you want to use when new jobs are created.

It is still possible to create new output locations as the last step in the new job wizard.

ePublisher AutoMap supports outputting to a folder. Folder refers to a local or a shared file system (for example C:\helpdocs or \\server\share).

To add an ouput destination:

1.	Open the application Preferences.

2.	Choose the Output Destinations preferences tab.

3.	Choose the type of destination from the Add button popup.

4.	Give the location a name in the Name field.

5.	Provide the relevant information depending on the type of destination chosen.

6.	Click OK to add the new destination.

7.	Click OK to save your settings.

To modify output destination:

1.	Open the application Preferences.

2.	Choose the Output Destinations preferences tab.

3.	Select a deploy target from the Name column.

4.	Click the Edit button to open the Deploy Target Editor.

5.	Make your modifications in the provided fields.

6.	Click OK to dismiss the Deploy Target Editor.

7.	Click OK to save your settings.

To delete an output destination:

1.	Open the application Preferences.

2.	Choose the Output Destinations preferences tab.

3.	Select a deploy target from the Name column.

4.	Click the Delete button to delete the entry.

5.	Click OK to save your settings.

Notification

ePublisher AutoMap includes functionality to send an email notification after running a job conversion. The notification provides information about whether the job ran successfully or if it encountered any errors. Optionally, you can specify to include the log file from the job as a text file attachment to the email.

To configure email notification:

1.	Open the application Preferences.

2.	Choose the Notification preferences tab.

3.	Enter the email address(es) for the recipients in the To Address field.

Separate multiple email addresses using the coma character. Alternatively, the email address may be an alias to a group, if multiple recipients are required. Please see your system administrator for setting up an email alias.

4.	Enter the sender’s email address in the From Address field.

The From Address specifies the email address that the email will be sent from. This is the address that will be in the To field if someone replies to a ePublisher AutoMap email notification (by hitting the Reply button in their email client).

5.	Enter the Mail Server Login Information in the provided fields.

ePublisher AutoMap email notification requires an SMTP email server to send emails. Please see your system administrator for more information.

All WebWorks products store passwords using encryption technology built into Microsoft Windows. Although this technology is proven effective, there are no guarantees that any encryption technology cannot be compromised. If you do not want your password to be encrypted and stored, please do not use this feature.

6.	Enable Always attach log to email if you wish to attach the job’s text log to the email notification.

7.	Select the Enable email notification checkbox to turn on email notification.

8.	Click OK to save your settings.

Email notification may be enabled and disabled at will without having to modify the actual settings. Simply toggle the Enable email notification checkbox shown below:

German, Japanese, and French support

In addition to the English language, the ePublisher AutoMap user interface has been translated into German, Japanese, and French languages. When ePublisher AutoMap starts, it will detect the operating system locale and automatically present the corresponding ePublisher AutoMap user interface.

It is possible to force ePublisher AutoMap to display a locale that is not the operating system default. For example, you can display the German user interface on an English version of Windows. However, this requires modifying an installed file which must follow a specific format. If you wish to take advantage of this capability, please checkout the webworks.com Technical Assistance Area for detailed instructions.

Quadralay worked very closely with the localization company to ensure proper translation of the ePublisher AutoMap user interface. We hope that we have accomplished this goal to your satisfaction. We would like to apologize in advance if anything was missed or translated improperly.

Related Topics

Starting WebWorks ePublisher AutoMap

Overview of the ePublisher AutoMap user interface

Setting application preferences

Opening ePublisher AutoMap

Configuring license keys

ePublisher AutoMap menus

ePublisher AutoMap contextual menus

ePublisher AutoMap toolbar

ePublisher AutoMap status information

Setting the Job Folder location

Setting the Staging Folder location

Setting the User Formats Folder location

Automatic scanning for conditions, media types, and variables

Keeping/deleting temporary files

XHTML 1.0 CSS WAI-A

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);

To delete a file mapping:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006360", false);

To add an ouput destination:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006372", false);

To modify output destination:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006380", false);

To delete an output destination:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006388", false);

To configure email notification:WebWorks_WriteArrow(WebWorksRootPath, "wwdd10006397", false);