A continuación se muestran listas de verificación que se pueden utilizar al crear un envío a la galería de herramientas de secuencia de comandos y modelos. En las listas de verificación siguientes, el término "datos locales" significa que los datos se pueden encontrar en la carpeta raíz o en sus subcarpetas (tal y como se indica en las Directrices de envío).

Documente sus herramientas y cajas de herramientas

Sus herramientas y cajas de herramientas deberían estar bien documentadas. Consulte el tema de ayuda de DesktopUn paseo introductorio por las cajas de herramientas y las herramientas de documentación.

General

Esta lista de comprobación es para todos los envíos. A continuación se facilitan listas de comprobación de modelos, secuencias de comandos y documentos de representación cartográfica.

Descripción Por qué es un problema Qué hacer
El archivo zip no puede tener un tamaño superior a 30 MB. 30 MB es el límite del tamaño del archivo para cualquier envío. Retire los dominios, representaciones, campos y datos innecesarios. Utilice conjuntos de datos más pequeños.
El archivo zip debería contener la carpeta raíz y no su contenido. Consulte las Directrices de envío. Ayuda a evitar la sobrescritura de datos. Agregue la carpeta raíz al archivo zip y no al contenido individual de la carpeta raíz.
Nombre las cajas de herramientas según la categoría de envío: Estudio de caso, Herramientas genéricas o Ejemplo de servicio. Consulte las Directrices de envío; la convención de nomenclatura ayuda a los usuarios a determinar si pueden utilizar sus herramientas inmediatamente o si necesitan examinar y estudiarlas primero. Haga clic con el botón derecho en la caja de herramientas, seleccione Propiedades y cambie el nombre y la etiqueta de la caja de herramientas.
Su caja de herramientas debería tener un alias. Los alias de la caja de herramientas se utilizan para identificar de forma exclusiva una herramienta en la secuencia de comandos. Haga clic con el botón derecho en la caja de herramientas, seleccione Propiedades y facilite un alias para la caja de herramientas. Consulte el tema de ayuda de Desktop Cambiar una caja de herramientas: nombre, etiqueta y alias para obtener más información.
Utilice los nombres de subcarpeta estándar: ToolData, Doc, Scripts y Scratch. Consulte las Directrices de envío. Si todos seguimos las convenciones de nomenclatura, será más fácil encontrar recursos. Si cambia el nombre de una subcarpeta que contenga datos, asegúrese de restablecer las capas de mapas y las herramientas que utilicen el nombre de subcarpeta original.
La carpeta Scratch (si tiene una) no debería contener datos. No desea que se incluyan datos innecesarios en su envío. Borre los datos de la carpeta Scratch.
Haga una limpieza de datos y elimine datos temporales, dominios, representaciones, campos innecesarios, etc. Los elementos innecesarios pueden aumentar en exceso el tamaño de su envío. Demasiados campos innecesarios dificultan la visualización de las tablas. Borre campos innecesarios, representaciones, dominios y datos temporales.

Modelos

