Especificación XML del diagrama de sintaxis

Una vez que haya creado un diagrama de sintaxis para el mandato de extensión, puede convertir el diagrama en una especificación XML de la sintaxis.

<Command xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xsi:noNamespaceSchemaLocation="extension.xsd" 
 Name="SPSSINC RASCH DEMO" Language="R" Mode="Source">
   <Subcommand Name="VARIABLES">
      <Parameter Name="ITEMS" ParameterType="VariableNameList"/>
   </Subcommand>
   <Subcommand Name="OPTIONS">
      <Parameter Name="MISSING" ParameterType="Keyword">
         <EnumValue Name="LISTWISE"/>
         <EnumValue Name="ALLAVAILABLE"/>
      </Parameter>
   </Subcommand>
   <Subcommand Name="HELP" Occurrence="Optional"/>
</Command>

La especificación XML del comando SPSSINC RASCH DEMO se muestra aquí. El elemento de nivel superior Command especifica el nombre del mandato de extensión así como el lenguaje de implementación, R, Python o Java.

El nombre del comando puede estar compuesto de hasta tres palabras separadas por espacios y sin distinguir entre mayúsculas y minúsculas, aunque la convención es el uso de las mayúsculas. Para reducir el riesgo de crear mandatos de extensión que entren en conflicto con mandatos o mandatos incorporados creados por otros usuarios, debe utilizar nombres de mandatos de dos o tres palabras, utilizando la primera palabra para especificar su organización, tal como se ha hecho aquí.

El atributo Mode en el elemento Command sólo se aplica a los mandatos de extensión implementados en R y especifica si el código de implementación está contenido en un archivo de origen R o en un paquete R. El valor Origen especifica el método de archivo de origen y se recomienda porque simplifica en gran medida la distribución de un mandato de extensión a otros usuarios.

Cada submandato se especifica con un elemento Subcommand . El atributo Occurrence es opcional y especifica si el submandato es necesario. De forma predeterminada, los submandatos son opcionales.

Los elementos Parameter describen las palabras clave asociadas con un subcomando. Hay muchos tipos de parámetros, como por ejemplo VariableNameList para especificar una lista de nombres de variables de IBM® SPSS® Statistics . Los valores especificados se comprueban para asegurar que son válidos para el tipo de parámetro concreto. Por ejemplo, los valores especificados para un parámetro VariableNameList se comprobarán para asegurarse de que representan nombres de variables IBM SPSS Statistics sintácticamente válidos (no se comprueba la existencia de las variables).

Los elementos EnumValue especifican valores permitidos para una palabra clave, como los valores LISTWISE y ALLAVAILABLE para la palabra clave MISSING en este ejemplo.

El subcomando opcional HELP mostrará ayuda para el comando de extensión. Es una convención recomendada para comandos de extensión. La ayuda se proporciona en un archivo HTML independiente, que se visualiza cuando el usuario especifica el submandato HELP .

No hay restricciones del nombre del archivo de especificación XML, aunque se debe utilizar una convención útil es utilizar el nombre del comando de extensión en mayúsculas, con los espacios sustituidos por caracteres de subrayado. La especificación XML del ejemplo actual se puede encontrar en el archivo SPSSINC_RASCH_DEMO.xml, disponible en el directorio Samples (bajo el directorio de instalación).

siguiente