Sdílet prostřednictvím

Odeslání hromadného balíčku metadat

Odeslání hromadného balíčku metadat:

  1. Podepište balíček hromadných metadat pomocí nástroje SignTool.

  2. Přihlaste se k řídicímu panelu z webu Hardware Dev Center nebo Windows Dev Center pomocí účtu Microsoft.

  3. V části Metadata zařízeníklikněte na Vytvořit hromadné odeslání.

  4. Vyhledejte a vyberte nový hromadný balíček metadat a potom klikněte na Odeslat.

Vytvoření balíčku hromadného odeslání

Balíček hromadného odeslání metadat je formát balíčku, ve kterém lze odeslat více balíčků metadat zařízení na řídicí panel.

Balíčky hromadného odesílání metadat by se měly nahrát na řídicí panel pomocí funkce hromadného odeslání. Tato funkce odebere uživatelské rozhraní pro vytváření prostředí, aby se usnadnilo nahrávání více balíčků metadat současně. Informace pro vytváření zážitků a úpravy atributů balíčku jsou obsaženy v dokumentu BulkMetadataSubmission XML.

Do hromadného balíčku lze zahrnout maximálně 50 souborů devicemetadata-ms nebo devicemanifest-ms.

Informace o použití Průvodce odesláním metadat zařízení k vytvoření hromadného balíčku metadat naleznete v tématu Vytvoření balíčku pro odesílání metadat zařízení v sadě Visual Studio.

Obsah balíčku hromadného odeslání metadat

Každý balíček hromadného odesílání metadat se skládá z následujících komponent:

  • Balíčky metadat zařízení

    Balíčky metadat zařízení obsahují informace a grafiku pro zobrazení ikon zařízení, nastavení akcí a využití funkcí prostředí zařízení.

  • Balíčky manifestu zařízení

    Balíčky manifestu zařízení obsahují informace pro ověření balíčků metadat zařízení.

  • XML dokument hromadného podání metadat

    Tento dokument obsahuje data použitá k správnému odeslání balíčků bez uživatelského rozhraní. Řídicí panel používá informace v tomto dokumentu k vytváření prostředí s přátelskými názvy, uspořádání balíčků do prostředí, aktualizaci prostředí a označení jednotlivých balíčků jako náhledové verze.

Poznámka:

Dokumenty XML musí být uloženy pomocí kódování UTF-8.

Do balíčku hromadného odeslání metadat musíte zahrnout alespoň jedno metadata zařízení nebo balíček manifestu zařízení.

Struktura balíčku hromadného odeslání metadat

Komponenty balíčku hromadného odeslání metadat jsou uloženy v komprimovaném souboru CAB. Název souboru musí mít příponu .bulkmetadata-ms.

Každý balíček hromadného odeslání metadat musí mít následující strukturu:

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

Název souboru 1, Název_souboru2, Název_souboru3, Název_souboru4 atd., musí být identifikátory GUID.

Pokud chcete vytvořit BulkMetadataSubmission.xml, přečtěte si část Vytvoření BulkMetadataSubmission.xml níže.

Informace o vývoji balíčku metadat zařízení *.devicemetadata-ms naleznete v tématu Referenční informace o schématu balíčku metadat zařízení pro systém Windows 8.

Pokud chcete vyvíjet balíček manifestu zařízení, *.devicemanifest-ms, přečtěte si Odeslání balíčku manifestu zařízení počítače.

Tyto balíčky CAB můžete vytvořit pomocí nástroje Cabarc. Další informace o tomto nástroji naleznete v tématu Cabarc Overview.

Při vytváření souboru *.bulkmetadata-ms pomocí nástroje Cabarc je nutné vytvořit místní adresář, ve kterém jsou balíčky metadat zařízení (*.devicemetadata-ms), balíčky manifestu zařízení (*.devicemanifest-ms) a dokument XML BulkMetadataSubmission jsou v kořenovém adresáři.

