> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/user-guides/it/import-records-1/import-a-.csv-file.md).

# Importazione di file di testo (.csv, .xls, .tsv)

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FiUkx8lvx84X0XZdz92NR%2FImport-Keeper-CSV.jpg?alt=media&#x26;token=fb35ab21-7e7d-4326-b0a2-47aba849067d" alt=""><figcaption></figcaption></figure>

## Istruzioni di importazione

Keeper può importare accessi e password da un file di testo (.csv, .xls, .tsv).

1. Per iniziare, dal **menu a discesa Account**, faccia clic su **Impostazioni**.

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FSAyF0pTOwpYisXvU9x1P%2FScreenshot%202026-01-23%20at%202.39.35%E2%80%AFPM.png?alt=media&#x26;token=4308988e-a53e-4428-8589-4aa6c29819e3" alt=""><figcaption><p>Menu a discesa Account > Impostazioni</p></figcaption></figure>

2. Faccia clic su **Importa > Importa** (accanto a «Usa un'altra fonte»).

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2F7n5Oy6CfK0yiGJkb8h2N%2FSettings%20(8).png?alt=media&#x26;token=683a792a-6267-4c5a-a794-dcb2f4d883c4" alt=""><figcaption><p>Importare da un file o da un gestore di password</p></figcaption></figure>

3. Dal menu a discesa, selezioni **File di testo (.csv, .xls o .tsv)**, quindi faccia clic su **Visualizza istruzioni**. Il metodo di importazione CSV di Keeper supporta strutture avanzate, incluse cartelle, sottocartelle, cartelle condivise e un numero qualsiasi di campi personalizzati.

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FEBjTP8UbMloy7HsEZ6oN%2Fimage%20(6).avif?alt=media&#x26;token=262d18f6-f4e3-4eef-a43f-164e43c6f082" alt=""><figcaption><p>Importare da file di testo</p></figcaption></figure>

4. Dopo aver creato il file di esportazione secondo le istruzioni, trascini e rilasci il file sulla finestra «Trascina qui un file» di Keeper oppure lo cerchi sul computer. Selezioni la casella se il file include intestazioni di colonna; in caso contrario, la prima riga verrà trattata come dati.

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FJj50L1DIgox9PRB02Oxb%2Fimage%20(7).avif?alt=media&#x26;token=6ea6e723-a847-4782-b13c-96010402e333" alt=""><figcaption><p>File caricato</p></figcaption></figure>

5. Dopo aver importato le credenziali con uno dei metodi sopra, può personalizzare come visualizzare le informazioni nella cassaforte nella schermata di mappatura dei campi. Qui vedrà i nomi dei campi standard in alto che «mappano» i dati sottostanti per ogni voce di Keeper.

Per regolare queste mappature:

* Faccia clic su un campo qualsiasi per aprire un menu a discesa
* Selezioni il nome del campo appropriato dall'elenco. Ripeta il processo su ogni colonna secondo necessità
* Faccia clic su **Successivo** per finalizzare le selezioni.

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2F7UwenNtpvzaOuRfF1Cq7%2Fimage%20(3).avif?alt=media&#x26;token=cbee3e5d-8a41-4c76-8325-e12efdb22878" alt=""><figcaption><p>Rivedere e modificare le informazioni importate</p></figcaption></figure>

6. Successivamente, una schermata di riepilogo mostrerà un'anteprima della cassaforte con la struttura delle cartelle delle voci importate. Qui può regolare la struttura delle cartelle e aprire le singole voci per visualizzarne i dettagli prima di finalizzare l'importazione. Faccia clic su **Conferma importazione** per completare il processo di importazione.

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FcXq2B3rTEEpXGA5KqvP3%2Fimage%20(4).avif?alt=media&#x26;token=102408a1-7d6b-412b-9e3d-41db8cbc080a" alt=""><figcaption><p>Riepilogo dell'importazione</p></figcaption></figure>

Al termine dell'importazione, consigliamo vivamente di eliminare dal computer eventuali file di password non crittografati e di disattivare i vecchi gestori di password.

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FN075CmhLSNQKkV2EcjIw%2Fimage%20(5).avif?alt=media&#x26;token=181747ac-5b71-431f-beec-0e23a6a5884d" alt=""><figcaption><p>Importazione riuscita</p></figcaption></figure>

## Risoluzione dei problemi

* Se desidera condividere solo alcune cartelle, dovrà suddividere il file CSV in due file distinti prima di importare ciascuno di essi.
* Se nell'importazione compaiono caratteri danneggiati, verifichi che il file CSV sia stato salvato/esportato con codifica UTF-8 o Unicode.

***

## Mappatura avanzata dei campi

Il metodo di importazione CSV di Keeper supporta anche strutture avanzate, incluse **Cartelle**, **Sottocartelle, Cartelle condivise e un numero qualsiasi di Campi personalizzati (CustomFieldName,CustomFieldValue).**

{% code title="Ordine dei campi nel file CSV" overflow="wrap" fullWidth="true" %}

```
Folder,Title,Login,Password,Website Address,Notes,Shared Folder,CustomField1Name,CustomField1Value
```

{% endcode %}

<table data-full-width="true"><thead><tr><th width="185">Folder</th><th width="97">Title</th><th width="191">Login</th><th width="217">Password</th><th width="171">Website Address</th><th>Notes</th><th width="139">Shared Folder</th><th width="159">Custom Field1 Name</th><th width="186">Custom Field1 Value</th><th>Custom Field2 Name</th><th>Custom Field2 Value</th><th>Custom Field3 Name</th><th>Custom Field3 Value</th><th width="73">Custom Field4 Name</th><th>Custom Field4 Value</th></tr></thead><tbody><tr><td>Folder1\subfolder</td><td>Google Account</td><td>user@example.com</td><td>liu.W241Q&#x3C;q$RGl9r;N1</td><td><a href="http://www.google.com/">www.google.com</a></td><td>main google account</td><td>TeamFolder</td><td>$oneTimeCode</td><td>otpauth://totp/?secret=ABC123ABC123ABC123ABC123ABC123</td><td>$type</td><td>login</td><td>$host</td><td>10.0.0.1</td><td>$url</td><td><a href="http://www.example.com/">www.example.com</a></td></tr></tbody></table>

• Per specificare le sottocartelle, usi la barra retroversa «\» tra i nomi delle cartelle\
• Per creare una cartella condivisa, specifichi il nome o il percorso nel 7º campo

Di seguito è riportato un elenco di alcuni tipi di voce (ne può avere di più se ha tipi di voce personalizzati, o di meno se ne sta limitando alcuni):

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FfutxI0asR1RJ7Fstu6uV%2FWindowsTerminal_wOnQKBPAAK.png?alt=media&#x26;token=3ee232a4-a43f-4257-8d9b-0714c034c137" alt=""><figcaption><p>Il tipo di voce può essere definito con il nome di campo personalizzato $type</p></figcaption></figure>

Di seguito è riportato un elenco di tutti i tipi di campo possibili (inclusi i campi personalizzati):

<figure><img src="https://914511346-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSGVtOTYUIkVBoYtFvK%2Fuploads%2FVIGQh9gDy9se7w9sL1aW%2FWindowsTerminal_myNZzFQtif.png?alt=media&#x26;token=f9324c06-f8c7-460d-98ea-22f2043d92a0" alt=""><figcaption><p>Tutti i tipi di campo</p></figcaption></figure>

**Esempio 1: creare una cartella normale a livello root con 2 campi personalizzati**

```
My Business Stuff,Twitter,marketing@company.com,123456,https://twitter.com,These are some notes,,API Key,5555,Date Created,2018-04-02
```

**Esempio 2: creare una sottocartella condivisa con autorizzazione di modifica e ri-condivisione, all'interno di una cartella normale**

```
Personal,Twitter,craig@gmail.com,123456,https://twitter.com,,Social Media#edit#reshare
```

**Esempio 3: creare una cartella condivisa con autorizzazione di modifica e ri-condivisione all'esterno e una struttura di cartelle annidate al di sotto.**

```
Personal\Financial\Home,Chase,craig@gmail.com,123456,https://chase.com,,Family Records#edit#reshare
```

In questo 3º esempio, la cartella condivisa esterna si chiama «Family Records» e sotto di essa c'è una struttura di cartelle. La voce viene aggiunta alla cartella annidata a 3 livelli di profondità.

Per visualizzare in anteprima la struttura di importazione, trascini e rilasci il file nella schermata Importa e faccia clic su **Successivo**.

## Note sulla gestione di cartelle e sottocartelle

Una Cartella, una Sottocartella (cartella annidata) e una Cartella condivisa sono oggetti creati in modo indipendente dalle voci. Le cartelle vengono spesso usate per categorizzare voci di tipo simile.

L'implementazione delle cartelle di Keeper è potente e flessibile e include funzioni di facilità d'uso come il trascinamento.

* Una cartella è un contenitore di voci e di riferimenti a voci (collegamenti).
* Una cartella condivisa è un contenitore di voci, con capacità flessibile di condivisione con utenti e team.
* Una cartella può essere composta da voci personali, voci condivise o altre sottocartelle normali.
* Le sottocartelle possono essere condivise o personali.
* Può creare un numero illimitato di cartelle e cartelle condivise.
* Una cartella condivisa può contenere un numero illimitato di sottocartelle; ogni sottocartella sotto una cartella condivisa conserva le autorizzazioni della cartella padre.
* Non c'è limite alla profondità della struttura delle cartelle.
* Le cartelle e le sottocartelle contenute in cartelle condivise ereditano le autorizzazioni della cartella condivisa.
* Una cartella condivisa con un solo utente (niente di condiviso con altri) resta comunque una Cartella condivisa.
* Una cartella condivisa non deve necessariamente essere condivisa con altre persone.

## Autorizzazioni delle voci

Le autorizzazioni delle voci all'interno di una Cartella condivisa possono essere controllate singolarmente con le due autorizzazioni seguenti:

* **Può modificare -** quando questa autorizzazione è abilitata, la voce può essere modificata da **qualsiasi utente** della cartella condivisa.
* **Può condividere** **-** quando questa autorizzazione è abilitata, le voci possono essere condivise da **qualsiasi utente** della cartella condivisa.

Keeper supporta anche formati di file JSON strutturati avanzati. Consigliamo di usare file JSON per l'importazione e l'esportazione di dati strutturati al posto dei file CSV. La descrizione è nella [pagina Importazione JSON.](/user-guides/it/import-records-1/import-json.md)

## Importazione con Commander CLI

La [Keeper Commander CLI](/keeperpam/commander-cli/command-reference/import-and-export-commands/import-export-commands.md) (in inglese) supporta funzionalità di importazione più avanzate con file CSV e JSON.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.keeper.io/user-guides/it/import-records-1/import-a-.csv-file.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
