Importieren von Benutzern

Sie können Benutzer mit zugehörigen Filtern und Gruppen aus Excel-Dateien, LDAP-Quellen oder einer Kombination aus beiden importieren.

Es wird empfohlen, eine Importieren-Aufgabe pro Satz Benutzern, Gruppen und Filtern zu verwenden. Sie können verschiedene Quellen für die gleichen Elemente haben. Beispiel: Eine Excel-Datei für Manager und eine Excel-Datei für Verkäufer, wobei beide Dateien eine gemeinsame Gruppe bzw. einen gemeinsamen Filter haben. Beide Quellen sollten an die gleiche Importieren-Aufgabe angehängt werden. Sie können den Pfad Ihrer Excel- und LDAP-Quellen bei Bedarf ändern.

Sie sollten Importieren-Aufgaben einzeln nacheinander ausführen. Wenn Sie mehrere Importieren-Aufgaben gleichzeitig ausführen, können Konflikte auftreten, und die Aufgaben schlagen möglicherweise fehl.

Einschränkungen

Beim Importieren bestehen bestimmte Einschränkungen:

• Sie können keine Filter anhand von LDAP importieren. Sie müssen eine Excel-Datei verwenden.
• Sie können alternative E-Mails nicht mit LDAP importieren. Sie müssen eine Excel-Datei verwenden.
• Wenn Sie Sicherheitsrollen erstellen oder löschen möchten, müssen Sie dies manuell in der Qlik NPrinting Web Console tun. Siehe: Verwalten von Rollen (nur auf Englisch)
• Sie können aus LDAP-Gesamtstrukturen, Strukturen und Domänen importieren, die sich vom Qlik NPrinting Server unterscheiden. Übergreifende Mitgliedschaft unter Gesamtstrukturen wird jedoch nicht unterstützt.
• Wenn Sie Benutzer aus LDAP importieren, sind die Werte für Gebietsschema und Zeitzone nicht verfügbar. Für auf diese Weise importierte Benutzer werden standardmäßig Englisch und UTC verwendet. Sie können andere Werte für Gebietsschema und Zeitzone festlegen, indem Sie Benutzer aus einer Excel-Datei importieren und manuell ändern. Wenn die gleichen Benutzer erneut über LDAP importiert werden, werden die Werte für Gebietsschema und Zeitzone nicht überschrieben.

Beim Importieren von Benutzern über Excel bestehen bestimmte Einschränkungen:

• Wenn Gruppen, Rollen oder Filter, die in der Zeile hinzugefügt werden, nicht existieren, werden sie ignoriert.

• Wenn der Name eines Filters, eines Benutzers oder einer Rolle Kommas enthält, verwenden Sie doppelte Anführungszeichen als Trennzeichen. Beispiel: "Jeremy Martinson, Jr."

• Wenn ein Feldwert doppelte Anführungszeichen, Leerzeichen am Anfang oder am Ende oder "{", "}" enthält, müssen Sie den String mit doppelten Anführungszeichen beginnen und beenden. Doppelte Anführungszeichen müssen zweimal eingefügt werden, um sie von den Escape-Anführungszeichen zu unterscheiden.

  Beispiel:

  • [Country]={" Italy, France ", "Germany",Spain} => " Italy, France ","Germany","Spain"
  • [Country]={"""Italy"""} => ""Italy""
  • [Country]={"{Sweden}"} => {Sweden}

• Um ein Feld mit Leerzeichen am Anfang/Ende zu importieren, muss der String mit eckigen Klammern beginnen und enden.

  Beispiel: [ Country ]={Italy}, CountryBorn ={Italy} => " Country "={Italy}, "CountryBorn"={Italy}

• Sie können nicht "[", "]" als Feldnamen einfügen.

• Sie können vorhandene Filterfelder löschen, indem Sie Felder (Werte, numerische Werte oder Formelspalten) mit einem gültigen Namen und einer leeren Werteliste hinzufügen. Das Kontrollkästchen Filter aktualisieren, falls modifiziert muss aktiviert sein.

  Beispiel:

  • [Country] => Eingabe ignoriert
  • [Country]={}=> Filterfeld mit Name Land entfernt

 

Importsyntax in Excel-Dokumenten

Sie müssen eine Excel-Datei mit den folgenden exakten Namen auf den Arbeitsblättern und Spalten erstellen. Sie können Spalten nicht neu anordnen oder entfernen. Sie können keine Arbeitsblätter neu anordnen oder entfernen.

