Skip to main content

Erstellung eines neuen Imports

  1. Navigieren Sie zu Einstellungen > Importeinstellungen > Stammdatenimporte > Importe.

  2. Klicken Sie auf der Übersichtsseite auf die Schaltfläche Neuer Import.

  3. Beginnen Sie im Importassistenten mit Schritt 1 "Ziel".

    Wählen Sie die Kartenart, welche Sie importieren möchten.

    Fügen Sie optional eine Kurzbeschreibung hinzu.

  4. Navigieren Sie zu Schritt 2 "Quelle" und wählen Sie den Quellentyp, aus dem Sie importieren möchten.

    Available import sources

    Anmerkung

    Wir empfehlen, den CSV/XLSX-Import zu verwenden. Um den Import aus einer Datenbank zu ermöglichen, benötigen Sie umfangreiche Kenntnisse zur Sicherung des SQL-Servers.

    Wenn Sie noch keine Quelldatei haben, verwenden Sie xlsx-Vorlage herunterladen, um eine leere, vorformatierte Datei zum Ausfüllen zu erhalten.

    Nachdem Sie Ihren Import mit einer Quelle verbunden haben, geben Sie die Zeitzone für alle Datumsfelder in der Quelldatei an.

    Hinweis

    Für den Import von Quelldateien ist eine maximale Dateigröße von 35 MB festgelegt.

    Optional können Sie nach Quelldaten filtern, um lediglich den relevanten Teil der Quelle zu importieren.

  5. Gehen Sie zu Schritt 3 "Feldzuordnung", um die aufgelisteten Quellfelder ihrem zugehörigen Feld in TOPdesk zuzuordnen. Im Folgenden wird die Feldzuordnung erläutert.

  6. Navigieren Sie zu Schritt 4 "Importeinstellungen" .

    Wählen Sie in der Dropdown-Liste Eindeutiger Schlüssel, welches TOPdesk Feld Sie als eindeutigen Schlüssel verwenden möchten.

    Anmerkung

    Die Werte des Feldes sollten sowohl in der Quelldatei als auch in TOPdesk eindeutig sein, damit die Quelldaten mit der richtigen TOPdesk Karte verknüpft werden können.

    Wenn Sie kein Feld mit eindeutigen Werten haben, können Sie zwei Felder kombinieren. Aktivieren Sie das Kontrollkästchen Einen zusammengesetzten eindeutigen Schlüssel verwenden und wählen Sie aus, welche TOPdesk Felder kombiniert werden sollen.

    Wählen Sie aus, ob Sie den Import aktivieren möchten, um neue Karten zu erstellen und/oder bereits bestehende Karten zu aktualisieren.

    Sie haben auch die Möglichkeit, zu de-archivieren und vorhandene archivierte Karten zu aktualisieren (wenn Sie die Option deaktivieren, werden alle archivierten Karten beim Import übersprungen).

    Wählen Sie außerdem aus, wie vorhandene Karten, welche nicht in der Quelle enthalten sind, verarbeitet werden sollen. Sollen sie beim Import ignoriert oder archiviert werden?

    Tipp

    Wenn Sie einzelne Stapel von Karten mit einer CSV- oder Excel-Datei importieren, kann es sinnvoll sein, TOPdesk als führend zu setzen. Sie müssen dann nicht alle Karten des entsprechenden Typs in Ihre Quelle aufnehmen.

  7. Gehen Sie zu Schritt 5 "Terminierung", um anzugeben, ob Sie den Import manuell oder automatisiert ausführen möchten.

    Automatisierte Importe basieren auf dem automatischen Hochladen von Dateien und werden jedes Mal ausgeführt, wenn eine Datei mit dem hinterlegten Namen erneut hochgeladen wird. Weitere Informationen finden Sie im Kapitel Einrichtung des automatisierten Datei-Uploads.

  8. Navigieren Sie zu Schritt 6 "Vorschau", um herauszufinden, wie viele Assets erstellt und aktualisiert werden, sowie um mögliche Fehler zu beurteilen.

    Anmerkung

    Was können Sie von der Vorschau erwarten? Lesen Sie mehr dazu unter Die Importvorschau im Detail.

  9. Klicken Sie auf Speichern und ausführen, um einen manuellen Import durchzuführen, oder Speichern und aktivieren, um einen automatischen Import durchzuführen.

    Warnung

    Sorgen Sie immer für ein Backup, bevor Sie den Import starten!

Erklärung der Feldzuordnung

Ordnen Sie Ihre Quellfelder (rechts) den zugehörigen Feldern in TOPdesk (links) zu und legen Sie fest, wie der Import diese Felder füllen soll.

  • In der Dropdown-Liste Zuordnung sehen Sie das entsprechende TOPdesk Feld.

    Wählen Sie, wie das Feld gefüllt werden soll:

    • Feld aus meiner Quelle verwenden: Wählen Sie in der Dropdown-Liste unten das Quellfeld aus, aus dem der Wert importiert werden soll.

      Legen Sie außerdem fest, welche Datenart das Quellfeld enthält.

    • Definieren Sie einen Fixwert: Wählen Sie in der Dropdown-Liste unten den Wert aus, der in das TOPdesk Feld eingefügt werden soll.

    • Werte aus Quellfeldern umwandeln: Konfigurieren Sie die nachstehenden Einstellungen, um Ihre Quelldaten zu konvertieren oder Werte zu kombinieren, bevor Sie sie in TOPdesk importieren.

      Im Kapitel Konvertieren von Werten wird die Einrichtung erklärt.

Hinweis

Sämtliche mit einem Sternchen * versehenen Felder müssen zugeordnet werden, bevor Sie mit dem nächsten Schritt fortfahren können. Vergewissern Sie sich, dass alle Felder unter Wählen Sie ein TOPdesk-Feld mit einem Sternchen zugeordnet sind.

Optionale Einstellungen

