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 existing workflow, add the file to a subdirectory, or overwrite the file during the save procedure.


When you save a workflow, the name you assign is given only to the workflow application file. It does not automatically match the name displayed for the workflow job in the dashboard. WFM assigns to the workflow job the name you enter in the Name field in the design workspace. If you want the job name and the application file name to match, you must assign the same name in the Name field and to the application file.

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.