Understanding the basic folder and file structure
- Take some time to understand what files are stored where and why in the configuration
- Understand the way how the configurations of different files are related to each other
- Practice the file relations and the navigation to the related files (e.g. workflows & workflow descriptor etc.)
- Create a (visual) overview containing the different functions of the files (e.g. explorer.xml, filters.xml, topology.xml etc.)
- Create a (visual) overview of relations between configured elements and time lengths
- The clientConfig.xml that is used to create a shortcut is placed under “RootConfigFiles”
- If you create a short cut for an Operator Client or Config Manager place each of those in separate folder, not in your region home
Understanding the project structure and task
- Follow the conventions used in a project
- Make a list of every step that is required to get to the desired solution in advance
- Create a (visual) overview of the problem implementation
- Take into account how the configured element will be used by the end user
- If available have a look at an example for your first configuration tasks
Good to know in the FEWS GUI
- The “Logs” window can be cleared by right clicking on it and press “clear messages”
- Learn and use the most important short cuts from the beginning:
In every display when the curser is e.g. in the logs window
- F12: provides several options (e.g. open database viewer, make ids visible, etc.)
- F5: reload configuration
Manual forecast display
- Ctrl r: run single modules in a workflow
- Ctrl d: run modules of a workflow in debug mode
- F12: provides several options (e.g. showing all workflows)
Database viewer
- F10: shows time series graphically (selecting a time series)
- Right click on a timeseries provides additional options
Data handling
- Always reload the configuration in FEWS with F5 after making changes to the configuration
- When importing always check that the data is still available in the import folder
- If not configured differently data from the import folder is deleted after the import → make a safety copy of the data in this case
- To avoid that the data is deleted from the import folder in a testing phase it is possible to use “deleteImportedFiles = false” in the configuration
- In case of mistakes or during debugging it might be useful to have a clear database viewer. First make a safety copy of the local data store (region home) to a separate folder.
To clear the database viewer, it is possible:
- To delete the whole local data store from the region home
- To remove only certain data press F12 “Delete module instance for selection” the database viewer display
- Making copies of the local data store is also a good way to safe the current data status of the system in case you would lake to go back to that state later
- Keep in mind that whether the data is shown in your data viewer, also depends on your current system time. Only data existing at the system time is shown.
- Keep in mind that since the data is often first imported, then processed and then put into a model, there can be different timeseries for all this data
- Use the database lister to see whether and how timeseries are written by a workflow
Model integration
- Keep in mind to start with the export activity in the general adaptor module, because:
- Export: fews > model,
- Import: model > fews
- The modules folder (region home) is constantly overwritten by the ModuleDataSetFiles→ it doesn’t make sense to change anything in the modules folder