README

将powermail表单提交作为jira问题发布

安装

这是一个基础扩展，不能单独使用 - 请安装以下之一：https://github.com/thomasrawiel/powermail-jira-issues 或 https://github.com/thomasrawiel/powermail-jiraonpremise-issues

需求

您需要

• 至少1个Jira项目，您可以在此项目中发布问题。
• 一个允许在该项目中创建问题的Jira用户
• 一个个人访问令牌，您可以在https://id.atlassian.com/manage-profile/security/api-tokens 获取

有关更多配置信息，请参阅：https://github.com/lesstif/php-JiraCloud-RESTAPI

配置

(工作正在进行中)

建议将您的凭据和安全相关配置值放在一个单独的 .env 文件中

连接到您的Jira实例

$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['powermail_jira'] = [
    'connection' => [
        'jiraHost' => getenv('JIRAAPI_V3_HOST'),
        'jiraUser' => getenv('JIRAAPI_V3_USER'),
        'personalAccessToken' => getenv('JIRAAPI_V3_PERSONAL_ACCESS_TOKEN'),
    ],
];

例如，在您的 additional.php 配置文件中添加此内容

此用户也将是创建的问题的作者。

添加项目

为每个项目添加一个配置数组

一些选项（如问题类型和优先级）可以配置（WIP）

$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['powermail_jira'] = [
    'issues' => [
        //configuration key, must be unique, max 20 chars
        'my_issues' => [
            //required: label for the configuration select in the powermail form backend form
            'label' => 'My Issues',
            //required: the projects project key where the issues are created
            'project_key' => getenv('PROJECT_KEY_FOR_MY_ISSUES'),
            //set type for the issues
            'type' => 'Task',
            //set priority of the issues
            'priority' => 'Medium',
        ],
        'other_issues' => [
            'label' => 'Other Issues',
            'project_key' => getenv('PROJECT_KEY_FOR_OTHER_ISSUES'),
            'type' => 'Task',
            'priority' => 'High',
        ],
    ],
];

提示：项目键是问题编号的前缀。在JRA-123的例子中，问题编号中的"JRA"部分是项目键。

标签和项目键是必需的。

使用方法

要启用向您的Jira看板发布，请确保将静态typoscript包含 添加Powermail Jira Issues Finisher 添加到您的页面模板中。

在您的表单中，选择配置

问题标题将是您在powermail插件中配置的接收者电子邮件的主题

表单的所有字段都将添加到问题的描述中

此扩展正在开发中，可能会随时更改。