--- title: Transformations Wizard slug: solutions/transformations-wizard docTags: createdAt: 2025-08-21T13:31:52.870Z --- [Transformations](docId\:zPaDX1lMmE0F44V7r6v6Q) allow to transform the data collected in instances by converting raw JSON data to a desired format by defining the JSON-based schema. To assist with the definition of the Transformations and ensure that the JSON Object is correctly formatted, the DT Model Management Tool provides a Transformation Wizard. # Access the Transformation Wizard :::hint{type="info"} **Notes**: To access the Transformation Wizard it is required that: - A **Model Type** is selected - A **Model Name** is defined ::: Select the respective cell in Column **Transformations **for the Model you want to define Transformation. If all conditions are met, the **Transformation Wizard** button is shown in the Help section of the **LitmusConfiguration **ribbon. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/38RrIhwS1RtJRmFJ0ZJfA_image.png) Open the Transformation Wizard by pressing the **Transformation Wizard** button. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/X0p2O8Tt6o8QiGXMgNSdO_image.png" size="60" width="289" height="149" position="center" showCaption="false"} The Transformation wizard will show. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ecOoYhDpMUb1gqDas74mO_image.png) :::hint{type="info"} **Notes**: If the Model has already Transformations defined, they will be shown in the List. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ibT02KD75Q-UMBcMufVW__image.png" size="80" width="1488" height="773" position="center" showCaption="false"} ::: # Add a new Transformation Schema To add a new Transformation Schema, press the **Add **option from the left panel. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/K-oZcirvLoCg42WldqiLn_image.png" size="80" width="1196" height="791" position="center" showCaption="false"} Transformation Schema are a set of three Parameters: - **Name:** The name of the Transformation Schema. - **Schema Type:** The format used by the Transformation Schema - **Schema**: The Transformation Schema code. To accept the entry press the green **Modify** button. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/q9p3awYx1VX1oQdKzNUea_image.png" size="80" width="1202" height="787" position="center" showCaption="false"} :::hint{type="info"} **Notes**: If not all Parameters for the Transformation Schema are provided, the **Modify **button will remain grayed out and the Transfromation Schema can not be saved. The wizard also performs a verification for each entry and will show any violation in red. In this case the **Modify** button will also be grayed out to prevent the saving of any invalid Transformation Schema. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/iwTMp1joTaPbB88OqdDTR_image.png" size="80" width="1194" height="787" position="center" showCaption="false"} ::: :::hint{type="info"} **Notes**: The tool will also verify that the Schema is correctly formated. If the Schema doesn't parse the **Modify **button will remain grayed out. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/6-mU8TyNCTPaD5czsV076_image.png) ::: :::hint{type="info"} **Notes**: Optionally you can use *System Variables* to define the Schema code. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/JRywt7hYJV0IgnF2Au8HZ_image.png) ::: # Edit a Transformation Schema Select the Transformation Schema you want to edit to open its **Edit **screen. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/G0iEEKiBPtCGcckd2FxHW_image.png" size="80" width="1195" height="760" position="center" showCaption="false"} Edit any of the Transformation Schema Parameters: - **Name:** The name of the Transformation Schema. - **Schema Type:** The format used by the Transformation Schema - **Schema**: The Transformation Schema code And press the **Modify **button. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/v5nmR0yiClXSp5qhuSoyx_image.png" size="80" width="1207" height="763" position="center" showCaption="false"} :::hint{type="info"} **Notes**: If not all Parameters for the Transformation Schema are provided, the **Modify **button will remain grayed out and the Transfromation Schema can not be saved. The wizard also performs a verification for each entry and will show any violation in red. In this case the **Modify** button will also be grayed out to prevent the saving of any invalid Transformation Schema. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/3fYIhaGyRx7DU3BNbZi1M_image.png" size="80" width="1200" height="770" position="center" showCaption="false"} ::: # Delete a Transformation Schema Select the Transformation Schema you want to delete to open its **Edit **screen. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/dfBe-zHpPVBAIxI3fjm9i_image.png" size="80" width="1199" height="770" position="center" showCaption="false"} To delete the Transformation Schema press the **Delete **button. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/mMexn_Wf8pqB53wd1xASJ_image.png" size="80" width="1199" height="770" position="center" showCaption="false"} # Save the Transformations To save all the defined Transformation Schemas as a new Transformations JSON Object, press the **Save **button. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/b-GU8n-0Q8DmGIeAu1v-h_image.png" size="80" width="1204" height="793" position="center" showCaption="false"} This will create the correctly formatted Transformations JSON Object and store it in column **Transformations** for the Model. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/rg7eOyPZdL9TLzvv4Ew84_image.png) :::hint{type="warning"} **Important: **This will overwrite the current value in column **Transformations**. ::: # Cancel the Transformation Wizard If a user decides to not save the current Transformation Wizard configuration, they can press the **Cancel **button. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/rNVhQiRg2yVB7nuTDehJY_image.png" size="80" width="1518" height="820" position="center" showCaption="false"} :::hint{type="info"} **Notes**: This will not overwrite the current value in column **Meta Data**. :::