---
title: 階層型 XML データのインポート
slug: neurons-for-itsm/admin-user-help/jpn/latest/pfHq-xml
createdAt: 2026-10-29T01:28:14.417Z
---

- [階層型XMLフォーマットについて](docId\:pfHqxd2iIY97ado2kc21q)
- [階層型 XML ノート](docId\:pfHqxd2iIY97ado2kc21q)
- [インポート ファイルの例 - インシデント (タスクを含む)、割り当て (ジャーナルを含む)、メモ](docId\:pfHqxd2iIY97ado2kc21q)
- [階層型 XML ファイルのインポートに関する注意事項](docId\:Vcbk7pY0Bkjlw9Zfyt_Or)
- [階層型 XML ファイルの例](docId\:OCrJHF5q2NGvoQrxMn1So)

## 階層型XMLフォーマットについて

サービス マネージャ 複数のビジネス オブジェクトを含む XML ファイルをインポートできます。 そのためには、ファイルは厳密な形式に従う必要があります (以下に概説)。 階層型インポート プロセスでは、この要件を満たすために現在のデータ形式を転記するための XSLT による前処理がサポートされています。

大きなファイル (50 MB 以上) の場合、最初のバッチが表示される前にファイル全体がダウンロードされるため、プレビューに時間がかかります。 その他のタイプでは、接続から **オブジェクト マッピング** ページに移動するときにコピー/ダウンロードが行われます。 階層型 XML では、すべてのマッピング ページをバイパスします。したがって、コピー/ダウンロードは、ユーザーがファイルをプレビューする場合にのみ発生します。

XML が従う必要がある 1.0 スキーマは次のとおりです。

\<xs\:schema xmlns\:xs="http\://www\.w3.org/2001/XMLSchema" version="1.0">

\<!-- decimal or empty string-->

\<xs\:simpleType name="decimal-or-empty">

    \<xs\:union memberTypes="xs\:decimal empty-string" />

\</xs\:simpleType>

\<xs\:simpleType name="empty-string">

    \<xs\:restriction base="xs\:string">

        \<xs\:enumeration value="" />

    \</xs\:restriction>

\</xs\:simpleType>

\<!-- Parent/Primary BusinessObject (BO) -->

\<xs\:element name="BusinessObject">

    \<xs\:complexType>

        \<xs\:all>

\<!-- Parent/Primary BO transaction action -->

            \<xs\:element name="Transaction" minOccurs="1" maxOccurs="1">

                \<xs\:simpleType>

                    \<xs\:restriction base="xs\:string">

\<!-- Insert only if it does not exist - will not update and error if it exists -->

                        \<xs\:enumeration value="Insert"/>

\<!-- Update only if it exists - will not insert and error if it does not exist -->

                        \<xs\:enumeration value="Update"/>

\<!-- Insert if it does not exist or Update if it exists -->

                        \<xs\:enumeration value="UpdateAdd"/>

\<!-- Delete if it exists or Ignore if it does not exist -->

                        \<xs\:enumeration value="Delete"/>

\<!-- Do nothing -->

                        \<xs\:enumeration value="None"/>

                    \</xs\:restriction>

               \</xs\:simpleType>

            \</xs\:element>

            \<xs\:element name="LinkTransaction" minOccurs="0" maxOccurs="1">

                \<xs\:simpleType>

                   \<xs\:restriction base="xs\:string">

\<!-- Link to parent/primary BO -->

                       \<xs\:enumeration value="Link"/>

\<!-- Unlink from parent/primary BO -->

                       \<xs\:enumeration value="Unlink"/>

\<!-- Do nothing -->

                                        \<xs\:enumeration value="None"/>

                    \</xs\:restriction>

                \</xs\:simpleType>

            \</xs\:element>

\<!-- List of composite keys that uniquely locate the onject in the target system -->

            \<xs\:element name="UniqueKeyList" minOccurs="1" maxOccurs="1">

                 \<xs\:complexType>

                     \<xs\:sequence>

\<!-- In schema version 1.0 only one unique key is supported -->

                        \<xs\:element name="UniqueKey" minOccurs="1" maxOccurs="1">

                 \<xs\:complexType>

                     \<xs\:sequence>

            \<xs\:element name="Field" minOccurs="1" maxOccurs="unbounded">

                 \<xs\:complexType>

\<xs\:attribute name="Name" type="xs\:string" use="required"/>

