Compartir vía

Enviar un paquete de metadatos masivos

  • Artículo

Para enviar un paquete de metadatos masivo:

  1. Firme el paquete de metadatos masivos con la herramienta SignTool .

  2. Inicie sesión en el panel desde el Centro de desarrollo de hardware o el Centro de desarrollo de Windows mediante una cuenta Microsoft.

  3. En Metadatos del dispositivo, haga clic en Crear envío masivo.

  4. Busque y seleccione el nuevo paquete de metadatos masivos y, a continuación, haga clic en Enviar.

Crear un paquete de envío masivo

Un paquete de envío de metadatos masivo es el formato de paquete en el que se pueden enviar varios paquetes de metadatos de dispositivo al panel.

Los paquetes de envío de metadatos masivos se deben cargar en el panel mediante la característica de envío masivo. Esta característica quita la interfaz de usuario para crear experiencias para facilitar la carga de varios paquetes de metadatos simultáneamente. La información para crear experiencias y modificar atributos de paquete se encuentra en el documento XML BulkMetadataSubmission.

Se puede incluir un máximo de 50 archivos devicemetadata-ms o devicemanifest-ms en un paquete masivo.

Para obtener información sobre cómo usar el Asistente para envío de metadatos de dispositivo para crear un paquete de metadatos masivo, consulte Creación de un paquete de envío de metadatos de dispositivo en Visual Studio.

Contenido del paquete de envío masivo de metadatos

Cada paquete de envío de metadatos masivo consta de los siguientes componentes:

  • Paquetes de metadatos de dispositivo

    Los paquetes de metadatos de dispositivo contienen información y gráficos para mostrar iconos de dispositivo, establecer acciones y usar características de experiencia del dispositivo.

  • Paquetes de manifiestos de dispositivo

    Los paquetes de manifiesto de dispositivo contienen información para validar los paquetes de metadatos del dispositivo.

  • Documento XML BulkMetadataSubmission

    Este documento contiene datos usados para enviar correctamente paquetes sin una interfaz de usuario. El Panel usa información de este documento para crear experiencias con nombres descriptivos, organizar paquetes en experiencias, actualizar experiencias y marcar paquetes individuales como versión preliminar.

Nota:

Los documentos XML se deben guardar mediante la codificación UTF-8.

Debe incluir al menos un paquete de manifiesto de dispositivo o metadatos de dispositivo en el paquete de envío de metadatos masivo.

Estructura de un paquete de envío de metadatos masivo

Los componentes de un paquete de envío de metadatos masivos se almacenan en un archivo de archivador comprimido. El nombre de archivo debe tener un sufijo ".bulkmetadata-ms".

Cada paquete de envío de metadatos masivos debe tener la estructura siguiente:

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

Filename1, Filename2, Filename3, Filename4, etc. deben ser GUID.

Para crear el BulkMetadataSubmission.xml, consulte Creación de BulkMetadataSubmission.xml a continuación.

Para desarrollar el paquete de metadatos del dispositivo, *.devicemetadata-ms, consulte Referencia del esquema del paquete de metadatos de dispositivo para Windows 8.

Para desarrollar el paquete de manifiesto del dispositivo, *.devicemanifest-ms, consulta Enviar un paquete de manifiesto de dispositivo pc.

Puede usar la herramienta Cabarc para crear estos paquetes CAB. Para obtener más información sobre esta herramienta, consulte Introducción a Cabarc.

Al crear un archivo *.bulkmetadata-ms mediante la herramienta Cabarc, debe crear un directorio local en el que los paquetes de metadatos del dispositivo (*.devicemetadata-ms), los paquetes de manifiesto del dispositivo (*.devicemanifest-ms) y el documento XML BulkMetadataSubmission se encuentran en la raíz del directorio.

Observaciones

  • Los nombres de archivo .devicemetadata-ms y .devicemanifest-ms deben especificar el GUID sin los delimitadores de llave ({}).

  • El GUID de cada paquete de metadatos de dispositivo y paquete de manifiesto de dispositivo debe ser único. Al crear un paquete nuevo o revisado, debe crear un NUEVO GUID.

  • Para obtener más información sobre cómo crear archivos de archivador, vea Microsoft Cabinet SDK.

