当前位置：文江博客 Node Package Readme @acumatica/jiraapi 中文文档教程

@acumatica/jiraapi 中文文档教程

发布于 4年前浏览 9 更新于 3年前

@acumatica/jiraapi

一组辅助工具，可与 JIRA REST API 一起收集、聚合和处理数据。处理无法直接从 UI 检索的数据。

Installing

npm install -g @acumatica/jiraapi

安装后，不带参数运行 jiraapi --help 以查看可用命令列表。

在 Windows 上，请确保您的 PATH 环境变量中有 %APPDATA\Roaming\npm。

在第一次执行任何命令时，该工具将要求您提供 JIRA 凭据。之后，它们将使用您操作系统上的默认凭据管理器安全地存储在您的计算机上。此工具使用 JIRA REST API 中的基本身份验证。

您可以在受让人列表中同时使用用户名 (jsmith) 或全名 (Josh Smith)。如果通过提供的全名找到多个用户，该工具将询问您应该使用哪一个。用户全名可以打错，该工具使用JIRA搜索找到合适的受让人。

Example

Getting an aggregated worklog for a predefined item category

jiraapi worklog -a "Josh Smith, Maxwell Baker, John Deer, Alexa Bloom" -t "2020 Q2" --itemtype SupportRequests

输出：

Alexa Bloom     73.79d
John Deer       54.09d
Josh Smith      30.89d
Maxwell Baker   47.87d

Total           206.64d

jiraapi worklog -a "jsmith, maxwell.baker, john.deer, alexa.bloom" -t "2019 Q4" --itemtype ExternalBugs

输出：

alexa.bloom     73.79d
john.deer       54.09d
jsmith          30.89d
maxwell.baker   47.87d

Total           206.64d

Getting an aggregated worklog using a custom JQL query

jiraapi worklog -a "John Smith, Maxwell Baker, John Deer, Alexa Bloom" -t "2019 Q4" -q "Project = PI AND Status not in (Resolved, Closed)"

Getting a detailed worklog

jiraapi worklog -a "Josh Smith, Alexa Bloom" -t "2019-12" --detailed

输出：

