Wiki-Quellcode von Import von CSV-Dateien

Zuletzt geändert von Sabrina V. am 2024/11/11 12:21
Zeige letzte Bearbeiter
1 {{aagon.floatingbox/}}
2
3 An verschiedenen Stellen in der ACMP Console haben Sie die Möglichkeit, zusätzliche Daten zu importieren. Der Import von CSV-Dateien ist systemübergreifend und immer dann sinnvoll, wenn externe Informationen für Ihre Arbeiten in der Console relevant sind und diese noch nicht eingepflegt wurden. Der Vorteil dieser Vorgehensweise ist, dass Sie in nur einem Schritt auch eine größere Menge ausgewählter Daten zentral in einer Datei hochladen können und diese Informationen nicht manuell eingeben müssen. Dies spart nicht nur Zeit, sondern Sie können auch auf bereits bestehende CSV-Datensätze zurückgreifen und diese direkt oder leicht abgewandelt weiterverwenden. Voraussetzung dafür ist jedoch, dass die Datei bereits für den Import erstellt wurde und Sie sie nur noch in die ACMP Console hochladen müssen.
4
5 Jeder Import einer CSV-Datei läuft nach dem gleichen Prinzip ab: Öffnen Sie in der Ribbonleiste die Aktion //Importieren //([[image:1731311907510-969.png||height="18" width="18"]]). Sie werden schrittweise durch einen mehrseitigen Wizard geleitet, um die Informationen der CSV-Datei in das System zu laden.
6
7
8 = Anwendungsbereiche =
9
10 Nachfolgend finden Sie zu den jeweiligen Einsatzbereichen eine kurze Beschreibung und in welchem Zusammenhang ein Import sinnig sein kann. In der Spalte //Besonderheiten //sind Informationen und Hinweise enthalten, die Sie bei einem Import berücksichtigen sollten.
11
12 |(% style="width:354px" %)**ACMP Bereich**|(% style="width:590px" %)**Beschreibung**|(% style="width:749px" %)**Besonderheiten**
13 |(% style="width:354px" %)(((
14 **Asset Management**
15
16 (//Asset Management// > //Hardware Assets//)
17 )))|(% style="width:590px" %)(((
18 Importieren Sie eine CSV-Datei, um beispielsweise weitere Anlage- und Sachgüter in der ACMP Console zu inventarisieren (z.B. wenn eine größere Menge an neuer Hardware bestellt wurde und diese ins System aufgenommen werden soll).
19
20
21 )))|(% style="width:749px" %)(((
22 * Im Asset Management gibt es zusätzliche Einstellungen, die Sie unter //System// > //Einstellungen// > //Asset// //Management// > //Import// konfigurieren müssen. Hierbei legen Sie fest, wie Sie mit der automatischen Verarbeitung von [[Asset-Duplikaten>>doc:ACMP.67.ACMP-Solutions.Asset Management.Assets verwalten.WebHome||anchor="HAssetsbearbeiten2ClF6schenundduplizieren"]] umgehen wollen.
23 * Innerhalb der Zuordnung (zweiter Schritt des Imports einer CSV-Datei) werden nur verfügbare Felder des Typen //Asset Management //berücksichtigt.
24 )))
25 |(% style="width:354px" %)**Lizenzmanagement**|(% style="width:590px" %)Im Lizenzmanagement kann es auch nötig sein, eine CSV-Datei zu importieren, wenn:|(% style="width:749px" %)
26 |(% style="width:354px" %)(((
27 Lizenzen
28
29 (//Lizenzmanagement// > //Lizenzen//)
30 )))|(% style="width:590px" %)- Lizenzen neu eingespielt werden sollen und bereits in der Datei Angaben zur [[Lizenzmetrik>>doc:ACMP.67.ACMP-Solutions.Lizenzmanagement.Lizenzen.WebHome||anchor="HLizenzenhinzufFCgen"]] und [[Kalkulationsmethode>>doc:ACMP.67.ACMP-Solutions.Lizenzmanagement.Lizenzen.Lizenzen und Produkte in ACMP importieren.WebHome||anchor="HKalkulationsmethode"]] gemacht werden können.|(% style="width:749px" %)(((
31 * Die Angabe des Lizenznamens (beim Import von Lizenzen) ist zwingend erforderlich, da es sich um ein Pflichtfeld handelt.
32 * Geben Sie den entsprechenden Wert zur Bestimmung der [[Kalkulationsmethode>>doc:ACMP.67.ACMP-Solutions.Lizenzmanagement.Lizenzen.Lizenzen und Produkte in ACMP importieren.WebHome||anchor="HKalkulationsmethode"]] in der Datei an, damit diese den richtigen Attributen zugeordnet werden kann.
33 )))
34 |(% style="width:354px" %)(((
35 Produkte
36
37 (//Lizenzmanagement// > //Produkte//)
38 )))|(% style="width:590px" %)- Eine größere Menge neuer Produkte in die ACMP Console eingepflegt werden soll. Innerhalb des Imports ist es möglich, die [[Kalkulationsmethode>>doc:ACMP.67.ACMP-Solutions.Lizenzmanagement.Lizenzen.Lizenzen und Produkte in ACMP importieren.WebHome||anchor="HKalkulationsmethode"]] zu hinterlegen.|(% style="width:749px" %)(((
39 * Die Angabe des Produktnamens (beim Importieren von Produkten) ist zwingend erforderlich, da es sich hierbei um ein Pflichtfeld handelt.
40 * Geben Sie den entsprechenden Wert zur Bestimmung der [[Kalkulationsmethode>>doc:ACMP.67.ACMP-Solutions.Lizenzmanagement.Lizenzen.Lizenzen und Produkte in ACMP importieren.WebHome||anchor="HKalkulationsmethode"]] in der Datei an, damit diese den richtigen Attributen zugeordnet werden kann.
41 )))
42 |(% style="width:354px" %)(((
43 **Manuelle Clients**
44
45 (//Client Management// > //Manuelle Clients//)
46 )))|(% style="width:590px" %)Der Import von manuellen Clients kann beispielsweise dann sinnvoll sein, wenn Sie einen Computer an einem Ihrer Standorte als Austauschgerät zurückhalten und Sie diesen bereits im Vorfeld in die manuellen Clients importieren wollen. Sollten gleich mehrere Clients erfasst werden, ist der Import über eine CSV-Datei zeitsparend und Sie können im Arbeitsalltag den Computer schnellstmöglich austauschen und Vorort verkabeln, denn alle relevanten Informationen sind schon in ACMP eingepflegt.|(% style="width:749px" %)(((
47 * Sollte ein solches Szenario eintreten, wie unter //Beschreibung //beschrieben, ist es notwendig, dass Sie in der CSV-Datei für den Import die MAC Adresse hinterlegen. Nur mit der MAC Adresse ist eine eindeutige Zuordnung möglich.
48 )))
49 |(% style="width:354px" %)**Stammdaten**|(% style="width:590px" %)Die Stammdaten bestehen aus verschiedenen Bereichen, in denen Sie jeweils einen eigenen Import starten können. Der Import kann sinnvoll sein, wenn:|(% style="width:749px" %)
50 |(% style="width:354px" %)(((
51 Kontakte
52
53 (Ribbonleiste //Stammdaten //>  //Kontakte//)
54 )))|(% style="width:590px" %)- Eine größere Menge an neuen Mitarbeitern in der ACMP Console hinterlegt werden soll. Sollten Sie beispielsweise einen neuen Vertragspartner haben oder neue Kooperationen mit anderen Firmen (bzw. dessen Mitarbeiter/Ansprechpartner) schließen, kann andernfalls das manuelle Einpflegen aller neuen Kontakte zeitaufwändig sein.|(% style="width:749px" %)(((
55 * Es muss das eindeutige Identifikationsmerkmal in der CSV-Datei hinterlegt sein, welches Sie innerhalb der Einstellungen unter //[[Eindeutiges Identifikationsmerkmal für den Kontaktsupport>>doc:ACMP.67.ACMP-Solutions.System.Einstellungen.Stammdaten.WebHome||anchor="HKontakte"]] //hinterlegt haben (die E-Mail oder Custom ID).
56
57
58 )))
59 |(% style="width:354px" %)(((
60 Standorte
61
62 (Ribbonleiste //Stammdaten //> //Standorte//)
63 )))|(% style="width:590px" %)- Ihr Unternehmen einen neuen Standort eröffnet und Sie direkt den Standort nach den Typen (Standort, Gebäude, Raum) eingliedern wollen.|(% style="width:749px" %)(((
64 * Es wird für die Zuordnung ein Standortname benötigt. Ohne einen Standortnamen (z.B. Stadtnamen oder eine Gebietseinteilung (Süd, West etc.) kann keine Datei importiert werden.
65 )))
66 |(% style="width:354px" %)(((
67 Firmen
68
69 (//Ribbonleiste Stammdaten //> //Firmen//)
70 )))|(% style="width:590px" %)- Eine größere Anzahl von Firmen in nur einem Schritt hinzugefügt werden soll, wenn Sie beispielsweise gleich mehrere Anbieter, Dienstleister oder Hersteller in die ACMP Console einpflegen möchten.|(% style="width:749px" %)(((
71 * Für die Zuordnung wird der Name der Firma benötigt. Ohne diese Angabe kann der Import nicht abgeschlossen werden.
72 )))
73 |(% style="width:354px" %)(((
74 Abteilungen
75
76 (//Ribbonleiste Stammdaten //> //Abteilungen//)
77 )))|(% style="width:590px" %)- Sie mehrere Abteilungen gleichzeitig hinzufügen wollen.|(% style="width:749px" %)(((
78 * Es wird ein Name für die Abteilung benötigt, da der Wizard andernfalls einen Fehler während der Zuordnung verursacht.
79 )))
80 |(% style="width:354px" %)(((
81 Kostenstellen
82
83 (//Ribbonleiste Stammdaten //> //Kostenstellen//)
84 )))|(% style="width:590px" %)- Ihr Unternehmen in mehrere Kostenstellen aufgegliedert bzw. neue Kostenstellen hinzugefügt werden sollen, um so eine bessere Kosten- und Leistungsübersicht der jeweiligen Abteilungen zu erzielen.|(% style="width:749px" %)(((
85 * Vergeben Sie einen Namen für die Kostenstelle. Andernfalls kann der Import nicht fortgesetzt werden.
86 )))
87 |(% style="width:354px" %)(((
88 Verträge
89
90 (//Ribbonleiste Stammdaten //> //Verträge//)
91 )))|(% style="width:590px" %)- Sie mehrere Verträge gleichzeitig hochladen wollen.|(% style="width:749px" %)(((
92 * Es wird ein Mapping für den Namen des Vertrags benötigt, andernfalls kann der Import nicht fertig gestellt werden.
93 )))
94
95 == Allgemeine Hinweise ==
96
97 * Eine doppelte Feldzuordnung führt zu einem Fehler. Vergewissern Sie sich, dass Sie innerhalb der Zuordnung keinem Feld die gleiche Bezeichnung zuordnen.
98 * Das Identifikationsmerkmal, welches Sie in den Einstellungen für das [[Asset Management>>doc:ACMP.67.ACMP-Solutions.System.Einstellungen.Asset Management.WebHome]] hinterlegt haben, muss zwingend für das Mapping vorhanden sein. Andernfalls führt der Import auch hier zu einem Fehler.
99 * Die Kategorien //Kontakte//, //Standorte//, //Firmen//, //Abteilungen// und //Kostenstellen//, die beim Import von Assets angegeben, jedoch nicht im ACMP vorhanden sind, werden automatisch als verfügbare Werte angelegt. Sollten Sie mehr Daten benötigen, als Sie im Mapping angeben können, importieren Sie vorher die jeweilige Entität.
100
101 = Aufbau der Import Datei und CSV-Datensätze =
102
103 == Aufbau der Import Datei ==
104
105 CSV-Dateien können Sie in einem beliebigen Texteditor (zum Beispiel Microsoft Excel, Notepad++ etc.) erstellen. Wichtig ist, dass Sie die Datei unter dem Format //CSV// speichern.
106
107 Möchten Sie eine eigene Datei erstellen, sollten Sie die folgenden Hinweise beachten, um einen erfolgreichen Import zu garantieren:
108
109 * Sollten Sie IP-Adressen verwenden, müssen diese in doppelte Anführungsstriche gesetzt werden. Beispiel: „192.156.200.18“
110 * Verwenden Sie Speichergrößen wie beispielsweise Festplattengrößen, RAM etc., müssen diese Werte ebenfalls in doppelte Anführungszeichen gesetzt werden, wenn diese einen Dezimalseparator und eine Einheit enthalten. Beispiel: „10,5 GB“.
111 * Wählen Sie zwischen den verfügbaren Einheiten (KB bis TB) aus. Die Binärpräfixe (KiB bis TiB) werden nicht unterstützt und beim Import durch den Wert „0“ ersetzt.
112 * Die CPU Frequenz muss in MHz angegeben werden, wobei die Einheit nicht in der CSV-Datei enthalten sein darf. Wird die Frequenz mit einem Separator angegeben, muss diese ebenfalls in doppelte Anführungsstriche gesetzt werden.
113 * Der Inhalt der CSV-Datei wird exakt so in ACMP übernommen, wie sie erstellt wurde. Achten Sie also bei der Benennung der einzelnen Felder auf die Schreibweise.
114
115 === Beispiel für CSV-Datensätze ===
116
117 Nachfolgend sehen Sie einige Beispiele, wie die CSV-Datensätze aufgebaut sein können:
118
119 {{code language="none"}}
120 Computer Name;Computer Domain;OS Name;Main User;Primary IP;ACMP Client Mac Address;CPU Name;CPU Frequency (Mhz);Total RAM;Total harddrive capacity
121 Computer 1;DOMAINTEST;Windows 7 Home;Benutzer 1;"10.0.0.1";AA:BB:CC:AA:3A:AF;Phenom 1;"2000,56";"1024 MB";"1 TB"
122 ComputerName;MSHEIMNETZ;Windows 8 Pro;John;"10.0.0.2";CC:CC:CC:CC:CC:CC;Phenom II x4;3400;"4 GB";"5 GB"
123
124 {{/code}}
125
126 == CSV-Dateien importieren ==
127
128 Um eine CSV-Datei zu importieren, müssen Sie in der Ribbonleiste der jeweils oben genannten Anwendungsbereiche die Aktion //Importieren// ([[image:1731313214858-303.png||height="18" width="18"]]) auswählen. Die Vorgehensweise ist in allen Bereichen immer die gleiche, daher ist es für die allgemeine Erklärung unerheblich, ob Sie nun manuelle Clients, Assets oder Lizenzen in die ACMP Console einpflegen wollen. Klicken Sie auf den Button und es öffnet sich ein Wizard.
129
130 Wählen Sie die vorbereitete CSV-Datei aus, indem Sie diese in die dafür vorgesehene Zeile einfügen. Geben Sie danach an, welche Trennzeichen und Dezimaltrennzeichen Sie in der hochgeladenen CSV-Datei verwendet haben. Konkretisieren Sie bei der Auswahl, ob die Datei Spaltennamen enthält und ob eine Zeichenkodierung erzwungen werden soll. Verwenden Sie dazu einen der aufgeführten Kodierungstypen. Im rechten Feld wird Ihnen die zugehörige Codepage angezeigt, welches lediglich als Kontrollfeld dient.
131
132 Klicken Sie auf //Weiter >//,// //um mit der Zuordnung (Mapping) fortzufahren. // //
133
134 [[Datei importieren>>image:66_CSV-Datei importieren_Datei importieren_761.png]]
135
136 == Mapping ==
137
138 Nachdem Sie eine CSV-Datei im Dateibrowser ausgewählt haben, wird diese eingelesen und im Wizard dargestellt. In diesem Beispiel werden manuelle Clients importiert.
139
140 In den obersten Zeilen werden die Spaltenüberschriften aus der CSV-Datei angezeigt. Wählen Sie für die Anzeige der manuellen Clients für jede Spalte das Feld in ACMP aus, welches Sie der jeweiligen Spalte zuordnen wollen. Beachten Sie dafür die jeweiligen Besonderheiten für die [[einzelnen Importe>>doc:||anchor="HAnwendungsbereiche"]], damit der Import erfolgreich durchlaufen kann.
141
142 Falls Sie in der Vergangenheit bereits Zuordnungen erstellt und gespeichert haben, können Sie diese hier verwenden. Diese Möglichkeit bietet ein schnelleres Zurückgreifen auf zuvor erstellte Zuordnungen, die Sie als Vorlage erneut verwenden möchten und gesichert haben. Nutzen Sie dafür die Funktionen //Mapping laden// ([[image:1731313703025-142.png]]), //speichern// ([[image:1731313703026-981.png]]) oder //zurücksetzen //([[image:1731313703026-197.png]]). Die Zuordnungen verwenden das .lmp-Format.
143
144 Sobald Sie mit der Zuordnung fertig sind, klicken Sie auf //Weiter >//.
145
146 [[Zuordnungsdatei>>image:66_ClientManagement_ManuelleClients_Zuordnung_747.png]]
147
148 Auf der letzten Seite des Wizards sehen Sie den Fortschritt und die Ergebnisse des Imports. Dort werden die Einträge gelistet, die insgesamt verarbeitet, erfolgreich importiert oder übersprungen wurden. Die entsprechende Log-Datei können Sie sich bei Bedarf speichern. Klicken Sie nun auf //Fertig//, um den Import der CSV-Datei abzuschließen.
149
150 [[Fortschritt des Imports>>image:66_CSV-Datei importieren_Import einer CSV-Datei Asset Management_766.png]]
151
152
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community