# 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-6/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 display the Job type if 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/gbwHDb7rKeekgtPY4WeC" 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 if the user has come out of the **Job Editor** the above steps can help to access it.*
{% endhint %}

* The ***Job Editor*** opens for the selected Job.
* Drag and drop the new required task, 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 the ***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 the given database.*

* *If the job is not running in Development mode, there will be no 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. &#x20;

  <figure><img src="/files/EzkV2JpRQUwScpSGwovB" 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 %}

## **Job Task Preview**

Users can get a sample of the task data under the Preview Data tab provided for the tasks in the Job Workflows.

* Navigate to the ***Job Editor page*** for a selected jo&#x62;***.***
* Open a task from where you want to preview records. &#x20;

  <figure><img src="/files/W6PktkTz856Ss1gOm03g" alt=""><figcaption></figcaption></figure>
* Click the ***Preview Data*** tab to view the content.&#x20;

  <figure><img src="/files/ftUtFRQIwy3v2spNvQ8N" alt=""><figcaption><p>Data Preiew </p></figcaption></figure>

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

* *Users can preview, download, and copy up to 10 data entries.*&#x20;
* *Click the **Download** icon to download the data in **CSV, JSON, or Excel** format.*&#x20;
* *Click on the **Copy** option to copy the data as a list of dictionaries.*
  {% endhint %}

### Movable Column Separators

* Users can drag and drop column separators to adjust columns' width, allowing personalized data view.
* This feature helps accommodate various data lengths and user preferences.

### Table View

1. The event data is displayed in a structured table format.
2. The table supports sorting and filtering to enhance data usability. The previewed data can be filtered based on the ***Latest***, ***Beginning***, and ***Timestamp*** options.

* The ***Timestamp*** filter option redirects the user to select a timestamp from the Time Range window. The user can select a start and end date or choose from the available time ranges to apply and get a data preview.  &#x20;

## **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** that is not in use, it will cause failure for the entire Job. So, avoid using any orphan task in the Job. Please see the image below, for reference. In the image below the highlighted DB writer task is an orphan task and if the Job is activated, then this Job will fail because the orphan DB writer task is not getting any input. Please <mark style="color:orange;">avoid the use of an orphan task inside the Job Editor workspace</mark>.*
{% endhint %}

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

### **Version Update**

* Navigate to the ***Job Editor*** page.
* The ***Job Version update*** button will display a red dot indicating that new updates are available for the selected job.&#x20;

  <figure><img src="/files/KFFe8DdV9FYbLj2vWPRY" alt=""><figcaption></figcaption></figure>
* &#x20;The ***Confirm*** dialog box appears.
* Click the ***YES*** option.

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

* A notification message appears stating that the version is upgraded. ![](/files/nSdf1OJGJHxpPnAlbGOj)
* After the job is upgraded, the Upgrade Job Version button gets disabled. It will display that the job is up to date and no updates are available.

  <figure><img src="/files/ivMXiHfVQGuP2AI95VtB" alt=""><figcaption></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-6/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.