Alexa Bloom 2.82d
    DEV-1922 (https://jira.mydomain.com/browse/DEV-1922) 1.76d
    DEV-1378 (https://jira.mydomain.com/browse/DEV-1378) 1.06d

Josh Smith  7.93d
    PI-223 (https://jira.mydomain.com/browse/PI-223) 3.46d
    QA-8842 (https://jira.mydomain.com/browse/QA-8842) 2.29d
    DEV-1922 (https://jira.mydomain.com/browse/DEV-1922) 2.18d

Total       12.23d

如果您有一个支持嵌入式超链接的终端（例如，Windows Terminal v1 .4 及更高版本），输出将如下所示：

Alexa Bloom  2.82d
    DEV-1922 1.76d
    DEV-1378 1.06d

Josh Smith   7.93d
    PI-223   3.46d
    QA-8842  2.29d
    DEV-1922 2.18d

Total        12.23d

Getting a human-readable output for large amounts of time

jiraapi worklog -a "John Smith, Maxwell Baker, John Deer, Alexa Bloom, Nick Daniels" -t "2020 Q2" --humanize

输出：

Alexa Bloom     2 months, 2 weeks, 3 days, 2 hours, 46 minutes
John Deer       1 month, 2 weeks, 5 hours, 3 minutes
Josh Smith      3 months, 2 weeks, 2 days, 3 hours, 27 minutes
Maxwell Baker   2 months, 2 weeks, 4 days, 4 hours, 2 minutes
Nick Daniels    2 months, 1 week, 1 day, 5 hours, 48 minutes

Total           1 year, 3 weeks, 4 hours, 30 minutes

原文

@acumatica/jiraapi

A set of helper tools to work with JIRA REST API to collect, aggregate & process the data that cannot be retrieved directly from the UI.

Installing

npm install -g @acumatica/jiraapi

After installing it, run jiraapi --help without arguments to see the list of commands available.

On Windows, please make sure that you have %APPDATA\Roaming\npm in your PATH environment variable.

On the first execution of any command, the tool will ask you for your JIRA credentials. After that, they will be securely stored on your computer using the default credentials manager on your OS. This tool uses Basic Authentication in JIRA REST API.

You can use both usernames (jsmith) or full names (Josh Smith) in the list of assignees. If there are multiple users found by the full name provided, the tool will ask you which one should be used. It is OK to make typos in the user's full name, the tool uses JIRA search to find the appropriate assignee.

Example

Getting an aggregated worklog for a predefined item category

jiraapi worklog -a "Josh Smith, Maxwell Baker, John Deer, Alexa Bloom" -t "2020 Q2" --itemtype SupportRequests

Output:

Alexa Bloom     73.79d
John Deer       54.09d
Josh Smith      30.89d
Maxwell Baker   47.87d

Total           206.64d

jiraapi worklog -a "jsmith, maxwell.baker, john.deer, alexa.bloom" -t "2019 Q4" --itemtype ExternalBugs

Output:

alexa.bloom     73.79d
john.deer       54.09d
jsmith          30.89d
maxwell.baker   47.87d

Total           206.64d

Getting an aggregated worklog using a custom JQL query

jiraapi worklog -a "John Smith, Maxwell Baker, John Deer, Alexa Bloom" -t "2019 Q4" -q "Project = PI AND Status not in (Resolved, Closed)"

Getting a detailed worklog

jiraapi worklog -a "Josh Smith, Alexa Bloom" -t "2019-12" --detailed

Output:

Alexa Bloom 2.82d
    DEV-1922 (https://jira.mydomain.com/browse/DEV-1922) 1.76d
    DEV-1378 (https://jira.mydomain.com/browse/DEV-1378) 1.06d

Josh Smith  7.93d
    PI-223 (https://jira.mydomain.com/browse/PI-223) 3.46d
    QA-8842 (https://jira.mydomain.com/browse/QA-8842) 2.29d
    DEV-1922 (https://jira.mydomain.com/browse/DEV-1922) 2.18d

Total       12.23d

If you have a terminal that supports embedded hyperlinks (e.g., Windows Terminal v1.4 and higher), the output will look like this:

Alexa Bloom  2.82d
    DEV-1922 1.76d
    DEV-1378 1.06d

Josh Smith   7.93d
    PI-223   3.46d
    QA-8842  2.29d
    DEV-1922 2.18d

Total        12.23d

Getting a human-readable output for large amounts of time

jiraapi worklog -a "John Smith, Maxwell Baker, John Deer, Alexa Bloom, Nick Daniels" -t "2020 Q2" --humanize

Output:

Alexa Bloom     2 months, 2 weeks, 3 days, 2 hours, 46 minutes
John Deer       1 month, 2 weeks, 5 hours, 3 minutes
Josh Smith      3 months, 2 weeks, 2 days, 3 hours, 27 minutes
Maxwell Baker   2 months, 2 weeks, 4 days, 4 hours, 2 minutes
Nick Daniels    2 months, 1 week, 1 day, 5 hours, 48 minutes

Total           1 year, 3 weeks, 4 hours, 30 minutes

友情链接

文江博客

@acumatica/jiraapi 中文文档教程

@acumatica/jiraapi

Installing

Example

Getting an aggregated worklog for a predefined item category

Getting an aggregated worklog using a custom JQL query

Getting a detailed worklog

Getting a human-readable output for large amounts of time

@acumatica/jiraapi

Installing

Example

Getting an aggregated worklog for a predefined item category

Getting an aggregated worklog using a custom JQL query

Getting a detailed worklog

Getting a human-readable output for large amounts of time

你可能也喜欢

友情链接