Managing Job Tags

Adding a Job Tag

1. Log in to the DataArts Studio console by following the instructions in Accessing the DataArts Studio Instance Console.
2. On the DataArts Studio console, locate a workspace and click DataArts Factory.
3. In the navigation pane, choose Configuration > Configure.
4. Choose Job Tag.
5. Click Add. In the displayed dialog box, enter a tag name and click OK.
   

   You can add a maximum of 100 job tags.

Deleting a Job Tag

1. In the navigation pane, choose Configuration > Configure.
2. Choose Job Tag.
3. Locate the tag you want to delete and click Delete in the Operation column. In the displayed dialog box, click OK.
   

   A locked tag cannot be deleted. For details about how to unlock a tag, see Locking and Unlocking a Job Tag.

Monitoring Jobs with a Specified Tag

1. In the navigation pane, choose Configuration > Configure.
2. Choose Job Tag.
3. Locate a tag and click Monitor in the Operation column. The Monitor Job page is displayed, on which all the jobs with the tag are displayed.

Locking and Unlocking a Job Tag

To perform these operations, you must have the Administrator, Tenant Administrator, or workspace administrator permission.

1. In the navigation pane, choose Configuration > Configure.
2. Choose Job Tag.
3. Locate a tag and click Lock or Unlock in the Operation column.
   

   • A locked job tag cannot be deleted.
   • Importing a locked tag will fail.
   • A locked tag cannot be added to or removed from a job.
   • Importing a job with a locked tag will fail.
   • When a job fails to be imported and a tag needs to be automatically generated, if the tag already exists and is locked, it will not be added to the job.

Importing Job Tags

To perform these operations, you must have the Administrator, Tenant Administrator, or workspace administrator permission.

1. In the navigation pane, choose Configuration > Configure.
2. Choose Job Tag.
3. Click Import Job Tag.
4. In the displayed dialog box, set the following parameters:
   • File Location: Select Local or OBS.
   • Select File from Local/OBS: Select a local path or an OBS bucket path.
     

     • You are advised to obtain a file to import by exporting tags. The first row of the file is the tag name, and the first column is the job name. If a job has a specified tag, the value in the corresponding cell is 1. Otherwise, the value is 0. If a cell is empty, the system uses value 0 for the cell.
     • The maximum size of the file to be imported is 10 MB.
     • If the file to be imported contains two tags with the same name, and the ID of one tag is 0 and that of the other tag is 1, the system uses 1 as the tag ID.
     • If the file to be imported contains two jobs with the same name, the system identifies the job in the latter row and uses the tag ID in this row.
   • Mode: Select Append or Overwrite.
     • Append: The new tag will not overwrite the existing one.
     • Overwrite: The new tag will overwrite the existing one.

5. Click OK.

Exporting Job Tags

1. In the navigation pane, choose Configuration > Configure.
2. Choose Job Tag.
3. Export tags.
   • To export all tags, click Export All Tags above the tag list.
   • To export some tags, select them and click Export Selected Tags above the tag list.

   The following figure shows the exported job tags.

   Figure 1 Exporting job tags
   
   

   • In the exported file, the first row is the tag name, and the first column is the job name. If a job has a specified tag, the value in the corresponding cell is 1. Otherwise, the value is 0.
   • The first column displays names of all the jobs in the workspace, including real-time job nodes, For Each subjobs, and Subjob subjobs.