---
title: Import Model(s) Wizard
slug: solutions/import-models-wizard
docTags: 
createdAt: 2025-08-21T14:19:27.445Z
---

The Import Model(s) Wizard allows users to search for Digital Twin Models on a Litmus Edge and select which of these Model(s) they want to import the Model settings into the DT Model Management tool.

# Open the Import Model(s) Wizard

To open the Import Model(s) Wizard, press the **Import Model(s)** button from the **LitmusConfiguration&#x20;**&#x52;ibbon.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/pmiox2cHAG_KsODG0koMa_image.png" size="80" width="400" height="178" position="center" showCaption="false"}

:::hint{type="info"}
**Notes**:

To open the Import Model(s) Wizard, the tool will verify that it is **not** in the Status:

- Offline
- DigitalTwin not responding
- No LE Set
- No API Key

If the Tool found to be in one of these states, a message is displayed.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/EdUZ3IZBvYDwaqbutbqik_image.png" size="60" width="405" height="172" position="center" showCaption="false"}
:::

# Setting up the Search Filter

To search for Digital Twin Model(s), the user can setup a filter to apply to the search.
This allows them to reduce the list for potentially imports to only the Model(s) they are truly interested in.

## Select the LE Device IP

### Tool set to One LE

If the tool is set to **Connect To** *One LE*, the user will not be able to change or select the LE Device IP.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/OhlldhcG-3Ak6T_ChmKWB_image.png" size="70" width="568" height="435" position="center" showCaption="false"}

### Tool set to Multiple LE

If the tool is set to **Connect To** *Multiple LE,* the user can select which Litmus Edge to search for, provided that more than one **Target Litmus Edge IP** has been defined.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/v7RXEGnS4uOmqa_jW3PnI_image.png" size="80" width="1023" height="430" position="center" showCaption="false"}

Additionally users can also enter a Litmus Edge IPv4 which is not yet present in the sheet

The tool will check if it does have an API Key for the Litmus Edge IPv4 address.
If no API Key is found, it will notify the user and request the API Key.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/CvFsx75AF7ubGVLpwu78H_image.png" size="80" width="675" height="448" position="center" showCaption="false"}

Press the **Yes** Button, provide the API Key and press the **Save&#x20;**&#x42;utton.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ZBF6PSM5rHwcoC-B3rVrj_image.png" size="80" width="715" height="552" position="center" showCaption="false"}

## Set Search Option

The tool provides a number of Filter Options the user can select from.
The include:

- **ALL**: Do not apply any filter and return all Model(s) defined in DigitalTwin on the selected Litmus Edge
- **EQUAL TO**: Select all Model(s) whith a Model Name equal to my [Model Name Mask](docId:6B2RMRJG50mF_gtiDWT8w).
- **NOT** **EQUAL TO**: Select all Model(s) whith a Model Name not equal to my [Model Name Mask](docId:6B2RMRJG50mF_gtiDWT8w).
- **CONTAINS**: Select all Model(s) where the Model Name contains the value from my [Model Name Mask](docId:6B2RMRJG50mF_gtiDWT8w).
- **DOES NOT CONTAIN**: Select all Model(s) where the Model Name does not contain the value from my [Model Name Mask](docId:6B2RMRJG50mF_gtiDWT8w).
- **BEGINS WITH**: Select all Model(s) where the Model Name begins with the value from my [Model Name Mask](docId:6B2RMRJG50mF_gtiDWT8w).
- **ENDS WITH**: Select all Model(s) where the Model Name ends with the value from my [Model Name Mask](docId:6B2RMRJG50mF_gtiDWT8w).

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/D6xJiVn86dvRDXFbDbTsW_image.png" size="80" width="829" height="447" position="center" showCaption="false"}

:::hint{type="info"}
**Notes**:

Al&#x6C;**&#x20;Search Options** except *ALL*, require a value for the [Model Name Mask](docId:6B2RMRJG50mF_gtiDWT8w).&#x20;
:::

