Empaquetar dependencias de Alteryx

PlaidCloud importa los archivos de flujos de trabajo de Alteryx desde Document y usa rutas de Document para las dependencias y los artefactos. Puede cargar archivos en Document, pedir a un agente conectado por MCP que organice los archivos por usted, o conectar Document directamente a un almacenamiento compartido como OneDrive, Google Drive, SharePoint, S3, Azure Blob o SFTP.

Nota

Use el selector de rutas de Document durante la importación para elegir exactamente dónde debe leer PlaidCloud los archivos de origen y dónde debe almacenar los artefactos generados.

Cargar o conectar almacenamiento compartido

Elija la ubicación de origen que mejor se adapte a su migración:

• Cargue el paquete en una cuenta de documentos.
• Conecte una ubicación de almacenamiento compartido existente como cuenta de documentos.
• Pida a un agente conectado por MCP que copie, mueva, cambie de nombre y organice los archivos que ya están disponibles en Document.

Las conexiones de almacenamiento compartido pueden reducir la preparación de la migración, porque el equipo puede mantener los archivos donde ya colabora:

• Google Drive
• OneDrive o SharePoint
• AWS S3
• Azure Blob Storage
• SFTP

Estructura de carpetas recomendada

Para cada lote de migración, use una estructura de carpetas como esta antes de importar:

workflow-package/
  workflows/
  macros/
  inputs/
  expected-outputs/
  reports/
  spatial/

Esta estructura es opcional, pero facilita la revisión y la validación.

Flujos de trabajo y macros

Coloque los archivos de flujos de trabajo y las macros en carpetas predecibles:

• Ponga los archivos .yxmd y .yxwz en workflows/.
• Ponga los archivos .yxmc en macros/.
• Mantenga las macros anidadas con el resto de la biblioteca de macros.
• No incluya nombres de macro duplicados en el mismo paquete, salvo que tengan versiones intencionadas.

PlaidCloud usa los archivos de origen de las macros para crear flujos de trabajo de macros de PlaidCloud y conectar las llamadas a macros de los flujos de trabajo convertidos.

Archivos de entrada

Coloque los datos de entrada en inputs/:

• Archivos CSV, TSV, de ancho fijo, JSON, XML, Excel, Access, YXDB, SAS, SPSS, Stata, Avro, Parquet y HDF.
• Archivos de búsqueda usados por fórmulas, reemplazo dinámico, coincidencia aproximada o combinaciones.
• Carpetas a las que hacen referencia las herramientas Directory y Dynamic Input.
• Archivos ASCII planos de Alteryx: incluya el archivo de diseño .flat junto a los datos que describe. Los anchos de columna solo están en ese archivo, y la conversión lo lee para construir el paso; por eso, si falta el archivo de diseño la conversión se completa de todos modos, pero el informe de conversión indica el archivo que debe cargar. Proporciónelo e importe el flujo de trabajo de nuevo, en lugar de limitarse a volver a ejecutarlo.

Cuando PlaidCloud importa el paquete, los pasos convertidos apuntan a las ubicaciones de Document seleccionadas.

Archivos espaciales

Coloque los archivos espaciales en spatial/ y mantenga juntos los archivos complementarios:

• Shapefiles: incluya .shp, .shx, .dbf y .prj.
• Archivos de MapInfo: incluya .tab, .map, .id y .dat.
• Incluya los archivos de proyección y las capas de búsqueda cuando existan.
• Mantenga KML, GeoJSON y otras entradas espaciales en el mismo paquete de dependencias.

No reparta los archivos espaciales complementarios entre carpetas. PlaidCloud necesita el grupo completo para materializar correctamente la geometría.

Informes y recursos de artefactos

Coloque los recursos de informes en reports/:

• Imágenes usadas por las herramientas del compositor de informes.
• Entradas en PDF.
• Fragmentos o plantillas HTML.
• Capas de mapa usadas por los mapas de informes.
• Ejemplos de informes generados cuando se requiere validación de artefactos.

Los pasos de informe convertidos crean artefactos de PlaidCloud que se pueden revisar desde Document y desde el historial de ejecuciones del flujo de trabajo.

Plantillas de Excel

Si algún flujo de trabajo escribe una salida con formato en una plantilla de Excel con estilos (los pasos de exportación que conservan el formato, Export to Excel y Export to Excel Sheets), prepare esos libros de plantilla en la cuenta de documentos junto con las entradas. Colóquelos en una carpeta 04_Templates al lado de 03_Inputs, donde preparó los datos de origen, para que el paso convertido pueda leer la plantilla que rellena.

Precaución

Una exportación convertida que conserva el formato lee su plantilla de la cuenta de documentos en tiempo de ejecución. Si falta la plantilla cuando se ejecuta la conversión, el paso recurre de forma segura a una exportación simple; pero una exportación convertida que conserva el formato cuya plantilla preparada no existe en tiempo de ejecución falla de forma explícita en lugar de escribir en silencio un archivo sin formato. Prepare 04_Templates antes de ejecutar el flujo de trabajo convertido.

Salidas esperadas

Coloque las salidas esperadas en expected-outputs/:

• Tablas de salida de Alteryx de confianza.
• Informes, PDF, mapas, imágenes o gráficos esperados.
• Notas sobre el orden de filas aceptado, la precisión numérica y el tratamiento de fechas.

Las salidas esperadas son opcionales para la validación estructural y son la mejor evidencia para la validación de paridad de salida.

Conexiones externas

Para los flujos de trabajo que usan bases de datos, API y orígenes en la nube, registre:

1. El nombre del sistema de origen.
2. El tipo de conexión.
3. Los nombres de base de datos, esquema, tabla, punto de conexión o bucket.
4. El propietario de las credenciales o el nombre del secreto.
5. La fecha de la instantánea cuando la paridad de salida depende de un origen en un momento dado.

Use conexiones o credenciales de PlaidCloud para ejecuciones de producción repetibles.

Guías relacionadas

• Lista de comprobación de preparación para la migración de Alteryx
• Migrar flujos de trabajo de Alteryx
• Orquestar migraciones de Alteryx con MCP
• Ajustar las importaciones de Alteryx