In den optionalen Einstellungen eines zugeordneten Feldes (zu finden durch Anklicken eines zugeordneten Feldes) können je nach Karte und Feldart verschiedene Zusatzfälle festgelegt werden:

  • Verfahren für leere Quellwerte: Legen Sie fest, was mit leeren Werten in der Quelle geschehen soll. Sie können TOPdesk einen Standardwert eintragen lassen, das Feld leer lassen oder den Wert so belassen, wie er in TOPdesk steht.

  • Verfahren für in TOPdesk fehlende Werte: Wenn Sie Werte für eine Dropdown-Liste importieren, können Sie festlegen, was mit nicht erkannten Werten geschehen soll. Verfügbare Optionen sind das Überspringen des Datensatzes, das Löschen des Feldes auf der betreffenden Karte oder die Verwendung eines Ersatzwertes.

    Für einige Felder sind Zusatzoptionen verfügbar, um neue Karten auf Grundlage der Quelle zu erstellen und die bereits in TOPdesk ausgefüllten Werte beizubehalten. Wenn zum Beispiel beim Import von Stammdaten der Wert für das Land noch nicht in TOPdesk vorhanden ist, wird er entweder erstellt oder aus dem Archiv abgerufen.

  • Wie soll mit Werten verfahren werden, die länger als # Zeichen sind?: Die meisten Text- und Zahlenfelder in TOPdesk haben eine maximale Eingabelänge. Wenn die Quelle mehr Zeichen enthält, können Sie TOPdesk den Datensatz überspringen lassen, die bereits in TOPdesk vorhandenen Werte beibehalten oder nur die ersten # Zeichen importieren.

  • Nur Werte für dieses Feld importieren, wenn es in TOPdesk leer ist: Je nach ausgewähltem Feld können Sie über dieses Kontrollkästchen unten in den optionalen Einstellungen festlegen, dass Werte in TOPdesk nicht vom Import überschrieben werden dürfen.

Die Importvorschau im Detail

Nachdem Sie die Importkonfiguration im Assistenten abgeschlossen haben, erstellt TOPdesk eine Importvorschau (Schritt 6, 'Vorschau').

Zu erstellende Karten: TOPdesk hat keine bereits existierende Karte mit demselben eindeutigen Schlüssel gefunden, der Ihrer Importquelle zugeordnet werden konnte. Die Karte wird durch den Import erstellt. [3]

Zu aktualisierende Karten: TOPdesk hat eine bereits existierende Karte mit demselben eindeutigen Schlüssel gefunden, der Ihrer Importquelle zugeordnet werden konnte und erkennt sie für eine mögliche Aktualisierung an.[3]

Anmerkung

Bitte beachten Sie, dass TOPdesk die Übersicht auf der Grundlage der in Ihrer Quelle ermittelten Daten erstellt. Wenn sich Ihre Quellwerte nicht geändert haben, werden sie als Zu aktualisierende Karten angezeigt, auch wenn sie nicht tatsächlich aktualisiert werden.

Sie können das Ergebnis nach der Ausführung des Imports überprüfen.

Zu archivierende Karten: TOPdesk hat in Ihrer Importquelle keine bereits zugeordnete Karte gefunden. Die Karte wird durch den Import archiviert.

Anmerkung

Karten, die auf Grundlage der Importquelle aus dem Archiv abgerufen werden, sind unter Zu aktualisierende Karten aufgeführt.

[3]

Fehler: In manchen Fällen kann TOPdesk potenzielle Fehler erkennen, wie z. B. Probleme mit dem eindeutigen Schlüssel und Quellfelder mit falschen Werten.

Verfügbare Importziele in TOPdesk

Der erste Schritt im Importassistenten ist, das Ziel in TOPdesk zu definieren. Allgemein verwenden wir den Begriff Kartenart, um die verfügbaren Ziele zu benennen, auch wenn es sich bei einigen um Suchlisten handelt, wie z. B. Kostenstelle:

  • Person

  • Personengruppe

  • Bearbeiter

  • Bearbeitergruppe

  • Niederlassung

  • Raum

  • Abteilung

  • Kostenstelle

Beispiele

Setting up SCIM provisioning with Microsoft Entra ID

SCIM (System for Cross-domain Identity Management)

SCIM lets you automate operator account management in TOPdesk. TOPdesk's SCIM implementation meets all mandatory requirements of the SCIM protocol, so it works with any compliant identity provider, such as Microsoft Entra ID. A SCIM integration can automatically create, update, and deactivate operator accounts based on changes in your identity provider. This helps keep user information up to date and reduces manual account administration.

Read SCIM for more information about SCIM in TOPdesk.

note

This topic walks you through an example configuration using Microsoft Entra ID, the identity provider most commonly used with TOPdesk. The steps for connecting a different SCIM-compliant identity provider will differ on the identity provider's side, but the SCIM source configuration in the TOPdesk import wizard stays the same.

Configuring Microsoft Entra ID

  1. Log into the Microsoft Entra admin center (external) and register a new application.

    step1-entra.jpg

  2. After clicking New application, click Create your own application.

  3. Enter a name and select Integrate any other application you don't find in the gallery (Non-gallery).

  4. Click Create.

  5. In the newly-created application, navigate to Manage > Provisioning.

  6. In the top menu, click New configuration, or in the Get started menu, click Connect your application.

  7. Next, fill in the Provisioning details (step 2 'Source' in the Import wizard of the SCIM import):

    • Authentication method;

    • Tenant URL;

    • Token endpoint;

    • Client identifier;

    • Client secret;

  8. Click Test connection, followed by Create.

  9. Navigate to Manage > Attribute mapping.

  10. Click and review the default attribute mappings under Provision Microsoft Entra ID Groups, then under Provision Microsoft Entra ID Users.

    Add, edit, or remove mappings as needed. In most cases, the default mappings are sufficient and can be further refined in TOPdesk.

    To import the manager relationship, make the following changes:

    1. Find the externalId mapping and click Edit.

    2. Replace the Source attribute mailNickName with objectId, then click OK. This stores the Entra user's objectId in the SCIM user's externalId field.

    3. Select Show advanced options, then click Edit attribute list for customappsso.

    4. Find the urn:ietf:params:scim:schemas:extension:enterprise:2.0:User attribute, change its type from Reference to String, and click Save.

      This stores the manager's objectId in the SCIM user's manager field instead of the SCIM ID of the manager.

  11. Navigate to Manage > Users and groups, then add the users and groups you want to provision.

  12. Under Provisioning, set Provisioning Status to On, and click Save.

    This starts the automatic provisioning.

    The first provisioning cycle may take some time to start and complete. After that, provisioning runs every 40 minutes.

    To import the manager relationship, configure the following field mappings in TOPdesk:

    1. Map the External ID (Import) target field to the External ID (externalId) source field.

    2. Map the Manager target field to the Manager (enterprise.manager.value) source field. For Which type of data does the source field 'manager' contain?, select External ID (Import).

Importing group membership of SCIM users

  1. Navigate to step 3 'Field mapping'.

  2. In the Select a TOPdesk field column, pick Person group (for person imports) or Operator group (for operator imports).

  3. For Which source value should be imported into 'Person group'/'Operator group'?, select the source field Groups (groups).

  4. For Which type of data does the source field contain?, select Name.

  5. Optionally, configure how the import should handle empty source fields and values missing in TOPdesk.

    tip

    To create missing person or operator groups in TOPdesk, select Create new linked cards in the optional settings

  6. Click Apply and proceed with the field mapping.