## Define the Model Name Mask

For any **Search Option** except *ALL*, a mask is required to apply to the Model Name.

Example: Selected **Search Option** set to *EQUAL TO* and **Model Name Mask** set to *Test&#x20;*

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/9arF5-eQLDeztuNsXuZ3m_image.png" size="80" width="634" height="371" position="center" showCaption="false"}

The Import Wizard will show what Filter will be applied.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/71AN3K91Lfo0k8gxz_E8G_image.png" size="80" width="634" height="371" position="center" showCaption="false"}

## Initiate the Search

If all settings are correctly set, the Search Button will be set to green and allows to initiate the search.
To initiate the search press the green **Search** button.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/J_OnS5L3DFptChNzuCkPB_image.png" size="80" width="870" height="699" position="center" showCaption="false"}

:::hint{type="info"}
**Notes**:

If the Filter is invalid, the Search button will be grayed out and can not be used.

Example: No **Model Name Mask** has been defined for the **Search Option&#x20;***EQUAL TO*

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/WUKj4qUHqmrGOXl2ZoL5T_image.png" size="80" width="828" height="708" position="center" showCaption="false"}
:::

# Importing Model(s)

After the Search has been initiated, the results are shown in a List Box.

The User will see the **Model Type&#x20;**&#x61;s well as the **Model Name**.

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/6XJ2vms7v_ROT1xt3Tvh1_image.png)

:::hint{type="info"}
**Notes**:

In case a Filter returned no Model(s), the user is informed and can initiate a new Search.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Cp91SiXSYkzQZxPygvnkn_image.png" size="70" width="888" height="775" position="center" showCaption="false"}
:::

## Selecting all Model(s)

To select all Model(s) for Import, check the Checkbox of the Header Row.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/XllBCCcthU681dWrIUsQB_image.png" size="70" width="881" height="429" position="center" showCaption="false"}

## Unselecting all Model(s)

To unselect all Model(s) for Import, uncheck the Checkbox of the Header Row.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/t_0NGMuwPB8C_2TWLwMdD_image.png" size="70" width="805" height="415" position="center" showCaption="false"}

## Select individual Models

To select individual Models for Import, check their respective Row or Checkbox.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/D5N4Ix7mW1ERg7Et2fk2p_image.png" size="70" width="757" height="388" position="center" showCaption="false"}

## Unselect individual Models

To unselect individual Models for Import, uncheck their respective Checkbox or Row.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/cyBTgCLI9BSDTcc473-ZY_image.png" size="70" width="867" height="411" position="center" showCaption="false"}

## Import Model(s)

If at least one Model has been selected from the list, the Import button will change to green and an Import can be initiated.
To initiate an Import press the green **Import&#x20;**&#x62;utton.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/RjVX7uyCcHHxbRWzR5sQn_image.png" size="80" width="776" height="631" position="center" showCaption="false"}

If no Model(s) have been selected, the Import button will be greyed out.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/YmYdb7svMFzpInJUpMBqg_image.png" size="80" width="788" height="644" position="center" showCaption="false"}

:::hint{type="info"}
**Notes**:

The Import wizard will show how many Model(s) have been selected in the left lower corner.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/_3DkmZgDI1v8pscH7YP1V_image.png" size="60" width="350" height="605" position="center" showCaption="false"}
:::

## After an Import finished

Once all the selected Model(s) have been imported, the user is informed about the result and has three further options:

1. **Close&#x20;**&#x74;he Wizard. This will end the import and the user can proceed with their desired actions on the sheet.
2. Set up a new [Search Filter](docId:6B2RMRJG50mF_gtiDWT8w) to execute a **New Search.**
3. [Select further Models](docId:6B2RMRJG50mF_gtiDWT8w) from the list they previously hadn't selected for another **Import**.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/PYDNGO1K4ICDb9JpZo4as_image.png" size="80" width="873" height="752" position="center" showCaption="false"}

