バルク メタデータ パッケージの提出
バルク メタデータ パッケージを提出するには、以下の手順に従ってください。
SignToolツールを使用して、一括メタデータパッケージに署名します。
Microsoftアカウントを使用して、ハードウェアデベロッパーセンターまたはWindowsデベロッパーセンターからダッシュボードにサインインします。
デバイスメタデータで、 [一括送信の作成] をクリックします。
新しい一括メタデータパッケージを参照して選択し、 [送信] をクリックします。
バルク メタデータ サブミッション パッケージの作成
一括メタデータ送信パッケージは、複数のデバイスメタデータパッケージをダッシュボードに送信できるパッケージ形式です。
一括メタデータ送信パッケージは、一括送信機能を使用してダッシュボードにアップロードする必要があります。 この機能では、複数のメタデータパッケージを同時にアップロードしやすくするためのエクスペリエンスを作成するためのユーザーインターフェイスが削除されます。 エクスペリエンスを作成し、パッケージ属性を変更するための情報は、BulkMetadataSubmission XMLドキュメントに含まれています。
最大50個のdevicemetadata-msまたはdevicemantify-msファイルを一括パッケージに含めることができます。
デバイスメタデータ送信ウィザードを使用して一括メタデータパッケージを作成する方法の詳細については、 「Visual Studioでのデバイスメタデータ送信パッケージの作成」 を参照してください。
バルク メタデータ サブミッション パッケージの内容
各一括メタデータ送信パッケージは、次のコンポーネントで構成されています。
デバイスメタデータパッケージ
デバイスメタデータパッケージには、デバイスアイコンの表示、アクションの設定、デバイスエクスペリエンス機能の利用を行うための情報とグラフィックスが含まれています。
デバイスマニフェストパッケージ
デバイスマニフェストパッケージには、デバイスメタデータパッケージを検証するための情報が含まれています。
BulkMetadataSubmission XMLドキュメント
このドキュメントには、ユーザーインターフェイスを使用せずにパッケージを適切に送信するために使用されるデータが含まれています。 ダッシュボードでは、このドキュメントの情報を使用して、フレンドリ名を使用してエクスペリエンスを作成し、パッケージをエクスペリエンスに整理し、エクスペリエンスを更新し、個々のパッケージをプレビューとしてマークします。
Note
XMLドキュメントは、UTF-8エンコードを使用して保存する必要があります。
一括メタデータ申請パッケージには、少なくとも1つのデバイスメタデータパッケージまたはデバイスマニフェストパッケージを含める必要があります。
バルク メタデータ サブミッション パッケージの構造
一括メタデータ申請パッケージのコンポーネントは、圧縮されたキャビネットファイルに格納されます。 ファイル名のサフィックスは".bulkmetadata-ms"である必要があります。
各一括メタデータ申請パッケージの構造は次のとおりです。
DDMMYYYY.bulkmetadata-ms
\Filename1.devicemetadata-ms
\Filename2.devicemetadata-ms
\...
\Filename3.devicemanifest-ms
\Filename4.devicemanifest-ms
\...
\BulkMetadataSubmission.xml
Filename1、Filename2、Filename3、Filename4などはGuidである必要があります。
BulkMetadataSubmission.xml を作成するには、以下の「BulkMetadataSubmission.xml の作成」を参照してください。
デバイスメタデータパッケージ*.devicemetadata-msを開発する方法については、Windows 8のデバイスメタデータパッケージスキーマリファレンスを参照してください。
デバイスマニフェストパッケージ*.devicemmanifest-msを開発するには、 「PCデバイスマニフェストパッケージの送信」 を参照してください。
Cabarcツールを使用して、これらのCABパッケージを作成できます。 このツールの詳細については、 「Cabarcの概要」 を参照してください。
Cabarcツールを使用して*.bulkmetadata-msファイルを作成する場合は、デバイスメタデータパッケージ(*.devicemetadata-ms) 、デバイスマニフェストパッケージ(*.devicemmanifest-ms) 、およびBulkMetadataSubmission XMLドキュメントがディレクトリのルートにあるローカルディレクトリを作成する必要があります。
解説
.devicemetadata-ms と .devicemanifest-ms のファイル名で指定する GUID は、中かっこ ({}) で区切らないでください。
各デバイスメタデータパッケージとデバイスマニフェストパッケージのGUIDは一意である必要があります。 新しいパッケージまたは変更されたパッケージを作成する場合は、新しいGUIDを作成する必要があります。
キャビネットファイルを作成する方法の詳細については、 「Microsoft Cabinet SDK」 を参照してください。
例
次に、Cabarcツールを使用して.bulkmetadata-msファイルを作成する方法の例を示します。 この例では、一括メタデータファイルのコンポーネントは、BulkPackagesという名前のローカルディレクトリにあります。
.\BulkPackages\
.\BulkPackages\BulkMetadataSubmission.xml
.\BulkPackages\GUID1.devicemetadata-ms
.\BulkPackages\GUID2.devicemetadata-ms
.\BulkPackages\GUID3.devicemanifest-ms
.\BulkPackages\GUID4.devicemanifest-ms
GUID.pcmetadata-msファイルは、PCFilesという名前のローカルディレクトリに作成されました。
Cabarc.exe -r -p -P .\BulkPackages\
N .\BulkFiles\ DDMMYYYY.bulkmetadata-ms
.\BulkPackages\BulkMetadataSubmission.xml
.\BulkPackages\GUID1.devicemetadata-ms
.\BulkPackages\GUID2.devicemetadata-ms
.\BulkPackages\GUID3.devicemanifest-ms
.\BulkPackages\GUID4.devicemanifest-ms
Note
このツールについて詳しくは、Cabarc の概要に関するページをご覧ください。。
BulkMetadataSubmission.xml の作成
BulkMetadataSubmission XML スキーマ
一括メタデータ送信パッケージには、1つのBulkMetadataSubmission.xmlドキュメントが含まれています。このドキュメントには、フレンドリ名を使用したエクスペリエンスの作成、エクスペリエンスへのパッケージの整理、エクスペリエンスの更新、および個々のパッケージのプレビューとしてのマーク付けを行うためにダッシュボードで使用される情報が含まれています。
BulkMetadataSubmission.xmlドキュメント内のデータは、次に説明するBulkMetadataSubmission XMLスキーマに基づいて書式設定されます。
Note
XMLドキュメントは、UTF-8エンコードを使用して保存する必要があります。
BulkMetadataSubmission XML スキーマの名前空間
PcMetadataSubmission XMLスキーマの名前空間を次に示します。 http://schemas.microsoft.com/Windows/2010/08/MetadataSubmission/BulkMetadataSubmission
BulkMetadataSubmission XML の要素/属性の概要
次の表では、BulkMetadataSubmission XMLスキーマのメタデータの要素と属性について説明します。
要素/属性 | 要素/属性の種類 | 必須/省略可能 |
---|---|---|
エクスペリエンス | ExperienceType | 必須 |
ExperienceName | xs:string | 必須 |
ExperienceId | tns:GUIDType | 省略可能 |
PackageList | tns:PackageListType | 必須 |
PackageFileName | PackageFileNameType | 必須 |
preview | xs:ブール値 | 必須 |
locale | xs:string | 必須 |
認定 | tns:QualificationType | 必須 |
LogoSubmissionIDList | tns:LogoSubmissionIDListType | 省略可能 |
LogoSubmissionID | xs:integer | 必須 |
update | xs:ブール値 | 必須 |
BulkMetadataSubmission XML スキーマのメタデータ
BulkMetadataSubmission XMLスキーマのメタデータを次に示します。
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="http://schemas.microsoft.com/Windows/2010/08/MetadataSubmission/BulkMetadataSubmission" xmlns:tns="http://schemas.microsoft.com/Windows/2010/08/MetadataSubmission/BulkMetadataSubmission" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" blockDefault="#all">
<xs:element name="BulkMetadataSubmission" type="tns:BulkMetadataSubmissionType" />
<xs:complexType name="BulkMetadataSubmissionType">
<xs:sequence>
<xs:element name="Experience" type="tns:ExperienceType" maxOccurs="unbounded" />
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="ExperienceType">
<xs:complexContent>
<xs:extension base ="tns:BaseExperienceType">
<xs:attribute name="update" type="xs:boolean" use="required"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="BaseExperienceType">
<xs:sequence>
<xs:element name="ExperienceName" type="xs:string" />
<xs:element name="ExperienceId" type="tns:GUIDType" minOccurs="0" />
<xs:element name="PackageList" type="tns:PackageListType" />
<xs:element name="Qualification" type="tns:QualificationType" />
<xs:element name="LogoSubmissionIDList" type="tns:LogoSubmissionIDListType" minOccurs="0" maxOccurs="unbounded" />
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:simpleType name="GUIDType">
<xs:restriction base="xs:string">
<xs:pattern value="[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}" />
</xs:restriction>
</xs:simpleType>
<xs:complexType name="PackageListType">
<xs:sequence>
<xs:element name="PackageFileName" type="tns:PackageFileNameType" maxOccurs="unbounded" />
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:complexType name="PackageFileNameType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="preview" type="xs:boolean" use="required" />
<xs:attribute name="locale" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:simpleType name="QualificationType">
<xs:union memberTypes="tns:QualificationTypeEnumeration xs:string" />
</xs:simpleType>
<xs:simpleType name="QualificationTypeEnumeration">
<xs:restriction base="xs:string">
<xs:enumeration value="Logo/IDDA" />
<xs:enumeration value="MicrosoftInboxDriver" />
</xs:restriction>
</xs:simpleType>
<xs:complexType name="LogoSubmissionIDListType">
<xs:sequence>
<xs:element name="LogoSubmissionID" type="xs:integer" maxOccurs="unbounded" />
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:schema>
BulkMetadataSubmission XML スキーマ リファレンス
BulkMetadataSubmission XMLスキーマでは、次の要素と属性が定義されています。
BulkMetadataSubmission
エクスペリエンス
ExperienceName
ExperienceID
PackageList
PackageFileName
preview
locale
認定
LogoSubmissionIDList
- LogoSubmissionID
update
Experience 要素
Experience要素は、1つのエクスペリエンスの情報を指定します。 エクスペリエンスの詳細については、Windows 8のデバイスメタデータパッケージスキーマリファレンスを参照してください。
この情報に基づいて、ダッシュボードは正しい情報を使用してエクスペリエンスを作成し、このエクスペリエンスにパッケージを送信するか、既存のエクスペリエンスを新しいパッケージで更新します。
<xs:element name="Experience" type="tns:ExperienceType" maxOccurs="unbounded" />
<xs:complexType name="ExperienceType">
<xs:complexContent>
<xs:extension base ="tns:BaseExperienceType">
<xs:attribute name="update" type="xs:boolean" use="required"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="BaseExperienceType">
<xs:sequence>
<xs:element name="ExperienceName" type="xs:string" />
<xs:element name="ExperienceId" type="tns:GUIDType" minOccurs="0" />
<xs:element name="PackageList" type="tns:PackageListType" />
<xs:element name="Qualification" type="tns:QualificationType" />
<xs:element name="LogoSubmissionIDList" type="tns:LogoSubmissionIDListType" minOccurs="0" maxOccurs="unbounded" />
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
複数のExperience要素を使用して、複数のエクスペリエンスを指定できます。 これにより、さまざまなデバイスに対して多数のパッケージを1回で送信できます。
たとえば、以下を参照してください。
<Experience update="false">
<ExperienceName>Test1</ExperienceName>
<PackageList>
<PackageFileName locale="en-us" preview ="false">
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.devicemanifest-ms
</PackageFileName>
</PackageList>
<Qualification>Logo/IDDA</Qualification>
<LogoSubmissionIDList>
<LogoSubmissionID>XXXXXXX</LogoSubmissionID>
</LogoSubmissionIDList>
</Experience>
<Experience update="false">
<ExperienceName>Test2</ExperienceName>
<PackageList>
<PackageFileName locale="en-us" preview ="false">
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.devicemetadata-ms
</PackageFileName>
</PackageList>
<Qualification>Logo/IDDA</Qualification>
<LogoSubmissionIDList>
<LogoSubmissionID>XXXXXXX</LogoSubmissionID>
</LogoSubmissionIDList>
</Experience>
ExperienceName 要素
ExperienceName要素は、エクスペリエンスの名前を指定します。 これが新しいエクスペリエンスである場合、ダッシュボードはこの名前のエクスペリエンスを作成します。 または、これが既存のエクスペリエンスの更新である場合、この値は無視されます。
<xs:element name="ExperienceName" type="xs:string" />
ExperienceId 要素
ExperienceId要素は、エクスペリエンスIDであるGUIDを指定します。 この値は、既存のエクスペリエンスを更新するときに必要です。 ダッシュボードは、この値を使用して、更新するエクスペリエンスを識別します。
<xs:element name="ExperienceId" type="tns:GUIDType" minOccurs="0" />
<xs:simpleType name="GUIDType">
<xs:restriction base="xs:string">
<xs:pattern value="[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}" />
</xs:restriction>
</xs:simpleType>
PackageList 要素
PackageList要素は、エクスペリエンスに含めるデバイスメタデータまたはデバイスマニフェストパッケージの一覧を指定します。 ダッシュボードは、この情報を使用して、新規または既存のエクスペリエンスにパッケージを追加します。
<xs:element name="PackageList" type="tns:PackageListType" />
<xs:complexType name="PackageListType">
<xs:sequence>
<xs:element name="PackageFileName" type="tns:PackageFileNameType" maxOccurs="unbounded" />
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
PackageFileName 要素
PackageFileName要素は、単一のデバイスメタデータまたはデバイスマニフェストパッケージのファイル名と情報を指定します。 ダッシュボードは、この情報を使用して、新規または既存のエクスペリエンスにパッケージを追加し、指定されている場合はパッケージをプレビューとして正しくマークします。 プレビューとロケールの値に基づいて、ダッシュボードは必要に応じて既存のパッケージも削除します。
<xs:element name="PackageFileName" type="tns:PackageFileNameType" maxOccurs="unbounded" />
<xs:complexType name="PackageFileNameType">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="preview" type="xs:boolean" use="required" />
<xs:attribute name="locale" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
PackageFileName要素のプレビューとロケールの属性を使用すると、ダッシュボードは既存のライブパッケージを新しく送信されたパッケージで更新できます。
たとえば、en-USプレビューパッケージが既にエクスペリエンスに存在し、同じエクスペリエンスの一括メタデータ送信パッケージでen-USプレビューパッケージが送信された場合、既存のパッケージは自動的に削除され、新しいパッケージが送信されます。
このため、パッケージを更新するときは、誤って削除されないように注意することも重要です。
preview 属性
preview属性は、デバイスメタデータまたはデバイスマニフェストパッケージをプレビューとしてマークするかどうかを指定します。 ダッシュボードでこの値を使用する方法の詳細については、PackageFileName要素を参照してください。
<xs:attribute name="preview" type="xs:boolean" use="required" />
locale 属性
locale属性は、デバイスメタデータまたはデバイスマニフェストパッケージの宣言されたロケール(PackageInfo.xmlから)をプレビューとしてマークするかどうかを指定します。 ダッシュボードでこの値を使用する方法の詳細については、PackageFileName要素を参照してください。
<xs:attribute name="locale" type="xs:string" use="required" />
Qualification 要素
Qualification要素は、デバイスにロゴ認定があるかどうか、Inbox Driver Distribution Agreement (IDDA) リストに含まれているかどうか、またはMicrosoft受信トレイドライバーを使用しているかどうかを指定します。 ダッシュボードでは、この情報を使用して、送信するデバイスメタデータの種類に対して適切なデバイス認定が行われるようにします。
<xs:element name="Qualification" type="tns:QualificationType" />
<xs:simpleType name="QualificationType">
<xs:union memberTypes="tns:QualificationTypeEnumeration xs:string" />
</xs:simpleType>
<xs:simpleType name="QualificationTypeEnumeration">
<xs:restriction base="xs:string">
<xs:enumeration value="Logo/IDDA" />
<xs:enumeration value="MicrosoftInboxDriver" />
</xs:restriction>
</xs:simpleType>
Device Stageなどの機能は、ロゴ認定に合格しておらず、IDDAリストにもないデバイスでは使用できません。
エクスペリエンスごとに、2つのオプションのいずれかを選択できます。 これらのオプションとその定義を次の表に示します。
列挙値 | 説明 |
---|---|
ロゴ/IDDA | デバイスにロゴ認定があるか、IDDAリストにあります。 ロゴ認定がある場合は、LogoSubmissionIDList要素で特定のロゴ送信Idを指定する必要があります。 |
MicrosoftInboxDrive | デバイスでMicrosoft受信トレイドライバーが使用されています。 この資格レベル (Device Stageなど) を使用する場合は、デバイスメタデータの一部の機能を使用できないことがあります。 |
LogoSubmissionIDList 要素
LogoSubmissionIDList要素は、デバイスのロゴ認定の一覧を指定します。 ダッシュボードでこの値を使用する方法の詳細については、 「Qualification要素」 を参照してください。
<xs:element name="LogoSubmissionIDList" type="tns:LogoSubmissionIDListType" minOccurs="0" maxOccurs="unbounded" />
<xs:complexType name="LogoSubmissionIDListType">
<xs:sequence>
<xs:element name="LogoSubmissionID" type="xs:integer" maxOccurs="unbounded" />
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
LogoSubmissionID 要素
LogoSubmissionID要素は、デバイスの個々のロゴ認定を指定します。 ダッシュボードでこの値を使用する方法の詳細については、 「Qualification要素」 を参照してください。
<xs:element name="LogoSubmissionID" type="xs:integer" maxOccurs="unbounded" />
複数のLogoSubmissionID要素を使用して、1つのデバイスに対して複数のロゴ認定を示すことができます。 ユーザーは、デバイスのすべてのロゴ認定を一覧に表示する必要があります。 複数のロゴ認定が一覧表示される例を次に示します。
<LogoSubmissionIDList>
<LogoSubmissionID>0000001</LogoSubmissionID>
<LogoSubmissionID>0000002</LogoSubmissionID>
<LogoSubmissionID>0000003</LogoSubmissionID>
</LogoSubmissionIDList>
update 属性
update属性は、エクスペリエンスを更新するかどうかを指定します。 ダッシュボードはこの値を使用して、競合するパッケージを削除し、update属性がtrueに設定されている場合に新しいパッケージをアップロードすることで、エクスペリエンスを更新します。 update属性がfalseに設定されている場合、ダッシュボードは新しいエクスペリエンスを作成し、それに新しいパッケージをアップロードします。
<xs:attribute name="update" type="xs:boolean" use="required"/>
BulkMetadataSubmission XML の例
次のXMLドキュメントでは、BulkMetadataSubmission XMLスキーマを使用して、BulkMetadataSubmission XMLドキュメントのコンポーネントを指定します。
<BulkMetadataSubmission xmlns="http://schemas.microsoft.com/Windows/2010/08/MetadataSubmission/BulkMetadataSubmission">
<Experience update="false">
<ExperienceName>Test1</ExperienceName>
<PackageList>
<PackageFileName locale="en-us" preview ="false">
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.devicemanifest-ms
</PackageFileName>
</PackageList>
<Qualification>Logo/IDDA</Qualification>
<LogoSubmissionIDList>
<LogoSubmissionID>XXXXXXX</LogoSubmissionID>
</LogoSubmissionIDList>
</Experience>
<Experience update="false">
<ExperienceName>Test2</ExperienceName>
<PackageList>
<PackageFileName locale="en-us" preview ="false">
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.devicemetadata-ms
</PackageFileName>
</PackageList>
<Qualification>Logo/IDDA</Qualification>
<LogoSubmissionIDList>
<LogoSubmissionID>XXXXXXX</LogoSubmissionID>
</LogoSubmissionIDList>
</Experience>
<Experience update="false">
<ExperienceName>Test3</ExperienceName>
<PackageList>
<PackageFileName locale="en-us" preview="false">
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.devicemanifest-ms
</PackageFileName>
</PackageList>
<Qualification>Logo/IDDA</Qualification>
<LogoSubmissionIDList>
<LogoSubmissionID>XXXXXXX</LogoSubmissionID>
</LogoSubmissionIDList>
</Experience>
<Experience update="false">
<ExperienceName>Test4</ExperienceName>
<PackageList>
<PackageFileName locale="en-us" preview="false">
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.devicemetadata-ms
</PackageFileName>
</PackageList>
<Qualification>Logo/IDDA</Qualification>
<LogoSubmissionIDList>
<LogoSubmissionID>XXXXXXX</LogoSubmissionID>
</LogoSubmissionIDList>
</Experience>
<Experience update="false">
<ExperienceName>Test5</ExperienceName>
<PackageList>
<PackageFileName locale="en-us" preview="false">
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.devicemetadata-ms
</PackageFileName>
</PackageList>
<Qualification>Logo/IDDA</Qualification>
<LogoSubmissionIDList>
<LogoSubmissionID>XXXXXXX</LogoSubmissionID>
</LogoSubmissionIDList>
</Experience>
</BulkMetadataSubmission>