> For the complete documentation index, see [llms.txt](https://docs.theconfigteam.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theconfigteam.com/prebilt-ewm/installation/ui-deployment.md).

# UI deployment

## Checklist

You will need:

1. ZIP file containing the built User Interface files (dist.zip)
2. Access to create ICF services in transaction SICF
3. A service user to assign to ICF services
4. Access to run program `/UI5/UI5_REPOSITORY_LOAD`
5. A workbench transport

## Change SAP GUI security settings

{% hint style="info" %}
**Note**

This step is optional but without it you will need to accept each file via a dialog box when uploading the application assets to the SAP system.
{% endhint %}

Run SAP GUI Options program and open the **Security Configuration** option:

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2Fgit-blob-56a9cb42d6062eb2f20ca0a726567b58e838cf2d%2FEWM-SAP%20GUI%20security%20settings.png?alt=media" alt=""><figcaption></figcaption></figure>

Change the Default Action to **Allow**:

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2Fgit-blob-c6d36e5045b281f3c946630374968db1dcdd6db8%2FEWM-security%20default%20action.png?alt=media" alt=""><figcaption></figcaption></figure>

Restart SAP GUI if necessary.

## Upload the user interface

Unzip the dist.zip file on your local machine.

In transaction *SE38* run program `/UI5/UI5_REPOSITORY_LOAD` and enter the name **ZTCTM\_FIORI**.

Execute the program.

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2F9KEHOaG6FAeDsaVHj6Wl%2Fimage.png?alt=media&amp;token=26de6046-6232-4421-8221-ee36c0b82e53" alt=""><figcaption></figcaption></figure>

The program will open a dialog. Navigate to the unzipped dist folder.

Navigate to the bottom and click the **Upload** button.

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2Fgit-blob-142c39cbb913c6df11b7c3ca6cedc030dbbe5263%2Fimage%20(127).png?alt=media" alt=""><figcaption></figcaption></figure>

Enter the **Description** and **Package** field&#x73;**,** leave the **External Codepage** option blank.

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2Fgit-blob-5f8df88356e839267e77be5d21d1efc4d46b4979%2Fimage%20(128).png?alt=media" alt=""><figcaption></figcaption></figure>

You will then be prompted to enter a Workbench transport.

Once finished, the program will have created a BSP Application and two corresponding ICF entries:

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2FfcM0vaDmoDLLw1k61jDD%2Fimage.png?alt=media&amp;token=34426bb1-6881-4903-91ec-679e6de5a45f" alt=""><figcaption></figcaption></figure>

## Create a new node for the frontend UI

Right click **default\_host** and select **New Sub-Element**.

The **Name of Service Element to Be Created** should be:

```
tctm_ewm_ui
```

You should create the new service element with **Reference to Existing Service** checked.

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2Fgit-blob-eac0d3a94c182c46e77c969a21b99ad8d18b2f78%2FEWM-new%20node%20frtonend%20ui.png?alt=media" alt=""><figcaption></figcaption></figure>

Create the service, then add the description using the details provided in the screenshot below.

{% hint style="info" %}
NOTE: You will add the Alias Target in a few additional steps.
{% endhint %}

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2FrzgEjQddtn6evJk604VL%2Fimage.png?alt=media&amp;token=9272e235-c4d3-4205-ad38-b097e403589c" alt=""><figcaption></figcaption></figure>

Enter the Service User details from the [preparation checklist](https://docs.theconfigteam.com/prebilt-ewm/installation/prebilt-standalone-edition-installation/import-the-base-framework#preparation-checklist).

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2FYVsizwJwjL3Sg6MpXzZP%2Fimage.png?alt=media&amp;token=696f714a-e6ef-46b6-adfa-1876af892571" alt=""><figcaption></figcaption></figure>

Assign the Host/Service to the Target.

{% hint style="info" %}
The navigation root for the target Host/Service is outlined in red below.
{% endhint %}

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2FtsrI5XtqjYlP2OJ4ezim%2Fimage.png?alt=media&amp;token=c6bb7622-8aa6-4787-b8b5-b7ad430f8670" alt=""><figcaption></figcaption></figure>

Upon saving, assign the package. You will then be prompted to enter a Workbench transport.

When complete, right click **tctm\_ewm\_ui** and click **Activate Link**.

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2F4N0aGWOmSvXzWJ0sw3ZJ%2Fimage.png?alt=media&amp;token=17bf0aa3-5ad6-47ce-a6bb-558e9fa114a4" alt=""><figcaption></figcaption></figure>

## Create a UIDYN node

Right click **tctm\_ewm** and select **New Sub-Element**.

The **Name of Service Element to Be Created** should be:

```
uidyn
```

You should create the new service element with **Independent Service** checked.

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2FP4fh870AKDcvvxbrjmNJ%2Fimage.png?alt=media&amp;token=4d2ae099-ce6d-4471-8631-c92deed8a93b" alt=""><figcaption></figcaption></figure>

Create the service, then add the description using the details provided in the screenshot below.

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2F9EAGHDyrjgcN6MrJWc6O%2Fimage.png?alt=media&amp;token=3faa4421-8762-48af-8b55-73128ab59d84" alt=""><figcaption></figcaption></figure>

Enter the Service User details from the [preparation checklist](https://docs.theconfigteam.com/prebilt-ewm/installation/prebilt-standalone-edition-installation/import-the-base-framework#preparation-checklist).

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2F1wp7tcpeIM4YKljtcZZt%2Fimage.png?alt=media&amp;token=fb21c870-df3f-4ff0-83d5-45d99e58e442" alt=""><figcaption></figcaption></figure>

The **Handler to be added** should be:

```
/TCTM/EWM_ICF_DYNUI
```

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2F5qRdSCfZlShd5bOUm6x1%2Fimage.png?alt=media&amp;token=e0fcb509-6fc4-49fb-8794-08413cb4de7f" alt=""><figcaption></figcaption></figure>

Upon saving, assign the package. You will then be prompted to enter a Workbench transport.

When complete, right click **uidyn** and click **Activate Service**.

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2FZmSCRZ6D3EfzzeAefaNw%2Fimage.png?alt=media&amp;token=0691e86e-576d-4c0a-910c-2d846a195a87" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**

Ensure that any services requiring activation are fully activated and that the Service User is configured in all environments and clients throughout the project.
{% endhint %}

## Launch the application

{% hint style="info" %}
**Note**

This may launch the HTTP version of the URL rather than HTTPS. HTTPS is preferred and required for all functionality to work as expected. If the URL does not launch correctly, check that the correct port is being used for HTTP or HTTPS.
{% endhint %}

<figure><img src="https://1016750988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7lFTpSLijn44pippdL6u%2Fuploads%2Fgit-blob-45766b13c1cbce9f4f9433e720b1a112d3978fbb%2FEWM-launch%20application.png?alt=media" alt=""><figcaption></figcaption></figure>
