Customizing

Global Settings (All) MOD009ABF

Access

  • Customizer → Master Data → Global Settings

  • Customizer → Module Customizer → Modules → Global Settings

Information

  • In the Global Settings module, customizing objects are stored/managed

    • which can, e.g., be used in different Python macros and/or value ranges (like modules, OLEs, etc.) to ensure that they can easily be interchanged system-wide.

    • the settings of which (in the case of parameters) are to apply system-wide.

  • In the module, global settings are grouped in thematically suitable categories. Within the thematic categories the settings are displayed subdivided by class (object category).

Caution

  • The global settings contained in the PLANTA standard system must not be deleted.

    • in the Edit Global Settings module you can delete settings you defined yourself by simply marking and deleting them.

Categories and Classes

Information

  • The global settings are grouped in thematically suitable categories.

  • Within the categories, the global settings in this module are subdivided by so called so-called classes.

    • Module ID

    • Module variant ID

    • OLE object

    • Parameters

    • Startup module ID

    • Search results

    • Template

    • Dialog message ID

    • Symbol ID

  • In the Global Settings (All) module, the settings of all categories and classes are listed and can be edited by users with customizer rights.

  • The parameters of the following categories are also contained in separate Global Settings modules of the respective areas of application which can also be edited without customizer rights:

Classes: Module ID, Dialog message ID, OLE object, Parameters, Startup module ID

Information

  • The following procedure exemplifies how to store a module ID in the global settings. For other classes, the procedure is identical.

Store ID in Global Settings

  • Select Insert → Global Settings from the context menu.

  • The Edit Global Settings dialog module will be opened.

  • Allocate a name in the Name field.

  • Define a Python ID in the Python ID field.

  • Enter the module ID in the Alpha (120) field.

  • Select the requested class in the Class listbox, here "module ID".

  • Select the required project from the Category listbox.

  • If required, fill other fields.

  • Save.

Read ID from global setting

Python
#Auslesen einer Modul-ID

from ppms.global_setting import get_global_setting_value
module_id = get_global_setting_value(python_id='', attribute='alpha120')

Details

  • The global_setting Python module is imported in order to be able to use the get_global_setting_value() method.

Notes

  • Python IDs must be usable as Python literals. They must not contain any special characters, umlauts, spaces, etc.

  • Python IDs must be defined uniquely in the global settings.

  • Individual Python IDs must start with an L and the license number.

    • Example: L100_pr_datasheet

    • If the customizer does not set this manually, the system will set it automatically.

Classes: Module variant ID, Restrict filter results

Information

  • The following procedure exemplifies how to store a module variant ID with its corresponding module ID in the Global Settings.

Store IDs in Global settings

  • Select Insert → Global Settings from the context menu.

  • The Edit Global Settings dialog module will be opened.

  • Allocate a name in the Name field.

  • Define a Python ID in the Python ID field.

  • Enter the module ID in the Alpha (120) field.

  • Enter the module variant ID in the Parameter Alpha (120) field.

  • Select the requested class from the Class listbox, here "Module variant ID".

  • Select the required project from the Category listbox.

  • If required, fill other fields.

  • Save.

Read IDs from the global setting

Python
#Auslesen einer Modulvarianten-ID

from ppms.global_setting import get_global_setting_value
mv_id = get_global_setting_value(python_id='', attribute='parameter')

Details

  • The global_setting Python module is imported in order to be able to use the get_global_setting_value() method.

Notes

  • Python IDs must be usable as Python literals. They must not contain any special characters, umlauts, spaces, etc.

  • Python IDs must be defined uniquely in the global settings.

  • Individual Python IDs must start with an L and the license number.

    • Example: L100_pr_datasheet

    • If the customizer does not set this manually, the system will set it automatically.

Class: Template

Store template code in Global Settings

  • Select Insert → Global Settings from the context menu.

  • The Edit Global Settings dialog module will be opened.

  • Allocate a name in the Name field.

  • Define a Python ID in the Python ID field.

  • Select the requested class in the Class listbox, here "Template”.

  • Select the required project from the Category listbox.

  • If required, fill other fields.

  • Save.

  • Refresh the module.

  • Click on image2021-10-25_10-49-33.png in the new global setting in order to open the Edit Global Settings dialog module.

  • Store the template in the Template code parameter.

  • Save.

Read ID from global setting

Python
#Auslesen eines Template-Codes 

from ppms.global_setting import get_global_setting_value
template = get_global_setting_value(python_id='', attribute='template_code')

Details

  • The global_setting Python module is imported in order to be able to use the get_global_setting() method.

Notes

  • Python IDs must be usable as Python literals. They must not contain any special characters, umlauts, spaces, etc.

  • Python IDs must be defined uniquely in the global settings.

  • Individual Python IDs must start with an L and the license number.

    • Example: L100_pr_datasheet

    • If the customizer does not set this manually, the system will set it automatically.