# Job Editor Page

## **Adding a Task to the Job Workflow**

*Once the Job gets saved in the Job list, the user can add a Task to the canvas. The user can drag the required tasks to the canvas and configure it to create a **Job workflow** or **dataflow**.*

The ***Job Editor*** appears displaying the ***Task Pallet*** containing various components mentioned as **Tasks**. 

<details>

<summary>Task Pallet</summary>

The ***Task Pallet*** is situated on the left side of the User Interface. It has a ***Task*** tab listing the various tasks.

The tasks are displayed in the below-given image:

![](/files/Vl6hSElx3qP9GHoWdrrH)

</details>

<details>

<summary>Task Components</summary>

The components used under the ***Task Pallet*** are broadly classified into:

* [x] **Readers**: Your repository of data can be a reader for you. It could be a database, a file, or a SaaS application.
* [x] **Writers**: The databases or data warehouses to which the data is loaded by the Jobs.
* [x] **Transforms**: The series of transformation tasks that help to cleanse, enrich, and prepare data for smooth analytics.

*<mark style="color:green;">Please Note:</mark> Refer to the* [***Task Components*** ](/data-pipeline-5/getting-started/homepage/create/creating-a-new-job/spark-job.md)*page for the more details.*

</details>

<details>

<summary>Searching a Task</summary>

* There is a ***Search Task*** space provided on the ***Task Panel***.

&#x20;     ![](/files/GlH3nxTe4LAqklYgTD6A)

* The user can search for a task by typing in the given space, the related Tasks will appear as suggestions.

&#x20;     ![](/files/yPXIxzk5DXyY1Hum72tY)

* Select a suggestion for search and the ***Task Panel*** will display the customized view based on the searched task.

&#x20;     ![](/files/CJiiYNtZw06TEV7ePagy)

</details>

## Steps to create a Job Workflow

* Navigate to the ***Job List*** page.&#x20;
* It will list all the jobs and also it will show the type of the Job whether it is **Spark** Job or **PySpark** Job in the type column.
* Select a ***Job*** from the displayed list.
* Click the ***View*** icon for the Job.     &#x20;

<figure><img src="/files/Nw1njQPJYvO5AnytWuF9" alt=""><figcaption><p><em><strong>List Jobs Page</strong></em></p></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark> Generally, the user can perform this step-in continuation to the **Job** creation, but in case the user has come out of the **Job Editor** the above steps can help to access it again.*
{% endhint %}

* The ***Job Editor*** opens for the selected Job.
* Drag and drop the new required task or make changes in the existing task’s meta information or change the task configuration as the requirement. (E.g., the DB Reader is dragged to the workspace in the below-given image):

<figure><img src="/files/Ol9xeEjS2MYy7qNjRFRw" alt=""><figcaption><p>Dragging and dropping task</p></figcaption></figure>

* Click on the dragged task icon.
* The task-specific fields open asking the meta-information about the dragged component.

<figure><img src="/files/3SfRvPT5BEiB4yhcG1M2" alt=""><figcaption></figcaption></figure>

* Open the Meta Information tab and configure the required information for the dragged component.
* Click the given icon to validate the connection.&#x20;
* Click the ***Save Task in Storage*** icon.

<figure><img src="/files/m3keidvNGY27XsGsSfdd" alt=""><figcaption><p><em><strong>Saving task</strong></em></p></figcaption></figure>

* A notification message appears.
* Click the ***Activate Job*** <img src="/files/f5KllGqGlD6crdn0jPf4" alt="" data-size="line"> icon to activate the job(It appears only after the newly created job gets successfully updated).
* A dialog window opens to confirm the action of job activation.
* Click the ***YES*** option to activate the job.
* A success message appears confirming the activation of the job.
* Once the job is activated, the user can see their job details while running the job by clicking on the ***View*** icon; the edit option for the job will be replaced by ***View*** icon when the job is activated.

<figure><img src="/files/Fdhz5oMnTI09pmBMoqgT" alt=""><figcaption><p>View Job</p></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">**Please Note:**</mark>*&#x20;

* *Jobs can be run in the **Development mode*** ![](/files/pITnjkAGUHpunYkagfBj) *as well. The user can preview only **10** records in the **preview** tab of the task if the job is running in the **Development mode** and if any writer task is used in the job then it will write only **10** records in the table of given database.*

* *If the job is not running in Development mode, there will be no any data in the preview tab of tasks.*
  {% endhint %}

* The ***Status*** for the Job gets changed on the job List page when they are running in the Development mode or it is activated.

<figure><img src="/files/G8uBP4e7bhziU0bAkfrY" alt=""><figcaption></figcaption></figure>

{% hint style="info" %} <mark style="color:green;">Please Note:</mark> *Click the **Delete*** ![](/files/13x1lmKoHiAN4O9IzjAi) *icon from the Job Editor page to delete the selected job. The deleted job gets removed from the Job list.*
{% endhint %}

## **Toggle Log Panel**

The Toggle Log Panel displays the Logs and Advanced Logs tabs for the Job Workflows.

* Navigate to the ***Job Editor*** page.
* Click the ***Toggle Log Panel*** icon on the header.

