• 使用を開始する
  • 関連ドキュメント

IT 資産管理 (ITAM) 用のインポート構造を作成する

Jira Service Management のアセットは、Premium と Enterprise のみの機能です。アセットの詳細についてはこちらをご確認ください。

このガイドの使用方法

アセット ガイドのこの章では、アセットにインポート構造を作成する方法について説明します。この章を十分に理解するには、以下の前の章を完了しておく必要があります。

このガイドの各ステップには、Jira Service Management のアセットを使用するための詳しい手順だけでなく、チームの IT 資産管理 (ITAM) プロセスの一環として使用する場合にこの強力な機能を最大限に活用するためのヒントやベスト プラクティスも記載されています。

このガイドには次の 2 種類の情報があります。

  • The headers with the blue background will help you get started in Assets. They will provide you with information about each step in the guide, including examples of data and how each feature can be used.

  • The text with the white background will give you a series of steps to help you navigate through Assets, or it will contain detailed information about an Assets concept.

他にも次のような情報があります。

  • Information in bold indicates text that you will find in Assets itself, such as the name of a menu option, a feature you can toggle on and off, or a button.

  • code の情報は、IT 資産管理 (ITAM) 用サンプル オブジェクト スキーマに含まれるテキストです。

  • Information in bold italics is a concept or idea that forms an important part of Assets.

インポートの概要

インポートとは、外部データをアセットに取り込んで、アセットオブジェクト タイプオブジェクト属性参照に変換する手段です。

インポートは、インターフェイスを使用してデータを作成するよりもスピーディかつ簡単で、動的であるため、データをアセットに取り込む方法として推奨されています。

アセットにデータをインポートするには次の 3 つが必要です。

  • データ: アセットに取り込む未加工の情報です。このデータは、CSV または JSON ファイルの形式でも、サードパーティのアプリやプロバイダーから直接入手したものでもかまいません。

  • 構造: データのフレームワークを提供するアセットのオブジェクト タイプ、属性、参照です。インポートの管理方法によっては、あらかじめ手動で作成した構造を使用した方が良い場合もあれば、オブジェクト タイプと属性の作成をアセット自体にすべて任せた方が良い場合もあります。

  • Mapping is a way of connecting our data and our structure by linking specific pieces of information in our data source with specific objects or values in our structure. Mapping also ensures this data fits in the correct place, and makes sure this information is normalized and accurate.

アセットには、インポート マッピング、オブジェクト タイプ マッピング、属性タイプ マッピングの 3 つのレベルのマッピングがあります。

それぞれが他のマッピングの中にネストされています。つまり、インポート マッピングはオブジェクト マッピングのグループであり、それらのオブジェクト マッピングにはそれぞれ複数の属性マッピングを含めることができます。

  • インポート マッピングには、エンコード方法やオブジェクトとオブジェクト タイプへの分割方法など、未加工データの設定方法に関する一般的な情報が含まれています。

  • オブジェクト タイプ マッピングには、マッピングからオブジェクトとオブジェクト タイプを作成する方法に関するより具体的な情報が含まれています。

  • 属性タイプ マッピングには、未加工データを新しいオブジェクトの属性に変換する方法の詳細が含まれています。

これらが IT 資産管理 (ITAM) でどのように機能するかを見てみましょう。

このガイドの前のセクションに従って、情報を格納するオブジェクト スキーマと属性を作成しました。これが今回の構造になります。次に、データアセットに取り込み、マッピングしてオブジェクトと属性を作成します。

データは、モデル データ ソースと資産データ ソースの 2 つの異なるデータ ソースから取得します。これらのデータ ソースはいずれも CSV 形式になります。

インポート時の情報アーキテクチャの概要

One of the key concepts in Assets is information architecture, which is understanding and developing the best ways to organise your data. In Assets, the information architecture is how you built object types and attributes to hold your data.

