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

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

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

Примеры

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

А. Указание sql:hide для атрибута

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

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

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
  <xsd:element name="Person.Person" >
     <xsd:complexType>
       <xsd:attribute name="BusinessEntityID"  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.Person[@BusinessEntityID="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.Person 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="2005-08-01" /> 
    <Order CustomerID="1" OID="44501" OrderDate="2005-11-01" /> 
    <Order CustomerID="1" OID="45283" OrderDate="2006-02-01" /> 
    <Order CustomerID="1" OID="46042" OrderDate="2006-05-01" /> 
  </Customers>
</ROOT>