Configuration File Maintenance window

Use the Configuration File Maintenance window to:

  • view configuration settings
  • update configuration settings, if your security permissions allow it.


 Opening the Configuration File Maintenance window

To open the Configuration File Maintenance window:

  1. Select Module > System Maintenance > Configuration File Maintenance.
    The Configuration File Maintenance window is displayed.
  2. Use the Find and Include Value Field in Search fields to filter the records.
  3. Select the configuration setting to maintain.
    Note: The fields on the left-hand side correspond to the selected setting in the grid area.


Configuration File Maintenance window key fields and buttons

Fields

Field

Description

Find

Type one or more characters that match those in:

  • one of the keys
  • the Value field, if Include Value Field in Search is selected.
    The results are refined and displayed as each character is typed.

Include Value Field in Search

Select to refresh the search with the Value field included in the search.

Clear the field to find corresponding characters in the key fields only.

Comment

Included by the Synergetic Management Systems developers and/or support staff to assist people with updating the highlighted configuration setting.

If you cannot see all the comments, you can:

  • use the scroll bar to display comments further down
  • drag the bottom of the Configuration File Maintenance window, if possible.

Show SelectionHistory Key

Some program selections are recorded here, such as timetable import, so they do not need changing next time the program is loaded.

Note: You would not normally need to modify this setting, as this is used by Synergetic internally to recall the user's previous selections.

Show User Key

Settings to recall the saved form size and position.

Note: You would not normally need to modify this setting, as this is used by Synergetic internally to recall the user's previous selections.

Show Tabs Key

Customised tab layouts for the user.

Note: You would not normally need to modify this setting, as this is used by Synergetic internally to recall the user's previous selections.

Key 1

First key used for identifying a configuration setting.

Generally either:

  • a system wide setting (System)
  • a Synergetic module or function, such as Staff Maintenance (StaffMaint)
  • other software, such as:
  • Community Portal (CommunityPortal)
  • Crystal Reports (CrystalReports).
  • interaction with an external system (ExternalSystem), such as exporting data to the New Zealand Ministry of Education (NZMOE).

Key 2 /
Key 3 /
Key 4 /
Key 5

Remaining part of the identifying keys for a configuration setting.

The number of keys used depends on the unique configuration settings required.

TypeType of value used for the configuration setting:
TypeDescription
STR

String value using alphanumeric characters.

Note: Use the button to edit long strings or add formatting characters, such as carriage return/line feed. See Updating string values using the memo button.

INTInteger value used. That is, 1, 2, 3, 4... ...n.
BITTrue or False value.
Represented as either a selected value or a cleared flag. See True or False (BIT) examples below.
DATDate value.
Value

The value of the configuration setting.

The allowable value depends on the Type of value set:

TypeFurther information
STR

Value consists of a string of alphanumeric characters.

It can also include:

  • characters used for formatting
  • Synergetic fields with brackets used for merging values from the Synergetic database. For example, {ClassDescription}.
BIT

The BIT type is displayed as a check box. Either:

  • select the Value check box to set the value to True
  • clear the Value check box to set the value to False.
    See True or False (BIT) examples below.
DAT

The DAT date type is entered as dd/mm/yyyy format where:

  • dd is the day of the date
  • mm is the month of the date
  • yyyy is the year of the date.
    For example, 25/07/2016.
Default

The default value of the configuration setting.

Tip: You can enter default configuration setting values for your organisation by typing the value into the Default field and clicking .

The allowable value depends on the Type of value set.

Note: The Type for the Default field is the same as for the Value field.

Buttons

Button

Description

Click to enter additional information about the highlighted configuration setting.

Tip: You can use the button to copy the comment to the clipboard for later use.

The comment added is displayed in the left-hand pane with any existing CDA comments.

Click to display and edit string values for the Value or Default fields that are either:

Note: The button is only displayed for string (STR) values.

Go to the first configuration setting.

Go to the previous configuration setting.

Go to the next configuration setting.

Go to the last configuration setting.

Add a new configuration setting.

This inserts a new blank record at the end of the configuration settings.

Type the key values for the configuration, the type of setting, the value for the setting and any comments.

Tip: Click if you need to undo the new setting.

Add a new configuration setting, using values from the highlighted configuration setting.

This inserts a new record immediately after the configuration setting that has just been copied.

Update the key values for the configuration, the type of setting, the value for the setting and any comments.

Save the changes made to the current configuration setting.

Undo the:

  • new record added
  • changes made to the current configuration setting.

Delete the current configuration setting.

The following confirmation message is displayed.

Note: Deleting existing records can cause some functions within Synergetic to perform incorrectly. Unless advised by Synergetic support staff you should not need to delete any settings.

Overwrite the existing value with the default value for your organisation set in the Default field.


True or False (BIT) examples

The BIT type is used to represent True or False values.

Note: The word BIT is derived from the computing term which denotes one bit which can have a value of 1 or 0 used to represent True or False (Boolean) values, respectively.

In the first example below, the Value field for the highlighted configuration setting has been selected. This is displayed on the grid as True.

In the second example below, the Value field for the highlighted configuration setting has been cleared. This is displayed on the grid as False.