...
See the How to link jobs to custom documentation sources article for information about how to link to documentation with JobScheduler versions up to and including 1.12.7.
Importing Documentation
Permissions
In the default configuration users with the root and application manager roles are able to import documentation items.
Formats Supported
The documentation function is intended for use with documents that users have created outside the scheduling environment and which are then imported and saved in the Reporting database. The following formats are supported:
- HTML (not all 'component' file types - e.g.
.eotfont files - are supported) - XML
- html
- xml
- markdown (must have the file extension 'md' or 'markdown')
- pdfPDF
- zip Zip (for both Windows and Linux OSs, tar.gz is not supported)
- The following file formats are also allowed, since they can be relatively addressed as external files:
- xsl XSL (xml XML with the file extension 'xsl' or 'xslt')
- images (gifGIF, jpegJPEG, pngPNG)
- javascriptjavaScript
- cssCSS
- If an html file contains links with a relative address then the linked file has to be imported too or an HTTP address should be used.
- Additional file formats which are used as embedded objects in an HTML file such as audio files can be displayed but need an HTTP address instead of a relative address.
- Markdown files are converted to HTML when they are to be displayed and:
- They have to match the syntax of John Gruber.
- During the conversion, a default css file ("/sos/css/default-markdown.css") is used and the title of the page is the name of the markdown file.
- The markdown can start with reference-style links which are invisible.
- These links can be used as header information for title and css file
- [css]: http://myHost/my.css or relative [css]: my.css
- [title]: myTitle
...
The virtual Path specified in the screenshot above reflects the organization of documentation items according to object type, with a folder for Jobs, one for Orders, etc. Such a 'centralized' approach to the organization of Documentation fits in well the the concept of reusing JobScheduler objects.
In addition note Note that the name chosen for the zip file reflects the Job being documented - this name will be used for the name of the folder containing the documentation.is not included in the virtual path.
The next screenshot shows the folder structure of the imported documentation item and the 'main' HTML file. The files from the CSS and images files can be accessed if required.
| Anchor | ||||
|---|---|---|---|---|
|
Documentation for all the JITL Jobs which are delivered with the JobScheduler is automatically imported from the ${SCHEDULER_DATA}/jobs folder to the JobScheduler's Reporting database when the JobScheduler Master is installed. The JITL documentation files are then shown in the JOC Cockpit's Resources->Documentation view in the ./sos/jitl-jobs virtual folder tree.
The next screenshot shows the top part of the JITL jobs documentation items:
Assigning Documentation
Permissions
While all of the default roles except the administrator have permission to view documentation, only the root and application manager roles have permission to assign documentation to scheduling objects.
The Assign Procedure
Documentation
...
is assigned to a JobScheduler object using the Additional Options menu as shown in the screenshot below:
The Select from Tree folder symbol shown in the above screenshot opens a view of the Documentation virtual tree, which is shown below.
The Submit button is used to complete the assigning procedure after the documentation has been selected. This is shown in the screenshot below.
Once the documentation has been assigned to a JobScheduler object a documentation symbol is shown alongside the Job Chain node state as shown in the screenshot below. Note that a few seconds after this screenshot was made the JOC Cockpit added the documentation alongside the second node of the JobChain, as this node uses the same simple_test_job_01 Job as the first.
Clicking on the documentation symbol will cause the documentation to be opened in either a new browser tab or window, depending on the configuration in the user's profile described in the next section.
Assigning to Other Objects - Job Chains
The procedure described above can also be used to assign documentation to a job chain as shown in the next screenshot.
Updating Documentation
The import procedure described above can be used to update documentation files in the reporting database after changes. There is no provision for in-situ editing of files.
The updated version of a documentation file will be immediately available for all the objects the documentation has been assigned to. It is not necessary to reassign updated filesText ...
Configuration
Users can specify whether a documentation item can be viewed by opening a new browser tab or a new browser window. This is specified in the User Profile as shown in the next screenshot:
The default setting is that documentation items are opened in a new browser tab.
...
Documentation items can either be deleted individually, by using the Additional Options (ellipsis symbol) menu for each object as shown in the first screenshot below or by opening all the items within a virtual folder, selecting the ones to be deleted and using the "Delete Documentation" button as shown in the second screenshot below.
Once a virtual folder is empty it will automatically be removed from the virtual file tree, when the file tree is reloaded. This is best achieved by the user logging out from the JOC Cockpit and then logging in again.
...