Descripción Por qué es un problema Qué hacer
El modelo se guarda con la opción de rutas relativas activada. Una vez concluida la descarga, los datos utilizados por el modelo no se encontrarán si se utilizan rutas absolutas (la opción está desactivada). Haga clic con el botón derecho en el modelo, seleccione Propiedades y, a continuación, haga clic en la ficha General. En la parte inferior del cuadro de diálogo, active Almacenar nombres de ruta relativos (en lugar de rutas absolutas). Consulte el tema de ayuda del escritorio Rutas explicadas: absoluta, relativa, UNC y URL para obtener más información.
Todas las variables de datos deben hacer referencia a datos locales. Todos los datos deberían incluirse en la carpeta ToolData y las geodatabases de archivo en la carpeta ToolData. Si su variable de datos hace referencia a una capa de un documento ArcMap, dicha capa debe hacer referencia a datos locales (consulte la lista de comprobación para los documentos de mapa a continuación). Copie los datos en la carpeta ToolData, abra la variable de datos en ModelBuilder e introduzca la ruta para los datos que ha copiado en la carpeta ToolData.
No utilice datos SDE. El usuario de la herramienta no podrá conectarse a la base de datos SDE. Cree una geodatabase de archivos en la carpeta ToolData. A continuación, utilice las herramientas Copiar entidades o Copiar filas para copiar datos de SDE en esta geodatabase de archivos locales. Restablezca todas las variables de modelo para utilizar los datos en la geodatabase de archivos locales.
Los archivos de simbología de capa (.lyr) deben ser locales. Si su modelo utiliza los archivos de simbología de capa (.lyr) para definir la simbología de salidas, asegúrese de que los archivos de capa son locales (en la carpeta ToolData). Copie los archivos de capa en la subcarpeta ToolData; restablezca la variable de modelo que utiliza el archivo de capa.
Las herramientas personalizadas a las que se hace referencia (herramientas de secuencias de comandos y modelos que crea) se encuentran en la caja de herramientas local. Si tiene un modelo o una secuencia de comandos que haga referencia (utilice) una herramienta de secuencias de comandos o modelos personalizados en otra caja de herramientas, la caja de herramientas a la que se haga referencia debe ser local. Salga de la aplicación (como ArcMap). Copie la caja de herramientas al que se haga referencia y cambie el nombre de la caja de herramientas original. Inicie ArcMap y edite todos los modelos que utilicen herramientas en la caja de herramientas al que acaba de cambiarle el nombre. Las herramientas de la caja de herramientas que se acaba de nombrar se mostrarán como una herramienta no válida. Haga doble clic en la herramienta no válida y explore la caja de herramientas local que contiene la herramienta. Cuando el modelo se haya fijado para utilizar las herramientas locales, puede cambiar el nombre de la caja de herramientas original. Consulte el tema de ayuda de Desktop Reparar un modelo para obtener más información.
Compruebe el modelo de los datos derivados huérfanos. Los datos derivados huérfanos son salida de datos por modelo, pero no son parámetros de salida o intermedios. Estos datos se dejarán atrás una vez se haya ejecutado el modelo y pueden ocasionar errores si el espacio de trabajo de salida no existe en el equipo de usuarios. Todos los datos derivados deberían ser parámetros de modelo o intermedio. Consulte el tema de ayuda de Desktop Un paseo introductorio por las cajas de herramientas y las herramientas de documentación para obtener más información.
El nombre del modelo no es el nombre de la herramienta predeterminado (por ejemplo, Modelo 1). Ambas herramientas tienen un nombre y una etiqueta. Los nombres predeterminados (como "Modelo", "Modelo 1") no ayudan a los usuarios a comprender los modelos. Haga clic con el botón derecho en el modelo y seleccione Propiedades. Facilite un nombre real y una etiqueta y no utilice el nombre predeterminado.
Las imágenes de modelo son locales. Los elementos de modelo se pueden mostrar como imágenes en lugar de como óvalos y rectángulos. Estos archivos de imágenes deben ser locales o las imágenes no se mostrarán en ModelBuilder. Coloque las imágenes en la subcarpeta Doc y restablezca todas las imágenes en el modelo para utilizar imágenes en la subcarpeta Doc.

Herramientas de secuencias de comandos