remark

The Groups (groups) field contains a newline-separated, alphabetically ordered list of the group names the SCIM user is a member of. If the user isn't a member of any group, the field is empty.

Microsoft Entra ID als Importquelle für Stammdaten

Um in TOPdesk Daten aus Entra ID zu importieren, registrieren Sie TOPdesk als Anwendung in Entra ID und hinterlegen Sie die Anwendungsdaten in TOPdesk.

Konfiguration von Microsoft Entra ID

  1. Registrieren Sie in Microsofts Anwendungsregistrierungsportal (extern) eine neue Anwendung für TOPdesk in Microsoft Entra.

    step1-entra.jpg

  2. Kopieren Sie die Anwendungs-ID (Client) und die Verzeichnis-ID (Tenant), und speichern Sie sie, um sie später in die entsprechenden Felder in TOPdesk einzufügen.

    step2-entra.jpg

  3. Klicken Sie unter API-Berechtigungen auf Eine Berechtigung hinzufügen.

    Hinweis

    Falls Sie die Rollenbasierte Zugriffskontrolle (RBAC) (extern) verwenden, können Sie den Schritt mit den Berechtigungen überspringen und mit folgendem Schritt fortfahren: Schritt 7.

    step3-entra.jpg

  4. Wählen Sie Microsoft Graph API und klicken Sie auf Anwendungsberechtigungen.

    step4-entra.png

  5. Wählen Sie die Berechtigungen GroupMember.Read.All und User.Read.All und klicken Sie auf Berechtigungen hinzufügen.

    step5-entra.jpg

  6. Gewähren Sie Admin-Freigabe für die neu hinzugefügte Berechtigung.

    step6-entra.jpg

  7. Navigieren Sie zu Zertifikate & Geheimnisse und klicken Sie auf Neues Client-Geheimnis.

    step7-entra.jpg

  8. Geben Sie eine Beschreibung und ein Ablaufdatum für das Geheimnis ein. Klicken Sie auf Hinzufügen und speichern Sie das Geheimnis zusammen mit dem Client-Wert und der Tenant-ID.

    Wichtig

    Wenn Sie das Geheimnis kopieren, verwenden Sie den Wert, nicht die geheime ID. Bitte beachten Sie, dass das Geheimnis nur einmal erhalten werden kann.

    step8-entra.jpg

  9. If you wish to authenticate with a client certificate , click Certificates and upload your certificate.

Mit Ihrem eigenen TOPdesk verbinden

  1. Melden Sie sich in TOPdesk an, navigieren Sie zu Einstellungen > Importeinstellungen > Stammdatenimporte > Importe.

  2. Erstellen Sie einen neuen Import oder bearbeiten Sie einen vorhandenen.

  3. Gehen Sie im Import-Assistenten zu Schritt 2 "Quelle" und wählen Sie als Quellentyp Entra ID.

    A pop-up window opens where you enter your Entra ID credentials.

    Tipp

    Use the credentials you previously saved. Choose a relevant name for the connection and enter it in the Name field. Enter the Application (client) ID, the Directory (tenant) ID, and the Client secret in the designated fields.

    Next to using a client secret, TOPdesk also supports authentication with a client certificate. To use a client certificate, click Client certificate and select the desired certificate from the drop-down list. If your certificate is not listed, upload it first via Functional Settings > Certificates.

  4. Klicken Sie auf Übernehmen.

    TOPdesk bestätigt, wenn Microsoft Entra ID erfolgreich als Importquelle verbunden wurde.

  5. Nach erfolgreicher Verbindung mit Microsoft Entra ID fahren Sie mit der Feldzuordnung (Schritt 3) fort.

Verwendung von Verzeichniserweiterungen

Wenn Sie Verzeichniserweiterungen verwenden, um bestimmte Daten mit Entra ID zu verwalten, können Sie diese Daten mit der Stammdaten-Importfunktion ganz einfach Ihren TOPdesk Feldern zuordnen.

  1. Klicken Sie in der Feldzuordnung auf das TOPdesk Feld, in das Sie Ihre Daten importieren möchten.

  2. Wählen Sie dann das Erweiterungsfeld aus Ihrer Quelle aus, das den Wert für Ihr TOPdesk Feld enthält.

  3. Fahren Sie wie gewohnt mit der Einrichtung der Importkonfiguration fort.

Anmerkung

Sie können weiterhin Verzeichniserweiterungen in Ihre Quelldatenfilter aufnehmen (Schritt 2 "Quelle").

In der Microsoft Dokumentation (extern) können Sie mehr über Erweiterungen lesen.

Importieren der Gruppenmitgliedschaften von Entra-Benutzern

  1. Klicken Sie in der Feldzuordnung auf das TOPdesk Feld Personengruppe.

  2. Wählen Sie unter Welcher Quellwert soll in "Personengruppe" importiert werden? das Quellfeld memberOfGroups und konfigurieren Sie den Rest der Zuordnung.

    Wenn das Personengruppenfeld zugeordnet ist, kann TOPdesk automatisch fehlende Personengruppen auf Grundlage ihrer Namen erstellen.

  3. Fahren Sie wie gewohnt mit der Einrichtung der Importkonfiguration fort.

Anmerkung

TOPdesk importiert nur Gruppen, in denen Benutzer direkte Mitglieder sind. Transitive Mitgliedschaften (d. h. Mitgliedschaften übergeordneter Gruppen) werden nicht berücksichtigt.

Einrichten Ihres lokalen Active Directory als Importquelle für Stammdaten

Befolgen Sie diese Schritte, um Ihre TOPdesk Benutzer mit Ihrem lokalen Active Directory zu synchronisieren.

Vorbereitung

TOPdesk needs to trust the certificate used by your AD server for secure LDAPS connections. The certificate must:

  • be currently valid;

  • be issued by a trusted Certificate Authority (CA), with the complete chain (including intermediates) trusted;

  • list the hostname used in the connection as a Alternative Name (SAN);

    wildcard certificates are allowed;

  • be presented by your AD server on TCP port 636;