\</xs\:complexType>

\</xs\:element>

\</xs\:sequence>

\</xs\:complexType>

\</xs\:element>

\</xs\:sequence>

\</xs\:complexType>

\</xs\:element>

\<xs\:element name="FieldList" minOccurs="1" maxOccurs="1">

\<xs\:complexType>

\<xs\:sequence>

\<xs\:element name="Field" minOccurs="0" maxOccurs="unbounded">

\<xs\:complexType mixed="true">

\<xs\:all>

\<xs\:element name="LanguageValues" minOccurs="0" maxOccurs="1">

\<xs\:complexType mixed="true">

\<xs\:all>

\<xs\:element name="de" type="xs\:string" minOccurs="0" maxOccurs="1"/>

\<xs\:element name="fr" type="xs\:string" minOccurs="0" maxOccurs="1"/>

\<xs\:element name="es" type="xs\:string" minOccurs="0" maxOccurs="1"/>

\<xs\:element name="pt\_BR" type="xs\:string" minOccurs="0" maxOccurs="1"/>

\<xs\:element name="nl" type="xs\:string" minOccurs="0" maxOccurs="1"/>

\<xs\:element name="jp" type="xs\:string" minOccurs="0" maxOccurs="1"/>

\<xs\:element name="ru" type="xs\:string" minOccurs="0" maxOccurs="1"/>

\<xs\:element name="default" type="xs\:string" minOccurs="0" maxOccurs="1"/>

\</xs\:all>

\</xs\:complexType>

\</xs\:element>

\<xs\:element name="CurrencyValue" type="decimal-or-empty" minOccurs="0" maxOccurs="1"/>

\<xs\:element name="CurrencyCode" type="xs\:string" minOccurs="0" maxOccurs="1"/>

\</xs\:all>

\<xs\:attribute name="Name" type="xs\:string" use="required"/>

\<xs\:attribute name="Type" use="optional">

\<xs\:simpleType>

\<xs\:restriction base="xs\:string">

\<xs\:enumeration value="" />

\<xs\:enumeration value="System.String" />

\<xs\:enumeration value="System.Int32" />

\<xs\:enumeration value="System.Int64" />

\<xs\:enumeration value="System.Single" />

\<xs\:enumeration value="System.Double" />

\<xs\:enumeration value="System.Decimal" />

\<xs\:enumeration value="System.DateTime" />

\<xs\:enumeration value="System.Boolean" />

\<xs\:enumeration value="Currency" />

\</xs\:restriction>

\</xs\:simpleType>

\</xs\:attribute>

\</xs\:complexType>

\</xs\:element>

\</xs\:sequence>

\</xs\:complexType>

\</xs\:element>

\<!-- List of related BOs -->

\<xs\:element name="RelatedBusinessObjectList" minOccurs="0" maxOccurs="1">

\<xs\:complexType>

\<xs\:sequence>

\<!-- support a maximum of 100 related objects for each parent/primary BO-->

\<xs\:element name="RelatedBusinessObject" maxOccurs="100">

\<xs\:complexType>

\<xs\:sequence>

\<xs\:element ref="BusinessObject" minOccurs="0" maxOccurs="1"/>

\</xs\:sequence>

\<xs\:attribute name="Relationship" type="xs\:string" use="required"/>

\</xs\:complexType>

\</xs\:element>

\</xs\:sequence>

\</xs\:complexType>

\</xs\:element>

\</xs\:all>

\<xs\:attribute name="Name" type="xs\:string" use="required"/>

\</xs\:complexType>

\</xs\:element>

\<!-- Hierarchical Business Objects -->

    \<xs\:element name="BusinessObjectList">

        \<xs\:complexType>

            \<xs\:sequence>

                \<xs\:element ref="BusinessObject" maxOccurs="unbounded"/>

            \</xs\:sequence>

            \<xs\:attribute name="SchemaVersion" use="required">

                \<xs\:simpleType>

                    \<xs\:restriction base="xs\:string">

\<!-- schema versions -->

                        \<xs\:enumeration value="1.0"/>

                    \</xs\:restriction>

                \</xs\:simpleType>

            \</xs\:attribute>

        \</xs\:complexType>

    \</xs\:element>

\</xs\:schema>

## 階層型 XML ノート

