Ejercicio 3: Rellenado del script Ant

En este ejercicio se muestra cómo editar el script Ant de Apache para publicar un informe.

Antes de empezar, debe completar el Ejercicio 2: Creación y configuración del script Ant.

Adición de una publicación de un elemento web al script Ant

Para añadir los elementos que publicar en el script Ant, siga los pasos que se indican a continuación:
  1. En la vista Navegador o Explorador de modelos, efectúe una doble pulsación en el script Ant publish.xml.
  2. En la ventana Editor Ant, escriba <pr Control+Espacio para añadir el elemento <project>. La ventana para completar el elemento emerge con el elemento <project>. Especifique un nombre en el atributo default. Por ejemplo, <project default="foo"></project>
  3. Sitúe el cursor delante de la etiqueta </project> de cierre y escriba <ta Control+Espacio para añadir la etiqueta <target>.
  4. En la lista de elementos posibles, efectúe una doble pulsación en <target>. Especifique un nombre para el atributo Name. Por ejemplo, <target name="foo"> </target>
  5. Sitúe el cursor delante de la etiqueta </target> de cierre y escriba <pub Control+Espacio para añadir la etiqueta <target>.
  6. En la lista de elementos posibles, efectúe una doble pulsación en <PublishModel>.
  7. Entre el nombre de la vía de acceso completa para SimpleUMLModel como valor del atributo modelPath. Para ver el nombre de la vía de acceso, seleccione el modelo en el Navegador o Explorador de modelos y pulse el botón derecho del ratón sobre Propiedades. Corte y pegue el valor de Location y, a continuación, pulse Cancelar en el recuadro de diálogo Propiedades.
  8. Mueva el cursor y sitúelo en cualquier lugar sobre "fully_qualified_path_to_the_output_folder", efectúe una doble pulsación y entre el nombre de la vía de acceso completa de la carpeta de salida en el atributo outputFolder.
    Nota: La carpeta debe existir.
    Por ejemplo, entre c:\pub\web.
  9. Deje que los demás atributos utilicen los valores por omisión.

Adición de un elemento de informe de publicación al script Ant

Para añadir los elementos que publicar en el script Ant, siga los pasos que se indican a continuación:
  1. Sitúe el cursor delante de la etiqueta </target> de cierre y escriba <pub Control+Espacio para añadir la etiqueta <target>.
  2. En la lista de elementos posibles, efectúe una doble pulsación en <PublishReport>.
  3. Entre el nombre de la vía de acceso completa para SimpleUMLModel como valor del atributo modelPath. Para ver el nombre de la vía de acceso, seleccione el modelo en el Explorador de modelos y pulse el botón derecho del ratón sobre Propiedades. Corte y pegue el valor de Location y, a continuación, pulse Cancelar en el recuadro de diálogo Propiedades. Por ejemplo, C:\Documents and Settings\user1\ws1\SimpleUMLProject\SimpleUMLModel.emx.
  4. Mueva el cursor y sitúelo en cualquier lugar sobre "fully_qualified_path_to_the_output_folder", efectúe una doble pulsación y entre el nombre de la vía de acceso completa de la carpeta de salida en el atributo outputFolder.
    Nota: La carpeta debe existir.
    Por ejemplo, entre c:\pub\rpt.
  5. Mueva el cursor y sitúelo en cualquier lugar sobre "file_name_to_use", efectúe una doble pulsación y entre el nombre de informe "Sample UML Metrics Report" en el atributo ReportName.
  6. Deje que los demás atributos utilicen los valores por omisión.
  7. Pulse Archivo > Guardar para guardar el archivo.
El script Ant ahora debe contener los elementos siguientes (tenga en cuenta que los valores de atributo pueden ser diferentes):
<project default="foo">
  <target name="foo">
<!-- ===================================================================
      modelPath: required parameter, fully qualified path(FQP) to the model to publish
      outputFolder: required parameter fully qualified path(FQP) to folder to publish to
     =================================================================== -->

    <com.ibm.xtools.publish.CLModelPublish
      modelPath="C:\Documents and Settings\user1\ws1\SimpleUMLProject\SimpleUMLModel.emx"
      outputFolder="C:\myWebs\FooWeb"
      overwriteExisting="true"
      preview="false"
      showIcons="true"
      diagramImageFormat="gif"
      detailLevel="full"
      errorHandling="ignore"/>

<!-- ===================================================================
      modelPath: required parameter, fully qualified path(FQP) to the model to publish
      targetOutputFolder: required parameter, fully qualified path(FQP) to folder to publish to
      targetOutputFile: required parameter, file name of the report
      =================================================================== -->
    <com.ibm.xtools.publish.CLReportPublish
      modelPath="C:\Documents and Settings\user1\ws1\SimpleUMLProject\SimpleUMLModel.emx"
      targetOutputFolder="c:\myRpts\simpleRpt"
      targetOutputFile="metric.pdf"
      reportName="Sample UML Metric Report"
      overwriteExisting="true"
      autoShowPublishedOutput="false"
      errorHandling="ignore"/>
  </target>
</project>

Ahora ya está preparado para empezar el Ejercicio 4: Prueba y establecimiento de la ejecución automática del script Ant.

Comentarios
(C) Copyright IBM Corporation 2005. Todos los derechos reservados.