Schwierigkeitsgrad: Experte

Haben Sie gelesen: https://spacewell.atlassian.net/wiki/spaces/KB/pages/45481997? Der folgende Artikel wiederholt einige der Informationen aus diesem Artikel und geht noch weiter in die Tiefe.

Grundlagen

Die Importfunktionalität ermöglicht ein schnelles Hochladen von großen Datenmengen in den Workplace. Durch die Verwendung eines Import-Connectors mit Import-Mappings ist es möglich, festzulegen, in welcher Datentabelle die verschiedenen Daten gespeichert werden sollen.

Für den Import von Master data beim Einrichten einer Umgebung stehen Standardimporte zur Verfügung. Damit kann die Umgebung z.B. mit Kontakten, Eigenschaften und Bereichen gefüllt werden. Die Dateien werden im csv-Format importiert.

Wo man Importe findet

Die Standardimporte werden in den Artikeln, die das Einrichten einer neuen Workplace-Umgebung mit dem Solution-Based Rollout (SBR) beschreiben, ausführlich erläutert https://spacewell.atlassian.net/wiki/spaces/KB/pages/92504065. Wenn Sie einen Import nicht im Kontext eines SBR ausführen möchten, können Sie auf die Importe zugreifen, indem Sie:

1. Drücken Sie die Schaltfläche "Standardimporte"/"Benutzerdefinierte Importe" auf dem StartBoard.

2. Öffnen Sie den Importanschluss, indem Sie auf die "Referenz" klicken. Nach Anklicken der Referenz öffnet sich die allgemeine Registerkarte des Imports;

   1. Wenn der von Ihnen gesuchte Import noch nicht in der Liste vorhanden ist, klicken Sie auf : Standardimporte generieren am Ende der Importliste.

Open

Registerkarte Allgemein des Eigenschaftsimports

Schritte zum Importieren von Daten (und Debuggen von Fehlermeldungen)

Gehen Sie wie folgt vor, um Daten zu importieren:

1. Generieren Sie eine Importvorlage, indem Sie auf "Importvorlage generieren" klicken.

   • Im Include am unteren Rand wird eine Datei mit dem Namen "Template import xxx" verfügbar.

   • Um die Datei herunterzuladen, klicken Sie auf das Download-Symbol.

2. Dies ist die Excel-Datei, die wir an den Kunden senden und ihn bitten, sie auszufüllen.

3. Nachdem Sie die Datei vom Kunden zurückerhalten haben, sollten Sie die Daten zu überprüfen:

   1. Vergleichen Sie mit der Vorlage, wenn der Kunde keine Spalten gelöscht/hinzugefügt oder Spaltenüberschriften geändert hat;

   2. Sind alle Spalten ausgefüllt;

   3. Prüfen Sie, ob die Daten gültig sind, insbesondere bei Feldern, die eine Auswahl (eine Anzahl von Werten) oder ein festes Format (Daten) erfordern. Abweichende/keine Werte führen NICHT zu einem Fehler. Das Ergebnis wird einfach sein, dass der Wert nicht importiert wird;. Zum Beispiel:

      1. wenn eine Spaltenbeschreibung die Frage "Ist es möglich, von dieser Eigenschaft aus Flächen zu reservieren (1 = ja)" > Vergewissern Sie sich, dass eine "1" eingetragen ist.

      2. wenn eine Spaltenbeschreibung die Frage "Das Errichtungsdatum der Immobilie (tt-mm-jjjj)" > Stellen Sie sicher, dass das Datumsformat korrekt ist.

      3. wenn eine Spaltenbeschreibung die Frage "Der Status der Immobilie, wählen Sie zwischen: in Gebrauch, Verhandlung, Renovierung, Bau, verkauft" > Stellen Sie sicher, dass die Eingabe genau einem dieser Werte entspricht.

4. Nun speichern Sie die Datei als CSV UTF-8.

   1. Tipp für die Konvertierung Ihrer .xlsx in CSV: Öffnen Sie die Importdatei in Excel > Datei > Exportieren > Dateityp ändern > wählen Sie "CSV" > Speichern unter.

