Atributos XML

  • Artículo

Este tema no está actualizado. Para obtener la información más reciente, consulte la Especificación de esquema de impresión.

Hay una serie de atributos XML que aparecen en varios tipos de elementos definidos en el marco de esquema de impresión. Los atributos XML con el mismo nombre suelen tener el mismo significado y obedecer las mismas reglas independientemente del tipo de elemento en el que residen. Por lo tanto, los atributos XML se enumeran aquí por nombre y no por su tipo de elemento host. No se permiten atributos XML definidos de forma privada. Solo los atributos XML definidos aquí se pueden usar en un documento PrintCapabilities o printTicket y, a continuación, solo en el contexto definido.

Aunque no se permite a las partes privadas introducir nuevas definiciones en el espacio de nombres de otra entidad, se les permite utilizar nombres existentes de otro espacio de nombres privado siempre que su uso sea coherente con el uso establecido por la otra parte. Por lo tanto, una opción puede contener elementos ScoredProperty definidos por varias partes diferentes, cada una de las cuales reside en diferentes espacios de nombres.

Nombre del atributo Tipos de datos y valores Propósito Notas
name
XML QName
 Este atributo XML identifica la instancia de elemento. Distingue un elemento de otro del mismo tipo de elemento. Este atributo XML se usa tan ampliamente que se lo conoce como atributo de nombre.
 Las siguientes restricciones pertenecen al atributo de nombre.
  • El atributo de nombre debe tener el formato de un QName definido en XML válido. Es decir, debe estar calificado por un espacio de nombres XML válido. Los QNames que aparecen como valores de atributos de nombre deben estar calificados explícitamente como espacio de nombres incluso si se define un espacio de nombres predeterminado.
  • El contenido de caracteres debe ser el de un QName definido por XML válido.
  • Los nombres definidos de forma privada deben estar calificados con un espacio de nombres que esté asociado de forma exclusiva con la parte que introdujo el atributo de nombre.
  • Requisito de unicidad del mismo nivel: no puede haber dos elementos del mismo nivel que pertenezcan al mismo tipo de elemento. La única excepción es los elementos Option, donde se puede usar el atributo name para definir una opción. Por lo tanto, los elementos de opción de varios hermanos pueden tener el mismo atributo de nombre.
  • Los siguientes tipos de elementos pueden contener atributos de nombre: Propiedad, ScoredProperty, ParameterDef, Option y Feature.
  • Los atributos de nombre deben aparecer en cada uno de los tipos de elementos que los contienen, excepto en el caso de algunos elementos públicos de Opción de esquema de impresión previamente definidos, como DocumentNUp.
El siguiente ejemplo muestra cómo identificar una instancia de Opción usando un atributo 'nombre'. Esta es la forma correcta de definir elementos de opción. Un proveedor no debe tener opciones sin nombre, a menos que estén definidas públicamente en el esquema de impresión, como 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>
propagar
Enumeración
Actualmente no se define ningún valor.
 El atributo de propagación no se utiliza en la versión inicial de Print Schema Framework. Está documentado aquí para que el código de validación PrintCapabilities o PrintTicket implementado para la versión inicial de Print Schema Framework pueda procesar cualquier versión posterior del esquema sin errores.
limitado
Enumeración
Valores permitidos:
  • Ninguno
  • PrintTicketSettings
  • AdminSettings
  • DeviceSettings
Indica si la opción está disponible para la selección o para su uso.
Los valores permitidos del atributo restringido tienen los significados siguientes. Tenga en cuenta que estos valores se enumeran en orden, de menos restrictivo (Ninguno) a más restrictivo (DeviceSettings).
Ninguno
  • La opción no está restringida.
PrintTicketSettings
  • La opción está restringida por la configuración de PrintTicket. Esto implica que cambiar la configuración puede quitar la restricción.
AdminSettings
  • La opción está restringida por la configuración del administrador; el usuario no puede habilitar la opción.
DeviceSettings
  • La opción está restringida por la configuración del dispositivo o las opciones de dispositivo instaladas físicamente; el usuario o el administrador no pueden habilitar la opción.
Cuando el proveedor PrintCapabilities notifica los valores del atributo restringido, se debe notificar la restricción más restrictiva. Por ejemplo, si una opción está restringida por una configuración de administrador y una configuración de dispositivo, el proveedor PrintCapabilities debe notificar DeviceSettings.
xmlns
URI
 Este atributo XML establece un vínculo entre un identificador uniforme de recursos de espacio de nombres (URI) y el prefijo de espacio de nombres que aparece en el QName XML. Debe establecer dicho vínculo al URI del espacio de nombres definido para Print Schema Framework antes de poder utilizar cualquiera de las etiquetas de elementos, atributos, atributos de nombre, etc. definidos por el Framework. Puede declarar este espacio de nombres como predeterminado para evitar calificar las etiquetas de elementos con un prefijo de espacio de nombres, aunque todos los demás QName deben calificarse explícitamente. El espacio de nombres estándar debe definirse en el elemento raíz adecuado. Observe todas las reglas y convenciones XML relativas al uso del atributo xmlns.
El URI del marco de esquema de impresión es http://schemas.microsoft.com/windows/2003/08/printing/printschemaframework.
El URI de las palabras clave del esquema de impresión es "https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords".

Especificación de esquema de impresión