La galería de herramientas de secuencias de comandos y modelos es un gran recurso para principiantes y expertos. Al enviar herramientas y flujos de trabajo de geoprocesamiento a esta galería, ayudará a miles de usuarios a solucionar los flujos de trabajo diarios. Hemos oído muchas historias sobre usuarios que han descargado entradas que les permitieron ahorrar un gran número de horas y días.

Si se está planteando realizar un envío a la galería, tómese unos minutos para leer estas directrices. Al seguir estas directrices, aumentan considerablemente las probabilidades de que su envío se encuentre, descargue y utilice con gran éxito.

También se facilita una lista de comprobación que le ayudará a crear el envío.

+Para agregar una entrada a la galería de herramientas de comandos y modelos, vaya a la galería y haga clic en "Agregar una entrada". A continuación, se le pedirá que facilite, entre otras cosas:

  • máxima
  • Descripción
  • Etiquetas
  • Archivo zip

Las directrices siguientes son sugerencias para:

  • Estructura y contenido del archivo zip
  • Elegir la versión correcta
  • Contenido de la descripción
  • Título del envío
  • Nombre de la caja de herramientas
  • Etiquetas que utilizará para el envío

Estructura y contenido del archivo Zip

Carpeta raíz

La carpeta raíz contiene su caja de herramientas y todos los recursos compatibles con sus herramientas, como los comandos, datos y documentos de mapa. Todos los recursos deben residir en la carpeta raíz o en sus subcarpetas, tal y como se ilustra a continuación.

A continuación se enumera el contenido de las subcarpetas. Para obtener más información, consulte el tema de ayuda de Desktop Estructura para compartir herramientas.

  • ToolData: contiene todos los datos (como clases de entidades) utilizados por las herramientas. Normalmente, contiene geodatabases de archivos, rasters y archivos de capas (.lyr).
  • Scripts: contiene las secuencias de comandos (como archivos .py) para cualquier herramienta de secuencias de comandos que desee enviar. Tenga en cuenta que en ArcGIS 10.0 puede incorporar su código de secuencia de comandos con la herramienta, por lo que es posible que no necesite esta subcarpeta.
  • Scratch: esta subcarpeta se puede utilizar para escribir datos intermedios en modelos y datos temporales en secuencias de comandos. Normalmente contiene una geodatabase de archivo denominada "scratch". Por lo general, no se necesita esta carpeta.
  • Doc: contiene todo lo que ayude al destinatario a comprender las herramientas, como archivos .pdf, .docx, .chm y .pptx. También contiene cualquier imagen utilizada en diagramas de modelo.

Al crear el archivo zip, agregue la carpeta raíz, no el contenido individual de la carpeta raíz, tal y como se ilustra a continuación.

Establezca rutas relativas

Si el envío contiene datos, deberá establecer rutas relativas en las herramientas y los documentos de mapa tal y como se describe en el tema de ayuda de Desktop Rutas explicadas: absoluta, relativa, UNC y URL.

Pruebe su archivo zip

Antes de cargar el archivo zip en la galería, entrégueselo a un compañero y pídale que descomprima el archivo en su equipo y revise y pruebe sus herramientas.

Elegir la versión correcta

Al enviar una herramienta desde el centro de recursos 10.0, asegúrese de que tiene activada la casilla de verificación de la versión 10.0. Si ha creado las herramientas en la versión 9.3 o 9.3.1, active la casilla de verificación junto a 9.3. Las herramientas creadas en 9.3 funcionarán en 10.0, por lo que, en teoría, podría comprobar tanto las versiones 9.3 como 10.0 al enviar una caja de herramientas de 9.3. No obstante, le sugerimos que solo active una casilla.

Si ha creado sus herramientas en la versión 10.0, active la casilla 10.0 y asegúrese de que la 9.3 no está activada. Esto es especialmente importante porque la versión 9.3 no puede abrir los cuadros de herramientas de la versión 10.0. Lo último que queremos es que un usuario de 9.3 descargue la caja de herramientas de 10.0 para descubrir luego que no puede abrirla.

Descripción

Si sus herramientas requieren licencias especiales (producto o extensión) o software de terceros, asegúrese de que menciona esto en la descripción de modo que los visitantes de la galería puedan decidir si desean o no descargar la entrada. Hay que evitar por todos los medios que alguien descargue la entrada solamente para descubrir que no puede utilizarla debido a problemas en las licencias.

Título y etiqueta basados en la categoría de envío

Para ayudar a los visitantes de la galería a comprender lo que van a descargar, debe facilitar un título descriptivo y etiquetas adecuadas para su envío. Con el transcurso de los años, hemos identificado tres categorías básicas de envíos: Estudio de caso, Herramientas genéricas y Ejemplos de servicios. Al incluir la categoría de envío en el título y las etiquetas, agregará mucha información sobre su envío con solo un par de palabras.

