This tool is used to create a documentation for your system, that works integrated with the projects related by ScriptCase.
This tool can be accessed from the menu at Tools > HelpCase.
How to Create a HelpCase
The creation process is simple, needing only to inform the name of the documentation.
After creating the helpcase, you need to generate the content of the documented manual of the functionalities and description of the project.
On the left side, in the block ‘WebHelp’, we’ll see the folder structure. Still in this block we can create the folders of the documentation.
Select the root or any other folder on the side panel and click on the folder icon. This way a folder will be created in the select directory.
Inform the directory name (Special characters aren’t acceptable) and the display name in the documentation menu.
To create .html files, where you’ll place your content, you need to select the directory where you’ll place the files in.
Inform the name of the file (Special characters aren’t acceptable) and the display name in the documentation menu.
Editing the helpcase
Selecting the folder that you’ll create, you’ll view some new option with the create button.
- Icon (Folder with letters) - Allows you to rename the archives and the display name for the menu.
- Icon (Recycle Bin) - Deletes the directory with all its content.
- Icon (Eye) - View the directory in the documentation menu.
- Icon (Slashed Eye) - Disable the view of the directory in the documentation menu.
After created, the files will be displayed on the list, when clicking on the directory that were created. Details about the files can be viewed, like the display title on the menu and its actual size, also other options like rename and delete.
- View - View the content of the file.
- Edit - Open the file to place your content in it.
- Link - Create a link between the file and the applications selected.
- Copy - Creates a copy of the file.
- Rename - Rename the file and it’s display menu.
- Delete - Deletes the chosen file.
After the creation or clicking on edit a file, you can insert the content that’ll be displayed for the end user.
You can upload already created content or images to use in the manual. The upload of these files, can be done by clicking on the upload button, on the upload page you’ll see the supported formats and size limit of the files.
Allows you to setup some things, like the header display and the search tab.
Allows to write content of the initial page of the documentation. The modification can be done also when selecting the
_home.htm file on the files panel.
Define a template to be used in the header of the manual, it’s possible to edit or create new templates in the editor.
This editor can be accessed from the menu Layout > HTML Templates
Allows to configure what will be displayed in the header.
Allows to modify the HelpCase CSS.
After creating all the content and the configuration of the layout, you need to associate the create files with the applications, so that the end user can have access to the information that he needs in a quick way.
You can start associating all the applications at once by clicking on links, or clicking on link, where you can associate only the chosen file to various applications.
On this option, you’ll see a list of the applications, where you should select the applications that’ll be associated.
Clicking on link, you’ll be presented a list of all the applications, in this case you need to select the files that’ll be associated for each application.
Generating the manual is the last step of its creation, after doing all the configurations, click on generate.
After generating the manual, you can download or access it.
For you to have access to the manual from the applications, you need to click on the button WebHelp on the toolbar of the applications that have a link to the manual.