Export the certificate from your AD server and upload the AD server's public certificate, or the CA certificate that issued it, via Functional Settings > Certificates.

  1. Navigieren Sie nach Auswahl Ihrer Zielkartenart zu Schritt 2 "Quelle".

  2. Wählen Sie Active Directory als Quellentyp.

  3. Klicken Sie auf Neue Microsoft Active Directory Verbindung.

  4. Geben Sie einen Namen für die Verbindung, den Hostnamen, einen Port (falls zutreffend) sowie den Benutzernamen und das Kennwort ein.

    Anmerkung

    TOPdesk verwendet standardmäßig den Standard-Port 636. Wenn dies Ihrer Einrichtung entspricht, brauchen Sie es nicht zu ändern.

  5. Klicken Sie auf Speichern.

    Tipp

    TOPdesk speichert Ihre Verbindungsdaten sicher unter dem von Ihnen gewählten Namen und ermöglicht Ihnen die erneute Verwendung der Daten für andere Importe.

  6. Filter anwenden, um die Organisationseinheit(en) oder Gruppe anzugeben, aus welcher Sie Benutzer importieren möchten.

  7. Optional können Sie den Quelldaten Filterregeln hinzufügen.

  8. Speichern Sie den Fortschritt und fahren Sie mit den restlichen Schritten des Assistenten fort.

Niederlassungen importieren

In diesem Thema behandeln wir die Konfiguration eines Stammdatenimports, der Ihre Niederlassungshierarchie in TOPdesk verwaltet. Die Quelle ist in diesem Fall CSV/XLSX.

Anmerkung

Abhängig von Ihren Einstellungen können die Niederlassungen einen individuellen Namen haben. Bitte beachten Sie, dass dies auch Auswirkungen auf die TOPdesk Felder und die Kartenart hat.

Vorbereiten der Quelle für den Import der Niederlassungshierarchie

  • Die XLSX-Vorlage beinhaltet die Spalten branchType und headBranch.

    Für die Spalte branchType sind die Vorgabewerte Hauptniederlassung, Selbstständige Niederlassung und Gehört zu Hauptniederlassung verfügbar.

    In der Spalte headBranch erwartet der Import den Namen der Hauptniederlassung.

Einrichten des Niederlassungsimports

  1. Nachdem Sie Niederlassung als Zielkartenart ausgewählt und erfolgreich eine CSV/XLSX-Datei hochgeladen haben, navigieren Sie zu Schritt 3 "Feldzuordnung".

  2. Wählen Sie in der Spalte TOPdesk Feld auswählen Niederlassungstyp aus.

  3. Für Welcher Quellwert soll in "Niederlassungstyp" importiert werden?, wählen Sie das Quellfeld, das die Daten zum Niederlassungstyp enthält.

    Tipp

    Wie in der Vorbereitung der Quelldatei ist dies das Feld branchType.

  4. Für Welcher Quellwert soll als "Hauptniederlassung" importiert werden?, wählen Sie das Quellfeld, das den Namen der Hauptniederlassung enthält.

    Tipp

    Dies ist nur notwendig, wenn diese Niederlassung einer Hauptniederlassung untergeordnet ist. Je nach Vorbereitung der Quelldatei ist dies das Feld headBranch.

  5. Für "Welche Art von Daten enthält das Quellfeld?", wählen Sie Name aus.

    Der Import identifiziert die Niederlassungsart und ordnet alle Niederlassungen mit der Niederlassungsart 'Gehört zu Hauptniederlassung' dem Niederlassungsnamen im Feld 'headBranch' zu.

  6. Optional können Sie konfigurieren, wie der Import leere Quellfelder und fehlende Werte in TOPdesk behandeln soll.

  7. Wählen Sie in Schritt 4 "Einstellungen importieren" den eindeutigen Schlüssel aus und konfigurieren Sie die übrigen Einstellungen.

  8. Speichern Sie Ihren Fortschritt und führen Sie den Import aus.

Ihren Bearbeitern eine Liste von Bearbeitergruppen zuordnen

Vorbereitung des Imports, um Ihren Bearbeitern eine Liste von Bearbeitergruppen zuzuweisen

Sind die Bearbeitergruppen bereits vorhanden und aktiv in TOPdesk?

In diesem Fall können Sie den ersten Teil der Vorbereitung überspringen und zu Schritt 2 "Vorbereitung und Import einer Quelldatei, um Ihren Bearbeitern eine Liste von Bearbeitergruppen zuzuordnen" springen.

  1. Vorbereitung einer Quelldatei für den Import der Liste der Bearbeitergruppen:

    1. Die XLSX-Vorlage für Bearbeitergruppen enthält die Spalte groupName. Geben Sie mindestens den Namen der Bearbeitergruppen ein.

      Optional können Sie die Gruppen bereits mit Niederlassungen (branch), Standorten (location), Kostenstellen (budgetHolder) usw. verknüpfen.

    2. Navigieren Sie zum Importassistenten.

    3. Nachdem Sie Bearbeitergruppe als Ziel-Kartenart ausgewählt und erfolgreich eine CSV/XLSX-Datei hochgeladen haben, navigieren Sie zu Schritt 3 "Feldzuordnung".

    4. Wählen Sie in der Spalte TOPdesk Feld auswählen Gruppenname aus.

    5. Für Welcher Quellwert soll in "Gruppenname" importiert werden?, wählen Sie das zugehörige Quellfeld aus (groupName).

    6. Optional können Sie mit der Feldzuordnung fortfahren und konfigurieren, wie der Import leere Quellfelder und fehlende Werte in TOPdesk behandeln soll.

    7. Wählen Sie in Schritt 4 "Einstellungen importieren" den eindeutigen Schlüssel (dieser sollte Gruppenname sein) aus und konfigurieren Sie die übrigen Einstellungen.

    8. Speichern Sie Ihren Fortschritt und führen Sie den Import aus.

  2. Vorbereiten und Importieren einer Quelldatei, um Ihren Bearbeitern eine Liste von Bearbeitergruppen zuzuordnen:

    1. Wenn Sie über keine Quelldatei verfügen, laden Sie die XLSX-Vorlage für Bearbeiter herunter.

    2. Füllen Sie die Felder für den eindeutigen Bezeichner der Bearbeiterkarte und die Bearbeitergruppe(n) aus, die Sie dem Bearbeiter zuweisen möchten.

      Im Allgemeinen sind lastName und branch obligatorisch.

      Tipp

      Fügen Sie in Excel mehrere Werte in das Feld operatorgroup ein, indem Sie ALT+ENTER verwenden, um einer Zelle Zeilen hinzuzufügen.

      Verwenden Sie in einer CSV-Datei die Eingabetaste, um die Werte voneinander zu trennen.

    3. Sie können auch neue Bearbeiter importieren und Bearbeitergruppen in einem Arbeitsgang zuordnen.

      Wie üblich ist ein eindeutiger Bezeichner erforderlich, z. B. employeeNumber.

    4. Vergewissern Sie sich, dass die Spalten in Ihrer Quelle alle Informationen enthalten, die Sie in TOPdesk importieren möchten, und dass die Bearbeitergruppen in der Spalte operatorgroup für jeden Bearbeiter aufgeführt sind.

    5. Navigieren Sie zum Importassistenten.

    6. Nachdem Sie Bearbeiter als Ziel-Kartenart ausgewählt und erfolgreich eine CSV/XLSX-Datei hochgeladen haben, navigieren Sie zu Schritt 3 "Feldzuordnung".

    7. Wählen Sie in der Spalte TOPdesk Feld auswählen Bearbeitergruppe aus.

    8. Für Welcher Quellwert soll in "Bearbeitergruppe" importiert werden?, wählen Sie das zugehörige Quellfeld aus (operatorgroup).

    9. Bei Welche Art von Daten enthält das Quellfeld "operatorgroup"?: Dies kann die Gruppen-ID, der Name oder die E-Mail-Adresse sein.

    10. Optional können Sie mit der Feldzuordnung fortfahren und konfigurieren, wie der Import leere Quellfelder und fehlende Werte in TOPdesk behandeln soll.

    11. Wählen Sie in Schritt 4 "Einstellungen importieren" den eindeutigen Schlüssel (dieser könnte Mitarbeiternummer sein) aus und konfigurieren Sie die übrigen Einstellungen.

    12. Speichern Sie Ihren Fortschritt und führen Sie den Import aus.