Wenn Sie eine Excel-Datei mit Beispielbenutzern zu Testzwecken benötigen, gehen Sie zu Beispieldateien (nur auf Englisch), laden Sie Examples.zip herunter und öffnen Sie Recipients.xls.

Import-Filtersyntax

Das erste Arbeitsblatt enthält Filterdefinitionen. Wenn ein Wert oder eine Formel Kommas enthält, verwenden Sie doppelte Anführungszeichen als Trennzeichen. Beispiel: [SalesmanName]={"Jeremy Martinson, Jr.", Tom Lindwall}.

Wenn ein Filter die Funktion Ausgeschlossene auswählen zum Ausschließen von Werten verwendet, fügen Sie am Ende <excluded> hinzu. Beispiel: [CategoryName]={Babywear, Men´s Wear, Women's Wear}<excluded>

Das Attribut <override> kann verwendet werden, wenn Filterfelder aus Excel mit aktiviertem Kennzeichen „Werte überschreiben“ importiert werden. Beispiel:

• [Country]={Sweden}<override>
• [Country]={"France"}<override,excluded>

Import-Benutzersyntax

Das zweite Arbeitsblatt enthält Benutzerdefinitionen.

In den Feldern Alternative E-Mail können Sie mehrere durch Semikola getrennte E-Mail-Adressen hinzufügen. Ihr E-Mail-Anbieter legt fest, wie viele Adressen jedem Feld hinzugefügt werden können.

Import-Gruppensyntax

Das dritte Arbeitsblatt enthält Gruppendefinitionen.

Importsyntax in LDAP-Quellen

Verbindungssyntax

Syntax der Eintragsattribute

Die Eintragsattribute sollten den Attributnamen Ihres LDAP Servers entsprechen.

Erweiterte Syntax

Active Directory

Active Directory-Benutzer sollten den Wert Benutzeridentifikation von inetOrgPerson zu user oder person ändern. Das Standardverhalten besteht im Importieren aller Gruppen. Wenn Sie eine bestimmte Gruppe importieren möchten, verwenden Sie die Felder Alternativer Gruppenpfad oder Zusätzliche Gruppenfilter.

Zusammenführen von Importquelldaten

Die Zusammenführungsrichtlinie bezieht sich auf die Regeln, die gelten, wenn Daten aus einem Importschritt mit den Ergebnissen früherer Schritte zusammengeführt werden. Die Synchronisierung von Zusammenführungsergebnissen von Importquelldaten im Qlik NPrinting-Repository verwendet keine Zusammenführungsrichtlinie. Sie basiert auf Ihren Importaufgabeneinstellungen. Informationen dazu finden Sie unter: Erstellen einer Import-Aufgabe.

Benutzer-Zusammenführungsschlüssel

Dies gibt das Benutzerfeld an, das verwendet wird, um zu identifizieren, ob ein aus Importquellen abgerufener Benutzer sich auf einen vorhandenen Benutzer bezieht. Der für die Zusammenführung der Benutzerdaten verwendete Algorithmus basiert auf Element- und Zuweisungs-Zusammenführungsrichtlinien. Um alle importierten Elemente mit dem Qlik NPrinting-Repository abzugleichen, wird Benutzername immer verwendet, sodass dieser Zusammenführungsschlüssel nicht berücksichtigt wird.

Element-Zusammenführungsrichtlinie

Damit wird der Algorithmus angegeben, der zum Zusammenführen der aus den einzelnen Importquellen abgerufenen Daten, die sich auf das gleiche Element (Benutzer, Gruppe oder Filter) beziehen, verwendet wird. Er wird nicht auf Felder angewendet, die eine Zuordnung zu einem anderen Element abbilden (Benutzerfilter, Rollen und Gruppen sowie Filterfelder).

Die unterstützten Werte sind Überschreiben, Aktualisierung fehlt und Ignorieren. Die aus einer vorherigen Importquelle abgerufenen Daten werden:

• Überschreiben: entfernt und durch den neuesten Import ersetzt. Spalten, die in einem vorherigen, aber nicht im letzten Schritt vorhanden sind, werden nicht geändert.
• Aktualisierung fehlt: ignoriert, außer im Fall von Werten, die in vorherigen Importaufgaben nicht vorhanden waren. Diese werden hinzugefügt. Dies gilt für fehlende Spalten, nicht für leere Zellen.
• Ignorieren: ignoriert.

Zuweisungs-Zusammenführungsrichtlinie

Damit wird der Algorithmus angegeben, der zum Zusammenführen von aus den einzelnen Importquellen abgerufenen Daten, die sich auf das gleiche Element (Benutzer, Gruppe oder Filter) beziehen, verwendet wird. Er wird auf Felder angewendet, die eine Zuweisung zu einem anderen Element abbilden (Benutzerfilter, Rollen und Gruppen sowie Filterfelder).

Unterstützte Werte sind Überschreiben, Zusammenführen und Ignorieren. Die Liste der Elemente, die aus einem früheren Importschritt abgerufen werden, wird:

• Überschreiben: entfernt und durch den neuesten Import ersetzt. Spalten, die in einem vorherigen, aber nicht im letzten Schritt vorhanden sind, werden nicht geändert.
• Zusammenführen: zusammengeführt.
• Ignorieren: ignoriert.

Zuweisen von Importrechten zu einer Sicherheitsrolle

Zum Importieren von Benutzern müssen Sie sich bei Qlik NPrinting Web Console als Benutzer mit Import-Aufgabe-Rechten in mindestens einer Sicherheitsrolle anmelden. Benutzer mit der Rolle Administrator haben Import-Aufgabe-Rechte. Wenn Sie die Rolle Administrator auf einen Benutzer anwenden, verfügt dieser Benutzer auch über alle anderen administrativen Berechtigungen.

Sie können einer Sicherheitsrolle auch Importrechte zuweisen, ohne ihr weitere Administratorrechte zu geben.

Gehen Sie folgendermaßen vor:

1. Melden Sie sich bei Qlik NPrinting Web Console als Benutzer mit der Sicherheitsrolle Administrator an.
2. Klicken Sie im Qlik NPrinting-Hauptmenü auf das Dropdown-Menü Admin.
3. Klicken Sie auf Sicherheitsrollen.
4. Klicken Sie auf die Rolle, der Sie Import-Aufgabe-Rechte gewähren möchten.
5. Klicken Sie auf die Registerkarte Apps.
6. Scrollen Sie zu den Kontrollkästchen für die Import-Aufgabe-Rechte.
7. Wählen Sie das Kontrollkästchen links von Import-Aufgabe aus, um der Rolle alle Import-Aufgabe-Rechte zuzuweisen.

   Sie können auch nur bestimmte Rechte auswählen, indem Sie die entsprechenden Kontrollkästchen aktivieren.

8. Klicken Sie auf Speichern.

Erstellen einer Import-Aufgabe

Gehen Sie folgendermaßen vor:

1. Wählen Sie im Qlik NPrinting-Hauptmenü Aufgaben und dann Import-Aufgabe aus.
2. Klicken Sie auf Import-Aufgabe erstellen.

3. Fügen Sie den Namen der Aufgabe ein. Beispiel: Import Users.

4. Lassen Sie das Kontrollkästchen Aktiviert aktiviert. Andernfalls wird Ihre Aufgabe von der Qlik NPrinting Engine ignoriert.
5. Klicken Sie unter Quellen auf Quelle hinzufügen. Wählen Sie im Dropdown-Menü die Option Aus Excel importieren oder Aus LDAP importieren aus.
6. Die nächsten Schritte hängen vom Quelltyp ab:

   1. Excel: Fügen Sie den Importdateipfad (auf dem Server) des Qlik NPrinting Server hinzu, auf dem die Excel-Datei gespeichert ist.

      Beispiel: C:\ProgramData\NPrinting\Imports\NP_Web_Imports.xlsx. Dabei handelt es sich nicht um den Dateipfad auf Ihrem lokalen Computer.

      Sie können auch einen Remotecomputer-Netzwerkpfad verwenden. Der Windows-Benutzer, der den Qlik NPrinting Scheduler Service ausführt, benötigt Zugriff auf den Remoteordner auf dem Qlik NPrinting Server. Siehe: Importsyntax in Excel-Dokumenten.

   2. LDAP: Fügen Sie den Verbindungspfad der LDAP-Quelle hinzu.

      Sie können die anderen Felder nach Bedarf ausfüllen. Informationen dazu finden Sie unter: Importsyntax in LDAP-Quellen.

7. Lassen Sie das Kontrollkästchen Aktiviert aktiviert. Andernfalls wird Ihre Quelle von der Qlik NPrinting Engine ignoriert.
8. Klicken Sie auf Quelle hinzufügen, um eine weitere Quelle hinzuzufügen.
9. Klicken Sie rechts auf , um eine Quelle zu löschen. Klicken Sie auf , um sie zu duplizieren.
10. Aktivieren Sie unter Einstellungen die Kontrollkästchen, die angeben, wie Sie mit Zusammenführungskonflikten umgehen möchten:
    • Benutzer erstellen, falls nicht vorhanden
    • Benutzer aktualisieren, falls geändert

    • Benutzer entfernen, die in den neuesten Importquellen nicht vorhanden sind

      Nur Benutzer, die während einer vorherigen Ausführung desselben Importvorgangs hinzugefügt worden sind, werden gelöscht. Andere Benutzer, z. B. jene, die manuell hinzugefügt wurden, werden nicht gelöscht.

    • Vorhandene Benutzerzuweisungen (Filter, Rollen und Gruppen) ersetzen

      Vorhandene Benutzerzuweisungen werden entfernt, wenn sie nicht in der Importdatei vorhanden sind. Sie werden durch Zuweisungen in der neuen Datei ersetzt.

    • Gruppen entfernen, die in den neuesten Importquellen nicht vorhanden sind

      Nur Gruppen, die während einer vorherigen Ausführung desselben Importvorgangs hinzugefügt worden sind, werden gelöscht. Andere Gruppen, z. B. jene, die manuell hinzugefügt wurden, werden nicht gelöscht.

    • Filter erstellen, falls nicht vorhanden
    • Filter aktualisieren, falls modifiziert

    • Filter entfernen, die in den neuesten Importquellen nicht vorhanden sind

      Nur Filter, die während einer vorherigen Ausführung desselben Importvorgangs hinzugefügt worden sind, werden gelöscht. Andere Filter, z. B. jene, die manuell hinzugefügt wurden, werden nicht gelöscht.

    • Vorhandene Filterfelder ersetzen

      Bestehende Filterfelder werden entfernt, wenn sie nicht in der Importdatei vorhanden sind. Sie werden durch Filterfelder aus der Importdatei ersetzt.

11. Unter Benachrichtigungen können Sie Aufgabenbenachrichtigungen senden auswählen. Es wird dann eine E-Mail an die unter Einstellungen > Aufgaben angegebenen Adressen gesendet. Informationen dazu finden Sie unter: Aufgabenausführungsbenachrichtigungen (nur auf Englisch).
12. Klicken Sie auf Erstellen.

Ausführen der Import-Aufgabe

Prüfen des Aufgabenstatus

Auf der Hauptseite der Aufgabe Importieren von Filtern und Empfängern sehen Sie den Status Ihrer Import-Aufgabe.

• Letzte Ausführung: Zeigt das Datum und die Uhrzeit der letzten Ausführung an.
• Letzter Ausführungsstatus: Wenn eine Aufgabe erfolgreich ausgeführt wurde, wird sie als Abgeschlossen angezeigt. Andernfalls wird sie als Fehlgeschlagen angezeigt.
• Status der letzten Ausführung: Zeigt, wie weit eine aktive Aufgabe fortgeschritten ist.

• Letztes Importprotokoll: Klicken Sie auf den Link Herunterladen, um die neuesten, der Aufgabe zugewiesenen Protokolle anzuzeigen.

  Wenn während des Imports ein Fehler auftritt, wird die Fehlermeldung im aktuellen Gebietsschema des Computers, auf welchem der Importvorgang ausgeführt wurde, im Protokoll angezeigt. Der Import für alle Benutzer wird bei dem Auftreten des ersten Fehlers gestoppt, und der ganze Import wird rückgängig gemacht. Der Protokolldatei-Download umfasst eine Protokollzeile für jede Importaktion. Die Aufgabenausführungsprotokolle enthalten nur die Hauptprotokolle wie Fehler und Fortschrittsinformationen.

• Aktiviert: Wenn dieses Kontrollkästchen nicht aktiviert ist, wird Ihre Aufgabe von der Qlik NPrinting Engine ignoriert.
• Aktionen: Klicken Sie auf , um die Aufgabe zu bearbeiten, zu löschen, auszuführen oder zu testen.

Prüfen Sie die importierten Benutzer auf der Seite Benutzer, um neu erstellte Benutzer anzuzeigen. Sie können prüfen, dass verknüpfte Filter erstellt wurden, indem Sie die Dialogseite Filter öffnen.