Jira

Jira is a popular issue tracking and project management tool. This module provides functionality to load and process issues from Jira projects, supporting various filtering options and metadata customization.

This module provides a sophisticated Jira document loader that can:

  • Load issues from Jira projects

  • Filter issues by creation date

  • Control batch size for requests

  • Process content with text splitters

  • Customize metadata extraction

  • Handle API authentication

Inputs

Required Parameters

  • Connect Credential: Jira API credentials (username and access token)

  • Host: Jira instance URL (e.g., https://jira.example.com)

  • Project Key: The key of the Jira project to load issues from

Optional Parameters

  • Limit Per Request: Number of issues to fetch per API request (default: 100)

  • Created After: Filter issues created after a specific date (e.g., 2024-01-01)

  • Text Splitter: A text splitter to process the extracted content

  • Additional Metadata: JSON object with additional metadata

  • Omit Metadata Keys: Comma-separated list of metadata keys to omit

Outputs

  • Document: Array of document objects containing metadata and pageContent

  • Text: Concatenated string from pageContent of documents

Features

  • API token authentication

  • Project-based issue loading

  • Creation date filtering

  • Batch size control

  • Text splitting support

  • Metadata customization

  • Flexible output formats

Authentication

The loader requires:

  • Jira username

  • API access token

  • Host URL of your Jira instance

Document Structure

Each document contains:

  • pageContent: Issue content and description

  • metadata:

    • Issue-specific metadata (customizable)

    • Project information

    • Creation dates

    • Issue status

    • Additional custom metadata

Metadata Handling

Two ways to customize metadata:

  1. Additional Metadata: Add new metadata fields

    • Specify as JSON object

    • Merged with existing metadata

  2. Omit Metadata Keys: Remove unwanted metadata

    • Comma-separated list of keys

    • Use * to remove all default metadata

    • Nested keys supported (e.g., key1, key2, key3.nestedKey1)

Notes

  • Handles API rate limiting

  • Efficient batch processing

  • Memory-efficient loading

  • Error handling for API requests

  • Supports both cloud and self-hosted Jira

  • Real-time issue data access

Last updated