提交批量元数据包Submit a Bulk Metadata Package

提交批量元数据包Submitting a bulk metadata package

提交批量元数据包To submit a bulk metadata package

  1. 使用 SignTool 工具对批量元数据包进行签名。Sign the bulk metadata package with the SignTool tool.

  2. 从硬件开发人员中心或 Windows 开发人员中心,使用 Microsoft 帐户登录到“仪表板”*Sign in to the *Dashboard from either the Hardware Dev Center or the Windows Dev Center by using a Microsoft account.

  3. 在“设备元数据”*下,单击“创建批量提交”Under **Device metadata, click **Create bulk submission*.

  4. 浏览并选择你的新批量元数据包,然后单击“提交”*Browse for and select your new bulk metadata package, and then click *Submit.

创建批量提交程序包Creating a Bulk Submission Package

批量元数据提交包是可以将多个设备元数据包提交到仪表板的包格式。A bulk metadata submission package is the package format in which multiple device metadata packages can be submitted to the Dashboard.

应使用批量提交功能将批量元数据提交包上载到仪表板。Bulk metadata submission packages should be uploaded to the Dashboard by using the bulk submission feature. 此功能将移除用于创建体验的用户界面,以便简化同时上载多个元数据包的操作。This feature removes the user interface for creating experiences to ease the uploading of multiple metadata packages simultaneously. 用于创建体验和修改包属性的信息包含在 BulkMetadataSubmission XML 文档中。The information to create experiences and modify package attributes is contained in the BulkMetadataSubmission XML document.

最多可将 50 个 devicemetadata-ms 或 devicemanifest-ms 文件包含在批量程序包中。A maximum of 50 devicemetadata-ms or devicemanifest-ms files can be included in a bulk package.

有关如何使用“设备元数据提交向导”创建批量元数据包的信息,请参阅在 Visual Studio 中创建设备元数据提交程序包For info about using the Device Metadata Submission Wizard to create a bulk metadata package, see Creating a device metadata submission package in Visual Studio.

批量元数据提交程序包内容Bulk Metadata Submission Package Contents

每个批量元数据提交包都包含以下组成部分:Each bulk metadata submission package consists of the following components:

  • 设备元数据包Device metadata package(s)

    设备元数据包包含用于显示设备图标,设置操作及使用设备体验功能的信息和图片。Device metadata packages contain information and graphics to display device icons, set actions, and utilize device experience features.

  • 设备清单包Device manifest package(s)

    设备清单包包含用于验证设备元数据包的信息。Device manifest packages contain information to validate device metadata packages.

  • BulkMetadataSubmission XML 文档BulkMetadataSubmission XML document

    此文档包含用于在没有用户界面情况下正确提交程序包的数据。This document contains data used to properly submit packages without a user interface. 仪表板使用此文档中的信息来创建具有友好名称的体验,将程序包组织到体验中、更新体验,以及将各个包标记为预览。The Dashboard uses information in this document to create experiences with friendly names, organize packages into experiences, update experiences, and mark individual packages as preview.

注意Note
这些 XML 文档必须使用 UTF-8 编码进行保存。The XML documents must be saved by using UTF-8 encoding.

在批量元数据提交包中,必须至少包含一个设备元数据或设备清单包。You must include at least one device metadata or device manifest package in your bulk metadata submission package.

批量元数据提交包的结构Structure of a Bulk Metadata Submission Package

批量元数据提交包的组成部分存储在压缩的 Cab 文件中。The components of a bulk metadata submission package are stored in a compressed cabinet file. 该文件名必须具有后缀 .bulkmetadata-ms。The file name must have a suffix of “.bulkmetadata-ms.”

每个批量元数据提交包都必须具有以下结构:Each bulk metadata submission package must have the following structure:

DDMMYYYY.bulkmetadata-ms
\Filename1.devicemetadata-ms
\Filename2.devicemetadata-ms
\...
\Filename3.devicemanifest-ms
\Filename4.devicemanifest-ms
\...
\BulkMetadataSubmission.xml

Filename1、Filename2、Filename3、Filename4 等必须是 GUID。Filename1, Filename2, Filename3, Filename4, and so on, must be GUIDs.

若要创建 BulkMetadataSubmission.xml,请参阅下面的信息。To create the BulkMetadataSubmission.xml, see below.

若要开发设备元数据包 *.devicemetadata-ms,请参阅 Windows 8 的设备元数据包架构参考To develop the device metadata package, *.devicemetadata-ms, see Device Metadata Package Schema Reference for Windows 8.

