Specific SIL™ integrations

Predefined structures for a Slack message

Configuring an integration

General setup

To configure an integration, perform the following operations:

1. In your Jira, go to Manage apps > Anova Apps

   Plugin ConfigurationImage Removed

   Plugin Configuration > Integration Configurations, and click Add Integration.

   
   

   
   
   

   View file
   name Invalid file id - UNKNOWN_MEDIA_ID page SIL Template Language

2. Fill in the necessary fields:

   • Name - Name of the integration, it should be unique from other integrations

   • Type - Integration type 

   • Access token
     

     Image Removed

     
     

     View file
     name Invalid file id - UNKNOWN_MEDIA_ID page SIL Template Language

3. Save the integration. After saving the added integration, a new entry is added to the table on the Integration Configurations page. 

To edit or remove a configuration, click Edit/Delete.

Configuring notifications to go from Jira to Slack

In order to send a message to a Slack room, add an integration configuration to the Integration Configurations page using new Slack apps functionality. To get an access token, perform the following operations:

1. Navigate to the Slack API page.

2. Click Your Apps > Create New App.

3. Go to your app and click Add Features and functionality.

   
   Image Removed

   
   

   View file
   name Invalid file id - UNKNOWN_MEDIA_ID page SIL Template Language

4. Go to Permissions > Scopes and select what this app is going to do. Click Save Changes.
   
   Image Modified
   

5. Go to Permissions > OAuth & Permissions. Install your app to the workspace. When you install the app, the the tokens are automatically generated. Otherwise,  in order to generate your OAuth tokens, request the approval to install this app on your workspace. Click Request Approval to send the request to Slack admins.

   Image Removed

   View file
   name Invalid file id - UNKNOWN_MEDIA_ID page SIL Template Language

   Optionally, you can Manage distribution for your app and enable other workspaces to install your app using OAuth.

   Image Removed

   View file
   name Invalid file id - UNKNOWN_MEDIA_ID page SIL Template Language

6. OAuth

   Copy the

    

    OAuth Access

   Token 

   Token to the

    Integration Configurations 

    Integration Configurations page and Save.

   
   Image Removed

   
   

   View file
   name Invalid file id - UNKNOWN_MEDIA_ID page SIL Template Language

7. That's it. Your configuration is ready.

Examples

Send a message to Slack when a ticket is created

To send a message to Slack when an issue is created, add a post-function on the create transition in Jira with the following code:

JSlackAttachment att1;
att1.pretext = "Optional text that appears above the attachment block";
att1.title = "This is an example of attachment ...";
att1.text = "*Bold* ~strike~ text";
att1.color = "#4286f4";
 
JSlackAttachment att2;
att2.title = "This is an example of attachment with code.";
att2.text = "`var i = 0; doSomethingWith(i);`";
att2.color = "#f45641";
 
JSlackMessage message;
message.channel = "C9S2LC24T";
message.text = "Test slack message with attachment...";
message.attachments = {att1, att2};
 
 
return sendIntegrationMessage("SLACK", message);

See also