- S**chemaVersion&#x20;**&#x5C5E;性は 1.0 である必要があります。
- 子ビジネス オブジェクトの最大レベルは 2 です。  たとえば、Incident-Task.Assignment-Journal.Notes などです。
- トランザクションは、挿入、更新、更新追加、削除、またはなしのいずれかである必要があります。
  - UpdateAdd は、見つからない場合は新しいレコードを挿入し、見つかった場合は更新します。
  - 子ビジネス オブジェクトのみがリンクまたはリンク解除されている場合は、None が使用されます。 それ以外の場合は何も行われません。
- LinkTransaction は、link、unlink、none のいずれかである必要があります。 LinkTransaction は、子ビジネス オブジェクト コンテキストでのみ使用されます。 ルート レベルの親情報に指定されている場合は無視されます。
- サポートされる RelationBusinessObjects の最大数は 100 です。
- タ**イプ&#x20;**&#x5C5E;性は次のいずれかになります。
  - システム.Int32
  - システム.Int64
  - システム.シングル
  - システム.Double
  - システム.10進数
  - システム.日付時刻
  - システム.ブール
  - 通貨

## インポート ファイルの例 - インシデント (タスクを含む)、割り当て (ジャーナルを含む)、メモ

\<?xml version="1.0" encoding="utf-8"?>

\<BusinessObjectList SchemaVersion="1.0" xmlns\:xsi="http\://www\.w3.org/2001/XMLSchema-instance" xsi\:noNamespaceSchemaLocation="HierarchicalObjects-1.0.xsd">

    \<BusinessObject Name="Incident">

        \<Transaction>UpdateAdd\</Transaction>

        \<UniqueKeyList>

            \<UniqueKey>

                \<Field Name="IncidentNumber" />

            \</UniqueKey>

        \</UniqueKeyList>

        \<FieldList>

            \<Field Name="IncidentNumber">50011\</Field>

            \<Field Name="Subject">Daily Backup Failure\</Field>

            \<Field Name="Symptom">Backup failed on server\</Field>

            \<Field Name="Service">Data Service\</Field>

            \<Field Name="Category">Backup\</Field>

            \<Field Name="Owner">JClerk\</Field>

            \<Field Name="OwnerTeam">Service Desk\</Field>

            \<Field Name="Impact">Low\</Field>

            \<Field Name="Urgency">High\</Field>

            \<Field Name="Source">Phone\</Field>

            \<Field Name="ProfileLink">John M Doe\</Field>

        \</FieldList>

        \<RelatedBusinessObjectList>

            \<RelatedBusinessObject Relationship="IncidentAssocTaskAssignment">

                \<BusinessObject Name="Task.Assignment">

                    \<Transaction>更新追加\</Transaction>

                    \<LinkTransaction>リンク\</LinkTransaction>

                    \<UniqueKeyList>

                        \<UniqueKey>

                            \<Field Name="AssignmentID" />

                        \</UniqueKey>

                    \</UniqueKeyList>

                    \<FieldList>

                        \<Field Name="AssignmentID">400011\</Field>

                        \<Field Name="Subject">サーバー上のバックアップを復元してください\</Field>

                        \<Field Name="OwnerTeam">サービスデスク\</Field>

                    \</FieldList>

                    \<RelatedBusinessObjectList>

                        \<RelatedBusinessObject Relationship="IncidentContainsJournal">

                            \<BusinessObject Name="Journal.Notes">

                                \<Transaction>UpdateAdd\</Transaction>

                                \<LinkTransaction>Link\</LinkTransaction>

                                \<UniqueKeyList>

                                    \<UniqueKey>

                                        \<Field Name="RecId" />

                                    \</UniqueKey>

                                \</UniqueKeyList>

                                \<FieldList>

                                    \<Field Name="RecId">2B4FDD4BF1FD49FFAD4BF0249A4038EE\</Field>

                                    \<Field Name="Category">Memo\</Field>

                                    \<Field Name="Source">Voice Mail\</Field>

                                    \<Field Name="Subject">Additional Info Request\</Field>

                                    \<Field Name="TimeSpent">10\</Field>

                                    \<Field Name="NotesBody">How soon do you need the backup.\</Field>

                                \</FieldList>

                            \</BusinessObject>

                        \</RelatedBusinessObject>

                    \</RelatedBusinessObjectList>

                \</BusinessObject>

            \</RelatedBusinessObject>

        \</RelatedBusinessObjectList>

    \</BusinessObject>

\</BusinessObjectList>