若要开发设备清单包 *.devicemanifest-ms,请参阅提交电脑设备清单包To develop the device manifest package, *.devicemanifest-ms, see Submit a PC device manifest package.

你可以使用 Cabarc 工具创建这些 CAB 程序包。You can use the Cabarc tool to create these CAB packages. 若要了解有关此工具的详细信息,请参阅 Cabarc 概述To learn more about this tool, see Cabarc Overview.

使用 Cabarc 工具创建 *.bulkmetadata-ms 文件时,你必须创建一个本地目录,其中设备元数据包 (*.devicemetadata-ms)、设备清单包 (*.devicemanifest-ms) 和 BulkMetadataSubmission XML 文档都位于该目录的根目录中。When you create a *.bulkmetadata-ms file by using the Cabarc tool, you must create a local directory in which the device metadata packages (*.devicemetadata-ms), the device manifest packages (*.devicemanifest-ms), and the BulkMetadataSubmission XML document are at the root of the directory.

备注Remarks

  • .devicemetadata-ms 和 .devicemanifest-ms 文件名必须指定不带花括号 ({}) 分隔符的 GUID。The .devicemetadata-ms and .devicemanifest-ms filenames must specify the GUID without the curly brace ({}) delimiters.

  • 每个设备元数据包和设备清单包的 GUID 都必须唯一。The GUID for each device metadata package and device manifest package must be unique. 当你创建新的或修改的程序包时,必须创建新 GUID。When you create a new or revised package, you must create a new GUID.

  • 有关如何创建 cabinet 文件的更多详细信息,请参阅 Microsoft Cab SDKFor more details about how to create cabinet files, see Microsoft Cabinet SDK.

示例Example

下面是如何使用 Cabarc 工具创建 .bulkmetadata-ms 文件的示例。The following is an example of how to use the Cabarc tool to create a .bulkmetadata-ms file. 在此示例中,批量元数据文件的组成部分位于名为 BulkPackages 的本地目录中:In this example, the components of the bulk metadata file are located in a local directory that is named 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 的本地目录中创建:The GUID.pcmetadata-ms file was created in a local directory that is named 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 概述You can find more information about this tool in Cabarc Overview.

创建 BulkMetadataSubmission.xmlCreating BulkMetadataSubmission.xml

BulkMetadataSubmission XML 架构BulkMetadataSubmission XML Schema

批量元数据提交包包含一个 BulkMetadataSubmission.xml 文档,其中包含仪表板用于创建具有友好名称的体验,将包组织到体验中,更新体验以及将各个包标记为预览的信息。A bulk metadata submission package contains one BulkMetadataSubmission.xml document, which has information that the Dashboard uses to create experiences with friendly names, organize packages into experiences, update experiences, and mark individual packages as preview.

BulkMetadataSubmission.xml 文档中的数据基于 BulkMetadataSubmission XML 架构(将在下面进行介绍)设置格式。The data in the BulkMetadataSubmission.xml document is formatted based on the BulkMetadataSubmission XML schema, which is described below.

注意Note
该 XML 文档必须使用 UTF-8 编码进行保存。The XML document must be saved by using UTF-8 encoding.

BulkMetadataSubmission XML 架构命名空间BulkMetadataSubmission XML Schema NameSpace

以下是 PcMetadataSubmission XML 架构的命名空间:http://schemas.microsoft.com/Windows/2010/08/MetadataSubmission/BulkMetadataSubmissionThe following is the namespace of the PcMetadataSubmission XML schema: http://schemas.microsoft.com/Windows/2010/08/MetadataSubmission/BulkMetadataSubmission

BulkMetadataSubmission XML 元素/属性概述Overview of BulkMetadataSubmission XML Elements/Attributes

下表描述 BulkMetadataSubmission XML 架构的元数据元素和属性。The following table describes the metadata elements and attributes of the BulkMetadataSubmission XML schema.

元素/属性Element/Attributes 元素/属性类型Element/Attribute type 必需/可选Required/ optional

ExperienceExperience

ExperienceTypeExperienceType

必需Required

ExperienceNameExperienceName

xs:stringxs:string

必需Required

ExperienceIdExperienceId

tns:GUIDTypetns:GUIDType

可选Optional

PackageListPackageList

tns:PackageListTypetns:PackageListType

必需Required

PackageFileNamePackageFileName

PackageFileNameTypePackageFileNameType

必需Required

previewpreview

xs:Booleanxs:Boolean

必需Required

localelocale

xs:stringxs:string

必需Required

QualificationQualification

tns:QualificationTypetns:QualificationType

