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

このガイドの使用方法

This chapter of the Assets guide will walk you through creating an import structure in Assets. To get the best results from this chapter, you should have completed the previous chapters:

• Building an object schema for IT Asset Management (ITAM)

• IT 資産管理 (ITAM) の属性を作成する

• IT 資産管理 (ITAM) 用のオブジェクト スキーマを設定する

Each step in this guide will include detailed instructions about how to use Assets in Jira Service Management, and also some tips and best practices about how to get the most out of this powerful feature when using it as part of your team’s IT Asset Management (ITAM) process.

このガイドには次の 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.

Importing is a way to bring outside data into Assets and convert it into Assets object types, objects, attributes and references.

Importing is the preferred way to bring data into Assets because it’s quicker, easier, and more dynamic than creating data using the interface.

To import data into Assets, we need the following three things:

• Data is raw information that we will pull into Assets. This data can be in the form of a CSV or JSON file, or it could be directly from a third-party app or provider.

• Structure is the object types, attributes, and references in Assets that provide a framework for our data. Depending on how we want to manage our import, we may want to use a structure that we’ve already manually created, or we might want to let Assets create the object types and attributes entirely by itself.

• マッピング: データ ソースの特定の情報を構造内の特定のオブジェクトまたは値とリンクすることで、データと構造を結びつける手段です。さらに、マッピングを行うことでこのデータが正しい場所に収まり、この情報が正規化されて正確になります。

There are three levels of mapping in Assets – import mapping, object type mapping, and attribute type mapping.

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

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

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

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

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. インポート構造は拡張可能です。オブジェクト構造は、データが変更された場合だけでなく、スキーマが変更された場合でも修正できるように設計されています。[属性マッピング] 画面の [AQL] フィールドを使用してインポートする場合は、本格的なオブジェクトを作成することをお勧めします。

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.

There are different kinds of import structures, correlating to the different sources of data that Assets can accept. Currently, there are four main types of import structure:

• CSV

• JSON

• Assets Discovery

• 外部インポート

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

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

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

Before we can start importing data into Assets, we will need a data source. A data source could be a static data file, such as an uploaded CSV or JSON, or it could be hosted on the web.

For this tutorial we will use two separate data sources - model and assets. The model will hold information about all of the possible IT Assets that we might encounter, while the assets will list only those inventory items that are currently in the system. By separating between the model and the assets, we will be able to import the model from one location - such as a vendor list, and sync it with our current inventory of assets..

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

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

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

Make sure to save each CSV files in the UTF-8 format. Although Assets can accept data in a multitude of formats, UFT-8 is the most commonly used format for CSV files.

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

このデータを別のテキスト ファイルにコピーして、assets.csv という名前を付けます。

Now that we have two sets of CSV data, we will create an import structure for each of them. Each import structure will contain the details about how to convert the data into objects and attributes in Assets.

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

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

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

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

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

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

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

If you choose to automatically create object types and attributes, Assets will create a default structure and configuration based on the type of import you have selected and the structure of the data you are importing. For example, when automatically mapping data from a CSV file, Assets will create a new object type with the name of the CSV file, a new object for each row in the file, and create attributes for each object based on the values in the header row of the CSV.

If there is already an object type in your object schema with the same name as the CSV file you are importing, Assets will not create a new object type, but will overwrite the your existing objects and their attributes with the same objects from your data source.

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.

お疲れ様でした!

ここでは、インポートとインポート構造の仕組みを学び、モデルになるデータ用、資産になるデータ用の 2 つのインポート構造を作成しました。

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