Jira Document Loader

Jira — популярный инструмент для отслеживания задач и управления проектами. Этот модуль предоставляет функциональность для загрузки и обработки задач из проектов Jira, поддерживая различные параметры фильтрации и настройку метаданных.

Данный модуль реализует продвинутый загрузчик документов Jira, который способен:

• Загружать задачи из проектов Jira
• Фильтровать задачи по дате создания
• Управлять размером пакетов запросов
• Обрабатывать содержимое с помощью разделителей текста
• Настраивать извлечение метаданных
• Обеспечивать аутентификацию через API

Входные данные

Обязательные параметры:

Connect Credential: учетные данные API Jira (имя пользователя и токен доступа) Host: URL экземпляра Jira (например, https://jira.example.com) Project Key: ключ проекта Jira, из которого нужно загружать задачи

Опциональные параметры:

• Limit Per Request: количество задач на один запрос API (по умолчанию: 100)
• Created After: фильтр задач, созданных после конкретной даты (например, 2024-01-01)
• Text Splitter: инструмент для разделения текста извлеченного содержимого
• Additional Metadata: JSON-объект с дополнительными метаданными
• Omit Metadata Keys: список ключей метаданных для исключения, разделённых запятыми

Выходные данные:

• Document: массив объектов документов с метаданными и pageContent
• Text: сконкатенированная строка, объединяющая pageContent всех документов

Особенности:

• Аутентификация по API-токену
• Загрузка задач по проектам
• Фильтрация по дате создания
• Контроль размера пакета запросов
• Поддержка разделения текста
• Настройка метаданных
• Гибкие форматы вывода

Аутентификация

Требуются:

• Имя пользователя Jira
• API токен доступа
• URL вашего экземпляра Jira

Структура документа

Каждый документ содержит:

• pageContent: содержимое и описание задачи
• metadata:
  • специфические для задачи метаданные (настраиваемые)
  • информация о проекте
  • даты создания
  • статус задачи
  • дополнительные пользовательские метаданные

Обработка метаданных

Два способа настройки:

1. Дополнительные метаданные: добавление новых полей

• указывается как JSON-объект
• объединяется с существующими метаданными

2. Исключение метаданных: удаление ненужных ключей

• список ключей через запятую
• использование * для удаления всех стандартных метаданных
• поддерживаются вложенные ключи (например, key1, key2, key3.nestedKey1)

Примечания:

• Обработка ограничения скорости API
• Эффективная работа с пакетами данных
• Экономия памяти при загрузке
• Обработка ошибок API-запросов
• Поддержка как облачной, так и локальной версии Jira
• Доступ к данным задач в реальном времени