以前オブジェクト タイプを作成したときに見たのと同じ一般的なルールがインポート構造の作成にも適用されます。それらを確認していきましょう。

  1. インポート構造は適切なサイズになっています。インポート構造はインポートするデータが収まるサイズになっています。作成するオブジェクトごとに 1 つのオブジェクト タイプ マッピングがあり、そのオブジェクト内の属性ごとに 1 つの属性タイプ マッピングがあります。

  2. インポート構造は一意です。あるインポート構造が別のインポート構造にあるマッピングと同じになることはありません。1 つのオブジェクト候補のセットから複数の異なるオブジェクト タイプを作成する場合は、子オブジェクト マッピングを使用してすべてを一度に作成するようにしてください。

  3. Your import structure is extensible. Your object structure is designed in such a way that it can be modified if the data changes, or even if the schema changes! We recommend creating full-fledged objects when importing using the AQL field in the Attribute mapping screen.

データを取り込む際には、モデルと資産のデータを別々に取り込み、それぞれ一意のものとして扱います。これには次のようにいくつかの理由があります。

  1. We are connecting each data source into a different location in our object schema. The assets of existing stock will populate our Hardware assets object type and it’s children, while our model of potential IT assets will populate our Model object type and it’s children. Because each data set has a different destination, we will use a unique mapping for each.

  2. We also want to process each data set separately. Our Model data can be imported directly, but our Hardware assets data we want to normalise by comparing to the results of our previous imports. We want to do this so we can check for missing assets, extra assets we weren’t expecting, or any anomalies between the expected and actual stock levels.

  3. 最後になりますが、モデルとアセットのデータ セットは必ずしも同時に更新されるわけではありません。これらを分けておくことで、資産を最新の状態に保ちながら、モデルの重要性を低くすることができます。

インポート構造の概要

An import structure is a recipe that tells Assets how to run an import. This recipe include all of the details above - where Assets can find the data, where Assets will build the structure for the data, and how Assets can break down the data into little pieces and use the mapping to put those pieces in the correct place.

Assets has the ability to manage and run multiple imports of different kinds, and overlay information from different sources (or from the same source!) to create an accurate and up-to-date single source of truth.

アセットで使用できるさまざまなデータ ソースに関連して、さまざまな種類のインポート構造があります。現在、インポート構造には主に次の 4 種類があります。

  • CSV

  • JSON

  • Assets Discovery

  • 外部インポート

また、REST API フレームワークを使用して、外部ソースからデータをインポートすることもできます。REST API を使用したインポートの詳細については、開発者向けドキュメント セクションの「Imports REST API」ガイドをご覧ください。

CSV データのフォーマット

あらかじめ用意されているサンプル データを使用するため、今回はデータのフォーマットについて心配する必要はありませんが、それ以外の状況では極めて非常になる場合があります。CSV または JSON データ ファイルに構文エラーがある場合、インポートによって予期しない結果になったり、実行されなかったりする可能性があります。

ここからは、CSV のデータ フォーマットについて、今後知っておくべき情報をいくつか紹介します。

  • UTF-8 (初期設定)、UTF-16、ISO-8859-1、ISO-8859-15、Windows-1250、Windows 1252 のいずれかの形式を使用できます。

  • CSV ファイルには、インポート用のデータ ロケーターの作成に使用されるヘッダーが必要です。

  • CSV ファイルには、1 文字の区切り文字を含める必要があります。通常、既定の区切り文字はカンマです。インポート設定を作成する際に、"区切り文字)" フィールドでカスタムの区切り文字を選択できます。区切り文字を含めるには、値を二重引用符で囲みます。区切り文字または二重引用符を含めるには、それぞれの値を二重引用符で囲みます。「\t」と入力すると、タブ区切り文字を使用できます。

  • 複数の値を除算するには (複数のカーディナリティを持つアセット属性の場合)、CSV ファイル内で「||」(2 つのパイプ文字) を使用します。

  • 複数の値を 1 つのアセット属性に結合する場合は、CSV ファイルで連結子を使用できます。既定ではダッシュ記号「-」が使用されます。データがスペースで連結されている場合は、インポート設定を作成するときに [連結] フィールドに「\s」を入力できます。

  • If you are importing objects from a CSV file into Assets, you must identify the objects by the attribute that is assigned as a Label, not their Name or Key.

  • If you are importing Jira users or groups into Assets, you must identify the users or groups by their IDs, not their Name(s).

  • If you are importing URLs into Assets they must begin with with http:// or https:// to be converted into the URL attribute type. If the http:// or https:// prefix is not included, they will be imported as the String attribute type. Learn more about attribute types.

  • Google スプレッド シートのリンクから CSV データをインポートする場合に、使用する URL を正しく機能させるには編集が必要です。URL の末尾から /edit#gid=0 を削除して、/export?format=csv に置き換えます。

