Directrices de creación de aplicaciones

En el caso de las aplicaciones web, solo puedes leer y escribir archivos que estén dentro de la misma carpeta que tu aplicación o en una carpeta inferior, en otras palabras, cualquier carpeta que esté dentro de la carpeta que contiene la aplicación (puede estar más de un nivel por debajo). Esta regla también se aplica a las macros que desees utilizar para tu aplicación, a menos que sea una macro estándar que forme parte del instalador del producto Alteryx o de un instalador de datos.

Cuando emplees la herramienta Acción en Actualizar/Cambiar valor, a menos que sea realmente necesario, no utilices la opción Reemplazar una cadena específica . Si cambias la configuración de la herramienta en el flujo de trabajo debido a un desarrollo continuo, es posible que termines truncando esa herramienta Acción, ya que esa cadena específica podría dejar de existir. Obviamente, hay veces en que necesitas usar esa opción, pero solo ten en cuenta que, si cambia esa cadena en la herramienta, es posible que también necesites actualizar la herramienta Acción.

Si utilizas una herramienta Acción para actualizar una herramienta Desvío , intenta completar y actualizar el desvío para ambas posibilidades, es decir, desvío a la izquierda y desvío a la derecha. De lo contrario, si solo actualizas para una condición y cambias el flujo de trabajo durante el desarrollo, entonces no tuviste en cuenta cuándo necesitas que el flujo de trabajo vaya por el otro lado.

Todos los desvíos deben terminar, especialmente antes de unir cualquier flujo de datos de un desvío a cualquier otra parte del flujo de trabajo. Una herramienta Fin del desvío no requiere configuración, por lo que es fácil de usar. Asegúrate de utilizarla o de finalizar el desvío con una herramienta Salida.

Cuando escribas las preguntas, ten en cuenta a tu usuario y anticípate a los errores más comunes. Debes emitir mensajes de error con una herramienta Mensaje de error . Por ejemplo, si el usuario debe seleccionar una opción y, luego, arroja un error cuando no selecciona nada, esto puede evitar que el motor arroje errores que podrían no ser lo suficientemente significativos para que el usuario entienda cómo solucionarlos. Lo ideal es arrojar un error por cada pregunta que el usuario necesita rellenar. También puedes establecer condiciones más complejas para asegurarte de que llenen las cosas correctamente. Por ejemplo, si necesitan rellenar un cuadro de texto con hasta cinco áreas comerciales separadas por comas (por ejemplo, 1, 2, 3, 4, 5), puedes usar una condición de RegEx para asegurarte de que no haya más de cuatro comas en el cuadro de texto.

En esta misma línea, trata de anticipar los casos en los que la aplicación podría fallar incluso cuando esté configurada correctamente. Por ejemplo, el usuario puede ingresar una dirección que no se geocodifique y no produzca resultados. Puedes manejar fácilmente los mensajes en tu aplicación mediante la filtración de geocódigos erróneos y, luego, mediante la herramienta Mensaje para devolver un mensaje al usuario: “La dirección que proporcionaste no se geocodificó. Comprueba que la dirección sea válida y realiza los cambios pertinentes o ingresa una dirección diferente y vuelve a ejecutarla”.

Si utilizas XML sin procesar para una herramienta o usas caracteres especiales en tus aplicaciones, ten en cuenta que en la Web esto puede no funcionar como se espera. Por ejemplo, la selección de una herramienta Lista desplegable o herramienta Cuadro de lista en el motor puede contener texto como: Age By Sex Summary Report:<Report Type=“summary”>Age By Sex Summary Report</Report>

Pero cuando esto se usa en la Web, en realidad no muestra la pregunta correctamente y, por lo tanto, cuando se usa en una acción, es probable que no tenga el efecto deseado. Una solución es cambiar el texto a: Age By Sex Summary Report:<Report Type="summary">Age By Sex Summary Report</Report>

Entonces, si utilizas la respuesta a la pregunta en una acción, debes actualizarla para que sea: EscapeXMLMetacharacters([AllocateSummaryReport])