Estudio de caso

Un estudio de caso utiliza datos para mostrar un flujo de trabajo. Un envío de estudio de caso contiene datos (como rasters y clases de entidades) utilizados por sus modelos y secuencias de comandos. Los documentos de mapa se incluyen por lo general para mostrar los datos. A diferencia de las herramientas genéricas (a continuación), se espera que los visitantes de la galería que descarguen su envío estudien sus modelos y secuencias de comandos, quizás ejecutándolos varias veces con los datos que incluya y, a continuación, modifiquen los modelos y sustituyan sus propios datos. Los estudios de caso son el tipo más común de envío.

Las herramientas de modelos y secuencias de comandos que se encuentran en este tipo de envío tienen por lo general valores predeterminados para variables de datos. Por ejemplo, en el siguiente modelo, todos los parámetros de datos de entrada tienen valores y el modelo está listo para ejecutarse. Para ejecutar el modelo, se deben incluir todos los datos en el envío o, de lo contrario, el modelo no se validará ni ejecutará.

Herramientas genéricas

Un envío de herramientas genéricas contiene herramientas que, cuando se abre su cuadro de diálogo, se parecen a las herramientas del sistema de Esri. Es decir, los parámetros de datos de entrada y de salida están vacíos y su usuario necesita que introduzca todos los valores de los parámetros para poder ejecutar la herramienta. A diferencia de las herramientas de estudio de caso, los visitantes de la galería que descarguen el envío esperan poder utilizar las herramientas en sus datos sin tener que modificar los modelos o las secuencias de comandos. El siguiente modelo es genérico porque el usuario facilita todos los valores de los parámetros de datos. Puede obtener más información sobre cómo crear una herramienta genérica en el tema de ayuda de Desktop Paseo introductorio sobre la creación de herramientas con ModelBuilder.

Ejemplo de servicio

Este tipo de envío contiene herramientas que se pueden publicar como un servicio de geoprocesamiento de ArcGIS Server. En muchos sentidos, estos envíos son similares a un estudio de caso en que contienen datos y documentos de mapa. La diferencia estriba en que los modelos y las secuencias de comandos se adhieren a requisitos de un servicio de geoprocesamiento, para lo que solo utilizan determinados tipos de entrada y de salida y escriben datos en el espacio de trabajo temporal facilitado por ArcGIS Server. Al igual que los estudios de caso, el usuario estudia los modelos y las secuencias de comandos y sustituye sus propios datos antes de publicarlos en ArcGIS Server. Por ejemplo, consulte Guía a los ejemplos de servicio de geoprocesamiento en la ayuda de Desktop.

Nombre el cuadro de herramientas y la entrada según la categoría de envío

Para ayudar a los visitantes con la galería de herramientas de secuencias de comandos y modelos, etiquete su entrada con la categoría de envío, como "Herramientas de biodiversidad: estudio de caso". También debería etiquetar su caja de herramientas de una forma similar, tal y como se ilustra a continuación:

Proporcione un alias a su cuadro de herramientas

El alias del cuadro de herramientas se utiliza para identificar exclusivamente el cuadro de herramientas y las herramientas que hay dentro, y se emplea al ejecutar herramientas en la ventana de Python o en secuencias de comandos. Para obtener más información sobre alias, consulte el tema de ayuda de Desktop Cambiar el nombre de un cuadro de herramientas: nombre, etiqueta y alias.

Etiquete la entrada con la categoría de envío

Cuando agrega una entrada a la galería de herramientas de secuencias de comandos y modelos, puede agregar una o varias etiquetas a la entrada. Incluya una de las siguientes etiquetas en la entrada:

  • Estudio de caso
  • Herramientas genéricas
  • Ejemplo de servicio

¿Qué ocurre si mi envío incluye más de una categoría?

No es infrecuente realizar un envío que contenga tanto herramientas genéricas como un estudio de caso. Es decir, muestra cómo utiliza sus herramientas genéricas con algunos datos de prueba reales, probablemente con modelos. Le sugerimos que realice un envío y utilice Herramientas genéricas en el título. De ese modo, los visitantes de la galería saben que obtendrán herramientas genéricas que pueden utilizar con sus propios datos. En su descripción, puede indicar que también incluye un estudio de caso. Si es posible, su envío debería tener dos cuadros de herramientas, uno que contenga las herramientas genéricas y el otro que contenga el estudio de caso, con cada cuadro de herramientas etiquetado de forma adecuada. Para las etiquetas, puede incluir ambas categorías de envío.

Filed under: