Manage Labels

Use the Manage Labels job to schedule routine label management. You can manage labels on new pages and spaces, which helps your users find relevant content. 

Follow these steps to set up a Manage Labels job. 

  1. Navigate to General Configuration > ScriptRunner > Jobs. 
  2. Select Create Job. 
  3. Select Manage Labels Job. 
  4. Enter a Note for your reference. 
    You could add a description of the job to easily identify it later. 

  5. Select the User. 
    When this job runs, this user is entered as who made the change. 

    You can create a user to assign for jobs like this. For example, ScriptRunner Bot User.

  6. Enter an Interval/Cron Expression. 
    Determine how often you want this job to run. You can select Show Examples to use an included expression or enter your own. You have two options for this field: 

    • If you want it to run on a schedule, enter the minutes. For example, 30 for every thirty minutes or 120 for every two hours.
    • If you want it to run at a certain time or day, enter a cron expression.
  7. Choose the type of content that should have labels affected. Your choices are: 
    • All Content Types
    • Page
    • Blog
    • Attachment
  8. Choose the Location where you want this job to work. 
    Your options are: 
    • All Spaces
    • Select Space(s)
      If you choose Select Space(s), the Target Space(s) fields appear, where you can select what space and pages you want to work with. 

    • Select Page(s) Within a Specific Space
      If you choose Selected Space, the Space and Page(s) fields appear, where you can select what space and pages you want to work with. 

      Not available for All Content Types.

  9. Once you make your selections, you can choose an Action:  
    • Add Label(s)
      1. Label(s) appears, where you can enter the labels that you want added to the page. 
    • Remove Label(s)
      1. Label(s) appears, where you can enter the labels that you want removed from the page. 
    • Rename Labels
      1. Original Name appears, where you enter the old label name that you want to change. 
      2. New Name appears, where you enter the new label name. 
  10. Select Add. 


Example

Add a label

Using this job, you can review and correct labels based on a parent page on a schedule. For example, you could run a weekly review to ensure that a benefits label was added to all pages under the main Benefits page in an HR space.

  1. The Note Benefits label for HR space describes the job. 
  2. Enter admin for the User.
  3. Enter 0 0 17 ? * FRI for the Interval/Cron Expression. 
  4. Select Page for Content Type.
  5. For Location, choose Selected Spaces Within a Specifc Page to be able to pick a specific space. 
  6. For Space, enter HR. 
  7. For Page(s), select Benefits Home to work with all pages updated or created in this section. 
  8. For Action, choose Add Label(s). 
  9. For Label(s), enter benefits to name the label. 
  10. Click Add. 

Now, at 5:00 PM on Fridays, the job runs, and pages in the Benefits section of the HR space are checked to make sure the benefits label is there. If it's not, it will be added.

Related Content



On this page