Ihren Personen eine Liste von Personengruppen zuordnen

Vorbereitung des Imports, um Ihren Personen eine Liste von Personengruppen zuzuweisen

Sind die Personengruppen bereits vorhanden und aktiv in TOPdesk?

In diesem Fall können Sie den ersten Teil der Vorbereitung überspringen und zu Schritt 2 "Vorbereitung und Import einer Quelldatei, um Ihren Personen eine Liste von Personengruppen zuzuordnen" springen.

  1. Vorbereitung einer Quelldatei für den Import der Liste der Personengruppen:

    1. Die XLSX-Vorlage für Personengruppen enthält die Spalte name. Geben Sie mindestens den Namen der Personengruppen ein.

      Optional können Sie die Gruppen bereits mit Niederlassungen (branch), Standorten (location), Kostenstellen (budgetHolder) usw. verknüpfen.

    2. Navigieren Sie zum Importassistenten.

    3. Nachdem Sie Personengruppe als Ziel-Kartenart ausgewählt und erfolgreich eine CSV/XLSX-Datei hochgeladen haben, navigieren Sie zu Schritt 3 "Feldzuordnung".

    4. Wählen Sie in der Spalte TOPdesk Feld auswählen Name aus.

    5. Für Welcher Quellwert soll in "Name" importiert werden?, wählen Sie das zugehörige Quellfeld aus (name).

    6. Optional können Sie mit der Feldzuordnung fortfahren und konfigurieren, wie der Import leere Quellfelder und fehlende Werte in TOPdesk behandeln soll.

    7. Wählen Sie in Schritt 4 "Importeinstellungen" den eindeutigen Schlüssel (dieser sollte name sein) aus und konfigurieren Sie die übrigen Einstellungen.

    8. Speichern Sie Ihren Fortschritt und führen Sie den Import aus.

  2. Vorbereiten und Importieren einer Quelldatei, um Ihren Personen eine Liste von Personengruppen zuzuordnen:

    1. Wenn Sie über keine Quelldatei verfügen, laden Sie die XLSX-Vorlage für Personen herunter.

    2. Füllen Sie die Felder für den eindeutigen Bezeichner der Personenkarte und die Personengruppe(n) aus, die Sie der Person zuordnen möchten.

      Im Allgemeinen sind lastName und branch obligatorisch.

      Tipp

      Fügen Sie in Excel mehrere Werte in das Feld persongroup ein, indem Sie ALT+ENTER verwenden, um einer Zelle Zeilen hinzuzufügen.

      Verwenden Sie in einer CSV-Datei die Eingabetaste, um die Werte voneinander zu trennen.

    3. Sie können auch neue Personen importieren und Personengruppen in einem Arbeitsgang zuordnen.

    4. Vergewissern Sie sich, dass die Spalten in Ihrer Quelle alle Informationen enthalten, die Sie in TOPdesk importieren möchten, und dass die Personengruppen in der Spalte persongroup für jede Person aufgeführt sind.

    5. Navigieren Sie zum Importassistenten.

    6. Nachdem Sie Person als Ziel-Kartenart ausgewählt und erfolgreich eine CSV/XLSX-Datei hochgeladen haben, navigieren Sie zu Schritt 3 "Feldzuordnung".

    7. Wählen Sie in der Spalte TOPdesk Feld auswählen Personengruppe aus.

    8. Für Welcher Quellwert soll in "Personengruppe" importiert werden?, wählen Sie das zugehörige Quellfeld aus (personGroup).

    9. Bei Welche Art von Daten enthält das Quellfeld "personGroup"?: hier können Sie die Gruppen-ID, den Namen oder die E-Mail-Adresse verwenden.

    10. Optional können Sie mit der Feldzuordnung fortfahren und konfigurieren, wie der Import leere Quellfelder und fehlende Werte in TOPdesk behandeln soll.

    11. Wählen Sie in Schritt 4 "Einstellungen importieren" den eindeutigen Schlüssel (dieser könnte Mitarbeiternummer sein) aus und konfigurieren Sie die übrigen Einstellungen.

    12. Speichern Sie Ihren Fortschritt und führen Sie den Import aus.

Personen mit Personengruppen mit Entra ID importieren

Zum Import von Gruppenmitgliedschaften aus Entra ID führen Sie folgende Schritte aus, während Sie einen neuen Personenimport erstellen oder einen bestehenden anpassen:

  1. Navigieren Sie zu Schritt 3 "Feldzuordnung".

  2. Wählen Sie in der Spalte TOPdesk Feld auswählen Personengruppe aus.

  3. Wählen Sie bei Welcher Quellwert soll in "Personengruppe" importiert werden? die Option memberOfGroups aus.

  4. Fahren Sie fort, die Datenart auszuwählen und die optionalen Einstellungen zu konfigurieren.

    Tipp

    Um fehlende Personengruppen in TOPdesk zu erstellen, wählen Sie in den optionalen Einstellungen die Option Neue verknüpfte Karten erstellen.

  5. Klicken Sie auf Übernehmen und fahren Sie mit der Feldzuordnung fort.

    TOPdesk ordnet der jeweiligen Person beim Import automatisch alle Personengruppen zu.

