Show Menu
THEMEN×

Bulk upload of POIs

Mit der Schaltfläche "POIs importieren "im Orte-Dienst können neue POIs mit einer CSV-Datei als Massen-Upload hochgeladen werden. Es wird eine Beispielvorlage für Tabellen bereitgestellt, die zeigt, welche Datenspalten erforderlich sind und wie optionale benutzerdefinierte Metadaten hinzugefügt werden.
Nachfolgend finden Sie ein Video mit dem Vorgang für den Massenimport und die Massenbearbeitung:

Python API-Skripten

Eine Reihe von Python-Skripten wurden erstellt, um den Stapelimport von POIs aus einer CSV-Datei in eine POI-Datenbank mithilfe der Web Service APIs zu vereinfachen. Diese Skripten können von diesem Open-Source- Git-Repo heruntergeladen werden.
Bevor Sie diese Skripten ausführen, lesen Sie die Informationen zum Zugriff auf die Webdienst-APIs unter Voraussetzungen für den Benutzerzugriff in der Übersicht über die Integration und Voraussetzungen .
Im Folgenden finden Sie einige Informationen zu den Skripten:
Diese Informationen sind auch in einer Readme-Datei im Git-Repo enthalten.

CSV-Datei nicht funktionierte, wurde behoben

Eine .csv-Beispieldatei places_sample.csv ist Teil dieses Pakets und enthält die erforderlichen Kopfzeilen und eine Reihe von Musterdaten. Diese Header sind alle Kleinbuchstaben und entsprechen den reservierten Metadatenschlüsseln, die in der Datenbank "Orte"verwendet werden. Spalten, die Sie der .csv-Datei hinzufügen, werden der POI-Datenbank in einem separaten Metadatenabschnitt für jeden POI als Schlüssel/Wert-Paare hinzugefügt und der Header-Wert wird als Schlüssel verwendet.
Im Folgenden finden Sie eine Liste der Spalten und der erforderlichen Werte:
  • lib_id
    Eine gültige Bibliotheks-ID, die aus der POI-Datenbank abgerufen wird.
  • type
    Point ist zurzeit der einzige gültige Wert.
  • longitude
    Ein Wert zwischen -180 und 180.
  • latitude
    Ein Wert zwischen -85 und 85.
  • radius
    Ein Wert zwischen 10 und 20.000.

Spaltenwerte

Die Werte der folgenden Spalten werden in der Benutzeroberfläche des Places-Dienstes verwendet:
  • Farbe, die als Farbe des Pins verwendet wird, der die Position des POI in der Benutzeroberfläche des Orts-Dienstes darstellt.
    • Die gültigen Werte sind "", #3E76D0, #AA99E8, #DC2ABA, #FC685B, #FC962E, #F6C436, #BECE5D, #61B56B und #3DC8DE und "".
    • Wenn der Wert leer gelassen wird, verwendet die Benutzeroberfläche des Places-Dienstes Blau als Standardfarbe.
      Die Werte entsprechen blau (#3E76D0), violett (#AA99E8), fuschia (#DC2ABA), orange (#FC685B), hellorange (#FC962E), gelb (#F6C436), hellgrün (#BECE5D), grün (#6 1B56B) bzw. hellblau (#3DC8DE).
  • -Symbol, das als Symbol auf dem Pin verwendet wird, das die Position des POI auf der Benutzeroberfläche des Places-Dienstes darstellt.
    • Die gültigen Werte sind "", Shop, Hotelbett, Auto, Flugzeug, Zug, Schiff, Stadion, amusementpark, Anker, Beaker, Bell, Bid, Buch, Box, Brieftasche, Broschüre, Bürste, Gebäude, Rechner, Kamera, Uhr, Bildung, Taschenlampe, folgen, Spiel, weiblich, männlich, Geschenk, Hammer, Herz, Schlüssel, Start, Glühbirne, Briefkasten, Geld, Posting, Geld, Geld, Posting, Pin Warenkorb, Warenkorb, Stern, Zielgruppe, Teekanne, Daumendown, Daumen, Trap, Trophäe, Schraubenschlüssel.
      Die Symbolwerte werden in der Reihenfolge aufgeführt, in der sie in der folgenden Abbildung angezeigt werden:
    • Wenn der Wert leer gelassen wird, verwendet die Benutzeroberfläche den Stern als Standardsymbol.
  • Spalten, die nicht erwähnt werden, können leer gelassen werden.

Ausführen des Skripts

  1. Laden Sie Dateien aus dem Git-Repo in Ihren lokalen Ordner herunter.
  2. Öffnen Sie die config.py Datei in einem Texteditor und führen Sie die folgenden Aufgaben aus:
    a. Bearbeiten Sie die folgenden Variablenwerte als Zeichenfolgen:
    • csv_file_path
      Dies ist der Pfad zu Ihrer .csv Datei.
    • access_code
      Dies ist Ihr Zugriffscode, den Sie beim Aufruf von Adobe IMS erhalten haben. Informationen zum Abrufen dieses Zugriffscodes finden Sie unter Voraussetzungen für den Benutzerzugriff in der Übersicht über die Integration und Voraussetzungen .
    • org_id
      Die Experience Cloud-orgID, in die die POIs importiert werden sollen. Informationen zum Abrufen der Organisations-ID finden Sie unter Voraussetzungen für den Benutzerzugriff in der Übersicht über die Integration und Voraussetzungen .
    • api_key
      Dies ist der REST-API-Schlüssel für Platzierungen, den Sie aus der Adobe I/O-Platzierungsintegration erhalten haben. Informationen zum Abrufen des API-Schlüssels finden Sie unter Voraussetzungen für den Benutzerzugriff in der Übersicht über die Integration und Voraussetzungen . b. Speichern Sie Ihre Änderungen.
  3. Navigieren Sie in einem Terminalfenster zum …/places-scripts/import/ Ordner.
  4. Geben Sie python ./places_import.py die enter ( return ) Taste ein.

CSV-Prüfungen vor dem Import

Das Skript führt zunächst die folgenden Prüfungen in der .csv-Datei durch:
  • Gibt an, ob eine .csv Datei angegeben wurde.
  • Ob der Dateipfad gültig ist.
  • Gibt an, ob die reservierten Metadaten-Header enthalten sind.
    Die reservierten Metadaten-Header sind lib_id, name, description, type, length, latitude, radius, country, state, city, street, Kategorie, icon und color.
    Die Kopfzeilen sind alle in Kleinbuchstaben und können in beliebiger Reihenfolge aufgeführt werden.
  • Prüft die Werte der im Abschnitt "CSV-Datei"angegebenen Spalten.
Wenn Fehler gefunden werden, gibt das Skript die Fehler aus und wird abgebrochen. Wenn keine Fehler gefunden werden, versucht das Skript, die POIs in Stapeln von 1000 zu importieren. Wenn der Stapel erfolgreich importiert wurde, gibt das Skript einen Statuscode von 200 aus. Wenn der Stapel nicht erfolgreich importiert wurde, werden Fehler gemeldet.

Unit-Tests

Komponententests befinden sich in der tests.py Datei, sollten vor jeder Pull-Anforderung ausgeführt werden und alle bestehen. Zusätzliche Tests sollten mit neuem Code hinzugefügt werden. Um die Tests auszuführen, navigieren Sie zum …/places-scripts/import/ Ordner und geben Sie python ./places_import.py in Terminal ein.