> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrace uživatelských jmen

## Migrace uživatelských jmen

Z hlediska přihlašování je primárním identifikátorem uživatele jeho e-mailová adresa. Pokud přecházíte z místního ověřování na SSO nebo z jednoho IdP na jiný, může být nutné aktualizovat e-mailové adresy uživatelů.

S tím pomáhá dodávaný skript, který migruje e-maily uživatelů pomocí souboru CSV v následujícím formátu:

`oldEmail,newEmail`

Po provedení několika ověřovacích kontrol skript projde soubor CSV a aktualizuje e-mailové adresy uživatelů z `oldEmail` na `newEmail`.

### **Ověření**

Před spuštěním migrace bude soubor `<csv_file>` zkontrolován, aby se zajistilo, že:

* V každém řádku jsou `oldEmail` i `newEmail` platné e-mailové adresy
* Neexistují duplicitní záznamy, například se nepokoušíte aktualizovat různé uživatele na stejnou novou e-mailovou adresu ani aktualizovat stejný uživatelský účet na již použitou e-mailovou adresu

### **Použití**

```bash wrap theme={null}
docker cp <csv_file> sharelatex:/overleaf/services/web/<csv_file> docker exec sharelatex /bin/bash -c "cd /overleaf/services/web;node ./modules/server-ce-scripts/scripts/migrate-user-emails.js [--commit] [--continue|--ignore-missing] [--admin-id=ADMIN_USER_ID] <csv_file>"
```

### **Příznaky**

| Název | Popis |
| - | - |
| `--commit` | <p>Zahrnutí příznaku `--commit` migraci skutečně provede. Pokud je vynechán, migrace proběhne v režimu zkušebního běhu (dry-run), ve kterém se neprovádějí žádné změny, ale ověření se přesto provede.<br /><br /><strong>Výchozí</strong>:`false`</p> |
| `--continue` | Příznak `--continue` pokračuje v procesu migrace, pokud již byla e-mailová adresa u uživatelského účtu aktualizována |
| `--ignore-missing` | Příznak `--ignore-missing` pokračuje v procesu migrace, pokud uživatelský účet nebyl nalezen |
| `--admin-id` | `--admin-id` by měl být nastaven na ID administrátora, který migraci provádí, a použije se pro záznamy v auditním záznamu. Své user-id zjistíte tak, že přejdete do **Admin** > **Manage Users**, vyhledáte svou e-mailovou adresu a kliknete na první výsledek. |
| `<csv_file>` | `<csv_file>` je soubor se starými a novými e-mailovými adresami |

### **Dokončení**

Během provádění migračního skriptu závisí na zvolených příznacích, zda se chyba zapíše do konzole a skript pokračuje, nebo se zapíše do konzole a skript skončí. Pokud skript kvůli chybě skončí předčasně, ukončí se s kódem 1, který značí neúspěch.

Po dokončení migrace skript vypíše do konzole počet úspěšných, neúspěšných a přeskočených aktualizací. Pokud migrace proběhne úspěšně, skript se ukončí s kódem 0.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.