必需Required

LogoSubmissionIDListLogoSubmissionIDList

tns:LogoSubmissionIDListTypetns:LogoSubmissionIDListType

可选Optional

LogoSubmissionIDLogoSubmissionID

xs:integerxs:integer

必需Required

updateupdate

xs:Booleanxs:Boolean

必需Required

BulkMetadataSubmission XML 架构元数据BulkMetadataSubmission XML Schema Metadata

以下是 BulkMetadataSubmission XML 架构元数据:The following is the BulkMetadataSubmission XML schema metadata:

<?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 Schema Reference

BulkMetadataSubmission XML 架构定义以下元素和属性:The BulkMetadataSubmission XML schema defines the following elements and attributes:

  • BulkMetadataSubmissionBulkMetadataSubmission

    • ExperienceExperience

      • ExperienceNameExperienceName

      • ExperienceIDExperienceID

      • PackageListPackageList

        • PackageFileNamePackageFileName

          • previewpreview

          • localelocale

      • QualificationQualification

      • LogoSubmissionIDListLogoSubmissionIDList

        • LogoSubmissionIDLogoSubmissionID
      • updateupdate

Experience 元素Experience Element

Experience 元素指定单个体验的信息。The Experience element specifies information for a single experience. 有关体验的详细信息,请参阅 Windows 8 的设备元数据包架构参考For more information about experiences, see Device Metadata Package Schema Reference for Windows 8.

仪表板将基于此信息创建具有正确信息的体验并向此体验提交包,或者使用新包更新现有体验。Based on this information, the Dashboard either creates an experience with the correct information and submits packages to this experience, or updates an existing experience with new packages.

<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>

备注Remarks

可以使用多个 Experience 元素指定多个体验。More than one Experience element can be used to specify multiple experiences. 这允许一次为不同设备提交许多包。This allows for a single submission of many packages for different devices.

例如,请参阅下列内容:For example, see the following.

<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 Element

ExperienceName 元素指定体验的名称。The ExperienceName element specifies the name of an experience. 如果这是新体验,仪表板将创建具有此名称的体验。The Dashboard will create an experience with this name if this is a new experience. 或者,如果这是对现有体验的更新,它将忽略此值。Or, it ignores this value when this is an update to an existing experience.

<xs:element name="ExperienceName" type="xs:string" />

ExperienceId 元素ExperienceId Element

ExperienceId 元素指定作为体验 ID 的 GUID。The ExperienceId element specifies the GUID that is the Experience ID. 在更新现有体验时需要使用此值。This value is required when updating an existing experience. 仪表板使用此值来标识要更新的体验。The Dashboard uses this value to identify the experience to update.

<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 Element

PackageList 元素指定要包含在某个体验中的设备元数据或设备清单包列表。The PackageList element specifies the list of device metadata or device manifest packages to be included in an experience. 仪表板使用此信息将这些包添加到新的或现有的体验中。The Dashboard uses this information to add packages to a new or existing experience.

<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 Element

PackageFileName 元素指定单个设备元数据或设备清单包的文件名和信息。The PackageFileName element specifies the filename and information of a single device metadata or device manifest package. 仪表板使用此信息将程序包添加到新的或现有的体验中,并将该程序包正确标记为预览(如果已指示)。The Dashboard uses this information to add a package to a new or existing experience, and correctly mark the package as preview if indicated. 根据预览值和区域设置值,仪表板也会根据需要删除现有程序包Based on the preview and locale values, the Dashboard also deletes existing packages if required

<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>

备注Remarks

通过 PackageFileName 元素的 preview 和 locale 属性,仪表板可以使用新提交的包更新你的现有实时包。The preview and locale attributes of the PackageFileName element allow the Dashboard to update your existing live package with a newly submitted package.

例如,如果体验中已存在 en-US 预览包,并且在批量元数据提交程序包中为同一体验提交了 en-US 预览包,则会自动删除现有程序包并提交新程序包。For example, if an en-US preview package already exists in the experience, and an en-US preview package was submitted in a bulk metadata submission package for the same experience, the existing package would be automatically deleted and the new package would be submitted.

为此,在更新包时也请务必小心,以避免意外删除。For this reason, it is also important to be careful when updating packages to avoid accidental deletions.

preview 属性preview Attribute

preview 属性指定是否应将设备元数据或设备清单包标记为预览。The preview attribute specifies whether a device metadata or device manifest package should be marked preview. 有关仪表板如何使用此值的详细信息,请参阅“PackageFileName 元素”。See PackageFileName Element for more information about how the Dashboard uses this value.

