データから属性と参照を作成する
Assets is included with Service Collection Paid plans (Standard, Premium, and Enterprise). What Assets is and how it works.
データをアセットにインポートするには、まずインポート構造を作成して、オブジェクト タイプ マッピングによってデータをアセットにマッピングする必要があります。
次に、オブジェクト タイプ属性マッピングによって属性をデータからマップできます。さらに、オブジェクト スキーマ内に参照を作成する場合は、オブジェクト タイプ属性マッピングとプレースホルダーによってこれらの参照をアセットにマッピングできます。
はじめる前に
You must create an import structure.
For each type of object that you want to map in Assets, you must create an object type.
For each attribute or reference that you want to map in Assets, you must create an attribute.
オブジェクト タイプ属性マッピングを使用して、データから属性を作成する
参照マッピング パネルで AQL、連結子、正規表現、または Base64 の列を表示して変更できるアセットのバージョンを使用している場合は、次の手順を使用してください。
サービス プロジェクトから、次の手順を実行します。
From the app switcher, select Assets
From your sidebar, select Schemas.
オブジェクト スキーマを選択します。
Select Configure, then choose the Import tab.
In the Import tab, select on Edit mapping on your import structure to view the object type mappings.
[属性マッピングを編集] を選択して、属性タイプ マッピングを表示します。
Every object imported into Assets will require at least one piece of information - the data source field that lets Assets know where to find objects in the data source. Learn more about the data source field.
[データ ソース フィールド] を選択します。データ ソース フィールドは、データ ファイル内のオブジェクトの場所を指定するものです。属性マッピングは、マッピングされた各属性にデータ ソース フィールドを指定するまで無効になります。複数のデータ ソース フィールドを選択できます。
データ ソース フィールドにマッピングする移動先属性を選択します。
オプションで、この属性マッピングの初期設定を変更できます。
AQL - データから参照を作成するには、ここに AQL ステートメントを入力します。これは、選択した移動先属性がオブジェクトの場合にのみ可能です。
連結子 - ここに、この属性マッピングにのみ適用される代替連結子を入力します。
正規表現 - ここに、この属性マッピングにのみ適用される正規表現 (regex) を入力します。
Base 64 - ここに代替の Base 64 値を入力します。
識別子として属性の 1 つを選択します。識別子は各オブジェクトを一意に識別し、オブジェクトが作成されるときにそのオブジェクトの新しいラベルになります。インポートを実行するには、識別子を 1 つのみ含める必要があります。識別子は、データの更新時にも重要です。ターゲット スキーマに同じ識別子がある場合はオブジェクトが更新され、ターゲット スキーマに識別子が見つからない場合はオブジェクトが作成されます。
右側の [追加] をクリックします。
オブジェクト タイプ属性マッピングを使用して、データから属性を作成する
連結子、正規表現、Base64 の機能が [アクション] 列の [...] の中に隠れているバージョンのアセットを使用している場合は、次の手順を使用してください。
サービス プロジェクトから、次の手順を実行します。
From the app switcher, select Assets
From your sidebar, select Schemas.
オブジェクト スキーマを選択します。
Select Configure, then choose the Import tab.
In the Import tab, select on Edit mapping on your import structure to view the object type mappings.
[属性マッピングを編集] を選択して、属性タイプ マッピングを表示します。
Every object imported into Assets will require at least one piece of information - the data source field that lets Assets know where to find objects in the data source. Learn more about the data source field.
[データ ソース フィールド] を選択します。データ ソース フィールドは、データ ファイル内のオブジェクトの場所を指定します。属性マッピングは、マッピングされた各属性にデータ ソース フィールドを指定するまで無効になります。
データ ソース フィールドにマッピングする移動先属性を選択します。
オプションで、既存の属性マッピングの初期設定を変更できます。
[アクション] 列の [...] ボタンをクリックします。
[高度なマッピング オプション] を選択します。
連結子 - ここに、この属性マッピングにのみ適用される代替連結子を入力します。
正規表現 - ここに、この属性マッピングにのみ適用される正規表現 (regex) を入力します。
Base 64 - ここに代替の Base 64 値を入力します。
[確認] をクリックします。
識別子として属性の 1 つを選択します。識別子は各オブジェクトを一意に識別し、オブジェクトが作成されるときにそのオブジェクトの新しいラベルになります。インポートを実行するには、識別子を 1 つのみ含める必要があります。識別子は、データの更新時にも重要です。ターゲット スキーマに同じ識別子がある場合はオブジェクトが更新され、ターゲット スキーマに識別子が見つからない場合はオブジェクトが作成されます。
右側の [追加] をクリックします。
オブジェクト タイプ属性マッピングとプレースホルダーを使用して、データから参照を作成する
参照マッピング パネルで AQL の列を表示して変更できるアセットのバージョンを使用している場合は、次の手順を使用してください。
サービス プロジェクトから、次の手順を実行します。
From the app switcher, select Assets
From your sidebar, select Schemas.
オブジェクト スキーマを選択します。
Select Configure, then choose the Import tab.
In the Import tab, select on Edit mapping on your import structure to view the object type mappings.
[属性マッピングを編集] を選択して、属性タイプ マッピングを表示します。
Every object imported into Assets will require at least one piece of information - the data source field that lets Assets know how to differentiate objects in the data. Learn more about the data source field.
"データ ソース" フィールド を選択します。[データ ソース] フィールドは、インポート設定にあるデータの場所を指定します。
データ ソース フィールドにマッピングするアセット属性を選択します。
[オブジェクト マッピング (AQL (アセット クエリ言語))] 列によって、参照のラベルをデータ ロケーターのプレースホルダーにマッピングする AQL を入力します。これは、選択した移動先属性がオブジェクトの場合にのみ可能です。
データから参照を 1 つだけマッピングする場合は、
Label = ${Locator}と入力します。Locatorはロケーターの名前に置き換わります。データから複数の参照をマッピングする場合は、「
Label IN (${Locator${0}})」と入力します。「Locator」はロケーターの名前に置き換わります。右側の [追加] をクリックします。
オブジェクト タイプ属性マッピングとプレースホルダーを使用して、データから参照を作成する
参照マッピング パネルで [シンプル] モードと [詳細] モードのいずれかを選択できるアセットのバージョンを使用している場合は、次の手順を使用してください。
サービス プロジェクトから、次の手順を実行します。
From the app switcher, select Assets
From your sidebar, select Schemas.
オブジェクト スキーマを選択します。
Select Configure, then choose the Import tab.
In the Import tab, select on Edit mapping on your import structure to view the object type mappings.
[属性マッピングを編集] を選択して、属性タイプ マッピングを表示します。
Every object imported into Assets will require at least one piece of information - the data source field that lets Assets know how to differentiate objects in the data. Learn more about the data source field.
"データ ソース" フィールド を選択します。[データ ソース] フィールドは、インポート設定にあるデータの場所を指定します。
データ ソース フィールドにマッピングする移動先属性を選択します。この属性は、[移動先属性タイプ] 列の [オブジェクト] で示されるオブジェクト参照タイプである必要があります。
参照マッピング列を使用して、[シンプル] モードまたは [詳細] モードを選択します。
[シンプル] モード - 参照の属性をデータ ソース フィールドのプレースホルダーにマッピングする属性を選択します。
たとえば、[ファースト ネーム] 属性を選択すると、それがデータ ソース フィールドにマッピングされます。したがって、AQL (アセット クエリ言語) は
"First name" = ${Name}となり、Nameはデータ ソース フィールドに置き換えられます。
[詳細] モード - 参照の属性をデータ ソース フィールドのプレースホルダーにマッピングする AQL を入力します。この例では、参照の
Label属性をマッピングしています。データから参照を 1 つだけマッピングする場合は、「
Label = ${Locator}」と入力します。Locatorはデータ ソース フィールドの値に置き換わります。データから複数の参照をマッピングする場合は、「
Label IN (${Locator${0}})」と入力します。「Locator」はデータ ソース フィールドの値に置き換わります。右側の [追加] をクリックします。
データ ソースの 1 つのフィールドから複数の参照を作成する場合は、二重パイプ「||」(CSV または JSON 形式) またはカンマ「,」(JSON 形式のみ) によって複数の値を区切ります。
データをアセットにインポートする方法
アセットにデータをインポートするには、次の 5 つのステップに従います。
Create an import structure. There are four different types of import available:
データをマッピングします。次の 2 つのオプションがあります。
Map your data automatically by automatically creating object types and attributes, or;
次の方法でデータを手動でマッピングします。
Using object type mapping to create Assets object types
Using object type attribute mapping to create Assets attributes and references
Using child object type mapping to create hierarchical parent and child structures.
オブジェクト タイプ マッピングを作成したら、それらを有効にする必要があります。すべてのオブジェクト タイプ マッピングが [有効化] に設定されるまで、インポート構造は実行されません。オブジェクト タイプ マッピングが有効にされていない場合は、オブジェクト タイプ マッピングを右クリックして [有効化] をクリックして有効にします。
この内容はお役に立ちましたか?