Versão de documentos XML

Os procedimentos armazenados da API SQL comum suportam múltiplas versões dos três documentos de parâmetros XML: documentos de entrada XML, documentos de saída XML e documentos de mensagem XML.

Se a estrutura, os atributos ou os tipos em um documento de parâmetros XML mudarem, a versão do documento de parâmetros XML mudará. Portanto, o conteúdo do documento de parâmetros XML varia dependendo da versão especificada.

A versão de todos os três documentos permanece sincronizada ao chamar um procedimento armazenado. Por exemplo, se você chamar o procedimento armazenado GET_SYSTEM_INFO e especificar o parâmetro major_version como 1 e o parâmetro minor_version como 1, os documentos de entrada XML, saída XML e mensagem XML serão documentos da Versão 1.1.

As informações da versão em um documento de parâmetros XML são expressas como pares de chave e valor para Document Type Major Version e Document Type Minor Version. Por exemplo, um documento de saída XML pode definir as chaves e os valores a seguir em um elemento de dicionário:
   <key>Document Type Name</key><string>Data Server Configuration Output</string>
   <key>Document Type Major Version</key><integer>2</integer>
   <key>Document Type Minor Version</key><integer>0</integer>

Para determinar a versão mais recente suportada do documento para um procedimento armazenado, especifique NULL para o parâmetro major_version, o parâmetro minor_version e todos os outros parâmetros necessários. O procedimento armazenado retorna a versão mais alta suportada do documento como valores nos parâmetros de saída major_version e minor_version e configura os parâmetros de saída xml_output e xml_message como NULL.

Se especificar valores não nulos para os parâmetros major_version e minor_version, você deverá especificar uma versão do documento que seja suportada. Se a versão for inválida, o procedimento armazenado retornará um erro (-20457).

Se o documento de entrada XML no parâmetro xml_input especificar as chaves Document Type Major Version e Document Type Minor Version, o valor para essas chaves deverá ser igual aos valores especificados nos parâmetros major_version e minor_version ou um erro (+20458) será mostrado.