<figure><img src="/files/GS81HC7WlN8jXZ5M0NL5" alt=""><figcaption></figcaption></figure>

* A panel ***Toggles*** displaying the collective logs of the job under the ***Logs*** tab.

<figure><img src="/files/aHOphE47zx3Sl2qfri9F" alt=""><figcaption><p>Logs panel in Jobs</p></figcaption></figure>

* Select the ***Job Status*** tab to display the pod status of the complete Job.

<figure><img src="/files/Z6sDJvpqIKcILM5QUyAf" alt=""><figcaption><p>Job Status</p></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">**Please Note:**</mark> If any orphan task is used in the **Job Editor Workspace** which is not in use, it will cause failure for the entire Job. So, avoid using any orphan task in the Job. Please see the below given image for the reference. In the below given image, the highlighted DB writer task is an orphan task and if the Job is activated, then this Job will get failed because the orphan DB writer task is not getting any input.*&#x20;

*So, it is recommended to avoid using an orphan task inside the Job Editor workspace.*
{% endhint %}

<figure><img src="/files/gWLCtJ1YdfwVuCOYD9aR" alt=""><figcaption><p><em><strong>Using an Orphan task inside a Job Workspace</strong></em></p></figcaption></figure>

### **Icons on the Header panel of the Job Editor Page**

<table><thead><tr><th width="126.33333333333331">Icon</th><th>Name</th><th>Action</th></tr></thead><tbody><tr><td><img src="/files/tafeLsetT6ifQDX0SKW7" alt=""></td><td>Job Version details</td><td>Displays the latest versions for the Jobs upgrade.</td></tr><tr><td><img src="/files/rkYu51O9RjOhxGJ8nfUh" alt="" data-size="line"></td><td><a href="/pages/ZW9ciFOUe1WdJ7xucqeY"><strong>Log Panel</strong></a></td><td>Displays Jobs logs and Job Status tab under Log panel.</td></tr><tr><td><img src="/files/2n5JHwYwN9GoZrxZeUWa" alt="" data-size="original"></td><td><a href="/pages/af1z2x29qDsEKSTsWrz3"><strong>Job Monitoring</strong></a></td><td>Redirects to the Job Monitoring page</td></tr><tr><td><img src="/files/56LXxMxzasmke5v54gd2" alt="" data-size="line"></td><td>Development Mode</td><td>Runs the job in development mode.</td></tr><tr><td><img src="/files/w8gMUJKhq5hC8lVsT7Rd" alt="" data-size="line"></td><td>Activate Job</td><td>Activates the current  Job.</td></tr><tr><td><img src="/files/YQlG28bSJXU8zEOyPam5" alt="" data-size="line"></td><td>Update Job</td><td>Updates the current Job.</td></tr><tr><td><img src="/files/AJtKhlzONblKOeqRnprG" alt="" data-size="line"></td><td>Edit Job</td><td>To edit the job name/ configurations.</td></tr><tr><td><img src="/files/I700iMSNEGUaysc4pvyW" alt="" data-size="line"></td><td>Delete Job</td><td>Deletes the current Job.</td></tr><tr><td><img src="/files/3dbwysHCtC0lyRfWTNZT" alt="" data-size="original"></td><td>Push Job</td><td>Push the selected job to GIT.</td></tr><tr><td><img src="/files/sZDQIqFdYgT9ToAH1Ne4" alt="" data-size="original"></td><td><a href="/pages/iXWUEQQPy5ruAInLFmZR"><strong>List Job</strong></a></td><td>Redirects to the <em><strong>List Job</strong></em> page.</td></tr><tr><td><img src="/files/SLFdrko08ENtriPzDqZS" alt="" data-size="line"></td><td><a href="/pages/eEpGxqxvDbSHOR7AsFOH"><strong>Settings</strong></a></td><td>Redirects to the <em><strong>Settings</strong></em> page.</td></tr><tr><td><img src="/files/KTmEO2KkhD0THkS7l3jH" alt="" data-size="original"></td><td><a href="/pages/zzjsXjTUVt8db7HkVGGz"><strong>Full Screen</strong></a></td><td>Opens the Job in Full screen</td></tr><tr><td><img src="/files/a2pF6VHTBGGUyjzJHSW9" alt="" data-size="original"></td><td><a href="/pages/EJcnnhc9fdzhOLZYXE8R"><strong>Format Flowchart</strong></a></td><td>Format the Job tasks in arranged manner.</td></tr><tr><td><img src="/files/IQ2MEQDmvgMf6aR6S584" alt="" data-size="original"></td><td><a href="/pages/6MKhEe6YyYPnm9eLKRYY"><strong>Zoom In</strong></a></td><td>Zoom in the Job workspace.</td></tr><tr><td><img src="/files/hWDr5RQv5QU08jFeEQsf" alt="" data-size="original"></td><td><a href="/pages/6MKhEe6YyYPnm9eLKRYY"><strong>Zoom Out</strong></a></td><td>Zoom out the Job workspace.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bdb.ai/data-pipeline-5/getting-started/homepage/create/creating-a-new-job/job-editor-page.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.