You can create publishing task that can be scheduled to run at off-peak times and on regular time intervals to ensure that published content is always current. The FMPS dashboard notifications keep you informed about pending jobs as you turn your attention to other publishing tasks.
You remotely define the publication tasks in Adobe FrameMaker Publishing Server and schedule them to run at the required interval. A task is a complete collection of all the build information that is required to run a publication task.
For more information, watch this video - FrameMaker Publishing Server: Automated publishingdeliveredremotely.
Typically, you define a task for each book or source document that you want to create outputs from. For example, if you have a book file from which you want to create Adobe PDF, Basic HTML, Responsive HTML5, or more outputs, specify the following settings for the Task:
Location of the source document or book. You can specify sources from the local file system, a network or WebDAV folder, an OpenText Documentum repository, a Microsoft SharePoint repository, DitaExchange or Adobe Experience Manager (AEM).
Output formats required and their settings.
The supported output formats are: PDF, Responsive HTML Help, Mobile App, ePub, Kindle, Microsoft HTML Help, AEM Mobile, and Basic HTML.
Presets for all supported output formats include the settings
such as DITAVAL File and Settings File (.STS
).
Preset help you apply these settings to repetitive and similar tasks
and save time.
For more information about configuring output presets using FrameMaker, see the Print and Publish topic in FrameMaker User Guide.
The location where you want the output from the output generation process saved. You can specify the output location as a folder in the local file system, a network or WebDAV folder, or an OpenText Documentum, Microsoft SharePoint repository, DitaExchange, or AEM.
Schedule to run the task and the frequency.
On the FrameMaker Publishing Server dashboard, select the Task tab.
In the Add New Task drop-down, select Add New Task.
On the new Task screen, specify a Name for the publishing task.
Tasks in the task queue are listed with the task name. Provide intuitive task names that indicate the type of document and the output formats to easily identify your task in the queue.
Click the browse button next to the Input Source field.
The Specify Input Source dialog appears. Enter the following details in it:
An input source file (.book, .ditamap, .fm, or .mif file). Enter full path and name of the input file.
Enter login credentials to access the input file, if required. For example, login information is required to access files over a network or a CMS.
If your input file is on a CMS, select the CMS option, choose the CMS type, and specify the CMS details, such as login information, server, and workspace.
To edit book settings, click the Modify link in front of Book Settings. In the Book Settings dialog, double-click (or use the move icons) to move the required entries in the Don’t Include and Include lists.
To add an output type, choose an output format, preset, and then click the browse button next to the Output Folder Path field. The Specify Output dialog appears. Enter the following details in it:
FrameMaker Publishing Server overwrites all existing files with the newly generated output. To keep the output files from an earlier publication task, move them to another folder. You can run a post-publish command as part of the publication task to move the output files to another location after the publication task completes.
Specify the destination file path where the output file is saved.
If required, enter login credentials to save the output file. For example, login information is required save output files on the network or on the CMS.
To save output file to a CMS, select CMS and enter the CMS details.
To add more output types, click Add Another Output and repeat step 6.
(Optional) Enter the path and name of a Pre-Publish Script to specify any automation script that you created.
(Optional) Enter the name and path of a Post-Publish script to specify any system command that you want to run on the outputs after the publication task is run. You can create a batch script and provide its path so that FrameMaker Publishing Server runs the script after the publication task completes.
Click the Not Scheduled link to open the Schedule dialog. Specify the time and frequency for the task to execute.
(Optional) In Send Log in Email, specify the email addresses where you want to send the task log. Use semicolons between multiple email IDs.
To add or delete information in the task logs, click Modify in front of Log Settings. In the Log Settings dialog, double-click (or use the move icons) to move the required entries in the Don’t Include and Include lists.
Click Save.
You can also create a task from a template. For more information, see Create a task from a template.
Related Links:
On the FrameMaker Publishing Server dashboard, select the tasks from the task list and click Run.
An easy way to create multiple tasks is to make a copy of an existing task, and then make the necessary changes for the duplicated task.
On the FrameMaker Publishing Server dashboard, do one of the following:
Click a task’s name and in the Task dialog, click the Duplicate icon.
Select a task and then select Duplicate Task from the Add New Task drop-down.
The Task
dialog opens with the same task settings and name of the task duplicated
with the suffix -copy
.
Edit the name and other details of the task and click Save.
On the FrameMaker Publishing Server interface, click on a task name.
The Task dialog appears.
Make the required changes in the task and click Save.
On the FrameMaker Publishing Server dashboard, select one or more tasks and click Delete.
Typically, you create publication settings for recurring tasks. With FrameMaker Publishing Server, you can create multiple publication tasks and schedule them to run at specified intervals. In a typical technical publications department, many teams create automated builds that are then run at the required intervals. You can specify the intervals as once, daily, weekly, or monthly. A publication task requires a defined schedule to run or a user can run them manually. For more information on running tasks manually, see Create a schedule for run.
After you schedule a task to run, FrameMaker Publishing Server adds these as scheduled tasks to the Windows Task Scheduler. You can view and edit these tasks from Windows Task Scheduler independent of FrameMaker Publishing Server. The scheduled tasks appear with the name of the task and the user name associated with the task.
Keep in mind the following when you determine the build schedules:
Each source document requires a separate publication task. If you have a large documentation set that heavily uses single-sourcing approach, you will need to create as many publication tasks as the number of book files.
Builds are queued—if you want to run an immediate publication task when a large number of builds are in the queue, you will have to wait for the builds in the queue to be completed before you can run your publication task.
If you require daily builds, consult with other teams so that your build schedule doesn’t clash with theirs. If you schedule a large build in the day time, chances are that a once-only build task you want to run urgently will have to wait until the build queue is completed. A good way to ensure that daily build schedules do not affect other build tasks is to plan your daily builds to run in after-office hours.
In the Task dialog, click the link next to Scheduling. The link could be:
Not Scheduled: If the task is not scheduled
A description of the scheduled task, such as 20:23 every SUN of every week if the task is scheduled
In the Schedule window, select the required interval, and specify the options.
Click Save.
FrameMaker Publishing Server lists all the tasks that are defined for the server, and shows their run status. In addition to the list of all tasks, you can see the next run status of each task in the Next Run column of the Tasks dashboard.