Fonctionnalité
Cette rubrique n’est pas à jour. Pour obtenir les informations les plus récentes, consultez la spécification du schéma d’impression.
Un élément Feature contient une liste complète des éléments option et Property qui décrivent entièrement un attribut d’appareil, un paramètre de mise en forme de tâche ou d’autres caractéristiques pertinentes.
Balise d’élément
<Fonctionnalité>
Attributs XML
Le tableau suivant répertorie les attributs XML qui peuvent être liés à cet élément.
| Attribut XML | Détails |
|---|---|
| name |
Contient le nom de la fonctionnalité, qu’il s’agisse d’une fonctionnalité standard ou d’une fonctionnalité définie en privé. |
Pour plus d’informations, consultez la section attributs XML .
Informations sur les éléments
Le tableau suivant répertorie les éléments qui peuvent être des parents de cet élément, les éléments qui peuvent être des enfants de cet élément, ainsi que toutes les restrictions applicables à l’élément lui-même.
| Category | Détails |
|---|---|
| Éléments parents |
PrintCapabilities PrintTicket Fonctionnalité |
| Éléments enfants |
Un des groupes suivants :
|
| Élément This |
Aucune donnée de caractères n’est autorisée. Les éléments d’option enfants dupliqués qui sont des frères sont autorisés. Raccourcis d’attribut de nom en double autorisés. |
Dépendances de configuration
Les éléments de fonctionnalité ne peuvent pas avoir de dépendances de configuration.
Utilisation des éléments
Relation aux attributs XML
Dans la représentation fonctionnalité/option, un attribut d’appareil est représenté par un élément de fonctionnalité. L’attribut d’appareil est identifié de manière unique par l’attribut Name dans l’élément Feature de l’attribut de périphérique, comme dans l’exemple suivant. Dans cet exemple, l’attribut d’appareil est Resolution.
<Feature name="Resolution" />
Le schéma d’impression définit un ensemble d’attributs de nom pour certaines instances de fonctionnalité. Ces attributs de nom servent à identifier un ensemble d’instances de fonctionnalités prédéfinies associées à des attributs d’appareil configurables spécifiques. Ces noms d’instances de fonctionnalités doivent être utilisés chaque fois que cela est possible, car ils augmentent la portabilité de votre document PrintCapabilities et les des PrintTicket dérivés de ceux-ci. Les instances de fonctionnalités définies de manière privée peuvent être introduites si certains attributs d’appareil ne correspondent à aucune des instances de fonctionnalités définies par schéma. Pour plus d’informations sur la syntaxe des attributs de nom et les conventions qui s’appliquent aux noms définis par le schéma et à la définition privée, consultez attributs XML.
Relation avec l’élément option
Chacun des États possibles est représenté par un élément option. Chaque définition d’option contient un ou plusieurs éléments ScoredProperty, qui, ensemble, décrivent de façon unique ou caractérisent l’État représenté. La technique utilisée pour créer des définitions d’options est décrite dans définitions d’options. Tous les éléments d’option associés à un élément de fonctionnalité particulier résident en tant qu’éléments enfants de l’élément de fonctionnalité.
Sous-composants
L’infrastructure du schéma d’impression permet également de regrouper les éléments de fonctionnalité de manière hiérarchique. Autrement dit, un élément Feature peut lui-même contenir un ou plusieurs éléments de fonctionnalités enfants (sous-fonctionnalités). Cela peut être utile pour organiser des éléments de fonctionnalités connexes ou pour des éléments de fonctionnalité qui contrôlent les aspects d’une fonctionnalité d’appareil. Par exemple, un appareil qui prend en charge l’agrafage. Un tel appareil peut offrir à l’utilisateur la possibilité de localiser l’agrafe, par exemple dans l’angle supérieur gauche, dans le coin supérieur droit, dans le bord supérieur ou sur le bord gauche. L’interface utilisateur de cet appareil doit être en mesure de présenter l’utilisateur avec les choix de niveau le plus élevé en premier, ce qui, dans ce cas, s’il faut utiliser l’agrafage. Une fois que l’utilisateur a décidé d’utiliser l’agrafage, il doit être présenté avec un deuxième niveau de choix, l’emplacement de l’agrafe. Une hiérarchie de fonctionnalités ajoute la structure supplémentaire qui rend cette interface utilisateur possible. L’infrastructure du schéma d’impression permet aux sous-fonctionnalités d’avoir leurs propres sous-fonctionnalités enfants, ce qui autorise un niveau illimité d’imbrication.
L’infrastructure du schéma d’impression permet également aux éléments d’option d’apparaître au même niveau que les sous-fonctionnalités ; autrement dit, en tant que frères dans le même élément de fonctionnalité parent. Cela permet à l’utilisateur de prendre la décision de haut niveau (s’il faut utiliser l’agrafage) avant d’effectuer les sélections de sous-fonctionnalités. Pour cet exemple, l’élément de fonctionnalité racine, « agrafe », peut contenir deux éléments option, « on » et « OFF », ainsi qu’une sous-fonctionnalité nommée « StapleLocation ».
Exemple
<psf:Feature name="psk:JobOutputBin">
<psf:Property name="psf:SelectionType">
<psf:Value xsi:type="xs:string">psk:PickOne</psf:Value>
</psf:Property>
<psf:Option constrained="psk:None">
<psf:ScoredProperty name="psk:Bin">
<psf:Value xsi:type="xs:string">SorterBin</psf:Value>
</psf:ScoredProperty>
<psf:ScoredProperty name="psk:MediaSheetCapacity">
<psf:Value xsi:type="xs:integer">100</psf:Value>
</psf:ScoredProperty>
</psf:Option>
</psf:Feature>