Differences

This shows you the differences between two versions of the page.

--- 2500_config_apps:0300_work_config_elements [2022/08/21 23:33] – [Working with Configuration Elements] administrator
+++ 2500_config_apps:0300_work_config_elements [2026/08/13 07:33] (current) – Imported by DokuWiki Advanced Plugin aware_support3
@@ Line 4: / Line 4: @@
 Business space version elements are added/edited using property editors specific to the element being added/edited.  However, certain editing principles described in the following sections are common to all configuration elements.
-{{simplenavi>2500_config_apps:0300_work_config_elements}}
+===== Adding Elements =====
+To add a new configuration element of any type:
+  - Click on a node in the Elements Tree that represents the collection of elements of the required type – for example, to add a new process click on Processes; to add a new business object click on Business Objects (the version that you are adding to must be in the ''NEW'' state– see [[2500_config_apps:0200_work_bsv:0100_bsv_lifecycle|Lifecycle of a Business Space Version]])
+  - Select the “File/New” command from the menu or right click to bring up the pop-up menu and select "New". The editor appropriate to the given type of element will be displayed in the Working Area of the screen.
+  - Specify properties specific to the element being added in the editor and/or in the properties of the element and its sub-elements. When finished press the Save button in the toolbar (or select File/Save from the menu) to save the new element in the business space version or close the editor tab to discard the changes.
+===== Editing/Viewing Elements =====
+To edit an existing configuration element of any type just double click on the element in the tree. Alternatively do the following:
+  - Click on the element’s node in the Elements Tree to select it.
+  - Select the “File/Open” command in the menu or right click to bring up the pop-up menu and select “Open”.
+The editor appropriate to the given type of element will be displayed in the Working Area of the screen. Modify properties specific to the element being edited inside the editor and/or in the properties windows for the main element and its sub-elements. When finished press the Save button in the toolbar (or select the “File/Save command from the menu) to save the changes to the element in the business space version. Close the editor tab to discard the changes.
+===== Deleting Elements =====
+To delete an element of any type:
+  - Click on the element’s node in the Elements Tree to select it (the element must belong to a business space version in the ''NEW'' state – see [[2500_config_apps:0200_work_bsv:0100_bsv_lifecycle|Lifecycle of a Business Space Version]])
+  - Select the “Edit/Delete” command in the menu or right click to bring up the pop-up menu and select “Delete”.
+<alert type="primary" icon="fa info-circle">
+**note**
+Certain elements of a business space version may not be deleted. This applies to those elements that are added to the business space version automatically and are required for the business space version to operate correctly. Examples of such elements are the ''RegularUser'' business object and the ''SystemUsers'' business objects group. An attempt to delete such an element will result in an error message.</alert>
+===== Copying Elements ======
+Elements of a business space version may be copied within a single business space version, between business space versions of the same business space or between business versions of different business spaces. Only compatible elements may be copied – for example it is possible to copy an attribute into a business object or notification but it is not possible to copy an attribute into a process or rule.
+To copy an element to the clipboard:
+  - Click on the element’s node in the Elements Tree to select it
+  - Select "Edit/Copy" in the menu or right click to bring up the pop-up menu and select "Copy".
+===== Pasting Elements ======
+Elements of a business space version may be copied within a single business space version, between business space versions of the same business space or between business versions of different business spaces. Only compatible elements may be copied – for example it is possible to copy an attribute into the business object or notification but it is not possible to copy an attribute into a process or rule.
+To paste an element which has been previously copied into the clipboard:
+  - Click on a node in the Elements Tree that represents the element into which the element in the clipboard is being pasted – for example, to paste a process click on Processes; to paste an attribute into a business object select the business object. The business space version where an element is being pasted must be in the ''NEW'' state  – see [[2500_config_apps:0200_work_bsv:0100_bsv_lifecycle|Lifecycle of a Business Space Version]]
+  - Select the “Edit/Paste” command in the menu or right click to bring up the pop-up menu and select “Paste”. Pasted element will appear in the Elements Tree.
+<alert type="primary" icon="fa info-circle">
+**note**
+ If an element with the same name already exists in the business space version //**AwareIM**// will change the name of the pasted element so that it is unique (you can later change this name to whatever you want) – for example, if a business object with the name Account is pasted into the version which already has a business object named ''Account'', the name of the pasted object will become ''Account1'' (or ''Account2'' if ''Account1'' exists as well).</alert>
+<alert type="primary" icon="fa info-circle">
+**note**
+ If a rule is being pasted the Configuration Tool may inspect the contents of the rule and offer to rename certain identifiers used in a rule. For example, if the following rule is pasted into the rule collection attached to the Account business object:
+<code aim>Account1.Balance = 100 </code>
+The Configuration Tool will detect the usage of the identifier ''Account1'' possibly inconsistent with the name of the owner of the rule collection (''Account'') and offer to rename ''Account1'' to ''Account'' (see also [[2500_config_apps:0800_add_edit_rules|Adding/Editing Rules]]).</alert>
+{{simplenavi>.:0300_work_config_elements}}