Importieren von Managern mit Entra ID

Das Verfahren zum Importieren von Managerinformationen erfordert besondere Aufmerksamkeit. Beim Importieren von Personenkarten mit Entra ID als Quelle:

  1. Nach erfolgreicher Verbindung mit Entra ID als Importquelle, navigieren Sie zu Schritt 3 "Feldzuordnung".

  2. Wählen Sie in der Spalte TOPdesk Feld auswählen Manager aus.

  3. Für Welcher Quellwert soll in "Manager" importiert werden?, wählen Sie ein Quellfeld, das eindeutige Daten enthält.

    Tipp

    Wir empfehlen die Felder manager employeeId, manager mail oder manager userPrincipalName, da diese in der Regel eindeutig sind.

  4. Unter "Welche Art von Daten enthält das Quellfeld?" wählen Sie das TOPdesk Feld aus, welches die Informationen enthält, die Sie im vorherigen Schritt ausgewählt haben.

    Ein Beispiel: Wenn Sie manager employeeId ausgewählt haben, ist die Auswahl vonEmployee Numberin der Regel das TOPdesk Feld, welches diese Information enthält.

TOPdesk erkennt automatisch, welche Personen Manager sind, und aktualisiert diese Karten entsprechend.

Hinweis

Es gibt einige andere Datentypen, aus denen Sie wählen können, um Manager eindeutig zu identifizieren.

Bilder für Bearbeiter und Personen mit Entra ID importieren

Fügen Sie über Entra ID Bilder zu Ihren Bearbeiter- und Personenkarten hinzu.

Führen Sie die folgenden Schritte aus, um einen neuen Import zu erstellen oder einen bestehenden Import zu bearbeiten:

  1. Navigieren Sie zu Schritt 3 "Feldzuordnung".

  2. Wählen Sie in der Spalte TOPdesk Feld auswählen Bild aus.

    Überprüfen Sie, dass Bild in der Zuordnungs-Dropdown-Liste ausgewählt ist, um das Profilbild von Microsoft Entra ID zu importieren.

    Tipp

    Die Bilder werden in ihrer Originalgröße aus der Quelle importiert.

  3. Klicken Sie auf Übernehmen, um fortzufahren.

    Das Bildfeld wird dem Profilbild in Entra ID zugeordnet.

Konvertieren von Werten

Manchmal müssen Sie die Formatierung Ihrer Quelldaten anpassen, bevor Sie sie in TOPdesk importieren können.

Mithilfe der Konvertierung von Werten können Sie Ihr Datenformat einfach anpassen, um die Voraussetzungen des Import-Assistenten zu erfüllen.

Verwendung

Hinweis

Hierbei kann Ihnen die FreeMarker-Dokumentation helfen, insbesondere der Abschnitt über eingebaute Strings.

  1. Navigieren Sie zu Einstellungen > Importeinstellungen > Stammdaten- / Assetimporte.

  2. Erstellen Sie einen Neuen Import oder öffnen Sie einen bereits bestehenden, indem Sie ihn auswählen und auf Bearbeiten klicken.

    Hinweis

    Konvertierung der Werte sind Teil der Feldzuordnung (Schritt 3). Sie können jede Feldzuordnung individuell konfigurieren.

  3. Klicken Sie im Schritt Feldzuordnung auf das gewünschte TOPdesk Feld und wählen Sie Werte aus Datenquelle konvertieren aus.

  4. Die Konvertierungseinstellungen erscheinen.

    1. Geben Sie im Feld FreeMarker-Vorlage den Ausdruck zur Verwendung in der Konvertierung ein.

      Sie finden unten ein Beispiel eines FreeMarker-Ausdrucks.

    2. Klicken Sie auf Wert aus Datenquelle einfügen, um zu sehen, welche Quellfelder für Ihren Ausdruck verfügbar sind.

    3. Klicken Sie auf Vorschau, um Ihren FreeMarker-Ausdruck zu validieren.

      Ist der FreeMarker-Ausdruck korrekt, werden Ihnen die ersten fünf umgewandelten Werte angezeigt.

      Ansonsten wird Ihnen eine Fehlermeldung angezeigt, die Ihnen bei der Fehlerbehandlung hilft.

  5. Fahren Sie mit den weiteren Schritten im Importassistenten fort.

Anmerkung

Bei manchen häufig vorkommenden Anwendungsfällen müssen Sie die Werte nicht konvertieren. Stattdessen können Sie auf die Standard-Feldzuordnungsoptionen zurückgreifen.

Tipp

Verwenden Sie, wann immer möglich, die Standard-Feldzuordnungsoptionen, um für die bestmögliche Leistung Ihres Imports zu sorgen.

Hier sind einige Beispiele für Anwendungsfälle, die kein Konvertieren von Werten erfordern. Sie können die meisten davon in den Optionalen Einstellungen konfigurieren.

  • Entfernung von Leerzeichen vor und nach dem Wert des Quell-Datenwertes. Dies ist eine Standardfunktionalität.

  • Einfügen eines fixen Wertes in ein TOPdesk Feld.

  • Verwendung eines Fallback-Wertes, falls ein Quellfeld leer ist.

  • Verkürzen des Quellwertes auf die maximal zulässige Zeichenanzahl des TOPdesk Feldes.

Ein FreeMarker-Beispiel für die Konvertierung von Werten

TOPdesk verwendet das ISO 8601 Datums-/Zeitformat: 2021-09-15T15:05:00Z

Ihre Quelle verwendet ein abweichendes Datums-/Zeitformat: Wed Sep 15 2021 03:05:00 PM

Dieser FreeMarker-Ausdruck wandelt das Datums-/Zeitformat um:

<#-- Datum manuell einlesen -->

<#assign parsedDate = _source["sourcefield name"]?datetime("EEE MMM dd yyyy hh:mm:ss a")>

<#-- Eingelesenes Datum in ISO 8601-Format umwandeln -->

<#assign isoDate = parsedDate?iso_utc>

<#-- Ergebnis ausgeben -->

${isoDate}

In diesem Beispiel haben wir das Datum manuell eingelesen. Dies ist für häufig verwendete Datums-/Zeitformate nicht erforderlich.

Tipp

Konsultieren Sie die FreeMarker-Dokumentation für Informationen, wie Sie die ?datetime Referenz verwenden können.

