階層型 XML データのインポート
階層型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 ノート
- SchemaVersion 属性は 1.0 である必要があります。
- 子ビジネス オブジェクトの最大レベルは 2 です。 たとえば、Incident-Task.Assignment-Journal.Notes などです。
- トランザクションは、挿入、更新、更新追加、削除、またはなしのいずれかである必要があります。
- UpdateAdd は、見つからない場合は新しいレコードを挿入し、見つかった場合は更新します。
- 子ビジネス オブジェクトのみがリンクまたはリンク解除されている場合は、None が使用されます。 それ以外の場合は何も行われません。
- LinkTransaction は、link、unlink、none のいずれかである必要があります。 LinkTransaction は、子ビジネス オブジェクト コンテキストでのみ使用されます。 ルート レベルの親情報に指定されている場合は無視されます。
- サポートされる RelationBusinessObjects の最大数は 100 です。
- タイプ 属性は次のいずれかになります。
- システム.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>