<xs:attribute name="preview" type="xs:boolean" use="required" />

locale 属性locale Attribute

locale 属性指定是否应将设备元数据或设备清单包的已声明区域设置(从 PackageInfo.xml)标记为预览。The locale attribute specifies the declared locale (from PackageInfo.xml) of a device metadata or device manifest package should be marked preview. 有关仪表板如何使用此值的详细信息,请参阅“PackageFileName 元素”。See PackageFileName Element for more information about how the Dashboard uses this value.

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

Qualification 元素Qualification Element

Qualification 元素指定设备是具有包含在内置驱动程序分发协议 (IDDA) 列表中的徽标认证还是使用 Microsoft 内置驱动程序。The Qualification element specifies whether the device has a Logo certification, is included in the Inbox Driver Distribution Agreement (IDDA) list, or uses a Microsoft inbox driver. 仪表板使用此信息来确保你提交的设备元数据类型的正确设备认证。The Dashboard uses this information to ensure correct device certification for the type of device metadata you are submitting.

<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>

备注Remarks

对于尚未通过徽标认证和未处于 IDDA 列表上的设备,无法使用 Device Stage 这样的功能。Features such as Device Stage are not available for devices that have not passed Logo certification and are not on the IDDA list.

你可以为每个体验选择一个或两个选项。You can select one of two options for each experience. 这些选项及其定义如下表所示。These options and their definitions are indicated in the table below:

枚举值Enumeration value

徽标/IDDALogo/IDDA

你的设备已徽标认证或已在 IDDA 列表上。Your device has a Logo certification or is on the IDDA list. 如果你已徽标认证,你需要在 LogoSubmissionIDList 元素中指定特定的徽标提交 ID。If you have a Logo certification, you will need to specify the specific Logo Submission IDs in the LogoSubmissionIDList element.

MicrosoftInboxDriveMicrosoftInboxDrive

你的设备使用 Microsoft 内置驱动程序。Your device uses a Microsoft inbox driver. 在使用此资格级别时,设备元数据的某些功能可能无法使用(例如 Device Stage)Some features of device metadata might not be available when using this qualification level (such as Device Stage)

LogoSubmissionIDList 元素LogoSubmissionIDList Element

LogoSubmissionIDList 元素指定设备的徽标认证列表。The LogoSubmissionIDList element specifies the list of logo certification(s) for a device. 有关仪表板如何使用此值的详细信息,请参阅 Qualification 元素。See Qualification Element for more information about how the Dashboard uses this value.

<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 Element

LogoSubmissionID 元素指定设备的单个徽标认证。The LogoSubmissionID element specifies an individual logo certification for a device. 有关仪表板如何使用此值的详细信息,请参阅 Qualification 元素。See Qualification Element for more information about how the Dashboard uses this value.

<xs:element name="LogoSubmissionID" type="xs:integer"  maxOccurs="unbounded" />

备注Remarks

可以使用多个 LogoSubmissionID 元素为单台设备指示多个徽标认证。Multiple LogoSubmissionID elements can be used to indicate multiple Logo certifications for a single device. 用户应该在列表中为其设备列出所有徽标认证。Users should list all logo certifications for their device in the list. 下面是列出多个徽标认证的一个示例:The following is an example where multiple logo certifications are listed:

<LogoSubmissionIDList>
  <LogoSubmissionID>0000001</LogoSubmissionID>
  <LogoSubmissionID>0000002</LogoSubmissionID>
  <LogoSubmissionID>0000003</LogoSubmissionID>
</LogoSubmissionIDList>

update 属性update Attribute

update 属性指定是否更新某个体验。The update attribute designates whether or not an experience is being updated. 仪表板使用此值来更新体验,当 update 属性设置为 true 时,删除发生冲突的包并上载新包。The Dashboard uses this value to update an experience by deleting conflicting packages and uploading new packages when the update attribute is set to true. 当 update 属性设置为 false 时,仪表板将创建新体验并向其中上载新包。When the update attribute is set to false, the Dashboard will create a new experience and upload new packages to it.

<xs:attribute name="update" type="xs:boolean" use="required"/>

BulkMetadataSubmission XML 示例BulkMetadataSubmission XML Example

以下 XML 文档使用 BulkMetadataSubmission XML 架构来指定 BulkMetadataSubmission XML 文档的组成部分。The following XML document uses the BulkMetadataSubmission XML schema to specify the components of the BulkMetadataSubmission XML document.

<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>

向 Microsoft 发送有关该主题的评论Send comments about this topic to Microsoft