- Angelegt von //SEIBERT/MEDIA Mitarbeiter, zuletzt geändert am Nov 06, 2024
Jira Service Management Cloud Dokumentation
Erstellen einer Importstruktur für IT Asset Management (ITAM)
Assets in Jira Service Management sind eine Funktion, die nur für Premium und Enterprise verfügbar ist. Hier erfährst du mehr über Assets.
Wie du diesen Guide verwendest
In diesem Kapitel des Assets Guide erfährst du, wie du eine Importstruktur in Assets erstellst. Um dieses Kapitel optimal nutzen zu können, solltest du die vorherigen Kapitel abgeschlossen haben:
- Aufbau eines Objektschemas für IT Assets Management (ITAM)
- Erstellen von Attributen für IT Asset Management (ITAM)
- Konfigurieren eines Objektschemas für IT Asset Management (ITAM)
Jeder Schritt enthält detaillierte Anweisungen zur Verwendung von Assets in Jira Service Management sowie einige Tipps und bewährte Vorgehensweisen, wie du das Beste aus dieser leistungsstarken Funktion herausholen kannst, wenn du sie als Teil des IT Asset Management (ITAM)-Prozesses deines Teams einsetzt.
In diesem Guide gibt es zwei Arten von Informationen:
- Die Überschriften mit dem blauen Hintergrund helfen dir, in Assets einzusteigen. Sie informieren dich über die einzelnen Schritte des Guides, einschließlich der Datenbeispiele und wie die einzelnen Funktionen verwendet werden können.
- Der Text mit weißem Hintergrund gibt dir eine Reihe von Schritten an die Hand, mit denen du dich in Assets zurechtfindest, oder er enthält detaillierte Informationen zu einem Assets-Konzept.
Und einige Hinweise zum Text:
- Fett gedruckte Informationen sind Text, den du in Assets selbst findest, z. B. der Name einer Menüoption, eine Funktion, die du ein- und ausschalten kannst, oder eine Schaltfläche.
- Informationen in Code ist Text, der Teil unseres Beispielobjektschemas für IT Asset Management (ITAM) ist.
- Fett und kursiv gedruckte Informationen sind ein Konzept oder eine Idee, die ein wichtiger Bestandteil von Assets ist.
Importe verstehen
Mit dem Import kannst du Daten von außen in Assets importieren und sie in Objekttypen, Objekte, Attribute und Referenzen von Assets umwandeln.
Der Import ist die bevorzugte Methode, um Daten in Assets zu importieren, weil er schneller, einfacher und dynamischer ist als das Erstellen von Daten über die Schnittstelle.
Um Daten in Assets zu importieren, brauchen wir die folgenden drei Dinge:
- Daten sind Rohdaten, die wir in Assets einbinden wollen. Diese Daten können in Form einer CSV- oder JSON-Datei vorliegen oder direkt von einer Drittanbieter-App oder einem Anbieter stammen.
- Struktur sind die Objekttypen, Attribute und Referenzen in Assets, die einen Rahmen für unsere Daten bilden. Je nachdem, wie wir unseren Import verwalten wollen, können wir eine Struktur verwenden, die wir bereits manuell erstellt haben, oder wir lassen Assets die Objekttypen und Attribute ganz von selbst erstellen.
- Die Zuordnung ist eine Möglichkeit, unsere Daten und unsere Struktur miteinander zu verbinden, indem wir bestimmte Informationen in unserer Datenquelle mit bestimmten Objekten oder Werten in unserer Struktur verknüpfen. Die Zuordnung stellt auch sicher, dass diese Daten an der richtigen Stelle stehen und dass die Informationen normalisiert und korrekt sind.
In Assets gibt es drei Zuordnungsebenen - Importzuordnung, Objekttypzuordnung und Attributtypzuordnung.
Jede Ebene ist in die andere verschachtelt - die Importzuordnung ist also eine Gruppe von Objektzuordnungen, und jede dieser Objektzuordnungen kann mehr als eine Attributzuordnung enthalten.
- Die Import-Zuordnung enthält allgemeine Informationen darüber, wie die Rohdaten konfiguriert sind, z. B. wie sie kodiert sind und wie sie in Objekte und Objekttypen zerlegt werden können.
- Die Objekttyp-Zuordnung enthält genauere Informationen darüber, wie Objekte und Objekttypen aus dem Zuordnung erstellt werden können.
- Die Attributtyp-Zuordnung enthält genauere Angaben darüber, wie die Rohdaten in Attribute für die neuen Objekte umgewandelt werden.
Schauen wir uns an, wie das alles mit IT Asset Management (ITAM) funktioniert.
In den vorangegangenen Abschnitten dieses Guides haben wir ein Objektschema und Attribute erstellt, um unsere Informationen zu speichern. Das wird unsere Struktur sein. Jetzt bringen wir unsere Daten in Assets ein und ordnen sie zu, um Objekte und Attribute zu erstellen.
Wir beziehen unsere Daten aus zwei verschiedenen Datenquellen - einer Modelldatenquelle und einer Asset-Datenquelle. Beide Datenquellen liegen im CSV-Format vor.
Verständnis der Informationsarchitektur beim Importieren
Eines der wichtigsten Konzepte in Assets ist die Informationsarchitektur, d.h. das Verständnis und die Entwicklung der besten Möglichkeiten, deine Daten zu organisieren. In Assets ist die Informationsarchitektur die Art und Weise, wie du Objekttypen und Attribute zur Aufnahme deiner Daten erstellst.
Dieselben allgemeinen Regeln, die du bereits bei der Erstellung deiner Objekttypen gesehen hast, gelten auch für die Erstellung von Importstrukturen. Sehen wir sie uns an:
- Deine Importstruktur hat die richtige Größe. Deine Importstruktur passt zu den Daten, die du importieren willst. Du hast eine Objekttypenzuordnung für jedes Objekt, das du erstellen willst, und eine Attributtypenzuordnung für jedes Attribut innerhalb dieses Objekts.
- Deine Importstruktur ist einzigartig. Deine Importstruktur kopiert keine Zuordnungen, die in einer anderen Importstruktur vorkommen. Wenn du mehrere verschiedene Objekttypen aus einem einzigen Satz potenzieller Objekte erstellen willst, solltest du versuchen, sie alle auf einmal mit Hilfe der Zuordnung für Unterobjekte zu erstellen.
- Deine Importstruktur ist erweiterbar. Deine Objektstruktur ist so konzipiert, dass sie geändert werden kann, wenn sich die Daten oder sogar das Schema ändern! Wir empfehlen, beim Import vollwertige Objekte zu erstellen, indem du das AQL-Feld im Fenster für die Attributzuordnung verwendest.
Wenn wir unsere Daten einbringen, wollen wir sicherstellen, dass wir die Daten des Modells und die Daten der Vermögenswerte getrennt einbringen und sie als eindeutig behandeln. Hierfür gibt es mehrere Gründe:
- Wir verbinden jede Datenquelle mit einem anderen Ort in unserem Objektschema. Die vorhandenen Bestände füllen unseren Objekttyp Hardware Assets und seine Unterobjekte, während unser Modell der potenziellen IT-Bestände unseren Objekttyp Modell und seine Unterobjekte füllt. Da jeder Datensatz ein anderes Ziel hat, werden wir für jeden eine eigene Zuordnung verwenden.
- Außerdem wollen wir jeden Datensatz separat verarbeiten. Unsere Modell-Daten können direkt importiert werden, aber die Daten der Hardware Assets wollen wir normalisieren, indem wir sie mit den Ergebnissen unserer vorherigen Importe vergleichen. Auf diese Weise können wir prüfen, ob Vermögenswerte fehlen, ob es zusätzliche Vermögenswerte gibt, die wir nicht erwartet haben, oder ob es Anomalien zwischen dem erwarteten und dem tatsächlichen Lagerbestand gibt.
- Schließlich werden unsere Modell- und Asset-Datensätze nicht unbedingt zur gleichen Zeit aktualisiert. Wenn wir sie getrennt halten, können wir sicherstellen, dass unsere Assets aktuell sind, während unser Modell weniger wichtig ist.
Verstehen der Importstrukturen
Eine Importstruktur ist eine Anleitung, die Assets sagt, wie ein Import durchgeführt werden soll. Dieses Konzept enthält alle oben genannten Details - wo Assets die Daten finden kann, wo Assets die Struktur für die Daten aufbaut und wie Assets die Daten in kleine Teile zerlegt und diese mithilfe der Zuordnung an die richtige Stelle setzt.
Assets ist in der Lage, mehrere Importe unterschiedlicher Art zu verwalten und durchzuführen und Informationen aus verschiedenen Quellen (oder aus derselben Quelle!) zu überlagern, um eine einzige, genaue und aktuelle Informationsquelle zu schaffen.
Es gibt verschiedene Arten von Importstrukturen, die mit den verschiedenen Datenquellen korrespondieren, die Assets akzeptieren kann. Derzeit gibt es vier Haupttypen von Importstrukturen:
- CSV
- JSON
- Discovery Import
- Externe Importe
Du kannst auch die REST API nutzen, um Daten aus externen Quellen zu importieren. Mehr über den Import erfährst du im Imports REST API Guide in der Developer Dokumentation. (Englisch)
CSV-Daten formatieren
Wir müssen uns heute keine Gedanken über die Formatierung unserer Daten machen, weil wir die mitgelieferten Beispieldaten verwenden, aber unter anderen Umständen kann dies sehr wichtig sein. Wenn du einen Syntaxfehler in deiner CSV- oder JSON-Datei hast, kann es sein, dass dein Import unerwartete Ergebnisse liefert oder nicht funktioniert.
Hier findest du einige Informationen über die Datenformatierung von CSV-Dateien, die du in Zukunft vielleicht wissen solltest.
- Du kannst jedes der folgenden Formate verwenden: UTF-8 (Standard), UTF-16, ISO-8859-1, ISO-8859-15, Windows-1250, Windows 1252.
- Die CSV-Datei muss eine Kopfzeile haben, da sie verwendet wird, um die Datenlokatoren für die Importe zu erstellen.
- Die CSV-Datei muss ein einstelliges Trennzeichen enthalten. Das Standardtrennzeichen ist natürlich das Komma. Du kannst ein benutzerdefiniertes Trennzeichen im Feld Trennzeichen auswählen, wenn du eine Importkonfiguration erstellst. Wenn du ein Begrenzungszeichen einfügen möchtest, musst du den Wert in Anführungszeichen setzen. Wenn du ein Begrenzungszeichen oder ein Anführungszeichen einfügen möchtest, setze jeden Wert zwischen Anführungszeichen. Du kannst auch "\t" eingeben, um ein Tab-Trennzeichen zu verwenden.
- Um mehrere Werte zu trennen (für die Assets-Attribute mit mehreren Kardinalitäten), kannst du "||" (2 Pipe-Zeichen) innerhalb der CSV-Datei verwenden.
Wenn du mehrere Werte zu einem Asset-Attribut zusammenfassen möchtest, kannst du in der CSV-Datei einen Konkatenator verwenden. Die Vorgabe ist ein Bindestrich "-". Wenn die Daten mit einem Leerzeichen verkettet werden, kannst du bei der Erstellung einer Importkonfiguration "\s" in das Feld Verkettung eingeben.
Wenn du Objekte aus einer CSV-Datei in Assets importierst, musst du die Objekte anhand des Attributs identifizieren, das als Stichwörter zugewiesen ist, nicht anhand ihres Namens oder Schlüssels.
Wenn du Jira-Benutzer oder -Gruppen in Assets importierst, musst du die Benutzer oder Gruppen anhand ihrer IDs identifizieren, nicht anhand ihrer Namen.
Wenn du URLs in Assets importierst, müssen sie mit http:// oder https:// beginnen, damit sie in den Attributtyp URL umgewandelt werden können. Wenn das Präfix http:// oder https:// nicht enthalten ist, werden sie als Attributtyp String importiert. Hier erfährst du mehr über Attributtypen.
Wenn du CSV-Daten aus einem Google Spreadsheet-Link importierst, muss die verwendete URL bearbeitet werden, damit sie richtig funktioniert. Entferne /edit#gid=0 aus der Endung der URL und ersetze sie durch /export?format=csv.
Datensätze erstellen
Bevor wir mit dem Import von Daten in Assets beginnen können, brauchen wir eine Datenquelle. Eine Datenquelle kann eine statische Datei sein, z. B. eine hochgeladene CSV- oder JSON-Datei, oder sie kann im Internet gehostet werden.
In diesem Lernprogramm werden wir zwei verschiedene Datenquellen verwenden - das Modell und die Assets. Das Modell enthält Informationen über alle möglichen IT-Assets, die uns begegnen könnten, während die Assets nur die Inventarobjekte auflisten, die sich derzeit im System befinden. Durch die Trennung von Modell und Vermögenswerten können wir das Modell von einem Ort importieren - z. B. von einer Lieferantenliste - und es mit unserem aktuellen Bestand an Vermögenswerten synchronisieren.
Hier sind einige Beispiel-CSV-Daten für unser Modell, die Informationen wie Modelle und technische Spezifikationen enthalten. Unser Modell umfasst derzeit 40 Objekte - 10 verschiedene Laptopmodelle, 10 verschiedene Telefonmodelle, 10 verschiedene Servermodelle und 10 verschiedene Druckermodelle.
Jedes Modell enthält Angaben zur Kategorie, zum Modell, zum Stückpreis und zur Beschreibung. Diese Details in der Datei werden auf die entsprechenden Attribute im Objekttyp Modelle abgebildet.
Kopieren wir diese Daten in eine Textdatei und geben ihr den Namen models.csv, da sie unser aktuelles Modell der möglichen Laptops beschreibt.
Achte darauf, dass du jede CSV-Datei im UTF-8-Format speicherst. Obwohl Assets Daten in einer Vielzahl von Formaten akzeptieren kann, ist UFT-8 das am häufigsten verwendete Format für CSV-Dateien.
Model Name,Category,Unit Price,Description iPhone 12,Phone,999,Apple iPhone 12 64GB iPhone 11,Phone,799,Apple iPhone 11 64GB Galaxy S21,Phone,999,Samsung Galaxy S21 128GB Galaxy S20,Phone,899,Samsung Galaxy S20 128GB Dell XPS 15,Laptop,2000,Dell XPS 15 9500 15.6" Laptop HP Spectre x360,Laptop,1500,HP Spectre x360 13.3" Laptop Lenovo ThinkPad X1 Carbon,Laptop,1900,Lenovo ThinkPad X1 Carbon 14" Laptop MacBook Pro 16,Laptop,2400,Apple MacBook Pro 16" Laptop Dell PowerEdge R640,Server,5000,Dell PowerEdge R640 1U Rack Server HP ProLiant DL380,Server,5500,HP ProLiant DL380 Gen10 2U Rack Server Lenovo ThinkSystem SR630,Server,6000,Lenovo ThinkSystem SR630 1U Rack Server HP LaserJet Pro MFP M428fdw,Printer,350,HP LaserJet Pro MFP M428fdw Monochrome Laser Printer Canon imageCLASS MF743Cdw,Printer,500,Canon imageCLASS MF743Cdw Color Laser Printer Brother MFC-L2750DW,Printer,250,Brother MFC-L2750DW Monochrome Laser Printer Epson WorkForce Pro WF-4830,Printer,300,Epson WorkForce Pro WF-4830 All-in-One Printer
Nachdem wir nun unsere Modellinformationen haben, machen wir das Gleiche mit unseren Assets. Unsere Asset-Datei enthält Informationen zu dem IT-Asset, das wir haben, wie z. B. die Seriennummer, den Eigentümer, das Kaufdatum und den Status.
Kopieren wir diese Daten in eine separate Textdatei und geben ihr den Namen assets.csv.
Device Type,Serial Number,Model Name,Purchase Date,Owner Group,Status,Asset Tag,PO Number,Asset Status Phone,SN001,iPhone 12,01/01/2021,HR,Active,AT001,PO001,In Use Phone,SN002,iPhone 11,01/02/2020,Sales,Active,AT002,PO002,In Use Phone,SN003,Galaxy S21,03/01/2021,IT,Inactive,AT003,PO003,In Stock Phone,SN004,Galaxy S20,12/01/2019,Finance,Active,AT004,PO004,In Use Laptop,SN005,Dell XPS 15,06/01/2020,HR,Active,AT005,PO005,In Use Laptop,SN006,HP Spectre x360,07/01/2019,Sales,Inactive,AT006,PO006,Disposed Laptop,SN007,Lenovo ThinkPad X1 Carbon,08/01/2018,IT,Active,AT007,PO007,In Use Laptop,SN008,MacBook Pro 16,10/01/2020,Finance,Active,AT008,PO008,In Use Server,SN009,Dell PowerEdge R640,04/01/2018,IT,Active,AT009,PO009,In Use Server,SN010,HP ProLiant DL380,05/01/2019,IT,Inactive,AT010,PO010,In Stock Server,SN011,Lenovo ThinkSystem SR630,11/01/2020,IT,Active,AT011,PO011,In Use Printer,SN012,HP LaserJet Pro MFP M428fdw,02/01/2021,Sales,Active,AT012,PO012,In Use Printer,SN013,Canon imageCLASS MF743Cdw,05/01/2020,HR,Active,AT013,PO013,In Use Printer,SN014,Brother MFC-L2750DW,08/01/2019,Finance,Inactive,AT014,PO014,Disposed Printer,SN015,Epson WorkForce Pro WF-4830,03/01/2021,IT,Active,AT015,PO015,In Use
Erstellen von Importstrukturen
Da wir nun zwei CSV-Datensätze haben, erstellen wir für jeden von ihnen eine Importstruktur. Jede Importstruktur enthält die Details zur Umwandlung der Daten in Objekte und Attribute in Assets.
Um jede Importstruktur zu erstellen, werden wir durch einige Schritte geführt, um unsere Daten zu konfigurieren und die CSV-Dateien hochzuladen, die wir im letzten Abschnitt erstellt haben.
Nennen wir die erste Importstruktur models-import. Wir laden die Datei hoch, die wir im letzten Abschnitt erstellt haben und die wir models.csv nennen.
Die zweite Importstruktur nennen wir assets-import. Wir laden die Datei hoch, die wir im letzten Abschnitt erstellt haben und die wir assets.csv nennen.
Da wir bereits Objekttypen und Attribute für unsere Modelldaten erstellt haben, deaktivieren wir für beide Importstrukturen die Option Objekttypen und Attribute automatisch erstellen und erstellen die Objektzuordnung und die Attributzuordnungen von Grund auf neu.
Vorerst werden wir keine der Standardeinstellungen für Trennzeichen, Codierung, Verkettung, leere Werte, unbekannte Werte oder Datumsformate ändern.
Den folgenden Prozess müssen wir zweimal durchführen, einmal für den models-import und einmal für den assets-import.
Um eine Importstruktur zu erstellen:
- Gehe in deinem Serviceprojekt zu Assets > Objektschemata.
- Wähle ein Objektschema aus.
- Wähle Schemakonfiguration aus und dann den Tab Importieren.
- Unter dem Tab Importieren:
- Wenn es noch keine Importstruktur gibt, siehst du die Meldung Keine Importe gefunden. Klicke auf Import erstellen.
- Wenn bereits eine Importstruktur erstellt wurde, klicke auf Import erstellen, um eine neue Importstruktur hinzuzufügen.
- Wähle CSV-Import aus den angebotenen Optionen aus.
- Verwende das Fenster Importstruktur definieren, um deine Importstruktur zu konfigurieren. Wenn du einen externen Import erstellst, kannst du diesen Schritt überspringen.
- Name (erforderlich) → gib einen Namen für die Importkonfiguration ein.
- Beschreibung → gib eine Beschreibung für die Importkonfiguration ein.
- Drag & Drop einer Datei oder Durchsuchen (erforderlich) → Ziehe deine QuellDatei per Drag & Drop oder suche sie hier.
- Objekttypen und Attribute automatisch erstellen → Wenn du diese Option deaktivierst, musst du deine Daten vor dem Import manuell deinem Schema zuordnen. Hier erfährst du mehr über das manuelle Zuordnen deiner Daten.
- Weitere Optionen → Ändere hier die Standardwerte, um festzulegen, wie Assets mit Begrenzungszeichen, Kodierung, leeren oder unbekannten Werten, Verkettung und Datumsformaten umgehen soll.
- Trennzeichen (erforderlich) → Wähle das in der Datei verwendete Begrenzungszeichen. Ein Begrenzungszeichen ist das Zeichen, das angibt, wo ein Wert aufhört und der nächste beginnt. Es sind nur Begrenzungszeichen von einem Zeichen Länge erlaubt, mit Ausnahme des Zeichens "Tab", das mit "\t" gekennzeichnet ist. Um ein Begrenzungszeichen oder ein Anführungszeichen einzufügen, musst du jeden Wert zwischen Anführungszeichen setzen.
- Codierung (erforderlich) → Wähle die in der CSV-Datei verwendete Kodierung aus. Die Standardkodierung ist UFT-8.
- Verkettung (erforderlich) → Wenn du mehrere Werte zu einem Assets-Attribut zusammenfassen möchtest, kannst du ein Verkettungszeichen verwenden. Die Vorgabe ist das Bindestrichsymbol "-". Du kannst auch "\s" eingeben, wenn die Daten mit einem Leerzeichen verkettet werden sollen.
- Leere Werte → Wenn ein Objekt aktualisiert wird, wähle aus, ob leere Werte aus der externen Quelle den bestehenden Wert entfernen sollen. Wähle aus:
- Entfernen → entfernt den aktuellen Wert. Handelt es sich bei dem Attribut um ein Status-, Select- oder Referenztyp-Attribut mit mehr als einem Wert, werden alle Werte entfernt.
- Ignorieren → den aktuellen Wert für diesen Objekttyp beibehalten. Handelt es sich bei dem Attribut um ein Status-, Select- oder Referenztyp-Attribut mit mehr als einem Wert, werden alle Werte beibehalten.
- Unbekannte Werte (erforderlich) → wähle aus, ob du leere Werte ignorieren oder hinzufügen möchtest.
- Datumsformat → Wähle ein Format für die Umwandlung von Daten in Assets. Assets versucht automatisch, das richtige Format zu finden, wenn keines angegeben wird.
- Datums-/Uhrzeitformat → Das Datums-/Uhrzeitformat für die Umwandlung von Daten mit Uhrzeit in Assets. Wenn du kein Format angibst, versucht Assets automatisch, das richtige Format zu finden.
- Klicke auf Import erstellen.
- Der Tab Importierung sollte jetzt mit deiner neuen Importstruktur gefüllt sein.
Verstehen der automatischen oder manuellen Zuweisung
Wenn du eine neue Importstruktur erstellst, hast du die Möglichkeit, Objekttypen und Attribute manuell oder automatisch zu erstellen.
Wenn du dich für die automatische Erstellung von Objekttypen und Attributen entscheidest, erstellt Assets eine Standardstruktur und -konfiguration, die auf der von dir gewählten Importart und der Struktur der zu importierenden Daten basiert. Wenn du zum Beispiel Daten aus einer CSV-Datei automatisch zuordnest, erstellt Assets einen neuen Objekttyp mit dem Namen der CSV-Datei, ein neues Objekt für jede Zeile in der Datei und Attribute für jedes Objekt auf der Grundlage der Werte in der Kopfzeile der CSV-Datei.
Wenn in deinem Objektschema bereits ein Objekttyp mit demselben Namen wie die CSV-Datei, die du importierst, vorhanden ist, erstellt Assets keinen neuen Objekttyp, sondern überschreibt deine vorhandenen Objekte und deren Attribute mit denselben Objekten aus deiner Datenquelle.
Wenn du dich dafür entscheidest, einen Import manuell zu erstellen, werden in der Importstruktur nicht automatisch Objekttypen und Attribute erstellt und die Daten aus der Datei werden nicht automatisch dem Import zugeordnet. Deine Importstruktur ist dann "leer", und du musst deine Daten mit Hilfe der Import-, Objekt- und Attributzuordnung in Assets zuordnen, bevor du den Import starten kannst.
Gute Arbeit!
Wir haben jetzt erfahren, wie der Import und die Importstrukturen funktionieren, und wir haben zwei Importstrukturen erstellt - eine für die Daten, die zu den Modellen werden, und eine für die Daten, die zu den Assets werden.
Kommen wir nun zum nächsten Abschnitt des Guides: Zuordnen importierter Daten für IT Asset Management (ITAM)
Link zu dieser Seite: https://seibert.biz/dokujsmcloudimportstrukturfueritam