Attributs XML

  • Article

Cette rubrique n’est pas à jour. Pour obtenir les informations les plus récentes, consultez la Spécification du schéma d’impression.

Il existe un certain nombre d’attributs XML qui apparaissent dans plusieurs types d’éléments définis dans l’infrastructure de schéma d’impression. Les attributs XML portant le même nom ont généralement la même signification et obéissent aux mêmes règles, quel que soit le type d’élément dans lequel ils résident. Par conséquent, les attributs XML sont répertoriés ici par nom et non par type d’élément de leur hôte. Les attributs XML définis en privé ne sont pas autorisés. Seuls les attributs XML définis ici peuvent être utilisés dans un document PrintCapabilities ou un PrintTicket, puis uniquement dans le contexte défini.

Bien que les parties privées ne soient pas autorisées à introduire de nouvelles définitions dans l’espace de noms d’un autre tiers, elles sont autorisées à utiliser des noms existants à partir d’un autre espace de noms privé tant que son utilisation est cohérente avec l’utilisation établie par l’autre partie. Ainsi, une option peut contenir des éléments ScoredProperty définis par plusieurs parties différentes, chacun résidant dans différents espaces de noms.

Nom de l’attribut Types de données et valeurs Objectif Notes
name
XML QName
 Cet attribut XML identifie l’instance d’élément. Il distingue un élément d’un autre du même type d’élément. Cet attribut XML est si largement utilisé qu’il est appelé attribut de nom.
 Les restrictions suivantes concernent l’attribut de nom.
  • L’attribut de nom doit être sous la forme d’un QName défini par XML valide. Autrement dit, il doit être qualifié par un espace de noms XML valide. Les QNames apparaissant sous forme de valeurs d’attributs de nom doivent être qualifiés explicitement par l’espace de noms même si un espace de noms par défaut est défini.
  • Le contenu de caractère doit être celui d’un QName défini par XML valide.
  • Les noms définis en privé doivent être qualifiés avec un espace de noms associé de manière unique à la partie qui a introduit l’attribut de nom.
  • Exigence d’unicité fraternelle : aucun élément frère appartenant au même type d’élément peut avoir le même attribut de nom. La seule exception est les éléments Option, où l’attribut de nom peut être utilisé pour définir une option. Par conséquent, plusieurs éléments Option frères peuvent avoir le même attribut de nom.
  • Les types d’éléments suivants peuvent contenir des attributs de nom : Property, ScoredProperty, ParameterDef, Option et Feature.
  • Les attributs de nom doivent apparaître dans chacun des types d’éléments qui les contiennent, sauf dans le cas de certains éléments d’option de schéma d’impression publics précédemment définis, tels que DocumentNUp.
L’exemple suivant montre comment identifier une instance d’option à l’aide d’un attribut « name ». Il s’agit du moyen approprié de définir des éléments Option. Un fournisseur ne doit pas avoir d’options non nommées, sauf si elles sont définies publiquement dans le schéma d’impression, comme DocumentNUp.
  <psf:Option name="psk:StapleBottomRight">
    \<psf:ScoredProperty name="psk:Angle">
      <psf:Value xsi:type="xs:integer">_Undefined_<psf:Value>
    </psf:ScoredProperty>
    <psf:ScoredProperty name="psk:SheetCapacity" >
      <psf:Value xsi:type="xs:integer">_Undefined_<psf:Value>
    <psf:ScoredProperty>
  </psf:Option>
propagate
Énumération
Aucune valeur n’est actuellement définie.
 L’attribut propagate n’est pas utilisé dans la version initiale de l’infrastructure de schéma d’impression. Il est documenté ici afin que le code de validation PrintCapabilities ou PrintTicket implémenté pour la version initiale de l’infrastructure de schéma d’impression puisse traiter les versions de schéma suivantes sans erreur.
constrained
Énumération
Valeurs autorisées :
  • Aucun
  • PrintTicketSettings
  • AdminSettings
  • DeviceSettings
Indique si l’option est disponible pour la sélection ou pour l’utilisation.
Les valeurs autorisées de l’attribut constrained ont les significations suivantes. Notez que ces valeurs sont répertoriées dans l’ordre, du moins restrictif (Aucun) au plus restrictif (DeviceSettings).
Aucun
  • L’option n’est pas limitée.
PrintTicketSettings
  • L’option est limitée par les paramètres PrintTicket. Cela implique que la modification de la configuration peut supprimer la contrainte.
AdminSettings
  • L’option est limitée par les paramètres de l’administrateur ; l’option ne peut pas être activée par l’utilisateur.
DeviceSettings
  • L’option est limitée par les paramètres de l’appareil ou les options d’appareil physiquement installées ; l’option ne peut pas être activée par l’utilisateur ou l’administrateur.
Lorsque le fournisseur PrintCapabilities signale des valeurs de l’attribut constrained, la contrainte la plus restrictive trouvée doit être signalée. Par exemple, si une option est limitée par un paramètre d’administrateur et un paramètre d’appareil, le fournisseur PrintCapabilities doit signaler DeviceSettings.
xmlns
URI
 Cet attribut XML établit un lien entre un URI (Uniform Resource Identifier) d’espace de noms et le préfixe d’espace de noms qui apparaît dans le QName XML. Vous devez établir un tel lien vers l’URI d’espace de noms défini pour l’infrastructure de schéma d’impression avant de pouvoir utiliser l’une des balises d’élément définies par l’infrastructure, des attributs, des attributs de nom, etc. Vous pouvez déclarer cet espace de noms comme étant la valeur par défaut pour éviter de qualifier réellement les balises d’élément avec un préfixe d’espace de noms, bien que tous les autres QNames doivent être qualifiés explicitement. L’espace de noms standard doit être défini dans l’élément racine approprié. Observez toutes les règles et conventions XML concernant l’utilisation de l’attribut xmlns.
L’URI de l’infrastructure de schéma d’impression est http://schemas.microsoft.com/windows/2003/08/printing/printschemaframework.
L’URI des mots clés de schéma d’impression est « https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords ».

Spécification du schéma d’impression