Descripción Por qué es un problema Qué hacer
La herramienta se almacena con la opción de nombres de ruta relativos activada. Los parámetros de herramientas de secuencias de comandos pueden hacer referencia a datos, como un archivo de capa de simbología. Una vez descargados, no se encontrarán los datos utilizados en las propiedades de parámetros de herramientas de secuencia de comandos si se utilizan las rutas absolutas (la opción está desactivada). Haga clic con el botón derecho en la herramienta de secuencia de comandos, seleccione Propiedades y, a continuación, haga clic en la ficha General. En la parte inferior del cuadro de diálogo, active Almacenar nombres de ruta relativos (en lugar de rutas absolutas). Consulte el tema de ayuda del escritorio Rutas explicadas: absoluta, relativa, UNC y URL para obtener más información.
No hay rutas absolutas en la secuencia de comandos. Las rutas no existirán en el equipo de los usuarios y su secuencia de comandos dará error. Consulte el tema de ayuda de DesktopTécnicas para compartir secuencias de comandos Python para saber cómo utilizar rutas relativas y obtener un espacio de trabajo temporal.
No es necesario agregar cajas de herramientas del sistema con las funciones AddToolbox o ImportToolbox. Las cajas de herramientas del sistema residen en el directorio de instalación de ArcGIS. No hace falta agregarlas de forma explícita, ya que se encontrarán automáticamente en el sistema de los usuarios. No tiene que agregarlas porque la ruta es absoluta. Si necesita descubrir el directorio de instalación, utilice la función GetInstallInfo.
El nombre de la herramienta no es el nombre de la herramienta predeterminado (por ejemplo, Secuencia de comandos 1). Las herramientas de secuencia de comandos tienen un nombre y una etiqueta. Los nombres predeterminados no ayudan a los usuarios a comprender la herramienta. Haga clic con el botón derecho en la herramienta y seleccione Propiedades. Facilite un nombre real y una etiqueta y no utilice el nombre predeterminado.
Utilice la función AddFieldDelimiters al crear instrucciones Select. Existen dos sintaxis de consulta, field y [field], dependiendo del formato de base de datos. Su herramienta dará error si no utiliza el formato correcto. Consulte el tema de ayuda de Desktop de la función AddFieldDelimiters.
Utilice un buen tratamiento de errores: intentar/exceptuar bloques y determinación del origen. Ayuda a los usuarios a comprender por qué se ha producido un determinado error. Consulte el tema de ayuda de Desktop Manejo de errores con Python.
Utilice el método de función AddIDMessage para los errores bien conocidos. La función AddIDMessage muestra los códigos de error introducidos en 9.3 junto con un vínculo a la descripción del error y las posibles soluciones. Consulte la función de ayuda de Desktop AddIDMessage.
Comente correctamente su código; hágalo legible. Los usuarios querrán saber lo que hace su secuencia de comandos. Hágales un favor y permita que se pueda leer su código de secuencia de comandos y esté bien documentado. Comente su código.
Consulte las licencias de extensión y de producto. Si su secuencia de comandos utiliza una herramienta que no dispone de licencia, el usuario recibirá automáticamente un mensaje de error cuando se ejecute la herramienta. No obstante, este mensaje de error podría aparecer tras varios minutos de procesamiento. La práctica más recomendable es comprobar las licencias requeridas antes de ejecutar todo el volumen de código. Consulte los temas de ayuda de Desktop para las funciones CheckProduct y CheckExtension.

Documentos de mapa

Descripción Por qué es un problema Qué hacer
Los mapas se deberían almacenar con la opción de ruta relativa activada. Las capas se romperán (se restablecerá su fuente de datos). En ArcMap, haga clic en el menú Archivo y seleccione Propiedades de documento de mapa. Active la opción Almacenar nombres de rutas relativas a los orígenes de datos. Consulte el tema de ayuda del escritorio Rutas explicadas: absoluta, relativa, UNC y URL para obtener más información. También puede consultar cómo utilizar la herramienta Consolidar mapa (novedad de la versión 10) para crear un documento de mapa y una carpeta de datos.
Las capas de mapa hacen referencia a los datos locales. Las capas se romperán (se restablecerá su fuente de datos). Copie datos en la carpeta Tooldata; restablezca cada fuente de datos de capas en ArcMap al hacer clic en el botón Establecer fuente de datos en la ficha Datos de origen del cuadro de diálogo Propiedades de capa.
Elimine los resultados anteriores de la ventana Resultados. Muchos resultados aumentan y reducen el tamaño del documento de mapa que se va a abrir. Elimine los resultados anteriores tal y como se describe en el tema de ayuda de Desktop Uso de la ventana Resultados.

Filed under: