Running the Model
The “Runtime” step allows running the Configuration Process or Catalog Process under specific conditions (such as the window size) and follow up on the results.
Setting up specific runtime conditions
In order to set up specific run-time conditions, proceed as follows:
How-To:
- [In the menu toolbar]
- Click on the step “Runtime”
- [In the explorer]
- Click on the tab “Configuration Launchers”
- [In the explorer tab “Configuration Launchers”]
- Select the icon of the root folder
- [In the menu toolbar]
- Execute the “New Launcher” function.
- [In the popup]
- Enter a name
- Hit “OK”
- [In the Configuration Launcher details]
- Choose a Configuration Settings file
- Choose a Configuration Layout file
- Enter the name of the file to which the configuration will be saved
- Indicate if the cached memory needs to be flushed automatically
- Indicate if the session information needs to be inherited (this involves the Configuration Process name and the language)
- Provide the frame size for the launcher
- The frame size is useful to test multiple resolutions
- Provide the frame location for the launcher
- The frame location is useful to simulate the Configuration Process embedded in a web application frame
- Provide a background image or color
- This will be used to “fill” the background” surrounding the frame
- [In the menu toolbar]
- Execute the “Save” function.Warning: When running the SellingPRO Designer, the launcher defined with the previous generation of CPQ Designer are still referenced. However, to differentiate them from the ones created in the SellingPRO Designer, they are pre-fixed by “OLD_DESIGNER_”.
- Execute the “Save” function.
Running the configuration
At each point in time, during the Design Configuration Process, you can test the design of your Configuration Process at run-time. In order to run the model you are currently working on, proceed as follows:
How-To:
- [In the menu toolbar]
- Click on the function Preview
- [In the popup]
Fill in the following information:
- Choose the Launcher of interest
- if this option is chosen, nothing else has to be entered. [alternatively]
Fill in the following information:
- if this option is chosen, nothing else has to be entered. [alternatively]
- Choose the layout file
- Choose the configuration file
- Indicate the “saved configuration file”: this indicates the name and location on the server of the file that will be used when the configuration is saved
- Tick the “Inherit current Modeling session” checkbox if you want to override the version, workspace, Configuration Process and language to be used when running the model by the ones belonging to the Configuration Process you are working on
- Choose the Launcher of interest
Managing runtime files
When running Configuration or Catalog Processes, it might be that some server access is required. For instance:
- The configuration settings need to be changed, or a new configuration file needs to be added
- The theme does not seem optimal and some changes need to be made to the css files.
- A macro-BRC did not execute correctly and the macro traces need to be viewed
- An image in the Rich Media Gallery needs to be updated
- The CPQ log file(s) need to be retrieved for support or analytics reasons
In order to access these server files proceed, the “Runtime” step offers the “Manage Files” explorer tab. This tab offers the following functions:
| MANAGE FILES FUNCTIONS | |
|---|---|
| Global functions | |
| Fileset properties | Shows the properties of the explorer section in terms of allocated space and security. |
| Reload content | Refreshes the view with respect to the file system. |
| Functions available for a given folder | |
| Upload | Uploads a file from the client in the opened folder |
| Import | Uploads a compressed file from the client and decompresses it in the opened folder |
| New file | Creates a new file in the opened folder |
| New folder | Creates a new folder in the opened folder |
| Functions available for a given folder content | |
| Cut | Cuts the selected file(s)/folder(s) |
| Copy | Copies the selected file(s)/folder(s) |
| Paste | Pastes the cut/copied line(s) in the opened folder |
| Delete | Deletes the selected file(s)/folder(s) recursively |
| Download | Downloads the selected file or folder (in case of a folder, it will be compressed). |
| Editor functions | |
| Go to line | Jumps to the line having the number entered by the user |
| Undo | Undo the last action |
| Redo | Redo the "undone" actions. |
| Search | Search for a character string. |
| Replace | Replace all occurrences of a character string by another one. |
| Increase font size | Increase the font size to make the file more easily readable. |
| Decrease font size | Decreases the font size. |
| Wrap | Allows wrapping the text automatically (visually breaking the line and continuing on the next line when it is larger then the editor width) or not. |
| Expand/collapse | For XML-documents, allows expanding (opening) or collapsing (closing) XML tags. |
The following views are accessible in the “Runtime” step:
Settings
- This view holds all the configuration.xml files and the catalog.xml files.
Traces
- This view holds all information necessary for “debugging” the Configuration Processes and consult analytics on the usage of CPQ by end-users.
- The JBoss server log file
- The cameleon log file
- The macro language traces
- The Analytics log file
Rich Media
- This view holds every rich media gallery, per workspace.
Themes
- This view holds all information necessary to graphically build and view the Configuration or Catalog process layout:
- The layout.xml files
- The configurationUI theme folders, holding images and css files
- The external components
In order to browse a certain view, proceed as follows:
How-To:
- [In the menu toolbar]
- Click on the step “Runtime”
- [In the explorer]
- Click on the tab “Manage Files”
- [In the explorer tab “Manage Files”]
- Select the section of interest (e.g. Traces)
- Expand the folders
- Click on the name of the folder of interest
In order to open a file, proceed as follows:
How-To:
- [Using the “Manage Files” explorer]
- Choose the folder of interest
- [In folder view]
- Click on the name of the file of interest.
- If the file can be edited, a file editor will be opened. If not, the Designer will propose to download it.
- Click on the name of the file of interest.
Trademarks
All other brands and their products are trademarks or registered trademarks of their respective holders and should be noted as such. This product includes software developed by the Apache Software Foundation https://www.apache.org/