Se agregó la función Evadir metacaracteres XML a la biblioteca de Fórmula en la versión 8.0. Puedes acceder a ella desde la categoría Especializadas. Esta función reemplaza todos los metacaracteres XML por sus versiones con escape.

Es mejor mantener una herramienta Apilar configurada manualmente fuera de cualquier aplicación porque, en la mayoría de los casos, el flujo de trabajo cambia en tiempo de ejecución. En lugar de configurar la herramienta Apilar en modo manual, inserta las herramientas Seleccionar en cada conexión que se introduzca en la herramienta Apilar. Cuando configures la herramienta Seleccionar, cambia el nombre y el orden de los campos según sea necesario, y ten cuidado de no incluir campos dinámicos/desconocidos. Configura la herramienta Apilar mediante Configurar automáticamente por nombre o Configurar automáticamente por posición.

La organización de la aplicación se realiza, en parte, mediante el uso de diferentes contenedores de herramientas para las distintas secciones de la aplicación. Por ejemplo, todas las herramientas Generación de informes suelen ser la última sección de una aplicación y se pueden colocar en un contenedor de herramientas etiquetado como “Generación de informes”.

Una herramienta Contenedor de herramientas puede codificarse por colores según la función que resalte. Los contenedores de herramientas codificados por colores facilitan la comprensión de lo que hace una aplicación, sobre todo cuando se ve con un zoom pequeño. Esto es útil durante la solución de problemas o la depuración de una aplicación que otra persona creó.

Las herramientas de interfaz deben colocarse en sus propios contenedores y codificarse por color como tales. Para aplicaciones con varias pestañas, es útil colocar las herramientas que componen cada pestaña en su propio contenedor.

Las anotaciones son cuadros de texto que se adjuntan a una herramienta específica y pueden ser muy útiles para describir el rol de herramientas individuales. Uno de los principales beneficios es que, si mueves la herramienta, la anotación se mueve con ella. En Configuración de flujo de trabajo , establece las Anotaciones que se deben mostrar.

Si es necesario, también puedes configurar anotaciones individuales para que se coloquen en la parte superior o inferior de una herramienta. Para cambiar la anotación , haz clic en la herramienta, selecciona la pestaña Anotación y selecciona Colocar la anotación en la parte superior o anula su selección.

Una herramienta Entrada de macro debe incluir datos. La inclusión de datos hace que sea mucho más fácil la solución de problemas o la depuración si algo sale mal. Hay una entrada de texto incrustada dentro de la herramienta Entrada de macro. Este es el método preferido para las entradas de macro. Si necesitas un archivo más grande para que actúe como entrada de datos, deberás incluirlo en la macro siempre que sea posible. Las dependencias de archivos de datos para una macro deben denominarse según el patrón a continuación:

Nombredelamacro.Nombredelarchivodedatos.yxdb

Los nombres de entrada y salida no deben tener un número de herramienta asociado. En la pestaña Propiedades de entrada de macro, asegúrate de que el nombre sea lo suficientemente descriptivo. El nombre especificado aquí será visible para usuarios cuando configuren la herramienta Macro.

Cuando hay varias entradas y salidas, la adición de una abreviatura de conector ayuda al usuario a configurar la herramienta, ya que proporciona una etiqueta en el ancla de la herramienta cuando esta se coloca en el lienzo. Consulta Herramienta Entrada de macro  o Herramienta Salida de macro  para obtener más información.

Los nombres de las pestañas deben ser descriptivos para facilitar su uso mientras el usuario configura la herramienta Macro. Las pestañas son visibles para el usuario en el momento de la configuración. El nombre predeterminado de la pestaña es “Preguntas”; no es un nombre muy descriptivo y esto suele ser un descuido a la hora de desarrollar una macro (o aplicación) con una sola pestaña. Consulta la ventana Diseñador de interfaz .

Las macros compatibles utilizadas en un flujo de trabajo principal deben estar presentes en la macro principal o en un directorio compatible, y deben tener un nombre como: NombreDelPrincipal.NombreDelSoporte.yxmc