External Platform Connectors
      Back to home
      1. Home
      2. 5: Workflow Toolkit
      3. External Platform Connectors

      Jira Connector

      The Jira connector node in Rayven.io provides powerful automation for managing issues and projects. With pre-configured nodes for creating, retrieving, and editing Jira issues and more.

      The Jira connector node in Rayven.io allows seamless integration of Jira’s issue tracking and project management capabilities into your workflows. Automate the creation, retrieval, and editing of Jira issues, and keep your team aligned by integrating Jira tasks with other systems in your Rayven workflows. This guide provides an overview of the available endpoints and how to configure and use the Jira connector in Rayven.io.

      Setting up the Jira Connector in Rayven.io

      1. Create a Jira Account and API Token:

        • Sign up or log in to Jira at Jira Software.
        • Navigate to Account Settings > Security > API Tokens and generate a new API token.
        • Copy the token and store it securely.

      2. Add Jira Credentials to Rayven.io:

        • In Rayven.io, navigate to Settings > Credentials.
        • Add your Jira email address, API token, and workspace URL to establish the connection between Jira and Rayven.io.

      Available Jira Operations in Rayven.io

      Below are the pre-configured endpoints available for the Jira connector in Rayven.io workflows.

      Output Operations:

      1. Create Issue
        Endpoint: Create an Issue
        Description: Automate issue creation in Jira directly from your workflows to log tasks or incidents.
        Usage: Use this node to create Jira issues when certain events occur, such as a system alert or a new customer inquiry.

      2. Edit Issue
        Endpoint: Edit an Issue
        Description: Modify existing Jira issues by updating fields such as status, priority, or description.
        Usage: Use this node to automate status updates or change issue ownership based on your business logic.

      Input Operations:

      1. Get Issue
        Endpoint: Get an Issue
        Description: Retrieve the details of a specific Jira issue by its ID or key.
        Usage: Use this node to display issue details in dashboards or send notifications based on the issue status.

      Using the Jira Connector in Rayven.io Workflows

      1. Create a New Workflow:

        • Navigate to Workflows in Rayven.io and click Create Workflow.

      2. Add Jira Nodes:

        • Drag and drop the Jira Input or Output Nodes into your workflow.

      3. Configure the Nodes:

        • For Create Issue, provide the necessary fields such as:
          • Project ID: The Jira project where the issue will be created.
          • Issue Type: Define the issue type (e.g., Bug, Task, Story).
          • Summary: A brief description of the issue.
        • For Edit Issue, specify the Issue ID or Key and the fields to update.
        • For Get Issue, enter the Issue ID or Key to retrieve its details.

      4. Incorporate Triggers and Automation:

        • Use triggers to run workflows automatically based on predefined schedules (e.g., check for new issues every hour).
        • Automate status changes or assignments using logic nodes and notifications.

      5. Push Data to Dashboards or External Systems:

        • Display issue statuses using visualization nodes on Rayven dashboards.
        • Send alerts via Slack or email when certain issues are updated or resolved.

      Using JQL (Jira Query Language) in Rayven.io

      You can retrieve issues based on specific criteria using Jira Query Language (JQL). For example, if you want to retrieve all issues related to a specific project:

      1. Use the Get Issue Node.
      2. In the JQL Field, enter a query such as:
        java
        Copy code
        project = "Rayven" AND status = "Open"
      3. This query will fetch all open issues for the "Rayven" project.

      For more advanced queries, refer to the official JQL Documentation.

      Example Use Case: Incident Management Workflow

      Scenario: When a system alert is triggered, create a Jira issue and send an email to the support team.

      1. Workflow Setup:

        • Use a trigger node to detect system alerts.
        • Add a Create Issue Node to log the incident in Jira.
        • Use an email node to notify the support team about the new issue.

      2. Automated Status Updates:

        • Add a Get Issue Node to monitor the issue status.
        • If the issue is resolved, use the Edit Issue Node to update the status to "Closed."

      HTTP Node for Additional Operations

      If your desired Jira operation is not available as a pre-configured node, use the HTTP Node in Rayven.io to call any Jira API endpoint.

      Steps:

      1. Add an HTTP Node to your workflow.
      2. Select Authentication > Predefined Credential Type and choose Jira.
      3. Provide the API endpoint, headers, and request body as required.

      Refer to the Jira API Documentation for more details on available operations.

      Conclusion

      The Jira connector node in Rayven.io provides powerful automation for managing issues and projects. With pre-configured nodes for creating, retrieving, and editing Jira issues, you can streamline your project management processes and keep your team aligned.

      For further customization, explore:

      If you need assistance with setup or further customization, contact our support team for help.