Weitere nützliche Methoden

  • ${_base64(“your-string-to-encode")}: encodiert einen String nach Base64

  • ${_base64Decode("zu dekodierende Zeichenkette")}: Dekodiert die angegebene Zeichenkette aus Base64

  • ${_random(N)}: gibt eine zufällige Zahl zwischen 0 und N aus

  • ${_randomUUID()}: generiert eine zufällige einzigartige Kennzahl

Fehlerbenachrichtigungen für Stammdaten- und Assetimporte

E-Mail-Benachrichtigungen erhalten, falls ein Import fehlschlägt.

Die E-Mail-Benachrichtigung beinhaltet Informationen, warum der Vorgang fehlgeschlagen ist, und eine Verknüpfung zur Importkonfiguration zur Fehlerbehandlung.

Sie können im Block Allgemeine E-Mail-Einstellungen unter Einstellungen > Funktionseinstellungen > E-Mails einen Standard-E-Mail-Absender festlegen.

Erstellen und Verwalten von Fehlerbenachrichtigungen

  1. Navigieren Sie zu Einstellungen > Importeinstellungen > Stammdaten- / Assetimporte.

  2. Klicken Sie auf Importe, um die Importübersicht zu öffnen.

  3. Klicken Sie oben rechts auf der Übersichtsseite auf die Schaltfläche Fehlerbenachrichtigungen.

  4. Klicken Sie auf Neue Fehlerbenachrichtigung und geben Sie einen Namen sowie einen oder mehrere Empfänger ein.

  5. Alternativ können Sie

    bestehende Benachrichtigungen bearbeiten,

    Bestehende Benachrichtigungen löschen,

    bestehende Benachrichtigungen als Standard festlegen oder entfernen.

Tipp

Um einen bestimmten Stammdaten- / Assetimport von den Standardeinstellungen auszuschließen, konfigurieren Sie die gewünschte Fehlerbenachrichtigung in den Einstellungen. Siehe Fehlerbenachrichtigungen in einem Import verwenden unten.

Achtung

Falls der Standard auf Keine Benachrichtigung gesetzt ist, wird TOPdesk keine Benachrichtigungen versenden, außer, wenn dies in den E-Mail-Importeinstellungen eingerichtet wurde.

Stammdaten- und Assetimporte verwenden separate Fehlerbenachrichtigungen. Konfigurieren Sie die Benachrichtigungen für jede Importart, insbesondere, wenn Sie für beide die gleichen Benachrichtigungen verwenden möchten.

Fehlerbenachrichtigungen in einem Import verwenden

  1. Navigieren Sie zu Einstellungen > Importeinstellungen > Stammdaten- / Assetimporte.

  2. Klicken Sie auf Importe, um die Importübersicht zu öffnen.

  3. Markieren Sie in der Übersicht den gewünschten Import und klicken Sie auf Bearbeiten, um Änderungen an seiner Konfiguration vorzunehmen.

  4. Navigieren Sie im Importassistenten zu Importeinstellungen (Schritt 4).

  5. Wählen Sie im Block Fehlerbenachrichtigungen die Fehlerbenachrichtigung aus, die für diesen Import verwendet werden soll.

    Tipp

    Wählen Sie Keine Benachrichtigung aus, um keine Fehlerbenachrichtigungen zu erhalten, oder Standard-Fehlerbenachrichtigung, um die Standard-Fehlerbenachrichtigung zu erhalten.

  6. Speichern Sie Ihre Einstellungen.

Zusätzliche Optionen für Fehlerbenachrichtigungen

TOPdesk versendet jedes Mal Fehlerbenachrichtigungen für Importe, wenn die Ausführung eines Imports fehlschlägt.

Dies kann diverse Gründe haben, beispielsweise:

  • Die Verbindung zur Importquelle konnte nicht hergestellt werden.

  • Die Feldzuordnung beinhaltet ein Feld, das in der Quelle entfernt wurde.

Zusätzlich können Sie Fehlerbenachrichtigungen einrichten für Importe, die mit Fehlern abgeschlossen wurden:

  1. Wählen Sie in der Importübersicht aus, für welchen Import Sie die Fehlerbenachrichtigung einrichten möchten, und klicken Sie auf Bearbeiten.

  2. Navigieren Sie im Importassistenten zu Importeinstellungen (Schritt 4).

  3. Wählen Sie im Block Fehlerbenachrichtigungen die gewünschte Benachrichtigung aus.

    Achtung

    Sie müssen eine Benachrichtigung auswählen, damit das Kontrollkästchen Auch benachrichtigen, wenn ein Datensatz nicht importiert werden konnte erscheint.

  4. Aktivieren Sie das Kontrollkästchen Auch benachrichtigen, wenn ein Datensatz nicht importiert werden konnte, falls es noch nicht aktiv ist.

  5. Speichern Sie Ihre Einstellungen.

Einrichtung des automatisierten Datei-Uploads

In diesem Kapitel führen wir Sie durch die Einrichtung des automatischen Datei-Uploads, welcher erforderlich ist, wenn Sie Ihre CSV/Excel-Importe automatisch planen möchten.

Voraussetzungen:

  • Sie haben einen neuen Stammdaten / Assetmanagement -Import erstellt.

  • Ihre Quelldatei erfüllt alle Bedingungen des geplanten Imports.

  • Sie verfügen über ein API-Konto mit der Berechtigung, Quelldateien in TOPdesk hochzuladen.

  • Sie verfügen über ein Skript, das die Quelldatei von Ihrem Server zu Ihrem TOPdesk überträgt.

  • Sie haben einen Aufgabenplaner konfiguriert, welcher das Skript zu bestimmten Zeiten hochlädt.

Konfiguration des Imports

Wählen Sie in Schritt 6 "Planung" des Import-Assistenten die Option Automatisiert als Planungsart.

Vorbereitung der Quelldatei

  • Der Header ist nicht leer. Das ist die erste Zeile in der Datei, die zur Benennung der Felder verwendet wird, die im Importassistenten in Schritt 3 "Feldzuordnung" angezeigt werden. Jede Spalte, die Werte enthält, benötigt einen Namen im Header.

  • Sämtliche relevanten Daten werden im ersten Blatt Ihrer Excel-Datei gespeichert.

  • Die Datei hat eine der unterstützten Dateierweiterungen: CSV, XLS, oder XLSX.

Zeichenkodierung

TOPdesk unterstützt UTF-8 kodierte Quelldateien. Es kann alle von Java (Version 21) nativ unterstützten Zeichenkodierungen in UTF-8 konvertieren.

Wir empfehlen Folgendes:

  • Speichen Sie Ihre Datei wenn möglich als UTF-8.

    Wenn Ihre CSV-Datei nicht in UTF-8 konvertiert werden kann, lesen Sie bitte unter Datei automatisch von einem Drittsystem hochladen nach.

  • Wenn Sie Microsoft Excel oder eine andere Windowsanwendung verwenden, kann es sein, dass Ihre Datei standardmäßig in der Windows-1252-Kodierung (auch als ANSI bekannt) gespeichert wird.

    Stellen Sie sicher, dass Ihre Excel-Dateien nur Zeichen enthalten, die von UTF-8 unterstützt werden. Versuchen Sie ansonsten, Ihre Daten als CSV-Datei zu speichern.

Die Kodierung prüfen oder festlegen:

  • CSV-Dateien: Wenn Sie von Excel aus speichern, verwenden Sie Speichern unter und wählen Sie CSV UTF-8 (Komma-delimitiert) (.csv), falls verfügbar. Wenn nur CSV Komma-delimitiert) (.csv) verfügbar ist, wird Ihre Datei wahrscheinlich in Windows-1252-Kodierung vorliegen.

  • Andere Editoren: In Editoren wie Notepad++ können Sie die Kodierung unter dem Menü Kodierung überprüfen und bei Bedarf in UTF-8 konvertieren.

Konfiguration des API-Kontos

Falls Sie noch nicht mit der TOPdesk API gearbeitet haben, leitet Sie das Kapitel API-Dienstkonto durch die Einrichtung.

Berechtigungen zuweisen

Zusätzlich zu den API-Berechtigungen benötigt das API-Konto folgende Berechtigungen:

Importe und Exporte

Standardimport > Lesen

Stammdaten- und Assetmanagement-Importe

Quelldateien hochladen

Hinweis

Fehlende Berechtigungen führen zu Fehler 403, Forbidden.

Automatisches Hochladen einer Datei aus einem Drittsystem

Festlegen des Content-Type-Headers für CSV-Dateien

Wenn Ihre CSV-Datei nicht in UTF-8 kodiert ist, können Sie ihre Kodierung in der Uploadanforderung angeben. TOPdesk konvertiert dann jegliche unterstützte Java-Zeichenkodierung in UTF-8.

Fügen Sie dazu einen Content-Type Header hinzu, der den korrekten Zeichensatz enthält. Wenn Ihre Datei z. B. in Windows-1257 kodiert ist, fügen Sie Ihrem Header folgendes hinzu:

Powershell:

'Content-Type' = 'text/csv; charset=Windows-1257'

cURL:

--header "Content-Type: text/csv; charset=Windows-1257"

cUrl-Skriptvorlage

set mypath=D:\myfolder\mysubfolder\
set myfile=FILENAME.csv
curl --upload-file "%mypath%%myfile%" --header "Authorization: Basic USERNAME:PASSWORD" https://[YOUR_TOPDESK_URL]/services/import-to-api-v1/api/[MODULE]/sourceFiles?filename=%myfile%

Ersetzen Sie das Folgende:

  • Ersetzen Sie D:\meinOrdner\meinUnterordner\ mit dem Pfad zur Quelldatei auf Ihrem Dateiserver.

  • Ersetzen Sie DATEINAME.csv mit dem Namen der Quelldatei

    Wichtig

    Vergessen Sie nicht, die Dateierweiterung anzupassen.

  • Ersetzen Sie BENUTZERNAME:PASSWORT mit dem in Base64-kodierten Benutzernamen und dem Anwendungskennwort des API-Kontos.

  • Ersetzen Sie [IHRE_TOPDESK_URL] mit der URL des Ziel TOPdesk.

  • Replace [MODULE] with either assetmanagement or supportingfiles.

Powershell-Skriptvorlage

#set variables
$customerurl='your-topdesk-url'
$mypath= "D:\Upload\"
$myfile = "filename.csv"
$file = $mypath + $myfile
$url = "https://$customerurl/services/import-to-api-v1/api/[MODULE]/sourceFiles?filename=$myfile"

#setup base64 string
$Text = 'username:ApplicationPassword'

$Bytes = [System.Text.Encoding]::UTF8.GetBytes($Text)
$EncodedAppPass =[Convert]::ToBase64String($Bytes)

$headers = @{
'Authorization' = 'BASIC ' + $EncodedAppPass
'Content-Type' = 'text/csv;'
}

#execute url
Write-Host "Uploading " $file  " to " $url -NoNewLine
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Invoke-RestMethod -Uri $url -Method PUT -headers $headers -InFile $file -SkipHeaderValidation

Ersetzen Sie das Folgende:

  • Ersetzen Sie D:\Upload\ mit dem Pfad zur Quelldatei auf Ihrem Dateiserver.

  • Ersetzen Sie ihre-topdesk-url mit der URL des Ziel TOPdesk.

  • Ersetzen Sie Dateiname.csv mit dem Namen der Quelldatei.

  • Ersetzen Sie 'Benutzername:Anwendungskennwort mit dem in Base64-kodierten Benutzernamen und dem Anwendungskennwort des API-Kontos.

  • Replace [MODULE] with either assetmanagement or supportingfiles.

Anmerkung

Die URL für den API-Request enthält eine Versionsnummer (import-to-api-v1). Wenn sich die Versionsnummer des Importdienstes ändert, müssen Sie die URL im Skript entsprechend anpassen.

Verwenden eines Aufgabenplaners zur Ausführung des Skripts

Ein Tool zur Aufgabenplanung führt das Upload-Skript zu vorgegebenen Zeiten aus. Je nach Ihrem Betriebssystem stehen verschiedene Lösungen zur Verfügung. Richten Sie den Zeitplan auf dem Server der Quelldatei ein.

Anmerkung

Aufgabenplaner sind Software von Drittherstellern und nicht in TOPdesk beinhaltet.

Windows

Sie können im Internet zahlreiche Anleitungen zur Planung von Aufgaben finden. Beispielsweise Jegliche Anwendung zeitgesteuert ausführen (extern) oder Windows-Zentrale (extern).

Linux

Abhängig von Ihrer Linux-Distribution stehen verschiedene Aufgabenplaner zur Verfügung. Beispielsweise Crontab (extern).



[3] Dies hängt von den Importeinstellungen ab (Schritt 4 im Assistenten). Sie können festlegen, wie der Import mit Karten umgehen soll, die in der Quelle nicht vorhanden sind, und ob das Erstellen/Aktualisieren von Karten erlaubt oder verboten sein soll.

In diesem Abschnitt: