# Jira

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2FV99bIsHPXJbmEKYzfq3d%2Fimage.png?alt=media&#x26;token=fd308e6e-1b64-410f-bb3c-63da50fa97b8" alt="" width="234"><figcaption></figcaption></figure>

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