Ejemplo

A continuación se muestra un ejemplo de cómo usar la herramienta Cabarc para crear un archivo .bulkmetadata-ms. En este ejemplo, los componentes del archivo de metadatos masivos se encuentran en un directorio local denominado BulkPackages:

.\BulkPackages\
.\BulkPackages\BulkMetadataSubmission.xml
.\BulkPackages\GUID1.devicemetadata-ms
.\BulkPackages\GUID2.devicemetadata-ms
.\BulkPackages\GUID3.devicemanifest-ms
.\BulkPackages\GUID4.devicemanifest-ms

El archivo GUID.pcmetadata-ms se creó en un directorio local denominado 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

Nota:

Puede encontrar más información sobre esta herramienta en Información general de Cabarc.

Creación de BulkMetadataSubmission.xml

Esquema XML BulkMetadataSubmission

Un paquete de envío de metadatos masivo contiene un documento de BulkMetadataSubmission.xml, que tiene información que el Panel usa para crear experiencias con nombres descriptivos, organizar paquetes en experiencias, actualizar experiencias y marcar paquetes individuales como versión preliminar.

Los datos del documento BulkMetadataSubmission.xml tienen formato basado en el esquema XML BulkMetadataSubmission, que se describe a continuación.

Nota:

El documento XML se debe guardar mediante la codificación UTF-8.

BulkMetadataSubmission XML Schema NameSpace

A continuación se muestra el espacio de nombres del esquema XML PcMetadataSubmission: http://schemas.microsoft.com/Windows/2010/08/MetadataSubmission/BulkMetadataSubmission

Información general sobre elementos/atributos XML BulkMetadataSubmission

En la tabla siguiente se describen los elementos y atributos de metadatos del esquema XML BulkMetadataSubmission.

Element/Attributes Tipo de elemento/atributo Obligatorio/ opcional
Experiencia ExperienceType Obligatorio
ExperienceName xs:string Obligatorio
ExperienceId tns:GUIDType Opcionales
PackageList tns:PackageListType Obligatorio
PackageFileName PackageFileNameType Obligatorio
Vista previa xs:Boolean Requerido
locale xs:string Obligatorio
Qualification tns:QualificationType Obligatorio
LogoSubmissionIDList tns:LogoSubmissionIDListType Opcionales
LogoSubmissionID xs:integer Obligatorio
update xs:Boolean Obligatorio

Metadatos del esquema XML BulkMetadataSubmission

A continuación se incluyen los metadatos del esquema XML BulkMetadataSubmission:

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

Referencia del esquema XML BulkMetadataSubmission

El esquema XML BulkMetadataSubmission define los siguientes elementos y atributos:

  • BulkMetadataSubmission

    • Experiencia

      • ExperienceName

      • ExperienceID

      • PackageList

        • PackageFileName

          • Vista previa

          • locale

      • Qualification

      • LogoSubmissionIDList

        • LogoSubmissionID

      • update

Elemento Experience

El elemento Experience especifica información para una sola experiencia. Para obtener más información sobre las experiencias, consulte Referencia del esquema del paquete de metadatos de dispositivo para Windows 8.

En función de esta información, el Panel crea una experiencia con la información correcta y envía paquetes a esta experiencia, o actualiza una experiencia existente con nuevos paquetes.

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

Se puede usar más de un elemento Experience para especificar varias experiencias. Esto permite un único envío de muchos paquetes para diferentes dispositivos.

Por ejemplo, vea lo siguiente.

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

Elemento ExperienceName

El elemento ExperienceName especifica el nombre de una experiencia. El panel creará una experiencia con este nombre si se trata de una nueva experiencia. O bien, omite este valor cuando se trata de una actualización de una experiencia existente.

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

Elemento ExperienceId

El elemento ExperienceId especifica el GUID que es el Id. de experiencia. Este valor es necesario al actualizar una experiencia existente. El Panel usa este valor para identificar la experiencia que se va a actualizar.

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

