Empacotar dependências do Alteryx

O PlaidCloud importa ficheiros de fluxos de trabalho do Alteryx a partir de Documentos e utiliza caminhos de Documentos para as dependências e os artefactos. Pode carregar ficheiros para Documentos, pedir a um agente ligado por MCP que os organize por si, ou ligar Documentos diretamente a armazenamento partilhado, como OneDrive, Google Drive, SharePoint, S3, Azure Blob ou SFTP.

Nota

Utilize o seletor de caminhos de Documentos durante a importação para escolher exatamente onde o PlaidCloud deve ler os ficheiros de origem e guardar os artefactos gerados.

Carregar ou ligar armazenamento partilhado

Escolha a localização de origem que melhor se adapta à sua migração:

• Carregue o pacote para uma conta de documentos.
• Ligue uma localização de armazenamento partilhado existente como conta de documentos.
• Peça a um agente ligado por MCP que copie, mova, mude o nome e organize ficheiros já disponíveis em Documentos.

As ligações de armazenamento partilhado podem reduzir a preparação da migração, porque a equipa pode manter os ficheiros onde já colabora:

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

Estrutura de pastas recomendada

Para cada lote de migração, utilize uma estrutura de pastas como esta antes de importar:

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

Esta estrutura é opcional, mas facilita a revisão e a validação.

Fluxos de trabalho e macros

Coloque os ficheiros de fluxos de trabalho e as macros em pastas previsíveis:

• Coloque os ficheiros .yxmd e .yxwz em workflows/.
• Coloque os ficheiros .yxmc em macros/.
• Mantenha as macros aninhadas com o resto da biblioteca de macros.
• Evite nomes de macro duplicados no mesmo pacote, a menos que tenham versões intencionais.

O PlaidCloud utiliza os ficheiros de origem das macros para criar fluxos de trabalho de macros do PlaidCloud e ligar as chamadas de macros dos fluxos de trabalho convertidos.

Ficheiros de entrada

Coloque os dados de entrada em inputs/:

• Ficheiros CSV, TSV, de largura fixa, JSON, XML, Excel, Access, YXDB, SAS, SPSS, Stata, Avro, Parquet e HDF.
• Ficheiros de consulta utilizados por fórmulas, substituição dinâmica, correspondência aproximada ou junções.
• Pastas referenciadas pelas ferramentas Directory e Dynamic Input.
• Ficheiros ASCII planos do Alteryx: inclua o ficheiro de esquema .flat junto dos dados que descreve. As larguras das colunas existem apenas nesse ficheiro e a conversão lê-o para construir o passo; por isso, um ficheiro de esquema em falta continua a converter, mas o relatório de conversão indica o ficheiro a carregar — forneça-o e importe novamente o fluxo de trabalho em vez de apenas o voltar a executar.

Quando o PlaidCloud importa o pacote, os passos convertidos apontam para as localizações de Documentos selecionadas.

Ficheiros espaciais

Coloque os ficheiros espaciais em spatial/ e mantenha os ficheiros auxiliares juntos:

• Shapefiles: inclua .shp, .shx, .dbf e .prj.
• Ficheiros MapInfo: inclua .tab, .map, .id e .dat.
• Inclua ficheiros de projeção e camadas de consulta quando existirem.
• Mantenha KML, GeoJSON e outras entradas espaciais no mesmo pacote de dependências.

Não distribua os ficheiros auxiliares espaciais por pastas diferentes. O PlaidCloud precisa do grupo completo para materializar corretamente a geometria.

Recursos de relatórios e artefactos

Coloque os recursos dos relatórios em reports/:

• Imagens utilizadas pelas ferramentas de composição de relatórios.
• Entradas em PDF.
• Fragmentos ou modelos HTML.
• Camadas de mapa utilizadas pelos mapas dos relatórios.
• Relatórios gerados de exemplo, quando é necessária a validação dos artefactos.

Os passos de relatório convertidos criam artefactos do PlaidCloud que podem ser revistos a partir de Documentos e do histórico de execuções do fluxo de trabalho.

Modelos do Excel

Se algum fluxo de trabalho escrever uma saída formatada num modelo do Excel com estilos — os passos Export to Excel e Export to Excel Sheets, que preservam o formato —, prepare esses livros de modelo na conta de documentos, juntamente com as entradas. Coloque-os numa pasta 04_Templates ao lado da 03_Inputs onde preparou os dados de origem, para que o passo convertido possa ler o modelo que preenche.

Cuidado

Uma exportação convertida que preserva o formato lê o respetivo modelo a partir da conta de documentos em tempo de execução. Se o modelo estiver em falta quando a conversão é executada, o passo recorre em segurança a uma exportação simples — mas uma exportação convertida que preserva o formato e cujo modelo preparado esteja ausente em tempo de execução falha de forma explícita em vez de escrever silenciosamente um ficheiro sem formatação. Prepare 04_Templates antes de executar o fluxo de trabalho convertido.

Saídas esperadas

Coloque as saídas esperadas em expected-outputs/:

• Tabelas de saída fiáveis do Alteryx.
• Relatórios, PDF, mapas, imagens ou gráficos esperados.
• Notas sobre a ordenação de linhas, a precisão numérica e o tratamento de datas aceites.

As saídas esperadas são opcionais para a validação estrutural e são a melhor evidência para a validação da paridade das saídas.

Ligações externas

Para fluxos de trabalho de bases de dados, APIs e origens na nuvem, registe:

1. O nome do sistema de origem.
2. O tipo de ligação.
3. Os nomes da base de dados, do esquema, da tabela, do endpoint ou do bucket.
4. O responsável pelas credenciais ou o nome do segredo.
5. A data do instantâneo, quando a paridade das saídas depende de uma origem num ponto específico no tempo.

Utilize ligações ou credenciais do PlaidCloud para execuções de produção repetíveis.

Guias relacionados

• Lista de verificação de prontidão para a migração do Alteryx
• Migrar fluxos de trabalho do Alteryx
• Orquestrar migrações do Alteryx com MCP
• Otimizar importações do Alteryx