5. Das in der CSV-Datei verwendete Feldbegrenzungszeichen (ein Komma oder ein Semikolon) sollte mit der Einstellung des Benutzers, der die Datei importiert, übereinstimmen.

   1. Um die Einstellung für das Feldbegrenzungszeichen Ihres Benutzers zu ändern, navigieren Sie zu: Ihr Profil (oben rechts auf Ihrem Bildschirm) > Einstellungen > Registerkarte Einstellungen > Feld "Feldbegrenzungszeichen".

6. Importieren Sie die Datei, indem Sie auf Datei importieren klicken.

7. Wählen Sie eine Datei aus, indem Sie auf Dateien auswählen klicken.

8. Das Importieren der Dateien wird im Hintergrund fortgesetzt. Wenn wir klicken: Ok, kehren wir zur Importseite zurück.

9. In der rechten oberen Ecke wird das Symbol für die Hintergrundaufgabe angezeigt; wenn Sie darauf klicken, sehen Sie den Importstatus.

   1. Tipp: Wenn die Hintergrundaufgabe nicht erscheint, aktualisieren Sie die Seite, indem Sie auf das Spacewell-Logo oben links auf der Seite klicken (oder klicken Sie F5, um Ihren Browser zu aktualisieren).

      Open

      

10. Wenn der Import abgeschlossen ist, finden Sie die Ergebnisse, indem Sie auf das Dokumentensymbol in der oberen rechten Ecke klicken.

11. Wählen Sie auf der Dokumentenseite Erweiterte Suche.

12. Geben Sie im Feld Datum > "Verknüpft von/bis" das heutige Datum ein oder drücken Sie sofort auf "ok", um alle zu diesem Import gehörenden Dokumente zu finden.

13. Je nach Einstellung des Anschlusses finden Sie die folgenden drei Dokumente

    1. (csv)-Datei, die Sie hochgeladen haben, z. B. Dateien[]-Vorlagenimport-Eigenschaften. Die Dateien werden nur gespeichert, wenn die Import-Connector-Einstellung "Dokumente speichern = ja";

    2. Verarbeitungsprotokoll - z.B. FMB-F-021-[Manual upload]-import. Hier wird angezeigt, welche neuen Datensätze erstellt wurden und ob bestehende Datensätze aktualisiert wurden;

    3. Verarbeitungsfehler - z. B. FMB-F-021-[Manueller Upload]-Fehler. Eine Liste der aufgetretenen Blockierfehler.

       1. Wenn die Importdatei korrekt ausgefüllt ist und im richtigen Format hochgeladen wird, treten keine Fehler auf. Wenn doch ein Fehler auftritt, kann es ziemlich schwierig sein, das genaue Problem der Importdatei herauszufinden. Im Folgenden werden einige Tipps und Hinweise zu möglichen Ursachen gegeben

Wie wird die Importdatei in Workplace abgebildet?

Öffnen eines Import-Mappings

1. Drücken Sie die Schaltfläche "Standardimporte"/"Benutzerdefinierte Importe" auf Ihrem StartBoard;

2. Öffnen Sie einen ftp-Anschluss, z. B. FMB-F-021;

3. Navigieren Sie zur Registerkarte "Details" (hier finden Sie die allgemeinen Importeinstellungen);

4. Blättern Sie nach unten zum Eintrag 'Mapping';

5. Öffnen Sie die gewünschte Kartierung, indem Sie auf die Lupe hinter der Spalte "Kartierung" drücken (nicht auf die blaue Lupe am Anfang der Zeile!!).
   
   

Beim Ausfüllen der Importdateien gibt es einige Dinge zu beachten.

• Jede Importdatei hat verschiedene Felder, die ausgefüllt werden müssen. Welche Felder das sind, hängt von der Konfiguration der Mappings ab, die mit dem Import-Connector verbunden sind.

• Wenn Sie eine Zuordnung öffnen, können Sie sehen, um welches Objekt es sich handelt (Feld "Objekte") und welche Felder betroffen sind (Feld "Zuordnung").

Spalten in einem Mapping