Poznámky

  • Názvy souborů .devicemetadata-ms a .devicemanifest-ms musí určovat identifikátor GUID bez oddělovačů složené závorky ({}).

  • Identifikátor GUID pro každý balíček metadat zařízení a balíček manifestu zařízení musí být jedinečný. Při vytváření nového nebo revidovaného balíčku je nutné vytvořit nový identifikátor GUID.

  • Další podrobnosti o tom, jak vytvořit soubory kabinetů, naleznete v Microsoft Cabinet SDK.

Příklad

Následuje příklad použití nástroje Cabarc k vytvoření souboru .bulkmetadata-ms. V tomto příkladu jsou komponenty hromadného souboru metadat umístěny v místním adresáři s názvem BulkPackages:

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

Soubor GUID.pcmetadata-ms byl vytvořen v místním adresáři s názvem 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

Poznámka:

Další informace o tomto nástroji najdete v Cabarc Overview.

Vytváření BulkMetadataSubmission.xml

Schéma XML pro hromadné odeslání metadat

Balíček hromadného odeslání metadat obsahuje jeden BulkMetadataSubmission.xml dokument, který obsahuje informace, jež řídicí panel používá k vytváření zážitků s přívětivými názvy, uspořádání balíčků do zážitků, aktualizaci zážitků a označení jednotlivých balíčků jako náhled.

Data v dokumentu BulkMetadataSubmission.xml jsou formátovaná na základě schématu XML BulkMetadataSubmission, které je popsáno níže.

Poznámka:

Dokument XML musí být uložen pomocí kódování UTF-8.

BulkMetadataSubmission XML Schema NameSpace

Následuje obor názvů XML schématu PCMetadataSubmission: http://schemas.microsoft.com/Windows/2010/08/MetadataSubmission/BulkMetadataSubmission

Přehled elementů a atributů XML BulkMetadataSubmission

Následující tabulka popisuje prvky metadat a atributy schématu BulkMetadataSubmission XML.

Element/Atributy Typ elementu nebo atributu Povinné nebo volitelné
Zkušenost Typ zkušenosti Povinné
NázevZážitku xs:string Povinné
ExperienceId tns:GUIDType Volitelný
Seznam balíčků tns:PackageListType Povinné
PackageFileName Typ názvu souboru balíčku Povinné
náhled xs:Boolean Povinné
lokalita xs:string Povinné
Kvalifikace tns:TypKvalifikace Povinné
SeznamIDPříspěvkůLoga tns:LogoSubmissionIDListType Volitelný
PředloženíLogoID xs:integer Povinné
aktualizace xs:Boolean Povinné

Metadata schématu BULKMetadataSubmission XML

Následuje metadata schématu 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>

Referenční dokumentace XML schématu BulkMetadataSubmission

Schéma XML BulkMetadataSubmission definuje následující prvky a atributy:

  • Hromadné odesílání metadat

    • Zážitek

      • NázevZkušenosti

      • Id zkušenosti

      • Seznam balíčků

        • PackageFileName

          • náhled

          • lokalita

      • Kvalifikace

      • SeznamIDLogoPodání

        • ID Přihlášky Loga

      • aktualizace

Prvek Zkušenosti

Element Experience určuje informace pro jedno prostředí. Další informace o zkušenostech naleznete v tématu Referenční informace o schématu balíčku metadat zařízení pro systém Windows 8.

Na základě těchto informací řídicí panel buď vytvoří prostředí se správnými informacemi a odešle do tohoto prostředí balíčky, nebo aktualizuje stávající prostředí s novými balíčky.

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

Více než jeden prvek Experience lze použít k určení několika zkušeností. To umožňuje jedno odeslání mnoha balíčků pro různá zařízení.

Podívejte se například na následující informace.

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

Prvek ExperienceName

Element ExperienceName určuje název prostředí. Pokud se jedná o nové prostředí, řídicí panel vytvoří prostředí s tímto názvem. Nebo tuto hodnotu ignoruje, pokud se jedná o aktualizaci existujícího prostředí.

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

ExperienceId Element

Element ExperienceId určuje identifikátor GUID, který je ID zkušenosti. Tato hodnota se vyžaduje při aktualizaci existujícího prostředí. Řídicí panel používá tuto hodnotu k identifikaci prostředí, které se má aktualizovat.

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

Prvek PackageList

