Criando elementos constantes usando sql:is-constant (SQLXML 4.0)

Para especificar um elemento constante, isto é, um elemento no esquema XSD que não seja mapeado para nenhuma tabela ou coluna do banco de dados, é possível usar a anotação sql:is-constant. Essa anotação usa um valor Booleano (0 = false, 1 = true). Os valores aceitáveis são 0, 1, true e false. A anotação sql:is-constant pode ser especificada em um elemento que não tem nenhum atributo. Se ela for especificada em um elemento com o valor true (ou 1), esse elemento não será mapeado para o banco de dados, mas ainda aparecerá no documento XML.

A anotação sql:is-constant pode ser usada para:

• Adicionar um elemento de nível superior ao documento XML. XML requer um único elemento de nível superior (elemento root) para o documento.

• Criar elementos de contêiner, como um elemento <Orders> que encapsula todas as ordens.

A anotação sql:is-constant pode ser adicionada a um elemento <complexType>.

Exemplos

Para criar exemplos de funcionamento usando os exemplos a seguir, é necessário atender a determinados requisitos. Para obter mais informações, consulte Requisitos para executar exemplos do SQLXML.

A. Especificando sql:is-constant para adicionar um elemento do contêiner.

Neste esquema XSD anotado, <CustomerOrders> é definido como um elemento constante especificando o atributo sql:is-constant com um valor de 1. Portanto, <CustomerOrders> não é mapeado para nenhuma tabela ou coluna de banco de dados. Esse elemento constante consiste nos elementos-filho <Order>.

Embora <CustomerOrders> não mapeie para nenhuma tabela ou coluna do banco de dados, ele ainda aparece no XML resultante como um elemento do contêiner que contém elementos-filho <Orders>.

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
<xsd:annotation>
  <xsd:appinfo>
    <sql:relationship name="CustOrders"
        parent="Sales.Customer"
        parent-key="CustomerID"
        child="Sales.SalesOrderHeader"
        child-key="CustomerID" />
  </xsd:appinfo>
</xsd:annotation>

  <xsd:element name="Customer" sql:relation="Sales.Customer" >
   <xsd:complexType>
     <xsd:sequence>
        <xsd:element name="CustomerOrders" sql:is-constant="1" >
          <xsd:complexType>
            <xsd:sequence>
              <xsd:element name="Order" sql:relation="Sales.SalesOrderHeader"
                           sql:relationship="CustOrders" 
                           maxOccurs="unbounded" >
                <xsd:complexType>
                   <xsd:attribute name="SalesOrderID" type="xsd:integer" />
                   <xsd:attribute name="OrderDate" type="xsd:date" />
                   <xsd:attribute name="CustomerID" type="xsd:string" />
                </xsd:complexType>
              </xsd:element>
            </xsd:sequence>
           </xsd:complexType>
          </xsd:element>
         </xsd:sequence>
          <xsd:attribute name="CustomerID" type="xsd:string" />
     </xsd:complexType>
  </xsd:element>
</xsd:schema>

Para testar uma consulta XPath de exemplo com relação ao esquema

1. Copie o código de esquema acima e cole-o em um arquivo de texto. Salve o arquivo como isConstant.xml.

2. Copie o modelo a seguir e cole-o em um arquivo de texto. Salve o arquivo como isConstantT.xml no mesmo diretório onde você salvou isConstant.xml.

   <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
       <sql:xpath-query mapping-schema="isConstant.xml">
           Customer[@CustomerID=1]
       </sql:xpath-query>
   </ROOT>
   

   O caminho de diretório especificado para o esquema de mapeamento (isConstant.xml) é relativo ao diretório onde o modelo está salvo. Também é possível especificar um caminho absoluto, por exemplo:

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

3. Crie e use o Script de Teste SQLXML 4.0 (Sqlxml4test.vbs) para executar o modelo.

   Para obter mais informações, consulte Usando o ADO para executar consultas SQLXML.

Este é o conjunto de resultados parcial:

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"> 
<Customer CustomerID="1"> 
  <CustomerOrders> 
    <Order SalesOrderID="43860" OrderDate="2001-08-01" CustomerID="1" /> 
    <Order SalesOrderID="44501" OrderDate="2001-11-01" CustomerID="1" /> 
    <Order SalesOrderID="45283" OrderDate="2002-02-01" CustomerID="1" /> 
    <Order SalesOrderID="46042" OrderDate="2002-05-01" CustomerID="1" /> 
    ...
  </CustomerOrders> 
</Customer> 
</ROOT>