Gerenciamento de fluxos de trabalho
Atualizações do Designer e do Server desvinculadas
Para modernizar a experiência de atualização e reduzir a sobrecarga de TI, a Alteryx desvinculou as atualizações do Designer e do Server. Essa alteração permite que você atualize o Designer independentemente do Server, para que os usuários possam acessar imediatamente os recursos mais recentes do Designer sem esperar pela aprovação do Server ou atualizações do ambiente. Essa melhoria simplifica a adoção, acelera o acesso a novas funcionalidades e reduz atrasos, especialmente para organizações com longos ciclos de atualização do Server.
Com esse aprimoramento, os ativos criados em versões mais recentes do Designer não são mais bloqueados da publicação em ambientes de versões mais antigas do Server. Em vez de um erro de bloqueio, os usuários agora verão um aviso e poderão escolher se querem continuar, empoderando equipes com mais flexibilidade e reduzindo as interrupções do fluxo de trabalho.
Para obter detalhes importantes, limitações e atualizações contínuas, acesse Compatibilidade de versões do Server e do Designer.
Como parte do gerenciamento de fluxos de trabalho, você pode salvar os fluxos de trabalho que você cria no Designer para reutilizá-los ou compartilhá-los com outros usuários no Server da sua empresa.
Você também pode gerenciar fluxos de trabalho existentes no Server da sua empresa abrindo-os no Designer. No Designer, você pode editá-los, salvá-los e compartilhá-los de volta para o Server. O Server mantém versões anteriores dos fluxos de trabalho, portanto, salvar o fluxo de trabalho revisado no Server da sua empresa não substitui a versão anterior.
Se você deseja salvar e compartilhar um fluxo de trabalho junto com suas dependências, como arquivos e conexões, você pode exportar tudo junto como um arquivo YXZP. Da mesma maneira que você faz com fluxos de trabalho de arquivo único, é possível compartilhar fluxos de trabalho exportados com outras pessoas no Server e abri-los no Designer.
Além de salvar fluxos de trabalho únicos, você também pode salvar múltiplos fluxos como um grupo, que podem ser abertos como um arquivo de grupo de fluxos de trabalho (.yxwg). Esses grupos só podem ser criados usando fluxos de trabalho já existentes e salvos localmente.
Workspace Execution
Com a plataforma Alteryx One, é possível salvar seus fluxos de trabalho criados pelo Designer na biblioteca do Alteryx One. Em seguida, você pode executar ou agendar fluxos de trabalho na nuvem. Acesse Workspace Execution para saber mais.
Salvar fluxos de trabalho
Com o fluxo de trabalho aberto, selecione Arquivo > Salvar como e selecione o local no qual deseja salvá-lo.
No 26.1, agora você pode salvar fluxos de trabalho em múltiplos formatos, por exemplo, fluxo de trabalho (.yxmd), Macro (.yxmc), Aplicativo analítico (.yxwz)
Diretório de arquivos (Navegar)
Siga estas etapas para salvar o fluxo de trabalho no diretório de arquivos local:
Selecione Navegar.
No explorador de arquivos, vá para o local onde pretende salvar o fluxo de trabalho.
Em Nome do arquivo, insira um nome para o fluxo de trabalho.
Clique em Salvar.
Alteryx One
Salve seus ativos do Designer (fluxos de trabalho, macros e aplicativos analíticos) na sua biblioteca do Alteryx One (parte do seu espaço de trabalho do Alteryx One).
Siga estas etapas para salvar seus ativos do Designer na biblioteca do Alteryx One:
Selecione Arquivo > Salvar como > Alteryx One (essa opção se conecta ao seu espaço de trabalho do Alteryx One).
Importante
Se você abrir um ativo de um espaço de trabalho e, em seguida, alternar para um espaço de trabalho ativo diferente, salvar o ativo resultará em um erro.
Insira um Nome para o ativo.
Selecione a pasta onde deseja salvar o ativo.
Selecione o Tipo de ativo: pacote do fluxo de trabalho
Após selecionar pacote de fluxo de trabalho, use a seção Dependências para revisar as dependências e determinar como deseja agrupá-las. Os ativos não empacotados não contêm dependências.
Para a execução do espaço de trabalho, verifique se todas as dependências e conexões estão acessíveis pelo Alteryx Cloud.
Ative a opção Agrupar por ferramenta* para exibir todos os ativos de fluxo de trabalho ou dependências de arquivo junto com a ferramenta à qual estão conectados. Essa configuração organiza os ativos de cada ferramenta de modo que as informações sejam mais fáceis de serem analisadas. Ela não altera o modo como o arquivo YXZP é criado.
Desmarque um ativo para omiti-lo do pacote de fluxo de trabalho.
A caixa de seleção Sincronizar as conexões do Designer é marcada por padrão para adicionar ou sincronizar todas as conexões usadas no fluxo de trabalho com o espaço de trabalho no Alteryx One. Essa sincronização é necessária para executar o fluxo de trabalho com sucesso (e evitar erros) por meio da execução do espaço de trabalho.
Nota
Na versão 26.1, o Designer salva ativos no Alteryx Cloud por padrão.
O espaço de trabalho ativo determina onde os ativos são salvos. Você pode exibir ou alterá-lo por meio de Gerenciar conexões > Links Alteryx. O espaço de trabalho ativo aqui corresponde ao espaço de trabalho ativo no aplicativo Alteryx One.
Workspace Execution
O Workspace Execution permite executar fluxos de trabalho do Designer na nuvem. Observe que os fluxos de trabalho construídos no Designer precisam ser editados no Designer. Esses fluxos de trabalho não são editáveis no Designer Cloud no momento.
Alteryx Server
Atualizações do Designer e do Server desvinculadas
Com a versão 2025.2, os ativos criados em versões mais recentes do Designer não são mais bloqueados da publicação em ambientes de versões mais antigas do Server. Em vez de um erro de bloqueio, agora você encontrará uma mensagem de aviso e poderá escolher se deseja continuar.
Para obter detalhes importantes, limitações e atualizações contínuas, acesse Compatibilidade de versões do Server e do Designer.
Por padrão, o Designer salva no seu espaço de trabalho privado os fluxos de trabalho que você possui. Fluxos de trabalho compartilhados com você em uma coleção são salvos na coleção.
Selecione Salvar como.
Selecione Alteryx Server > Server da minha empresa.
Faça login com seu nome de usuário e senha. Selecione Mantenha-me conectado para manter sua sessão ativa, se desejado.
Na janela Salvar fluxo de trabalho, insira um Nome do fluxo de trabalho. Por padrão, o Local exibe o estúdio onde o fluxo de trabalho será salvo. Se o fluxo de trabalho tiver sido compartilhado com você em uma coleção, o Local exibirá essa coleção.
Em Tag de trabalhador, selecione uma opção para atribuir um trabalhador específico para executar o fluxo.
(Opcional) Em Detalhes, insira quaisquer comentários úteis.
(Opcional) Clique em Opções de fluxo de trabalho para selecionar um dos seguintes:
Opções de fluxo de trabalho
Descrição
Publicar esta versão do fluxo de trabalho
Publica esta versão do fluxo de trabalho como a versão disponível no Server.
Essa opção só estará disponível se o mesmo fluxo de trabalho já tiver sido salvo no Server antes. Não selecione essa opção se não desejar que os outros usuários usem essa versão do fluxo de trabalho.
Para atualizar a versão do fluxo de trabalho no Server...
Veja os detalhes do aplicativo e selecione Version # para visualizar as versões disponíveis.
Selecione uma versão e, para publicá-la, selecione Versão publicada.
Validar o fluxo de trabalho e salvar
(Opção padrão) Essa opção vem selecionada por padrão. A validação verifica se há ferramentas ou comandos proibidos. Se a validação falhar, será necessária uma isenção para que o fluxo de trabalho seja executado no Server da sua empresa. Entre em contato com o seu administrador do Server para solicitar que ele altere o modo de execução do seu fluxo.
As seguintes ferramentas requerem isenções para serem executadas no Alteryx Gallery público: R, Executar Comando, Python, E-mail e Baixar.
O Server não permite a execução de eventos ou aplicativos encadeados. Acesse Configuração do fluxo de trabalho e Janela do designer de interface.
Acesse Mensagens ao salvar no Server para obter informações adicionais sobre como solicitar uma isenção.
AMP Engine
Se o seu fluxo de trabalho estiver usando o AMP Engine, mas o seu controlador não estiver, a validação do fluxo de trabalho estará desabilitada e não poderá ser habilitada. Para ativar a validação do fluxo de trabalho, habilite o AMP Engine no controlador ou altere o fluxo de trabalho para ser executado no motor original através da Configuração do fluxo de trabalho.
Para saber mais sobre o AMP Engine, consulte estes recursos:
Gerenciar ativos do fluxo de trabalho
Visualize e gerencie os ativos associados ao fluxo de trabalho.
Selecione Agrupar ativos por ferramenta* para exibir todos os ativos de fluxo de trabalho ou dependências de arquivo junto com a ferramenta à qual estão conectados.
Desmarque um ativo para omiti-lo do pacote de fluxo de trabalho.
Os ativos que incluem uma constante no caminho de entrada são exibidos na lista de ativos, mas não são incluídos no pacote de fluxo de trabalho.
*Essa configuração organiza os ativos de cada ferramenta de maneira que as informações sejam mais fáceis de analisar. Ela não altera o modo como o arquivo YXZP é criado.
Habilitar bloqueio de fluxo de trabalho
Visualize as opções de bloqueio para o fluxo de trabalho.
Selecione Restringir o uso a números de série específicos para limitar a utilização do fluxo de trabalho bloqueado apenas para os números de série especificados. Quando selecionado, somente os números de série (endereços de e-mail) presentes na lista poderão utilizar o fluxo de trabalho bloqueado. Para permitir que um fluxo de trabalho seja executado no Server, é necessário listar o número de série para o Server, que é o administrador padrão do Server. O administrador padrão do Server é definido ao configurar a autenticação do Server. Acesse Configurar autenticação do Server para obter mais informações. Insira cada número de série exclusivo (endereço de e-mail), um por linha.
Selecione Definir vencimento para fluxo de trabalho bloqueado para fazer com que ele expire na data selecionada. Quando a data de vencimento é atingida, o fluxo de trabalho não pode mais ser utilizado nem executado.
Marque a caixa para indicar que você reconhece as implicações de bloquear seu fluxo de trabalho.
Selecione Concluído para bloquear o fluxo de trabalho.
Acesse Bloquear fluxo de trabalho para obter mais informações.
Definir credenciais do fluxo de trabalho
Para que essa opção esteja disponível, um administrador do Server deve selecionar a opção Permitir que o usuário selecione em Administrador > Configurações > Configuração > Ativos > Configurações de credenciais de fluxo de trabalho.
Uma vez que essa opção é habilitada, os usuários podem selecionar as credenciais para executar o fluxo de trabalho:
O usuário não precisa especificar credenciais: executa o fluxo de trabalho utilizando as credenciais padrão do Server ou estúdio.
O usuário deve especificar suas próprias credenciais: solicita que um usuário insira suas próprias credenciais para executar o fluxo de trabalho.
Sempre executar este fluxo de trabalho com estas credenciais: insere credenciais para usar toda vez que o fluxo de trabalho for executado.
Clique em Salvar. Acesse Mensagens ao salvar no Server para obter mais informações sobre erros e avisos que você pode receber ao tentar salvar um fluxo de trabalho em um Server.
Alteryx Server: adicionar novo Server
Atualizações do Designer e do Server desvinculadas
Com a versão 2025.2, os ativos criados em versões mais recentes do Designer não são mais bloqueados da publicação em ambientes de versões mais antigas do Server. Em vez de um erro de bloqueio, agora você encontrará uma mensagem de aviso e poderá escolher se deseja continuar.
Para obter detalhes importantes, limitações e atualizações contínuas, acesse Compatibilidade de versões do Server e do Designer.
Selecione Salvar como > Alteryx Server> Adicionar novo Server.
Na tela Salvar fluxo de trabalho - Adicionar um Server, use o campo URL para inserir o caminho do URL para o Server da sua empresa.
Clique em Conectar.
As etapas de autenticação variam com base na configuração do Server:
Tipo de configuração
Etapas de autenticação
Autenticação interna
Em E-mail e Senha, digite seu e-mail e senha do Server.
Se desejado, selecione Mantenha-me conectado.
Clique em Conectar.
Autenticação do Windows
Um nome de usuário é exibido.
Selecione Continuar para fazer login.
Selecione o Server na lista e siga as etapas para salvar o fluxo de trabalho no Server da sua empresa.
Modelo
Salve seu fluxo de trabalho, macro ou aplicativo analítico como um modelo para usar como ponto de partida para projetos futuros. Acesse Modelos para obter detalhes.
Salvar um novo modelo
Você pode salvar um fluxo de trabalho, macro ou aplicativo existente como um modelo. Siga estas etapas para fazê-lo:
Com um fluxo de trabalho, um macro ou um aplicativo aberto no Designer, selecione Arquivo > Salvar como.
Selecione Modelo para abrir a caixa de diálogo Salvar como modelo.
Use a caixa de diálogo Salvar como modelo para fornecer alguns metadados sobre o modelo. Os metadados tornam-se parte do XML e você pode editá-los posteriormente se precisar.
Proprietário: insira o nome do proprietário do modelo. Isso pode ajudar os usuários a encontrar a pessoa certa caso tenham dúvidas sobre o modelo.
Nome: insira um nome para o modelo. Observe que o Designer usa o nome do seu projeto por padrão e pré-configura o tipo de arquivo com base no projeto com o qual você começou (fluxo de trabalho, macro, aplicativo). Consulte Tipos de arquivos de modelo para obter mais informações.
Descrição: insira uma descrição para o modelo, por exemplo, o caso de uso pretendido. Isso ajuda os usuários a determinar se ele é apropriado para o projeto em que estão trabalhando.
Imagem: carregue um ícone ou uma captura de tela da parte principal do seu fluxo de trabalho, macro ou aplicativo. Aceita formatos de arquivo JPEG e PNG.
Clique em Salvar para salvar seu modelo ou em Fechar para voltar ao projeto.
O Designer salva o modelo na pasta "Templates" neste local (a menos que você especifique um local diferente por meio das etapas para alterar o diretório de fluxo de trabalho):
C:\Users\[USUÁRIO]\AppData\Local\Alteryx\Templates
Você pode acessar, editar e usar seu modelo no menu principal do Designer em Arquivo > Modelos.
Exportar fluxo de trabalho
Faça a exportação de um fluxo de trabalho e de suas dependências como um arquivo empacotado (YXZP). É necessário salvar o fluxo de trabalho para poder exportá-lo.
Empacotar arquivos de dependência
Estes ativos são automaticamente incluídos em um fluxo de trabalho exportado:
Arquivos de entrada
Referências de saída
Macros
Aplicativos encadeados
Arquivos adicionados pelo usuário
Estes arquivos não são incluídos em um fluxo de trabalho exportado:
Arquivos ausentes
Arquivos que são parte da instalação do Alteryx
Arquivos referenciados por um caminho de rede
Caminhos de entrada que contêm uma constante
Quando você exporta um fluxo de trabalho e suas dependências, o Designer mantém o formato original de cada arquivo. A estrutura de pastas dos ativos incluídos no fluxo de trabalho é mantida desde que os arquivos estejam na mesma pasta do fluxo ou em uma pasta dentro dela. Todos os outros arquivos são considerados externos e, caso incluídos no pacote, serão colocados em uma pasta _ externals.
Utilize Dependências do fluxo de trabalho para garantir que nenhum caminho seja quebrado ao referenciar arquivos ausentes.
Exportar fluxo de trabalho
Vá para Opções > Exportar fluxo de trabalho para exibir a janela Exportar fluxo de trabalho. O campo Fluxo de trabalho exibe o nome do fluxo e sua extensão de arquivo.
Complete as opções de configuração disponíveis:
Opção
Descrição
Bloquear
Não é possível desfazer o bloqueio. O Alteryx recomenda que você configure essa opção por último.
Crie uma cópia do fluxo de trabalho, aplicativo ou macro que pode ser executada, mas não pode ser aberta e editada no Designer.
Selecione o botão Bloquear.
Marque a caixa de seleção Habilitar bloqueio para este fluxo de trabalho.
Configure as seguintes opções, conforme apropriado:
Restringir o uso a números de série específicos (um por linha): insira os números de série das licenças que você quer que tenham acesso ao fluxo de trabalho bloqueado. Liste cada número de série em uma linha separada. Um número de série é usado para cada instalação do Alteryx. Para visualizar seu número de série...
Vá para Opções > Gerenciar licenças e clique no ícone de engrenagem no canto superior direito.
Em seguida, selecione Visualizar gerenciador de licenças de dados de parceiros e veja o Número de série da máquina na parte superior direita da janela.
Definir vencimento para fluxo de trabalho bloqueado: configure o fluxo bloqueado para expirar na data selecionada. Quando a data de vencimento é atingida, o fluxo de trabalho não pode mais ser utilizado ou executado.
Marque a caixa para indicar que você reconhece as implicações de bloquear seu fluxo de trabalho.
Selecione Concluído para bloquear o fluxo de trabalho.
Local do pacote
Altere o local onde o arquivo é salvo.
Agrupar ativos por ferramenta
Agrupe os ativos do fluxo de trabalho pelas ferramentas nas quais eles são usados. Se essa opção não estiver selecionada, os ativos serão listados individualmente.
Desmarque um ativo para excluí-lo do pacote de fluxo de trabalho. É feita uma referência ao ativo, mas ele não é incluído no pacote.
Os ativos que incluem uma constante como parte do caminho de entrada são exibidos na lista de ativos, mas não são empacotados como parte do fluxo de trabalho.
Clique em Salvar. Acesse Bloquear fluxo de trabalho para obter mais informações.
Salvar grupos de fluxos de trabalho
Considerações adicionais
Você só pode criar um grupo de fluxos de trabalho com fluxos já existentes e salvos localmente. Se quiser criar um grupo com fluxos de trabalho que estão salvos no Alteryx Server, é necessário primeiro salvar cada fluxo de trabalho individualmente em sua unidade local.
Se você mover ou excluir um fluxo de trabalho que faz parte do grupo criado, o Designer exibirá um erro quando esse grupo for aberto.
Abra todos os fluxos de trabalho salvos localmente que você deseja incluir no grupo. O arquivo Inicie aqui.yxmd não é salvo com nenhum grupo de fluxos de trabalho.
Selecione Arquivo > Criar grupo de fluxos de trabalho.
No explorador de arquivos, vá para o local onde pretende salvar o grupo.
Em Nome do arquivo, insira um nome para o fluxo de trabalho.
Clique em "Salvar" para salvar os fluxos individuais como um arquivo único de grupo de fluxos de trabalho (YXWG).
Abrir fluxo de trabalho salvo ou exportado
Abra os fluxos de trabalho usando um diretório de arquivos ou o Server.
Abrir um fluxo de trabalho único a partir do diretório de arquivos (navegar)
Selecione Arquivo > Abrir fluxo de trabalho > Navegar.
Vá para o local onde o fluxo de trabalho está salvo.
Clique duas vezes no nome do arquivo para abri-lo no Designer.
Fluxos de trabalho exportados
Se o fluxo de trabalho estiver em um arquivo YXZP, faça o seguinte:
Na janela Importação de pacotes, selecione Sim para importar o fluxo de trabalho.
Na janela Importar pacote de fluxo de trabalho, verifique as seguintes informações:
Nome de arquivo do pacote: exibe o caminho completo para o arquivo.
Fluxo de trabalho: exibe o nome do fluxo de trabalho. Os ativos do pacote são exibidos na caixa.
Diretório de destino: exibe o local onde o pacote será salvo. Para alterar o local, clique no ícone de disquete e selecione um novo local.
Clique em Importar.
Na janela Progresso de importação do fluxo de trabalho, selecione Sim para carregar o fluxo de trabalho. Se a importação falhar, tente novamente.
Abrir um grupo de fluxos de trabalho a partir do diretório de arquivos
Vá para Arquivo > Abrir grupo de fluxos de trabalho.
Acesse o local onde o arquivo do grupo de fluxos de trabalho foi salvo.
Clique duas vezes no arquivo YXWG para abri-lo. Cada fluxo dentro do grupo é aberto em uma guia separada no Designer.
Abrir ativos pelo Alteryx One
Siga estas etapas para abrir um ativo do Designer pela biblioteca do Alteryx One (parte do seu espaço de trabalho do Alteryx One). O ativo é aberto no Designer.
Clique em Arquivo > Abrir fluxo de trabalho > Alteryx One. A caixa de diálogo Abrir pelo espaço de trabalho do Alteryx One é exibida (essa opção se conecta ao seu espaço de trabalho ativo do Alteryx One). Aqui, você pode acessar a biblioteca do Alteryx One.
Para abrir um arquivo local, selecione Abrir do local na parte inferior do modal. Como alternativa, você pode clicar no ativo do Designer que deseja abrir na biblioteca.
A biblioteca exibe estas informações do ativo:
Nome: o nome do ativo.
Tipo de ativo: lista o tipo de ativo do Designer ativo, que pode ser fluxo de trabalho, macro, aplicativo analítico ou pacote de fluxo de trabalho.
Compartilhado com: lista os usuários com quem o ativo foi compartilhado.
Proprietário: o proprietário do ativo.
Última atualização: o carimbo de data/hora da última atualização.
Há uma série de opções de filtragem e pesquisa disponíveis para ajudar você a encontrar seu ativo:
Use as opções Tudo, Pertencentes a mim e Compartilhados comigo para restringir a lista de ativos conforme necessário.
Use o ícone de funil para aplicar um filtro à biblioteca.
Use o campo Pesquisar para encontrar o ativo por nome.
Após localizar o ativo que deseja abrir, selecione-o na lista. O ativo é aberto no Designer.
Abrir fluxo de trabalho do Server
Selecione Arquivo > Abrir fluxo de trabalho > Server da minha empresa.
Faça login com seu nome de usuário e senha. Selecione Mantenha-me conectado para manter sua sessão ativa, se desejado.
Na janela Server da minha empresa, localize o fluxo de trabalho. Você pode usar Pesquisar, usar a lista suspensa Todos os locais para filtrar e selecionar cabeçalhos de coluna para ordenar os resultados.
Selecione o ícone em Versões, à direita de um fluxo de trabalho, para visualizar versões anteriores, se necessário. Essa opção deve ser habilitada no Server para estar visível no Designer.
Selecione o fluxo de trabalho e clique em Abrir. Acesse Mensagens ao salvar no Server para obter mais informações sobre erros e avisos que você pode receber ao tentar salvar um fluxo de trabalho em um Server.
Adicionar novo Server
Selecione Arquivo > Abrir fluxo de trabalho > Adicionar novo Server.
Em URL, digite o caminho do URL para o Server da sua empresa.
Clique em Conectar.
As etapas de autenticação variam com base na configuração do Server:
Tipo de configuração
Etapas de autenticação
Autenticação interna
Em E-mail e Senha, digite seu e-mail e senha do Server.
Se desejado, selecione Mantenha-me conectado.
Clique em Conectar.
Autenticação do Windows
Um nome de usuário é exibido.
Selecione Continuar para fazer login.
Selecione o Server na lista e siga as etapas para abrir um fluxo de trabalho salvo no Server da sua empresa.