18.104.22.168.1. Filesystem product configuration
The "New Product" dialog allows to define the settings for the product to be created. By default, the storage type "Filesystem" is selected. Keep the default selection if you want to use filesystem storage. Enter the remaining fields as described below and finally click "Okay" to create a new empty product.
Figure 2.7.10. New product dialog
Enter a unique identifier for the product to be created (no whitespace characters allowed). Although it is possible to change the product-ID later on, it is recommended to use an identifier which is stable, i.e. does not change too often.
Enter a descriptive name for the product. The product name can include whitespace characters.
Keep the default value "Filesystem" to use filesystem storage. Change the selection, to use another storage type. See Section 22.214.171.124, “Storage types” and the following chapters for more information on the available storage types.
Path (product directory)
For filesystem-storage and embedded-database-storage this field defines the filesystem path (on server-side) where the product documentation is stored. By default, products are stored in a sub-directory of the document-store directory, where the product-ID is used as directory name (see Section 2.7.8, “Application settings” for information on the document-store directory).
If the default location is not appropriate, check the "User defined" radio button and enter an absolute path to another location:
Figure 2.7.11. Setting an absolute product path
For example, if the absolute path "C:\work\my_products\my_app" has been entered as user-defined path for the product with ID "MyApp", then this directory is used to store the product documentation for product MyApp. If a new product is created then the entered user-defined directory initially needs to be empty.
A product that has a user-defined path is called an external product. The word external shall express that the product directory is located outside of the application's document-store directory. Note however, that only product related data is stored in the external product directory. Global settings, e.g. user and groups settings, are in any case stored in the application's document-store directory.
Add one or more languages by clicking the "Add" button. One of the selected languages has to be defined as the "original" language. All other languages will be translation languages. To define one of the added languages as the "original" language, select the language from the list and click the "Set as Original" button. To delete a language from the list, select the language from the list and click the "Delete" button.
Note that it is possible to add translation languages at any time after the product has been created. However, the original language cannot easily be changed after the product has been created (see Section 126.96.36.199, “Editing a product”)!