Skip to main content

Build Plans

In Plan View, you design your plan, which includes the building and sequencing of tasks and the triggers that execute your sequence of tasks.

When a plan is triggered Alteryx One captures a snapshot of the objects in the plan. This snapshot defines the set of tasks that are executed as part of a plan run. Snapshots don’t include the assets behind tasks, so later changes to those assets may affect task outcomes during plan execution.

  • The set of tasks in the plan is triggered in the order listed in the plan.

  • All of the dependencies for any task are also executed.

  • If one task fails to execute, the other tasks are not executed.

Antes de começar

Antes de começar, verifique o seguinte:

  • Você tem acesso a todos os ativos que deseja usar em seu plano.

Criar plano

Para começar, é preciso criar um objeto de plano.

  1. Na página de chegada do Alteryx One, selecione Planos no seletor de aplicativos.

  2. Na página "Planos", clique em Novo. Um novo plano com o nome Untitled plan - X é criado, onde X é um número.

  3. Clique em Untitled plan - X para inserir um nome e uma descrição para o plano.

  4. O seu plano é salvo e apresentado na "Exibição do plano".

Na exibição do plano, você cria os objetos que fazem parte do plano. Eles incluem:

  • Agendamento do plano: um agendamento é composto por um ou mais acionadores que determinam quando o plano é executado.

    • Acionador: objeto de agendamento que determina as condições sob as quais o plano é executado.

    • Um agendamento pode conter um ou mais acionadores.

  • Tarefa: uma ação que é executada quando acionada.

    • Você pode criar uma sequência de uma ou mais tarefas em seu plano.

Drag and drop a task from the left side panel of tasks. Configuration window for the task should pop up on the right.

Criar tarefa

  1. Identifique as tarefas que deseja executar.

    Nota

    Você deve ter acesso aos ativos que deseja executar como tarefas.

  2. Na página "Exibição do plano", arraste e solte um tipo de tarefa na tela do plano. Os detalhes da tarefa e as opções de configuração são exibidos no lado direito.

  3. Selecione a tarefa e configure-a conforme necessário.

  4. Acrescente tarefas adicionais conforme necessário.

  5. Para testar seu plano, clique em Executar. O plano é imediatamente colocado na fila para execução.

  6. Edite o plano e repita as etapas acima até que o plano esteja pronto para execução de produção.

    Dica

    Enquanto um plano está em desenvolvimento, você pode desabilitar o agendamento, o que impede a execução de acordo com o agendamento. Você ainda pode realizar execuções de teste usando o botão Executar.

  7. Para criar o agendamento, selecione Agendar.

    1. Especifique um ou mais acionadores para o agendamento. Quando o acionador ocorre, o plano é colocado na fila para execução.

  8. Quando estiver pronto, o plano será executado na hora agendada no acionador.

Tipos de tarefa

For a complete overview of the tasks and their specific details, visit Plan Tasks.

View for Tasks

When you create or select a task, you can modify its settings through the context panel on the right.

Task context menu options:

Some options may not be available for specific task types.

  • Edit name: Modify the name of the task.

  • Delete: Delete the task from your plan.

To cancel a plan that is currently running, click Cancel plan run.

Task Execution Rule

Next to the task you created, you'll find a set of icons on the right. These symbols represent the possible outcomes—whether the task succeeds, fails, or can lead to either result.

Icon

Description

Plans-SuccessIcon.png

Success

Plans-FailureIcon.png

Failure

Plans-OnExecutionAnyStatus.png

Any status

Plans-OutputAnchor.png

Input Anchor

Dica

Você pode adicionar novas tarefas ao seu plano e conectá-las à primeira tarefa em um desses caminhos.

You can gate the execution of a task based on the completion status of its previous task. To execute the task, click and join the required icons to the output anchor of another task. You can also drag the required icon to the output anchor of any task. See the icons above.

  • On success: Runs if the previous task is successful.

  • On failure: Runs if the previous task is failed.

  • On execution (any status): Runs the task in the canvas irrespective of the previous task's status (success or failure).

Criar ramificações do plano

Em alguns cenários, talvez seja necessário ramificar as etapas de execução do plano com base nos resultados de uma tarefa dentro dele. Por exemplo, pode ser necessário enviar mensagens separadas usando uma tarefa HTTP com base no sucesso ou na falha de uma tarefa anterior. Você pode criar ramificações no gráfico de planos adicionando regras de execução de tarefas e nós paralelos, que são executados com base nos estados de sucesso e falha das execução de seu plano.

Para começar este exemplo simples:

  1. Crie sua primeira tarefa.

  2. Conclua as seguintes seções.

Exemplo: tarefas de sucesso ou falha em um plano

Plans-TaskExecutionRules.png

Figura: execução condicional de uma tarefa em um plano

Aplicar substituições de parâmetros

Se as tarefas do seu plano incluírem ativos em que parâmetros foram definidos, você poderá revisar e substituir esses valores de parâmetros. As substituições são aplicadas quando a tarefa é acionada como parte da execução de um plano.

Suporte limitado à parametrização