Elemento PackageList

El elemento PackageList especifica la lista de metadatos de dispositivo o paquetes de manifiesto de dispositivo que se incluirán en una experiencia. El Panel usa esta información para agregar paquetes a una experiencia nueva o existente.

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

Elemento PackageFileName

El elemento PackageFileName especifica el nombre de archivo y la información de un único paquete de manifiesto de dispositivo o metadatos de dispositivo. El Panel usa esta información para agregar un paquete a una experiencia nueva o existente y marcar correctamente el paquete como versión preliminar si se indica. En función de los valores de vista previa y configuración regional, el panel también elimina los paquetes existentes si es necesario.

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

Los atributos preview y locale del elemento PackageFileName permiten que el panel actualice el paquete activo existente con un paquete recién enviado.

Por ejemplo, si ya existe un paquete en-US preview en la experiencia y se envió un paquete en-US preview en-US en un paquete de envío de metadatos masivo para la misma experiencia, el paquete existente se eliminaría automáticamente y se enviaría el nuevo paquete.

Por este motivo, también es importante tener cuidado al actualizar paquetes para evitar eliminaciones accidentales.

Atributo de vista previa

El atributo preview especifica si los metadatos de un dispositivo o un paquete de manifiesto de dispositivo deben marcarse como versión preliminar. Vea Elemento PackageFileName para obtener más información sobre cómo usa el panel este valor.

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

Atributo de configuración regional

El atributo de configuración regional especifica la configuración regional declarada (de PackageInfo.xml) de un paquete de manifiesto de dispositivo o metadatos de dispositivo debe marcarse como versión preliminar. Vea Elemento PackageFileName para obtener más información sobre cómo usa el panel este valor.

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

Elemento Qualification

El elemento Qualification especifica si el dispositivo tiene una certificación Logo, se incluye en la lista Del Acuerdo de distribución de controladores de bandeja de entrada (IDDA) o usa un controlador de bandeja de entrada de Microsoft. El panel usa esta información para garantizar la certificación correcta del dispositivo para el tipo de metadatos de dispositivo que va a enviar.

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

Las características como Device Stage no están disponibles para los dispositivos que no han superado la certificación logo y no están en la lista IDDA.

Puede seleccionar una de las dos opciones para cada experiencia. Estas opciones y sus definiciones se indican en la tabla siguiente:

Valor de enumeración Descripción
Logotipo o IDDA El dispositivo tiene una certificación logo o está en la lista idda. Si tiene una certificación logo, deberá especificar los identificadores de envío de logotipo específicos en el elemento LogoSubmissionIDList.
MicrosoftInboxDrive El dispositivo usa un controlador de bandeja de entrada de Microsoft. Es posible que algunas características de los metadatos del dispositivo no estén disponibles al usar este nivel de calificación (por ejemplo, fase del dispositivo).

Elemento LogoSubmissionIDList

El elemento LogoSubmissionIDList especifica la lista de certificaciones de logotipo para un dispositivo. Consulte Elemento De calificación para obtener más información sobre cómo usa el panel este valor.

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

Elemento LogoSubmissionID

El elemento LogoSubmissionID especifica una certificación de logotipo individual para un dispositivo. Consulte Elemento De calificación para obtener más información sobre cómo usa el panel este valor.

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

Se pueden usar varios elementos LogoSubmissionID para indicar varias certificaciones logo para un único dispositivo. Los usuarios deben enumerar todas las certificaciones de logotipo de su dispositivo en la lista. A continuación se muestra un ejemplo en el que se enumeran varias certificaciones de logotipo:

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

atributo update

El atributo update designa si se está actualizando o no una experiencia. El panel usa este valor para actualizar una experiencia mediante la eliminación de paquetes en conflicto y la carga de nuevos paquetes cuando el atributo update se establece en true. Cuando el atributo update se establece en false, el panel creará una nueva experiencia y cargará nuevos paquetes en él.

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

Ejemplo XML bulkMetadataSubmission

El siguiente documento XML usa el esquema XML BulkMetadataSubmission para especificar los componentes del documento XML BulkMetadataSubmission.

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