Siehe Bildschirmfoto oben.

• Reihenfolge: Legt fest, in welcher Reihenfolge das Mapping bearbeitet wird.

• Name: Der Name hier entspricht einer der Spaltenüberschriften in der Importdatei (xlsx/ csv).

• Typ/Feld/Lookup: Diese bestimmen, in welchem Feld im Workplace der importierte Wert gespeichert werden soll.

  • Beispiel: Sehen Sie sich Zeile 80 des obigen Screenshots an. Mit diesen Einstellungen wird der Wert in der Spalte 'Stadt' der Importdatei wird im Feld Adresse.Stadt (das Objekt ist Address ) im Workplace.

Wichtige Werte

• Die Schlüsselwerte eines Mappings befinden sich in der Spalte "Schlüssel". Der Wert "Ja" bedeutet, dass dieses Feld ein Schlüsselwert ist.

• Schlüsselwerte sind Pflichtfelder, damit ein Import funktioniert. Das bedeutet, dass der Import nicht ordnungsgemäß durchgeführt werden kann, wenn die Schlüsselwerte fehlen.

• Die Schlüsselwerte werden verwendet, um festzustellen, ob ein neues Objekt angelegt werden muß ODER ob ein bestehendes Objekt aktualisiert werden muß. Um dies festzustellen, prüft der Workplace, ob bereits ein Objekt existiert, das ALLE Schlüsselwerte enthält.

• Wie funktioniert das? In der Adresszuordnung (siehe Screenshot oben) sind Straße, Hausnummer und Postleitzahl die Schlüsselwerte. Die Werte in der Importdatei könnten zum Beispiel lauten: Zweite Straße, 55, 1234AB. Das Mapping prüft, ob eine Adresse mit diesen Merkmalen vorhanden ist. Es findet eine der folgenden Aktionen statt:

  • Wenn die Adresse existiert, werden die Nicht-Schlüsselwerte aktualisiert.

  • Wenn die Adresse noch nicht existiert, wird eine neue Adresse angelegt, in der die Schlüssel- und Nichtschlüsselwerte gespeichert werden.

Hintergrundinformationen zu Importkonnektoren und Mappings

Fast alle verfügbaren Importverbindungen bestehen aus mehreren Importzuordnungen. Für jedes Objekt, das wir importieren wollen, ist eine eigene Zuordnung erforderlich. Dies ist jedoch nicht der einzige Grund, warum wir verschiedene Zuordnungen verwenden. Wir könnten auch eine bestimmte Zuordnung verwenden, um nur die Hierarchie eines Objekts festzulegen, so dass dies bei Eigenschaften die Hierarchie innerhalb der importierten Eigenschaften sein könnte.

Ausführen eines Mappings anstelle des Import-Connectors

Wir sind in der Lage, Mappings getrennt von ihrem Connector zu betreiben:

1. Öffnen Sie den Import-Connector;

2. Wechseln Sie zur Registerkarte Details;

3. Wählen Sie ein Mapping aus, indem Sie auf die Lupe neben dem Mapping-Namen klicken;

4. Klicken Sie auf Importieren;

5. Wählen Sie Ihre Datei aus.

Der Import wird dann ausgeführt und die Ergebnisse werden auf der Seite angezeigt.

Einstellungen des Anschlusses

Nur Partnerbenutzer können die Einstellungen der Konnektoren ändern. Bitte beachten Sie, dass, wenn es sich um einen Standardimport handelt, auch Partnerbenutzer keinen Zugriff haben, da die Importdefinition von der Basislinie geerbt wird. In der folgenden Tabelle gehen wir auf einige wichtige Einstellungen ein. Bewegen Sie den Mauszeiger über eine Einstellung im Workplace, um den Hilfetext für andere Einstellungen anzuzeigen.

Automatisieren eines Imports oder Exports

• Es ist auch möglich, Importe so einzurichten, dass sie periodisch von einem FTP-Server ausgeführt werden.

• Der automatische Export kann so eingestellt werden, dass die Daten auf: FTP-Server und E-Mail.

Zusammenfassung

Suche