O Plans é compatível com a parametrização apenas para fluxos do Trifacta Classic no momento.

  1. No menu de contexto "Exibição do plano", selecione Parâmetros.

  2. Revise os nomes, fontes e valores atuais de todos os parâmetros em seu plano.

  3. Para aplicar uma substituição, selecione o ícone de lápis e insira um novo valor. Clique em Salvar.

As execuções posteriores do plano usam esse novo valor como substituição para o parâmetro.

Testar plano

Depois de criar as tarefas do seu plano, você pode realizar uma execução de teste.

  1. Para testar, clique em Executar.

  2. O plano é colocado na fila para execução.

Monitorar execuções do plano

  1. No canto superior direito de "Exibição do plano", clique no link "Execuções".

  2. Na página "Execuções do plano", você pode monitorar o progresso da execução do seu plano.

    1. A execução do plano acionada mais recentemente é exibida.

    2. Se você realizou múltiplas execuções, pode usar os colchetes angulares ao lado do carimbo de data/hora para a execução.

  3. Para tarefas em andamento, você pode selecionar a tarefa para exibir informações no painel de contexto.

  4. Para ver os detalhes da execução do plano, clique na guia "Saídas". Em seguida, selecione Detalhes do trabalho.

Para obter mais informações, vá para Página "Execuções do plano".

Adicionar agendamento do plano

Você pode adicionar um objeto de agendamento para especificar os acionadores da execução do plano.

Nota

O agendamento de um plano não pode ser executado até que tenha sido habilitado. Se um plano tiver um agendamento desabilitado, você ainda poderá executá-lo com o botão "Executar agora".

Etapas:

  1. Para começar, você pode clicar em Agendar no menu de contexto "Exibição do plano" ou em Criar agendamento no painel de contexto direito.

  2. No painel "Adicionar acionador", você pode especificar os acionadores de quando o plano deve ser executado. Você pode especificar um ou mais acionadores:

    CreateaPlan-AddTrigger.png

    Figura: adicionar acionador(es)

  3. Para cada acionador:

    1. Fuso horário: especifique o fuso horário que se aplica à hora agendada. Para obter mais informações sobre fusos horários, vá para Valores de fuso horário com suporte.

    2. Frequência: você pode especificar a frequência de quando o agendamento é acionado.

      1. Para cada acionador, você pode especificar múltiplos valores para "Em" (por exemplo, mesmo horário no domingo e na segunda-feira).

      2. Conforme necessário, você pode especificar o valor de "Em" usando uma forma modificada de sintaxe de trabalho cron. Para obter mais informações, vá para Referência de sintaxe de agendamento cron.

  4. Para adicionar mais acionadores, selecione Adicionar outro acionador e especifique-o.

    1. Para excluir um acionador, selecione o "X" ao lado dele.

  5. Substituições de parâmetros:

    1. Se os ativos do seu plano contiverem parâmetros, você poderá aplicar substituições aos valores dos parâmetros.

      Suporte limitado à parametrização

      O Plans é compatível com a parametrização apenas para fluxos do Trifacta Classic no momento.

    2. As substituições fornecidas neste painel são aplicadas apenas quando o acionador é executado.

      Nota

      Múltiplos valores são aceitos para parâmetros de plano, desde que os valores de parâmetro não entrem em conflito. Se você vir um ícone de aviso ao lado de um conjunto de múltiplos valores de parâmetros, deverá corrigir esse conflito no ativo original ou o plano não será executado.

    3. Você também pode aplicar substituições por meio de "Exibição do plano".

  6. Para salvar o agendamento, clique em Salvar.

  7. No painel de contexto, você pode fazer alterações em seu agendamento:

    1. Depois de salvar, o agendamento é automaticamente habilitado. Para desabilitar o agendamento, use a barra deslizante.

      Nota

      Não é possível executar um plano se o agendamento tiver sido desabilitado.

    2. Para fazer alterações no agendamento e seus acionadores, clique em Editar.

Top Bar

Dica

To rename the plan, select the plan name in the top bar.

  • Run: Run the plan. You can track the progress of your plan run. Go to Run Plans Page.

    Dica

    You can apply overrides to parameters through the Parameters tab. Go to Plan Runs Page.

  • Schedule: Create or edit the plan schedule with one or more triggers through the right context panel. Go to Schedule Plans.

  • Share: Share the plan with other users. Go to Share a Plan.Share a Plan

  • Runs: The Runs link tracks the current total number of runs that have been queued or executed for this plan. Click this link to track the progress on your plan run.

Plan context menu (three-dot menu)

  • Rename: Modify the name and description for your plan.

  • Parameters: You can apply overrides to the parameters for your plan tasks during plan job runs. Go to Manage Plans Parameters.

    Suporte limitado à parametrização

    O Plans é compatível com a parametrização apenas para fluxos do Trifacta Classic no momento.

  • Email notifications: Send email notifications on the plan runs. Go to Manage Plan Notifications.

  • Export: Export the plan from Alteryx One. Go to Export and Import Plan.

  • Transfer ownership: (Available to owner or admin only) Transfer ownership of this asset to another user. Go to Transfer Asset Ownership.

  • Delete: Delete your plan.