# Penambahan Fitur Switch Tenant untuk Multi Tenants di SMH - \[28 May 2024]

Halo, Kawan Simpli!\
\
Ada kabar yang perlu kamu tahu, nih!\
\
Kini, terdapat penambahan fitur switch tenant untuk kamu yang memiliki banyak cabang distributor pada SMH agar dapat memudahkan dalam memonitori beberapa cabang sekaligus hanya dengan 1 user untuk memaksimalkan penggunaan sistem.

Untuk kamu yang punya banyak cabang, tentu sangat perlu untuk memonitori secara langsung database tenant yang kamu miliki. Tentunya, kamu perlu 1 akun yang powerful untuk bisa masuk ke beberapa database tenant tanpa harus memiliki banyak user ditiap database tenant.

Nah, untuk bisa menggunakan 1 user dengan fitur switch tenant ini ada beberapa syarat yang perlu diketahui. 

Adapun **syarat** untuk dapat melakukan switch tenant adalah sebagai berikut:

1. User/akun harus di-assign ke role group (konfigurasi akses) yang memiliki role group item berikut:
   1. TenantControl atau 
   2. TenantRead  dan TenantSwitch
2. Tenant yang dipilih telah terdaftar pada akun tersebut.\
   (Untuk mendapatkan akses ke beberapa tenant yang diinginkan, kamu harus *request* ke tim CSA SimpliDOTS untuk dibantu assign/allow)

Perubahan atau penambahan tampilannya sebagai berikut:

#### **1. Menu Switch Tenant**

<figure><img src="https://lh7-us.googleusercontent.com/3qprhpKHvi0ogkJyEdgBKSUL8KElr9qbRRfvi2SHnjc7YdSnHdqhhG7H1w47T8E8JEF2Zlt6Cz9yppY6M0ZhcMq62qev4T6ht7oVqOpz7VSVpf7UnRdM4br96krpJsQb112H-Cn0QR9jqNP-dVBgE0M" alt=""><figcaption></figcaption></figure>

Menu switch tenant dapat diakses melalui tombol profile pada sebelah kanan top bar.

{% hint style="warning" %}
**NB:**&#x20;

menu switch tenant tidak akan muncul jika syarat di atas tidak terpenuhi.
{% endhint %}

#### 2. Pilih Tenant

<figure><img src="https://lh7-us.googleusercontent.com/XdX4CyehpaAW188ZFIbpY9b-eEqQEBncQ_-NWCJXT9_RRv3jF3mnVtnyPpH9Td7ymhpvLmaNw7Kscug9kbklaF0vzeWXGI6gT6J854ZjbIYHhfy8uneDJHCgfsrWswZK7TVv7ZMmV8xYPPDZJLmQw5A" alt=""><figcaption></figcaption></figure>

Tampilan untuk memilih tenant dapat dilihat seperti gambar di atas. Hanya tenant yang terdaftar atau terafiliasi dengan akun yang sedang login yang akan ditampilkan dan dapat dipilih.

Beberapa skenario yang dapat terjadi setelah switch tenant antara lain sebagai berikut:

* **Logout**\
  Jika tenant yang dipilih belum pernah dipilih sebelumnya atau cache (pada sistem) sudah expired, maka user akan diminta untuk login ulang. Informasi juga ditunjukkan dalam bentuk pesan sukses switch tenant.<br>

  <figure><img src="https://lh7-us.googleusercontent.com/5qUsPRGodM6i7CweBImVFrEJ3FYxt03tauJv6PLvSjHntipADk3_wfDgKbiSVwPaP2K_fL0GaDyV0UHfYAAwAHZeDTk7IYMB5-5jTHBalWHNEe8BAXOPoZGBtJI-LkfMIegOLtAkKUwSEnaNBc3swzg" alt=""><figcaption></figcaption></figure>
* **Tidak logout**

Jika tenant yang dipilih sudah pernah dipilih sebelumnya dan sessionnya (pada sistem) belum expired, maka user tidak perlu logout dan informasi sukses switch tenant akan muncul. Selain itu, user akan dibawa ke laman dashboard.<br>

<figure><img src="https://lh7-us.googleusercontent.com/qdLTj8DomqUof8keawx09IdcuviAUD3BEVtwZjjLQLi0DP6HZBS8W8xgZbfAYXT7iWD0seKOx3KIf0sewWJjUIKbmVaOPyEFklUEcE42ce-2pEJvVcIwQu280SksTpK4Cn19ypaUPKaWoLxQAkhlU98" alt=""><figcaption></figcaption></figure>

* **Tambahan Setelah Login**

Setelah login, terdapat pesan sukses login dengan informasi nama tenant/company yang sedang diakses sekarang.

<figure><img src="https://lh7-us.googleusercontent.com/7P2AO-UH8uu4LvoSIRq4hspoMeuVoUF7Q08_qRu61nQhlcQDpsAUSfZvLy5tIH6b0HbMmuPmV6AV4i-gcVuyVhuu_zI54cgsNKgQlExct1KcM2TVSBn0rFFjQN0uiWXn6qVyKiL_CK1c3dGrQMCNLts" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-us.googleusercontent.com/QQhSKYsqqZ29DknPOHE5CX7_Glrc9rdhWnC_TmUsWoUy7Q_IxxbrXY38Si0yUOolS-WE9KwBNzSq_jprKyae4xcLZgsc6x6wTjKewqHfBIIOXN0cvHrKKmZ8yPo7FDCgLzX6tJOrTrUr4S4WBfwP0FE" alt=""><figcaption></figcaption></figure>

### <mark style="color:red;">**ATTENTION!**</mark>

Terdapat beberapa kasus dimana user mengakses SMH pada beberapa tempat sekaligus dengan akun yang sama (yang melakukan switch tenant) antara lain:

* **Multiple Tab (browser yang sama)**

Jika pada tab yang satu user melakukan switch tenant, maka tab yang lain akan muncul suatu popup yang meminta user untuk refresh page dan dibawa ke dashboard sehingga perubahan tenant dapat diimplementasikan sistem.

<figure><img src="https://lh7-us.googleusercontent.com/urLyomJIms7l5xQvmeaiPTaAIVhmO4jfYII_DecVhvAzpkzmdX1_F7uE0QKFUAxx7SsI2blqrUY2LbTsWwWJavMtdlmeeRcDtykd3xfN10LTI41LngLoJWllhM4_R1_OFk_rTpmIrSb40ZtmHRUmqW4" alt=""><figcaption></figcaption></figure>

* **Multiple Browser (1 device, browser yang berbeda) & Multiple Device**

Browser yang tidak melakukan switch tenant akan tetap memiliki session tenant yang lama. User perlu melakukan re-login secara manual untuk mendapatkan sesi terbaru.

Selamat mencoba, Kawan Simpli!

<figure><img src="/files/PthbHzVIlPzfWNXCxaYZ" alt="" width="164"><figcaption><p>Salam Hangat<br>- Androsim -</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://fitur-sap.simplidots.id/smh/fitur-pada-smh-sales-management-hub/2024/penambahan-fitur-switch-tenant-untuk-multi-tenants-di-smh-28-may-2024.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.