データ セットの作成

アセットへのデータのインポートを始める前に、データ ソースを用意する必要があります。データ ソースは、アップロードされた CSV や JSON などの静的データ ファイルでも、Web 上でホストされているものでも構いません。

このチュートリアルでは、モデル資産という 2 つの独立したデータ ソースを使用します。モデルには、発生する可能性のあるすべての IT アセットに関する情報が格納され、資産には、現在システム内にあるインベントリ アイテムのみが一覧表示されます。モデルと資産に分けることで、ベンダー リストなど 1 か所からモデルをインポートし、現在の資産インベントリと同期できるようになります。

モデルや技術仕様などのモデル一覧情報のサンプル CSV データを次に示します。このモデルには現在 40 個のオブジェクト (10 種類のラップトップ モデル、10 種類の電話モデル、10 種類のサーバー モデル、10 種類のプリンター モデル) があります。

各モデルには、カテゴリモデル単価説明を指定する詳細が含まれています。データ ファイル内のこれらの詳細は、モデル オブジェクト タイプの適切な属性にマップされます。

このデータをテキスト ファイルにコピーして models.csv というファイル名を付けます。このデータは、入手可能なノート パソコンの現行モデルを表しています。

各 CSV ファイルは必ず UTF-8 形式で保存してください。アセットはさまざまな形式のデータを受け入れることができますが、UFT-8 は CSV ファイルで最も一般的に使用されている形式です。

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

モデル情報が定義できたら、資産についても同じ作業をしましょう。資産のデータ ファイルには、シリアル番号、所有者、購入日、ステータスなど、手元にある実際の IT 資産に固有の情報が含まれます。

このデータを別のテキスト ファイルにコピーして、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

インポート構造の作成

CSV データが 2 セットできたら、それぞれのインポート構造を作成します。各インポート構造には、データをアセットのオブジェクトと属性に変換する方法の詳細が含まれます。

それぞれのインポート構造を作成するため、データを設定し、前のセクションで作成した CSV ファイルをアップロードする手順を説明します。

最初のインポート構造に models-import という名前を付けます。前のセクションで作成した models.csv ファイルをアップロードします。

2 つ目のインポート構造に assets-import という名前を付けます。前のセクションで作成した assets.csv ファイルをアップロードします。

モデル データのオブジェクト タイプと属性はすでに作成しているので、両インポート構造の [オブジェクト タイプと属性を自動で作成] を無効にして、オブジェクト マッピングと属性マッピングをイチから手動で作成します。

現時点では、区切り文字、エンコード、連結子空の値、不明な値、または日付形式の既定の設定は変更しません。

以下のプロセスは、model-import に対して 1 回、assets-import に対して 1 回の計 2 回行う必要があります。

