Workflow Management
Also available as:
loading table of contents...

Save a Workflow Draft

You can save a workflow, whether valid or invalid, to any location on HDFS to which you have access permissions. You can save an invalid draft of your workflow and access it later to complete it.

About This Task

Each workflow file must have a unique name within a single directory. If you want to save a workflow into a directory that already contains a workflow of the same name, you must either rename the workflow, add the file to a subdirectory, or overwrite the file during the save procedure.

When you save a workflow, you assign a name to the workflow application file. That name is not the same name that is automatically assigned to the workflow job that you view in the dashboard. If you want the file name and the job name to match, you must change the default name in the Name field on the design workspace.

You can save valid workflows or invalid workflows as drafts. The default name for a saved workflow is always "workflow.xml.draft" for a draft workflow that is not validated or "workflow.xml" for a valid workflow. You can change the workflow file name during the save operation.


  1. With a draft workflow open, click the Save icon on the workspace Action Menu.

  2. Click Browse to select an HDFS directory in which to save the workflow file.


    If the File Browser window opens but does not display a directory list, you might have lost network connectivity or the required data node might be unresponsive.

  3. Navigate to the directory you want, click on the directory name, and expand the directory.

  4. Optional: If a workflow file already exists in the directory:

    1. To overwrite the existing file, click Select, check Overwrite in the Save Workflow dialog box, and then click Submit.

    2. To keep the existing file and the new workflow file, in the Selected Path field, append a new name for the file or append a new subdirectory to the path, click Select, and then click Submit.

      The workflow file must use the .xml extension.

      Figure 4.6. Example of saving a workflow to a new directory

      After submitting, the new directory is created and contains the renamed workflow file.

  5. Optional: Click in the Name field and type a name for the workflow job.


    The name displayed in the Name field is the name used for a job in the dashboard. If you want the job name and the workflow file name to match, you must change both names. The tab name also reflects the content entered in the Name field.