Скрытие элементов и атрибутов при помощи sql:hide

Когда запрос XPath направляется к XSD-схеме, результирующий XML-документ располагает элементами и атрибутами, указанными в схеме. Можно указать, что некоторые элементы и атрибуты скрыты в схеме с использованием заметки sql:hide. Это полезно, когда критерий выбора запроса требует определенных элементов или атрибутов в схеме, но их не нужно возвращать в формируемом XML-документе.

Заметка sql:hide имеет логическое значение (0 = false, 1 = true). Допустимые значения: 0, 1, true и false.

Примеры

Чтобы создать рабочие образцы на основе следующих примеров, необходимо выполнить определенные требования. Дополнительные сведения см. в разделе Требования к запуску примеров SQLXML.

А. Указание sql:relationship на атрибуте

XSD-схема в этом примере состоит из элемента <Person.Contact> с атрибутами ContactID, FirstName, and LastName.

Элемент <Person.Contact> относится к сложному типу и поэтому сопоставляется таблице с тем же именем (сопоставление по умолчанию). Все атрибуты элемента <Person.Contact> относятся к простому типу и сопоставляются столбцам с теми же именами в таблице Person.Contact в базе данных AdventureWorks. В схеме задана заметка sql:hide на атрибуте ContactID. Если указан запрос XPath для этой схемы, атрибут ContactID не возвращается в XML-документе.

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"             xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  <xsd:element name="Person.Contact" >     <xsd:complexType>       <xsd:attribute name="ContactID"  sql:hide="true" />        <xsd:attribute name="FirstName"   type="xsd:string" />        <xsd:attribute name="LastName"    type="xsd:string" />      </xsd:complexType>  </xsd:element></xsd:schema>

Проверка образца запроса XPath к схеме

  1. Скопируйте приведенный выше код схемы и вставьте его в текстовый файл. Сохраните файл с именем Hide.xml.

  2. Скопируйте следующий шаблон и вставьте его в текстовый файл. Сохраните файл под именем HideT.xml в том же каталоге, где был сохранен файл HideT.xml.

    <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">    <sql:xpath-query mapping-schema="Hide.xml">        /Person.Contact[@ContactID="1"]    </sql:xpath-query></ROOT>

    Путь к каталогу схемы сопоставления (файл Hide.xml) задается относительно каталога, в котором сохранен шаблон. Можно также задать абсолютный путь, например:

    mapping-schema="C:\MyDir\Hide.xml"

  3. Создайте и запустите тестовый сценарий SQLXML 4.0 (Sqlxml4test.vbs), чтобы выполнить шаблон.

    Дополнительные сведения см. в разделе Использование ADO для выполнения запросов SQLXML 4.0.

Полученный результирующий набор показан ниже.

 <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">    <Person.Contact FirstName="Gustavo" LastName="Achong" />  </ROOT>

Если на элементе указана заметка sql:hide, элемент и его атрибуты или дочерние элементы не отображаются в созданном XML-документе. Ниже приведена еще одна XSD-схема, в которой задана sql:hide на элементе <OD>:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"            xmlns:dt="urn:schemas-microsoft-com:datatypes"            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  <xsd:annotation>    <xsd:documentation>      Sales.Customer-Sales.SalesOrderHeader-Sales.SalesOrderDetail Schema      Copyright 2004 Microsoft. All rights reserved.    </xsd:documentation>    <xsd:appinfo>      <sql:relationship name="CustomerOrder"         parent="Sales.Customer"                  parent-key="CustomerID"                  child-key="CustomerID"                  child="Sales.SalesOrderHeader" />       <sql:relationship name="OrderOrderDetails"                  parent="Sales.SalesOrderHeader"                  parent-key="SalesOrderID"                  child-key="SalesOrderID"                  child="Sales.SalesOrderDetail"/>    </xsd:appinfo>  </xsd:annotation>  <xsd:element name="Customers" sql:relation="Sales.Customer">    <xsd:complexType>      <xsd:sequence>        <xsd:element name="Order" sql:relation="Sales.SalesOrderHeader"                      maxOccurs="unbounded"                      sql:relationship="CustomerOrder">          <xsd:complexType>            <xsd:sequence>               <xsd:element name="OD" sql:relation="Sales.SalesOrderDetail"                                       maxOccurs="unbounded"                                       sql:relationship="OrderOrderDetails"                                       sql:hide="1">                  <xsd:complexType>                    <xsd:attribute name="SalesOrderID" type="xsd:string"/>                    <xsd:attribute name="ProductID" type="xsd:string"/>                  </xsd:complexType>               </xsd:element>            </xsd:sequence>          <xsd:attribute name="CustomerID" type="xsd:string"/>          <xsd:attribute name="OID" sql:field="SalesOrderID"                                     type="xsd:string"/>          <xsd:attribute name="OrderDate" type="xsd:date"/>         </xsd:complexType>      </xsd:element>    </xsd:sequence>    <xsd:attribute name="CID" sql:field="CustomerID"                                 type="xsd:string"/>    </xsd:complexType>  </xsd:element></xsd:schema>

Если запрос XPath (например, /Customers[@CID="1"]) указан для этой схеме, сформированный XML-документ не включает элемент <OD> и его потомков, как показано в этом частичном результате.

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  <Customers CID="1">    <Order CustomerID="1" OID="43860" OrderDate="2001-08-01" />     <Order CustomerID="1" OID="44501" OrderDate="2001-11-01" />     <Order CustomerID="1" OID="45283" OrderDate="2002-02-01" />     <Order CustomerID="1" OID="46042" OrderDate="2002-05-01" />   </Customers></ROOT>
  • Last updated on