インポート構造を作成するには、サービス プロジェクトから次の手順を実行します。

  1. [アセット] に移動してから [オブジェクト スキーマ] に移動します

  2. オブジェクト スキーマを選択します。

  3. [スキーマ設定] を選択して、次に [インポート] タブを選択します。

  4. [インポート] タブで、次の手順に従います。

    1. インポート構造がない場合は、メッセージ「インポート構造が作成されていません」が表示されます。[最初に作成] をクリックします。

    2. インポート構造がすでに作成されている場合は、[インポートを作成] をクリックして新しいインポート構造を追加します。

  5. 表示されたオプションから [CSV インポート] を選択します。

  6. 次に、[インポート構造を定義] 画面でインポート構造を設定します。外部インポートを作成する場合は 、このステップをスキップできます。

    1. Name (required) (名前 (必須)): インポート設定の名前を入力します。

    2. 説明: インポート設定の説明を入力します。

    3. ファイルをドラッグ & ドロップするか参照する (必須) - ここにソース データ ファイルをドラッグ & ドロップするか参照します。

    4. オブジェクト タイプと属性を自動で作成する - このオプションを無効にするには、データのインポート前にデータをスキーマに手動でマッピングする必要があります。データの手動マッピングについて詳しくはこちらをご確認ください。

    5. その他のオプション - アセットが区切り文字、エンコード、空または未知の値、連結、日付形式を処理する方法を変更するには、ここで既定値を変更します。

      1. 区切り文字 (必須) - ファイルで使用する区切り文字を選択します。区切り文字は、ある値の終わりと次の値の始まりの場所を示す文字です。「\ t」で示される「タブ」文字を除いて、1 文字の長さの区切り文字のみが許可されます。区切り文字または二重引用符を含めるには、それぞれの値を二重引用符で囲みます。

      2. Encoding (required) (エンコーディング (必須)): CSV ファイルで使用するエンコーディングを選択します。デフォルトのエンコーディングは UFT-8 です。

      3. 連結子 (必須) - 複数の値を 1 つのアセット属性に結合する場合は、連結子を使用できます。既定ではダッシュ記号「-」が使用されます。データがスペースで連結されている場合は「\s」を入力できます。

      4. 空の値 - オブジェクトが更新される際に、外部ソースからの空の値で既存の値を削除するかどうかを選択します。次の項目から選択します。

        1. 削除 - 現在の値を削除します。属性がステータス、選択、または複数の値を持つ参照タイプ属性である場合、すべての値が削除されます。

        2. 無視 - 該当するオブジェクト タイプに対して現在の値を保持します。属性がステータス、選択、または複数の値を持つ参照タイプ属性である場合、すべての値が保持されます。

      5. Unknown values (required) (不明な値 (必須)): 空の値を無視するか追加するかを選択します。

      6. 日付形式 - 日付を変換する形式を選択します。何も指定されていない場合は、アセットが正しい形式を自動で検索します。

      7. 日時の形式 - 日時を変換する日時形式。何も指定されていない場合は、アセットが正しい形式を自動で検索します。

  7. [作成] を選択します。

  8. これで、[インポート] タブに新しいインポート構造が入力されます。

自動マッピングと手動マッピングの概要

新しいインポート構造を作成する際は、オブジェクト タイプと属性を手動または自動で作成するオプションがあります。

オブジェクト タイプと属性を自動で作成することを選択した場合、アセットは、選択したインポートのタイプとインポートするデータの構造に基づいて既定の構造と構成を作成します。たとえば、CSV ファイルのデータを自動的にマッピングする場合、アセットは CSV ファイルの名前で新しいオブジェクト タイプを作成し、ファイルの各行に対して新しいオブジェクトを作成し、CSV のヘッダー行の値に基づいて各オブジェクトの属性を作成します。

インポートする CSV ファイルと同じ名前のオブジェクト タイプがオブジェクト スキーマにすでにある場合、アセットは新しいオブジェクト タイプを作成せず、既存のオブジェクトとその属性をデータ・ソースの同じオブジェクトで上書きします。

If you choose to create an import manually, the import structure will not automatically create object types and attributes, and it will not automatically map data from the data file into the import. Your import structure will be “empty”, and you will have to map your data into Assets using import mapping, object mapping, and attribute mapping before you can run the import.

 

お疲れ様でした!

We’ve now learned about how importing and import structures work, and we’ve created two import structures - one for the data that will become the models and one for the data that will become the assets.

次に、ガイドの次のセクション「IT 資産管理 (ITAM) 用のオブジェクトと属性をマッピングする」に進みましょう。

 

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。