diff --git a/apps/docs/content/docs/de/tools/jira.mdx b/apps/docs/content/docs/de/tools/jira.mdx index 2d94828c3..b85b69915 100644 --- a/apps/docs/content/docs/de/tools/jira.mdx +++ b/apps/docs/content/docs/de/tools/jira.mdx @@ -90,14 +90,20 @@ Ein Jira-Issue erstellen | Parameter | Typ | Erforderlich | Beschreibung | | --------- | ---- | -------- | ----------- | -| `domain` | string | Ja | Ihre Jira-Domain (z.B. ihrfirma.atlassian.net) | +| `domain` | string | Ja | Ihre Jira-Domain \(z.B. ihrfirma.atlassian.net\) | | `projectId` | string | Ja | Projekt-ID für das Issue | | `summary` | string | Ja | Zusammenfassung für das Issue | | `description` | string | Nein | Beschreibung für das Issue | -| `priority` | string | Nein | Priorität für das Issue | -| `assignee` | string | Nein | Bearbeiter für das Issue | -| `cloudId` | string | Nein | Jira Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie anhand der Domain abgerufen. | -| `issueType` | string | Ja | Art des zu erstellenden Issues (z.B. Task, Story) | +| `priority` | string | Nein | Prioritäts-ID oder -Name für das Issue \(z.B. "10000" oder "High"\) | +| `assignee` | string | Nein | Account-ID des Bearbeiters für das Issue | +| `cloudId` | string | Nein | Jira Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. | +| `issueType` | string | Ja | Typ des zu erstellenden Issues \(z.B. Task, Story\) | +| `labels` | array | Nein | Labels für das Issue \(Array von Label-Namen\) | +| `duedate` | string | Nein | Fälligkeitsdatum für das Issue \(Format: YYYY-MM-DD\) | +| `reporter` | string | Nein | Account-ID des Melders für das Issue | +| `environment` | string | Nein | Umgebungsinformationen für das Issue | +| `customFieldId` | string | Nein | Benutzerdefinierte Feld-ID \(z.B. customfield_10001\) | +| `customFieldValue` | string | Nein | Wert für das benutzerdefinierte Feld | #### Ausgabe @@ -107,6 +113,7 @@ Ein Jira-Issue erstellen | `issueKey` | string | Erstellter Issue-Key \(z.B. PROJ-123\) | | `summary` | string | Issue-Zusammenfassung | | `url` | string | URL zum erstellten Issue | +| `assigneeId` | string | Account-ID des zugewiesenen Benutzers \(falls zugewiesen\) | ### `jira_bulk_read` @@ -520,6 +527,30 @@ Einen Beobachter von einem Jira-Issue entfernen | `issueKey` | string | Issue-Key | | `watcherAccountId` | string | Account-ID des entfernten Beobachters | +### `jira_get_users` + +Jira-Benutzer abrufen. Wenn eine Account-ID angegeben wird, wird ein einzelner Benutzer zurückgegeben. Andernfalls wird eine Liste aller Benutzer zurückgegeben. + +#### Eingabe + +| Parameter | Typ | Erforderlich | Beschreibung | +| --------- | ---- | -------- | ----------- | +| `domain` | string | Ja | Ihre Jira-Domain \(z.B. ihrfirma.atlassian.net\) | +| `accountId` | string | Nein | Optionale Account-ID, um einen bestimmten Benutzer abzurufen. Wenn nicht angegeben, werden alle Benutzer zurückgegeben. | +| `startAt` | number | Nein | Der Index des ersten zurückzugebenden Benutzers \(für Paginierung, Standard: 0\) | +| `maxResults` | number | Nein | Maximale Anzahl der zurückzugebenden Benutzer \(Standard: 50\) | +| `cloudId` | string | Nein | Jira Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie anhand der Domain abgerufen. | + +#### Ausgabe + +| Parameter | Typ | Beschreibung | +| --------- | ---- | ----------- | +| `ts` | string | Zeitstempel der Operation | +| `users` | json | Array von Benutzern mit accountId, displayName, emailAddress, active-Status und avatarUrls | +| `total` | number | Gesamtanzahl der zurückgegebenen Benutzer | +| `startAt` | number | Startindex für Paginierung | +| `maxResults` | number | Maximale Ergebnisse pro Seite | + ## Hinweise - Kategorie: `tools` diff --git a/apps/docs/content/docs/es/tools/jira.mdx b/apps/docs/content/docs/es/tools/jira.mdx index 13f7a8015..eea1dec33 100644 --- a/apps/docs/content/docs/es/tools/jira.mdx +++ b/apps/docs/content/docs/es/tools/jira.mdx @@ -89,24 +89,31 @@ Escribir una incidencia de Jira #### Entrada | Parámetro | Tipo | Obligatorio | Descripción | -| --------- | ---- | -------- | ----------- | +| --------- | ---- | ----------- | ----------- | | `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) | | `projectId` | string | Sí | ID del proyecto para la incidencia | | `summary` | string | Sí | Resumen de la incidencia | | `description` | string | No | Descripción de la incidencia | -| `priority` | string | No | Prioridad de la incidencia | -| `assignee` | string | No | Asignado para la incidencia | -| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. | +| `priority` | string | No | ID o nombre de prioridad para la incidencia \(p. ej., "10000" o "Alta"\) | +| `assignee` | string | No | ID de cuenta del asignado para la incidencia | +| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. | | `issueType` | string | Sí | Tipo de incidencia a crear \(p. ej., Tarea, Historia\) | +| `labels` | array | No | Etiquetas para la incidencia \(array de nombres de etiquetas\) | +| `duedate` | string | No | Fecha de vencimiento para la incidencia \(formato: AAAA-MM-DD\) | +| `reporter` | string | No | ID de cuenta del informador para la incidencia | +| `environment` | string | No | Información del entorno para la incidencia | +| `customFieldId` | string | No | ID del campo personalizado \(p. ej., customfield_10001\) | +| `customFieldValue` | string | No | Valor para el campo personalizado | #### Salida | Parámetro | Tipo | Descripción | | --------- | ---- | ----------- | | `ts` | string | Marca de tiempo de la operación | -| `issueKey` | string | Clave de la incidencia creada (p. ej., PROJ-123) | +| `issueKey` | string | Clave de la incidencia creada \(p. ej., PROJ-123\) | | `summary` | string | Resumen de la incidencia | | `url` | string | URL de la incidencia creada | +| `assigneeId` | string | ID de cuenta del usuario asignado \(si está asignado\) | ### `jira_bulk_read` @@ -520,6 +527,30 @@ Eliminar un observador de una incidencia de Jira | `issueKey` | string | Clave de incidencia | | `watcherAccountId` | string | ID de cuenta del observador eliminado | +### `jira_get_users` + +Obtener usuarios de Jira. Si se proporciona un ID de cuenta, devuelve un solo usuario. De lo contrario, devuelve una lista de todos los usuarios. + +#### Entrada + +| Parámetro | Tipo | Obligatorio | Descripción | +| --------- | ---- | ----------- | ----------- | +| `domain` | string | Sí | Tu dominio de Jira \(p. ej., tuempresa.atlassian.net\) | +| `accountId` | string | No | ID de cuenta opcional para obtener un usuario específico. Si no se proporciona, devuelve todos los usuarios. | +| `startAt` | number | No | El índice del primer usuario a devolver \(para paginación, predeterminado: 0\) | +| `maxResults` | number | No | Número máximo de usuarios a devolver \(predeterminado: 50\) | +| `cloudId` | string | No | ID de Jira Cloud para la instancia. Si no se proporciona, se obtendrá usando el dominio. | + +#### Salida + +| Parámetro | Tipo | Descripción | +| --------- | ---- | ----------- | +| `ts` | string | Marca de tiempo de la operación | +| `users` | json | Array de usuarios con accountId, displayName, emailAddress, estado activo y avatarUrls | +| `total` | number | Número total de usuarios devueltos | +| `startAt` | number | Índice de inicio de paginación | +| `maxResults` | number | Máximo de resultados por página | + ## Notas - Categoría: `tools` diff --git a/apps/docs/content/docs/fr/tools/jira.mdx b/apps/docs/content/docs/fr/tools/jira.mdx index 70ccb82cc..094e40754 100644 --- a/apps/docs/content/docs/fr/tools/jira.mdx +++ b/apps/docs/content/docs/fr/tools/jira.mdx @@ -89,15 +89,21 @@ Rédiger une demande Jira #### Entrée | Paramètre | Type | Obligatoire | Description | -| --------- | ---- | -------- | ----------- | -| `domain` | string | Oui | Votre domaine Jira (ex. : votreentreprise.atlassian.net) | -| `projectId` | string | Oui | ID du projet pour la demande | -| `summary` | string | Oui | Résumé de la demande | -| `description` | string | Non | Description de la demande | -| `priority` | string | Non | Priorité de la demande | -| `assignee` | string | Non | Assigné de la demande | -| `cloudId` | string | Non | ID Jira Cloud pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. | -| `issueType` | string | Oui | Type de demande à créer (ex. : Tâche, Story) | +| --------- | ---- | ----------- | ----------- | +| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) | +| `projectId` | chaîne | Oui | ID du projet pour le ticket | +| `summary` | chaîne | Oui | Résumé du ticket | +| `description` | chaîne | Non | Description du ticket | +| `priority` | chaîne | Non | ID ou nom de la priorité du ticket \(ex. : "10000" ou "Haute"\) | +| `assignee` | chaîne | Non | ID de compte de l'assigné pour le ticket | +| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. | +| `issueType` | chaîne | Oui | Type de ticket à créer \(ex. : tâche, story\) | +| `labels` | tableau | Non | Étiquettes pour le ticket \(tableau de noms d'étiquettes\) | +| `duedate` | chaîne | Non | Date d'échéance du ticket \(format : AAAA-MM-JJ\) | +| `reporter` | chaîne | Non | ID de compte du rapporteur pour le ticket | +| `environment` | chaîne | Non | Informations d'environnement pour le ticket | +| `customFieldId` | chaîne | Non | ID du champ personnalisé \(ex. : customfield_10001\) | +| `customFieldValue` | chaîne | Non | Valeur pour le champ personnalisé | #### Sortie @@ -107,6 +113,7 @@ Rédiger une demande Jira | `issueKey` | chaîne | Clé du ticket créé \(ex. : PROJ-123\) | | `summary` | chaîne | Résumé du ticket | | `url` | chaîne | URL vers le ticket créé | +| `assigneeId` | chaîne | ID de compte de l'utilisateur assigné \(si assigné\) | ### `jira_bulk_read` @@ -520,7 +527,31 @@ Supprimer un observateur d'un ticket Jira | `issueKey` | string | Clé du ticket | | `watcherAccountId` | string | ID du compte observateur supprimé | -## Notes +### `jira_get_users` + +Récupère les utilisateurs Jira. Si un ID de compte est fourni, renvoie un seul utilisateur. Sinon, renvoie une liste de tous les utilisateurs. + +#### Entrée + +| Paramètre | Type | Obligatoire | Description | +| --------- | ---- | ----------- | ----------- | +| `domain` | chaîne | Oui | Votre domaine Jira \(ex. : votreentreprise.atlassian.net\) | +| `accountId` | chaîne | Non | ID de compte optionnel pour obtenir un utilisateur spécifique. S'il n'est pas fourni, renvoie tous les utilisateurs. | +| `startAt` | nombre | Non | L'index du premier utilisateur à renvoyer \(pour la pagination, par défaut : 0\) | +| `maxResults` | nombre | Non | Nombre maximum d'utilisateurs à renvoyer \(par défaut : 50\) | +| `cloudId` | chaîne | Non | ID Cloud Jira pour l'instance. S'il n'est pas fourni, il sera récupéré à l'aide du domaine. | + +#### Sortie + +| Paramètre | Type | Description | +| --------- | ---- | ----------- | +| `ts` | chaîne | Horodatage de l'opération | +| `users` | json | Tableau d'utilisateurs avec accountId, displayName, emailAddress, statut actif et avatarUrls | +| `total` | nombre | Nombre total d'utilisateurs renvoyés | +| `startAt` | nombre | Index de début de pagination | +| `maxResults` | nombre | Nombre maximum de résultats par page | + +## Remarques - Catégorie : `tools` - Type : `jira` diff --git a/apps/docs/content/docs/ja/tools/jira.mdx b/apps/docs/content/docs/ja/tools/jira.mdx index 7a9cc4e91..0aeb57552 100644 --- a/apps/docs/content/docs/ja/tools/jira.mdx +++ b/apps/docs/content/docs/ja/tools/jira.mdx @@ -94,10 +94,16 @@ Jira課題を作成する | `projectId` | string | はい | 課題のプロジェクトID | | `summary` | string | はい | 課題の要約 | | `description` | string | いいえ | 課題の説明 | -| `priority` | string | いいえ | 課題の優先度 | -| `assignee` | string | いいえ | 課題の担当者 | +| `priority` | string | いいえ | 課題の優先度IDまたは名前（例：「10000」または「高」） | +| `assignee` | string | いいえ | 課題の担当者アカウントID | | `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 | | `issueType` | string | はい | 作成する課題のタイプ（例：タスク、ストーリー） | +| `labels` | array | いいえ | 課題のラベル（ラベル名の配列） | +| `duedate` | string | いいえ | 課題の期限（形式：YYYY-MM-DD） | +| `reporter` | string | いいえ | 課題の報告者アカウントID | +| `environment` | string | いいえ | 課題の環境情報 | +| `customFieldId` | string | いいえ | カスタムフィールドID（例：customfield_10001） | +| `customFieldValue` | string | いいえ | カスタムフィールドの値 | #### 出力 @@ -106,7 +112,8 @@ Jira課題を作成する | `ts` | string | 操作のタイムスタンプ | | `issueKey` | string | 作成された課題キー（例：PROJ-123） | | `summary` | string | 課題の要約 | -| `url` | string | 作成された課題へのURL | +| `url` | string | 作成された課題のURL | +| `assigneeId` | string | 割り当てられたユーザーのアカウントID（割り当てられている場合） | ### `jira_bulk_read` @@ -520,7 +527,31 @@ Jira課題からウォッチャーを削除する | `issueKey` | string | 課題キー | | `watcherAccountId` | string | 削除されたウォッチャーのアカウントID | -## 注意事項 +### `jira_get_users` -- カテゴリー: `tools` -- タイプ: `jira` +Jiraユーザーを取得します。アカウントIDが提供された場合、単一のユーザーを返します。それ以外の場合、すべてのユーザーのリストを返します。 + +#### 入力 + +| パラメータ | 型 | 必須 | 説明 | +| --------- | ---- | -------- | ----------- | +| `domain` | string | はい | あなたのJiraドメイン（例：yourcompany.atlassian.net） | +| `accountId` | string | いいえ | 特定のユーザーを取得するためのオプションのアカウントID。提供されない場合、すべてのユーザーを返します。 | +| `startAt` | number | いいえ | 返す最初のユーザーのインデックス（ページネーション用、デフォルト：0） | +| `maxResults` | number | いいえ | 返すユーザーの最大数（デフォルト：50） | +| `cloudId` | string | いいえ | インスタンスのJira Cloud ID。提供されない場合、ドメインを使用して取得されます。 | + +#### 出力 + +| パラメータ | 型 | 説明 | +| --------- | ---- | ----------- | +| `ts` | string | 操作のタイムスタンプ | +| `users` | json | accountId、displayName、emailAddress、activeステータス、avatarUrlsを含むユーザーの配列 | +| `total` | number | 返されたユーザーの総数 | +| `startAt` | number | ページネーション開始インデックス | +| `maxResults` | number | ページあたりの最大結果数 | + +## 注記 + +- カテゴリ：`tools` +- タイプ：`jira` diff --git a/apps/docs/content/docs/zh/tools/jira.mdx b/apps/docs/content/docs/zh/tools/jira.mdx index d5013e470..880f85940 100644 --- a/apps/docs/content/docs/zh/tools/jira.mdx +++ b/apps/docs/content/docs/zh/tools/jira.mdx @@ -91,13 +91,19 @@ Jira 的主要功能包括： | 参数 | 类型 | 必需 | 描述 | | --------- | ---- | -------- | ----------- | | `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) | -| `projectId` | 字符串 | 是 | 问题的项目 ID | -| `summary` | 字符串 | 是 | 问题的摘要 | -| `description` | 字符串 | 否 | 问题的描述 | -| `priority` | 字符串 | 否 | 问题的优先级 | -| `assignee` | 字符串 | 否 | 问题的负责人 | -| `cloudId` | 字符串 | 否 | 实例的 Jira 云 ID。如果未提供，将使用域名获取。 | -| `issueType` | 字符串 | 是 | 要创建的问题类型 \(例如：任务、故事\) | +| `projectId` | 字符串 | 是 | 问题所属项目 ID | +| `summary` | 字符串 | 是 | 问题摘要 | +| `description` | 字符串 | 否 | 问题描述 | +| `priority` | 字符串 | 否 | 问题优先级 ID 或名称 \(例如：“10000”或“High”\) | +| `assignee` | 字符串 | 否 | 问题负责人账户 ID | +| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 | +| `issueType` | 字符串 | 是 | 要创建的问题类型 \(例如：Task、Story\) | +| `labels` | 数组 | 否 | 问题标签 \(标签名称数组\) | +| `duedate` | 字符串 | 否 | 问题截止日期 \(格式：YYYY-MM-DD\) | +| `reporter` | 字符串 | 否 | 问题报告人账户 ID | +| `environment` | 字符串 | 否 | 问题环境信息 | +| `customFieldId` | 字符串 | 否 | 自定义字段 ID \(例如：customfield_10001\) | +| `customFieldValue` | 字符串 | 否 | 自定义字段的值 | #### 输出 @@ -107,6 +113,7 @@ Jira 的主要功能包括： | `issueKey` | 字符串 | 创建的问题键 \(例如：PROJ-123\) | | `summary` | 字符串 | 问题摘要 | | `url` | 字符串 | 创建的问题的 URL | +| `assigneeId` | 字符串 | 已分配用户的账户 ID（如已分配） | ### `jira_bulk_read` @@ -520,7 +527,31 @@ Jira 的主要功能包括： | `issueKey` | string | 问题键 | | `watcherAccountId` | string | 移除的观察者账户 ID | -## 注意事项 +### `jira_get_users` -- 类别: `tools` -- 类型: `jira` +获取 Jira 用户。如果提供了账户 ID，则返回单个用户，否则返回所有用户的列表。 + +#### 输入 + +| 参数 | 类型 | 必需 | 描述 | +| --------- | ---- | -------- | ----------- | +| `domain` | 字符串 | 是 | 您的 Jira 域名 \(例如：yourcompany.atlassian.net\) | +| `accountId` | 字符串 | 否 | 可选账户 ID，用于获取特定用户。如果未提供，则返回所有用户。 | +| `startAt` | 数字 | 否 | 要返回的第一个用户的索引 \(用于分页，默认值：0\) | +| `maxResults` | 数字 | 否 | 要返回的最大用户数 \(默认值：50\) | +| `cloudId` | 字符串 | 否 | 实例的 Jira Cloud ID。如果未提供，将使用域名获取。 | + +#### 输出 + +| 参数 | 类型 | 描述 | +| --------- | ---- | ----------- | +| `ts` | 字符串 | 操作的时间戳 | +| `users` | json | 用户数组，包含 accountId、displayName、emailAddress、active 状态和 avatarUrls | +| `total` | 数字 | 返回的用户总数 | +| `startAt` | 数字 | 分页起始索引 | +| `maxResults` | 数字 | 每页最大结果数 | + +## 备注 + +- 分类：`tools` +- 类型：`jira` diff --git a/apps/docs/i18n.lock b/apps/docs/i18n.lock index c5718252d..5556a4124 100644 --- a/apps/docs/i18n.lock +++ b/apps/docs/i18n.lock @@ -2521,9 +2521,9 @@ checksums: content/22: ef92d95455e378abe4d27a1cdc5e1aed content/23: febd6019055f3754953fd93395d0dbf2 content/24: 371d0e46b4bd2c23f559b8bc112f6955 - content/25: 7ef3f388e5ee9346bac54c771d825f40 + content/25: caf6acbe2a4495ca055cb9006ce47250 content/26: bcadfc362b69078beee0088e5936c98b - content/27: e0fa91c45aa780fc03e91df77417f893 + content/27: 57662dd91f8d1d807377fd48fa0e9142 content/28: b463f54cd5fe2458b5842549fbb5e1ce content/29: 55f8c724e1a2463bc29a32518a512c73 content/30: 371d0e46b4bd2c23f559b8bc112f6955 @@ -2638,8 +2638,14 @@ checksums: content/139: 33fde4c3da4584b51f06183b7b192a78 content/140: bcadfc362b69078beee0088e5936c98b content/141: b7451190f100388d999c183958d787a7 - content/142: b3f310d5ef115bea5a8b75bf25d7ea9a - content/143: 4930918f803340baa861bed9cdf789de + content/142: d0f9e799e2e5cc62de60668d35fd846f + content/143: b19069ff19899fe202217e06e002c447 + content/144: 371d0e46b4bd2c23f559b8bc112f6955 + content/145: 480fd62f8d9cc18467e82f4c3f70beea + content/146: bcadfc362b69078beee0088e5936c98b + content/147: 4e73a65d3b873f3979587e10a0f39e72 + content/148: b3f310d5ef115bea5a8b75bf25d7ea9a + content/149: 4930918f803340baa861bed9cdf789de 8f76e389f6226f608571622b015ca6a1: meta/title: ddfe2191ea61b34d8b7cc1d7c19b94ac meta/description: 049ff551f2ebabb15cdea0c71bd8e4eb