Delete Instance(s) from Digital Twin for one Litmus Edge
To delete Instance(s) with Litmus Excel Add-ins, you should be familiar with how Models work in Digital Twins on Litmus Edge. as well as the consequences.
Before You Begin
- You have installed the Litmus Excel Add-ins extension. See Install Litmus Excel Add-ins for details.
Initial Preparation
Open a new DT Instance Management Tool File in Excel.
If prompted, Enable Content to allow the code to run.
Make sure the the tool is set Connect To is set to One LE.
Delete Instance(s)
Import Instance(s)
Import the Settings for Instance(s) defined on Litmus Edge using the Import Instance(s) Wizard.
Users can set a filter to reduce the number of Instance(s) shown as selection to the user.
- Search Option: Select what type of filter is to be used
- Instance Name Mask: Set the filter to be applied. Will be ignored if Search Option is set to ALL
- Digital Twin Models: Select if you want to search for Instance(s) only from a specific Model.
- The wizard will show what filter will be applied.
- Press the Search button to pull the filtered List of Instance(s) from Litmus Edge.
- The user will be shown the filtered List of Instance(s) matching their filter.
- Select the Instance(s) to import and press the Import button.
Users can choose between:
- Press New Search to set another filter and search again if the list doesn't show the Instance(s) the user wanted to import
- Select All Instance(s) using the Checkbox in the Header Row.
- Select a Group of Instance(s) by selecting their respective Check Box
- Select one Instance by selecting the respective Check Box
- Select No Instance and close the Wizard pressing the Close button instead.
- The selected Instance(s) with their settings are imported into the sheet. Once finished, the user can either.
- perform another search using the New Search button
- finish the import using the Close button
- The Action for each imported tag is set to M for modify.
Mark Instance(s) for deletion
Change the Action to D for the Instance(s) you want to delete on Litmus Edge.
Notes:
Set the Action to I for ignore for Instance(s) in the sheet you do not want to process.
Executing Actions
If the tool also includes Instance(s) with either the Action A or M, it is Recommended but not mandatory to verify the configuration first without executing the Action by pressing the Verify Only button.
This will check that all required Instance Settings are provided and logically correct. And provide any finding to the user. Example: Example: Below the user did not set a Topics (value is "") for the Dynamic Attribute.
Important: The tool can not verify if all provided Instance settings are factually correct. For example it can not verify that the value of a Static Attribute is correct for what the user want to achieve.
The Instance(s) can be deleted from Litmus Edge by pressing the Verify + Execute button.
This will check that all required Instance Settings are provided and logically correct. And provide any finding to the user. If no issues have been identified, the tool will verify that the user wants to execute ALL the actions from the Action Column:
- A: Add Instance(s)
- M: Modify Instance(s)
- D: Delete Instance(s)
- I: Ignore Instance(s) -> do nothing
To perform all actions, press the Yes button.
The Tool will perform ALL Actions row by row. When finished, a result Summary is shown. Close the Result Summary by pressing the X close button.
The tool will ask if the user wants to re-compare the Instance(s) against Litmus Edge. To re-compare, press the Yes button. To not re-compare, press the No button.
If the User selected to press the Yes button from aboves messagebox, the tool will pull all the Instance settings from Litmus Edge again including the InstanceID and also change the Action to M for each Instance with a InstanceID or A for an Instance with no InstanceID.
