> For the complete documentation index, see [llms.txt](https://docs.pascom.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pascom.net/integrations/connector/user-csv-import.md).

# Benutzer aus CSV-Datei

Importieren Sie Ihre Benutzer aus externen Systemen via CSV

## Connector-Profil "Benutzer aus CSV"

| Variablen                     | Beschreibung                                                                                                                            |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Bezeichnung**               | Bezeichnung des Profils                                                                                                                 |
| **Typ**                       | <p>Wählen Sie aus wie die CSV-Datei zur Verfügung gestellt wird. Optionen:<br><em>Default</em>: Upload in Browser<br>Fetch from url</p> |
| **Zeichensatz der CSV-Datei** | Gibt an in welchem Format die CSV-Datei vorliegt. Wie empfehlen Ihnen UTF-8 zu verwenden.                                               |
| **Trennzeichen**              | Mit welchem Trennzeichen wurden die Felder separiert.                                                                                   |
| **Zeilenende**                | Wenn die CSV-Datei unter Windows oder Mac/Linux erstellt worden ist, unterscheidet sich das Zeilenende.                                 |
| **Feldeinfassung**            | Wir empfehlen die einzelnen Felder mit Zeichen einzufassen, z. B. "Max Muster"                                                          |

Nach dem Speichern kann die Vorlage im Reiter **Basisdaten** bei Bedarf angepasst werden.

### Basisdaten

In den Basisdaten konfigurieren Sie den CSV-Import genauer oder können die zuerst konfigurierten Einstellungen ändern.

| Feld                | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Bezeichung**      | Name des Connectors (*wird automatisch befüllt*)                                                                                                                                                                                                                                                                                                                                                                        |
| **Quelle**          | CSV (*nicht veränderbar*)                                                                                                                                                                                                                                                                                                                                                                                               |
| **Modus**           | <p><strong>Neue Sätze importieren, geänderte abgleichen und früher importiere Datensätze entfernen</strong>: (<em>Standardauswahl</em>) Importiert nur neue Telefonbucheinträge und gleicht geänderte Einträge ab, alte Einträge werden entfernt.<br><strong>Neue Sätze importieren und geänderte abgleichen</strong>: Importiert neue Telefoneinträge und gleicht geänderte ab. Es werden keine Einträge entfernt.</p> |
| **Typ**             | <p>Wurde beim Erstellen <strong>Upload in Browser</strong> gewählt: Manuell Hochladen<br>Wurde beim Erstellen <strong>Fetch from url</strong> gewählt: Von URL herunterladen</p>                                                                                                                                                                                                                                        |
| **CSV Datei**       | Wurde "Upload in Browser" ausgewählt, kann hier die Datei direkt hochgeladen werden.                                                                                                                                                                                                                                                                                                                                    |
| **CSV Datei URL**   | Wurde "Fetch from url" ausgewählt, kann hier die URL zur Datei eingetragen werden.                                                                                                                                                                                                                                                                                                                                      |
| **Trennzeichen**    | Mit welchem Trennzeichen wurden die Felder separiert. (*wird automatisch befüllt*)                                                                                                                                                                                                                                                                                                                                      |
| **Datei Format**    | Gibt an in welchem Format die CSV-Datei vorliegt. (*wird automatisch befüllt*)                                                                                                                                                                                                                                                                                                                                          |
| **Zeilenende**      | Gibt das Betriebssystem an auf dem die CSV-Datei erstellt wurde (*wird automatisch befüllt*)                                                                                                                                                                                                                                                                                                                            |
| **Feld Einfassung** | Gibt an ob und welche Feldeinfassung in der CSV-Datei verwendet wird (*wird automatisch befüllt*                                                                                                                                                                                                                                                                                                                        |
| **Dokumentation**   | Dient zur Dokumentation/ Beschreibung des Connectors                                                                                                                                                                                                                                                                                                                                                                    |

### Pre Filter

Im Standard importiert die Vorlage alle Zeilen der CSV-Datei. Über den Reiter **Pre Filter** können Sie den Import auf bestimmte Werte einschränken, z. B. die Spalte *displayname*, ist nicht leer. Ersetzen Sie dazu "return true;" durch folgenden Code:

```
    return array_key_exists('displayName', $row);
```

### Benutzerfelder aus CSV

Im Reiter **Variablen** sehen Sie welche Felder in PASCOM importiert werden können. Die Feldzuordnung von CSV > PASCOM können Sie unter diesem Reiter an Ihre Bedürfnisse anpassen. Standardmäßig entsprechen die CSV-Spaltennamen dem Feldnamen in PASCOM.

Hier ein Beispiel für eine CSV- Datei:

```
    "displayname","username","password","pin","phone","givenname","surname","email","mobile","homephone","job"
    "Max Muster","mmuster","12ab34cd56","1234","345","Max","Muster","","","","Vertriebsleiter"
```

### Importlauf testen und aktivieren

Nachdem Sie die Konfiguration abgeschlossen haben, können Sie durch die Schaltfläche **Speichern und Simulieren** testen, welche Datensätze importiert werden würden. Wenn Sie mit dem Ergebnis zufrieden sind können Sie den Import entweder einmalig unter **Aktion** > **Import jetzt durchführen** ausführen oder durch die Schaltfläche **Automatisieren** eine regelmäßige Durchführung des Importes einrichten.

{% hint style="info" %}
Ein automatisierter Import wird nur empfohlen, wenn als Importtyp **Fetch from url** ausgewählt wurde.
{% endhint %}

#### Optionale Änderungen

Sie möchten Änderungen an Quellvariablen oder der Connector Struktur vornehmen? Dann folgen Sie den folgenden Links zu den entsprechenden Anleitungen:

[Variablen Zuweisung](/integrations/connector/variables-assignment.md)

[Variablen Struktur](/integrations/connector/variables-structure.md)

#### IP-Telefone zuweisen

Sie können via CSV einem Benutzer direkt ein IP-Telefon zuweisen.

**IP-Telefon via MAC zuweisen:**

Wenn Sie dem Benutzer ein pascom-Softphone zuweisen möchten, muss keine zusätzliche Variable im PASCOM Connector angelegt werden.

Fügen Sie hierzu lediglich in Ihrer CSV-Datei die Spalten "phonemac" und "phoneip" hinzu, in der Sie die MAC-Adresse und IP-Adresse des IP-Telefons eintragen.

Dadurch wird dem importierten Benutzer automatisch ein IP-Telefon mit dieser MAC-Adresse zugewiesen.


---

# 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 following URL with the `ask` and `goal` query parameters:

```
GET https://docs.pascom.net/integrations/connector/user-csv-import.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

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.