Element PackageList určuje seznam metadat zařízení nebo balíčků manifestu zařízení, které se mají zahrnout do prostředí. Řídicí panel používá tyto informace k přidání balíčků do nového nebo existujícího prostředí.

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

Element PackageFileName určuje název souboru a informace jednoho metadat zařízení nebo balíčku manifestu zařízení. Řídicí panel používá tyto informace k přidání balíčku do nového nebo existujícího prostředí a správně ho označí jako náhled, pokud je to uvedeno. Na základě náhledu a hodnot národního prostředí řídicí panel také v případě potřeby odstraní existující balíčky.

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

Atributy náhledu a národního prostředí elementu PackageFileName umožňují řídicímu panelu aktualizovat existující živý balíček nově odeslaným balíčkem.

Pokud například v prostředí již existuje balíček en-US preview a balíček en-US Preview byl odeslán v balíčku hromadného odeslání metadat pro stejné prostředí, stávající balíček se automaticky odstraní a nový balíček se odešle.

Z tohoto důvodu je také důležité při aktualizaci balíčků dávat pozor, aby nedošlo k náhodnému odstranění.

Preview – atribut

Atribut náhledu určuje, zda by metadata zařízení nebo balíček manifestu zařízení měly být označeny jako náhled. Další informace o tom, jak řídicí panel používá tuto hodnotu, naleznete v elementu PackageFileName.

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

atribut lokále

Atribut národního prostředí určuje deklarované národní prostředí (z PackageInfo.xml) metadat zařízení nebo balíčku manifestu zařízení by mělo být označeno jako preview. Další informace o tom, jak řídicí panel používá tuto hodnotu, naleznete v elementu PackageFileName.

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

Prvek kvalifikace

Prvek kvalifikace určuje, jestli má zařízení certifikaci loga, je součástí seznamu Smlouvy o distribuci ovladačů doručené pošty (IDDA) nebo používá ovladač doručené pošty Microsoftu. Řídicí panel používá tyto informace k zajištění správné certifikace zařízení pro typ metadat zařízení, která odesíláte.

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

Funkce, jako je fáze zařízení, nejsou k dispozici pro zařízení, která neprošla certifikací loga a nejsou v seznamu IDDA.

Pro každé prostředí můžete vybrat jednu ze dvou možností. Tyto možnosti a jejich definice jsou uvedené v následující tabulce:

Hodnota výčtu Popis
Logo/IDDA Vaše zařízení má certifikaci loga nebo je v seznamu IDDA. Pokud máte certifikaci loga, budete muset zadat konkrétní ID odeslání loga v elementu LogoSubmissionIDList.
MicrosoftInboxDrive Vaše zařízení používá ovladač doručené pošty Microsoftu. Některé funkce metadat zařízení nemusí být při použití této úrovně kvalifikace (například Device Stage) dostupné.

LogoSubmissionIDList Element

Element LogoSubmissionIDList určuje seznam certifikací loga pro zařízení. Další informace o tom, jak řídicí panel používá tuto hodnotu, najdete v části Prvek kvalifikace.

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

Element LogoSubmissionID určuje individuální certifikaci loga pro zařízení. Další informace o tom, jak řídicí panel používá tuto hodnotu, najdete v části Prvek kvalifikace.

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

Více prvků LogoSubmissionID lze použít k označení více certifikací loga pro jedno zařízení. Uživatelé by měli zobrazit seznam všech certifikací loga pro své zařízení v seznamu. Následuje příklad, ve kterém je uvedeno více certifikací loga:

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

aktualizovat atribut

Atribut aktualizace určuje, jestli se prostředí aktualizuje nebo ne. Řídicí panel používá tuto hodnotu k aktualizaci prostředí odstraněním konfliktních balíčků a nahrání nových balíčků, když je atribut aktualizace nastaven na hodnotu true. Když je atribut aktualizace nastavený na false, řídicí panel vytvoří nové prostředí a nahraje do něj nové balíčky.

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

Příklad XML BulkMetadataSubmission

Následující dokument XML používá schéma BulkMetadataSubmission XML k určení komponent bulkMetadataSubmission XML dokumentu.

<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>
  • Last updated on