{"id":18045,"date":"2023-01-06T02:55:49","date_gmt":"2023-01-06T02:55:49","guid":{"rendered":"https:\/\/44.225.35.201\/testrail\/docs\/801\/server-guide\/customizations-and-extensions\/customizing-a-defect-plugin\/"},"modified":"2023-09-12T11:26:58","modified_gmt":"2023-09-12T02:26:58","slug":"example-custom-plugin","status":"publish","type":"page","link":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/server-guide\/customizations-and-extensions\/example-custom-plugin\/","title":{"rendered":"\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306e\u30ab\u30b9\u30bf\u30de\u30a4\u30ba"},"content":{"rendered":"<p>TestRail \u306b\u306f\u3001Jira\u3001FogBugz\u3001Bugzilla \u306a\u3069\u306e\u4e00\u822c\u7684\u306a\u30d0\u30b0 \u30c8\u30e9\u30c3\u30ab\u30fc\u306b\u5bfe\u5fdc\u3057\u305f\u3059\u3050\u306b\u4f7f\u3048\u308b\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u304c\u4ed8\u5c5e\u3057\u3066\u3044\u307e\u3059\u3002\u30d0\u30b0\u8ffd\u8de1\u30c4\u30fc\u30eb\u304c\u30ab\u30b9\u30bf\u30de\u30a4\u30ba\u3055\u308c\u3066\u3044\u308b\u5834\u5408 (\u30ab\u30b9\u30bf\u30e0 \u30d5\u30a3\u30fc\u30eb\u30c9\u306e\u8ffd\u52a0\u306a\u3069)\u3001\u307e\u305f\u306f\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306b\u6a5f\u80fd\u3092\u8ffd\u52a0\u3057\u305f\u3044\u5834\u5408\u306f\u3001\u30cb\u30fc\u30ba\u306b\u5408\u308f\u305b\u3066\u30d3\u30eb\u30c8\u30a4\u30f3\u306e\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u30ab\u30b9\u30bf\u30de\u30a4\u30ba\u3067\u304d\u307e\u3059\u3002TestRail \u306b\u306f\u30c7\u30d5\u30a9\u30eb\u30c8\u306e\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306e\u5b8c\u5168\u306a\u30bd\u30fc\u30b9 \u30b3\u30fc\u30c9\u304c\u542b\u307e\u308c\u3066\u304a\u308a\u3001\u3053\u306e\u30bb\u30af\u30b7\u30e7\u30f3\u3067\u306f\u305d\u308c\u3089\u3092\u30ab\u30b9\u30bf\u30de\u30a4\u30ba\u3059\u308b\u4f8b\u3092\u3044\u304f\u3064\u304b\u793a\u3057\u307e\u3059\u3002<\/p>\n<p>[et_pb_text admin_label=&#8221;Note&#8221; _builder_version=&#8221;4.4.2&#8243; background_color=&#8221;#ffffdd&#8221; hover_enabled=&#8221;0&#8243; border_width_all=&#8221;1px&#8221; border_color_all=&#8221;#E1E163&#8243;]<\/p>\n<p><span>\u672c\u30bb\u30af\u30b7\u30e7\u30f3\u3067\u306f\u3001<\/span><strong>JIRA Server 3.x<\/strong><span>\u00a0\u307e\u305f\u306f\u00a0<\/span><strong>4.x<\/strong><span> \u7528 \u306e\u30d3\u30eb\u30c8\u30a4\u30f3\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u30ab\u30b9\u30bf\u30de\u30a4\u30ba\u3059\u308b\u4f8b\u3092\u793a\u3057\u3066\u3044\u307e\u3059\u3002<\/span><\/p>\n<p>[\/et_pb_text]<\/p>\n<p>\u63d0\u4f9b\u3055\u308c\u3066\u3044\u308b\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306e 1 \u3064\u3092\u30ab\u30b9\u30bf\u30de\u30a4\u30ba\u3059\u308b\u524d\u306b\u3001\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306e\u5185\u90e8\u52d5\u4f5c\u306b\u95a2\u3059\u308b\u91cd\u8981\u306a\u80cc\u666f\u60c5\u5831\u304c\u591a\u304f\u8a18\u8f09\u3055\u308c\u3066\u3044\u308b\u300c<a href=\"\/building-custom-plugin\/\" target=\"_blank\" rel=\"noopener\"><strong>\u30ab\u30b9\u30bf\u30e0\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306e\u4f5c\u6210<\/strong><\/a>\u300d\u30bb\u30af\u30b7\u30e7\u30f3\u3092\u8aad\u3080\u3053\u3068\u3092\u304a\u52e7\u3081\u3057\u307e\u3059\u3002[<strong>\u6b20\u9665\u306e\u30d7\u30c3\u30b7\u30e5<\/strong>] \u30c0\u30a4\u30a2\u30ed\u30b0\u306b\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u8ffd\u52a0\u3059\u308b\u65b9\u6cd5\u3068\u30e6\u30fc\u30b6\u30fc \u30de\u30c3\u30d4\u30f3\u30b0\u3092\u5b9f\u88c5\u3059\u308b\u65b9\u6cd5\u306e\u4f8b\u306b\u3064\u3044\u3066\u306f\u3001\u4ee5\u4e0b\u3092\u53c2\u7167\u3057\u3066\u304f\u3060\u3055\u3044\u3002<\/p>\n<h2>\u30ab\u30b9\u30bf\u30e0 \u30d5\u30a3\u30fc\u30eb\u30c9\u306e\u8ffd\u52a0<\/h2>\n<p>\u30c7\u30d5\u30a9\u30eb\u30c8\u306e\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u3067\u30b5\u30dd\u30fc\u30c8\u3055\u308c\u3066\u3044\u306a\u3044\u8ffd\u52a0\u306e\u5fc5\u9808\u30ab\u30b9\u30bf\u30e0 \u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u4f7f\u7528\u3057\u3066\u3044\u308b\u5834\u5408\u3001[<strong>\u6b20\u9665\u306e\u30d7\u30c3\u30b7\u30e5<\/strong>] \u30c0\u30a4\u30a2\u30ed\u30b0\u306b\u65b0\u3057\u3044\u9805\u76ee\u3092\u8ffd\u52a0\u3059\u308b\u3068\u4fbf\u5229\u3067\u3059\u3002[<strong>\u30a2\u30b5\u30a4\u30f3<\/strong>] \u306a\u3069\u306e\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u30c0\u30a4\u30a2\u30ed\u30b0\u306b\u8ffd\u52a0\u3059\u308b\u3053\u3068\u3082\u3067\u304d\u307e\u3059\u3002\u3053\u306e\u30bb\u30af\u30b7\u30e7\u30f3\u3067\u306f\u3001\u305d\u306e\u65b9\u6cd5\u306b\u3064\u3044\u3066\u8aac\u660e\u3057\u307e\u3059\u3002\u3053\u306e\u4f8b\u3067\u306f Jira \u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u4f7f\u7528\u3057\u307e\u3059\u304c\u3001\u4ed6\u306e\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u3067\u3082\u540c\u69d8\u306e\u30ab\u30b9\u30bf\u30de\u30a4\u30ba\u304c\u53ef\u80fd\u3067\u3059\u3002Jira \u306e\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u30ab\u30b9\u30bf\u30de\u30a4\u30ba\u3059\u308b\u524d\u306b\u3001\u307e\u305a\u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u30b3\u30d4\u30fc\u3057\u3066\u540d\u524d\u3092\u5909\u66f4\u3057\u307e\u3059\u3002<strong>Jira.php<\/strong> \u30d7\u30e9\u30b0\u30a4\u30f3 \u30d5\u30a1\u30a4\u30eb\u3092 TestRail \u306e\u30a2\u30d7\u30ea\u30b1\u30fc\u30b7\u30e7\u30f3 \u30c7\u30a3\u30ec\u30af\u30c8\u30ea\u304b\u3089\u30ab\u30b9\u30bf\u30e0 \u30c7\u30a3\u30ec\u30af\u30c8\u30ea\u306b\u30b3\u30d4\u30fc\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"raw\">\u30aa\u30ea\u30b8\u30ca\u30eb\u30c7\u30a3\u30ec\u30af\u30c8\u30ea: &lt;TestRail&gt;\/app\/plugins\/defects\/Jira.php\n\u30ab\u30b9\u30bf\u30e0\u30c7\u30a3\u30ec\u30af\u30c8\u30ea: &lt;TestRail&gt;\/custom\/defects\/Jira_custom.php<\/pre>\n<p>\u30d5\u30a1\u30a4\u30eb\u306e\u540d\u524d\u304c <strong>Jira_custom.php\u00a0<\/strong> \u306b\u5909\u66f4\u3055\u308c\u3066\u3044\u308b\u3053\u3068\u306b\u6ce8\u76ee\u3057\u3066\u304f\u3060\u3055\u3044 \u3002TestRail \u306e\u7ba1\u7406\u30a8\u30ea\u30a2\u3067\u3001\u6a19\u6e96\u306e Jira \u30d7\u30e9\u30b0\u30a4\u30f3\u3068\u30ab\u30b9\u30bf\u30de\u30a4\u30ba\u3055\u308c\u305f\u30d0\u30fc\u30b8\u30e7\u30f3\u306e\u3069\u3061\u3089\u3067\u3082\u4efb\u610f\u306b\u9078\u629e\u3067\u304d\u308b\u3088\u3046\u306b\u3059\u308b\u305f\u3081\u306b\u3001\u3053\u308c\u306f\u91cd\u8981\u306a\u51e6\u7406\u3067\u3059\u3002\u30d5\u30a1\u30a4\u30eb\u3092\u30b3\u30d4\u30fc\u3057\u305f\u3089\u3001\u30af\u30e9\u30b9\u540d\u3092\u5909\u66f4\u3059\u308b\u5fc5\u8981\u304c\u3042\u308a\u307e\u3059\u3002\u305d\u308c\u306b\u306f\u3001\u30c6\u30ad\u30b9\u30c8 \u30a8\u30c7\u30a3\u30bf\u30fc\u3067 Jira_custom.php \u30d5\u30a1\u30a4\u30eb\u3092\u958b\u304d\u3001\u30d5\u30a1\u30a4\u30eb\u306e\u5148\u982d\u306b\u3042\u308b\u30af\u30e9\u30b9\u540d\u3092\u6b21\u306e\u3088\u3046\u306b\u5909\u66f4\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">class Jira_custom_defect_plugin extends Defect_plugin\n{\n}<\/pre>\n<p>\u3053\u306e\u4f8b\u3067\u306f\u3001\u554f\u984c\u307e\u305f\u306f\u30d0\u30b0\u304c\u767a\u751f\u3057\u305f\u30c6\u30b9\u30c8 \u30de\u30b7\u30f3\u306e\u30cf\u30fc\u30c9\u30a6\u30a7\u30a2\u3084\u30bd\u30d5\u30c8\u30a6\u30a7\u30a2\u306e\u69cb\u6210\u3092\u30c6\u30b9\u30bf\u30fc\u304c\u6307\u5b9a\u3067\u304d\u308b\u3088\u3046\u3001[<strong>\u6b20\u9665\u306e\u30d7\u30c3\u30b7\u30e5<\/strong>] \u30c0\u30a4\u30a2\u30ed\u30b0\u306b\u65b0\u3057\u3044\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u8ffd\u52a0\u3057\u307e\u3059\u3002Jira \u306e\u5bfe\u5fdc\u3059\u308b\u30d5\u30a3\u30fc\u30eb\u30c9\u306f <strong>Text Field<\/strong> \u30bf\u30a4\u30d7\u306e\u30ab\u30b9\u30bf\u30e0 \u30d5\u30a3\u30fc\u30eb\u30c9\u3067\u3001<strong>Config<\/strong> \u3068\u3044\u3046\u540d\u524d\u3067\u3059\u3002\u3053\u306e\u30d5\u30a3\u30fc\u30eb\u30c9\u306f\u3059\u3079\u3066\u306e\u8ab2\u984c\u30bf\u30a4\u30d7\u306b\u6709\u52b9\u3067\u3042\u308a\u3001\u5fc5\u9808\u3067\u306f\u3042\u308a\u307e\u305b\u3093\u3002<\/p>\n<p>\u6700\u521d\u306b\u5909\u66f4\u3057\u306a\u3051\u308c\u3070\u306a\u3089\u306a\u3044\u306e\u306f <strong>prepare_push<\/strong>\u00a0\u30e1\u30bd\u30c3\u30c9\u306e\u30d5\u30a9\u30fc\u30e0 \u30b9\u30ad\u30fc\u30de\u3067\u3059 (\u307e\u3060\u8aad\u3093\u3067\u3044\u306a\u3044\u5834\u5408\u306f\u300c<a href=\"\/building-custom-plugin\/\" target=\"_blank\" rel=\"noopener\"><strong>\u30ab\u30b9\u30bf\u30e0\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306e\u4f5c\u6210<\/strong><\/a>\u300d\u3092\u5fc5\u305a\u304a\u8aad\u307f\u304f\u3060\u3055\u3044)\u3002\u30e6\u30fc\u30b6\u30fc\u304c\u30d0\u30b0 \u30ec\u30dd\u30fc\u30c8\u306b\u30b7\u30b9\u30c6\u30e0\u69cb\u6210\u3092\u5165\u529b\u3067\u304d\u308b\u3088\u3046\u3001\u30c0\u30a4\u30a2\u30ed\u30b0\u306b\u65b0\u3057\u3044\u6587\u5b57\u5217\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u8ffd\u52a0\u3057\u307e\u3059\u3002\u30d5\u30a3\u30fc\u30eb\u30c9\u540d\u3092 <strong>config<\/strong> \u3068\u3057\u3001<strong>description<\/strong> \u30d5\u30a3\u30fc\u30eb\u30c9\u306e\u76f4\u524d\u306b\u8ffd\u52a0\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">public function prepare_push($context)\n{\n  \/\/ Return a form with the following fields\/properties\n  return array(\n    'fields' =&gt; array(\n      'summary' =&gt; array(\n        'type' =&gt; 'string',\n        'label' =&gt; 'Summary',\n        'required' =&gt; true,\n        'size' =&gt; 'full'\n      ),\n      'type' =&gt; array(\n        'type' =&gt; 'dropdown',\n        'label' =&gt; 'Issue Type',\n        'required' =&gt; true,\n        'remember' =&gt; true,\n        'size' =&gt; 'compact'\n      ),\n      'project' =&gt; array(\n        'type' =&gt; 'dropdown',\n        'label' =&gt; 'Project',\n        'required' =&gt; true,\n        'remember' =&gt; true,\n        'cascading' =&gt; true,\n        'size' =&gt; 'compact'\n      ),\n      'component' =&gt; array(\n        'type' =&gt; 'dropdown',\n        'label' =&gt; 'Component',\n        'required' =&gt; true,\n        'remember' =&gt; true,\n        'depends_on' =&gt; 'project',\n        'size' =&gt; 'compact'\n      ),\n      'config' =&gt; array(\n        'type' =&gt; 'string',\n        'label' =&gt; 'Configuration',\n        'remember' =&gt; true,\n        'size' =&gt; 'full'\n      ),\n      'description' =&gt; array(\n        'type' =&gt; 'text',\n        'label' =&gt; 'Description'\n      )\n    )\n  );\n}<\/pre>\n<p>\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u30d5\u30a9\u30fc\u30e0 \u30b9\u30ad\u30fc\u30de\u306b\u8ffd\u52a0\u3057\u305f\u3089\u3001<strong>prepare_filed<\/strong><span>\u30e1\u30bd\u30c3\u30c9\u306b <strong>config <\/strong><\/span><span>\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u8ffd\u52a0\u3057\u307e\u3059\u3002\u3053\u308c\u306f\u3001\u30e6\u30fc\u30b6\u30fc\u304c\u4ee5\u524d\u306b\u30c0\u30a4\u30a2\u30ed\u30b0\u306b\u5165\u529b\u3057\u305f\u8a18\u61b6\u6e08\u307f\u306e\u5024\u3092\u5fa9\u5143\u3059\u308b\u305f\u3081\u3067\u3059\u3002\u3053\u3046\u3059\u308b\u3068\u3001\u30e6\u30fc\u30b6\u30fc\u306f\u9001\u4fe1\u3059\u308b\u3059\u3079\u3066\u306e\u30d0\u30b0 \u30ec\u30dd\u30fc\u30c8\u3067\u8a2d\u5b9a\u3092\u518d\u5165\u529b\u3059\u308b\u5fc5\u8981\u304c\u3042\u308a\u307e\u305b\u3093\u3002\u65b0\u3057\u3044 <strong>config <\/strong><\/span><span>\u30d5\u30a3\u30fc\u30eb\u30c9\u3067\u5229\u7528\u3059\u308b\u305f\u3081\u306b\u3001\u8a2d\u5b9a\u51e6\u7406\u30b3\u30fc\u30c9\u3092\u30e1\u30bd\u30c3\u30c9\u306e\u5148\u982d\u306b\u79fb\u52d5\u3057\u305f\u3053\u3068\u306b\u6ce8\u76ee\u3057\u3066\u304f\u3060\u3055\u3044\u3002<\/span><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">public function prepare_field($context, $input, $field)\n{\n  $data = array();\n \n  \/\/ Take into account the preferences of the user, but only\n  \/\/ for the initial form rendering (not for dynamic loads).\n  if ($context['event'] == 'prepare')\n  {\n    $prefs = arr::get($context, 'preferences');\n  }\n  else\n  {\n    $prefs = null;\n  }\n \n  \/\/ Process those fields that do not need a connection to the\n  \/\/ Jira installation.\t\t\n  if ($field == 'summary' || $field == 'description' || $field == 'config')\n  {\n    switch ($field)\n    {\n      case 'summary':\n        $data['default'] = $this-&gt;_get_summary_default(\n          $context);\n        break;\n \n      case 'description':\n        $data['default'] = $this-&gt;_get_description_default(\n          $context);\n        break;\n \n      case 'config':\n        $data['default'] = arr::get($prefs, 'config');\n        break;\n    }\n \n    return $data;\n  }\n \n  \/\/ [ .. ]\n}<\/pre>\n<p>\u3053\u308c\u3067\u30b9\u30af\u30ea\u30d7\u30c8\u306f\u4ee5\u524d\u306b\u5165\u529b\u3055\u308c\u305f\u8a2d\u5b9a\u3092\u5fa9\u5143\u3059\u308b\u3088\u3046\u306b\u306a\u308a\u307e\u3057\u305f\u3002\u6700\u5f8c\u306e\u30b9\u30c6\u30c3\u30d7\u306f\u3001(\u8ab2\u984c\u3092\u4f5c\u6210\u3059\u308b\u305f\u3081\u306b) Jira \u306b\u9001\u4fe1\u3059\u308b API \u30ea\u30af\u30a8\u30b9\u30c8\u306b\u65b0\u3057\u3044\u30ab\u30b9\u30bf\u30e0 \u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u8ffd\u52a0\u3059\u308b\u3053\u3068\u3067\u3059\u3002\u305d\u308c\u306b\u306f\u3001<strong>push<\/strong> \u30e1\u30bd\u30c3\u30c9\u3092\u6b21\u306e\u3088\u3046\u306b\u5909\u66f4\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">public function push($context, $input)\n{\n  $api = $this-&gt;_get_api();\n \n  $data = array();\n  $data['summary'] = $input['summary'];\n  $data['type'] = $input['type'];\n  $data['project'] = $input['project'];\n  $data['component'] = $input['component'];\n  $data['description'] = $input['description'];\n  $data['customFieldValues'] = array(\n    array(\n      'customfieldId' =&gt; 'customfield_10000',\n      'values' =&gt; array($input['config'])\n    )\n  );\n \n  return $api-&gt;add_issue($data);\n}<\/pre>\n<p><strong>customfield_10000<\/strong> \u306e\u540d\u524d\u3092\u5909\u66f4\u3057\u3066\u3001\u9001\u4fe1\u3059\u308b\u30ab\u30b9\u30bf\u30e0 \u30d5\u30a3\u30fc\u30eb\u30c9\u306e\u5b9f\u969b\u306e ID \u3092\u4f7f\u7528\u3059\u308b\u5fc5\u8981\u304c\u3042\u308a\u307e\u3059\u3002\u30ab\u30b9\u30bf\u30e0\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306b\u65b0\u3057\u3044\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u8ffd\u52a0\u3057\u305f\u306e\u3067\u3001\u66f4\u65b0\u3055\u308c\u305f [<strong>\u6b20\u9665\u306e\u30d7\u30c3\u30b7\u30e5<\/strong>] \u30c0\u30a4\u30a2\u30ed\u30b0\u3092\u4f7f\u7528\u3057\u3066\u8ab2\u984c\u3068\u5171\u306b\u8a2d\u5b9a\u306e\u8a73\u7d30\u3092\u9001\u4fe1\u3067\u304d\u307e\u3059 (\u65b0\u3057\u3044\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u8868\u793a\u3059\u308b\u306b\u306f\u3001<strong>[\u7ba1\u7406] &gt; [\u7d71\u5408]<\/strong> \u3067\u65b0\u3057\u3044 <em>Jira_custom<\/em> \u30d7\u30e9\u30b0\u30a4\u30f3\u304c\u9078\u629e\u3055\u308c\u3066\u3044\u308b\u3053\u3068\u3092\u78ba\u8a8d\u3057\u3066\u304f\u3060\u3055\u3044)\u3002<\/p>\n<p><a href=\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-content\/uploads\/push-defect-custom.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-content\/uploads\/push-defect-custom.png\" alt=\"\" width=\"502\" height=\"397\" class=\"aligncenter size-full wp-image-9090\" srcset=\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-content\/uploads\/push-defect-custom.png 502w, https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-content\/uploads\/push-defect-custom-480x380.png 480w\" sizes=\"auto, (min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) 502px, 100vw\" \/><\/a><\/p>\n<p>\u5b8c\u5168\u306a\u30b5\u30f3\u30d7\u30eb\u306e\u30d5\u30a1\u30a4\u30eb\u306f\u4e0b\u8a18\u304b\u3089\u30c0\u30a6\u30f3\u30ed\u30fc\u30c9\u3067\u304d\u307e\u3059\u3002<\/p>\n<div class=\"callout callout--success\">\n<p class=\"callout__title\"><a href=\"\/wp-content\/uploads\/jira_custom.zip\">\u30ab\u30b9\u30bf\u30e0 Jira \u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306e\u30b5\u30f3\u30d7\u30eb<\/a><\/p>\n<\/div>\n<h2>\u30d3\u30eb\u30c8\u30a4\u30f3 \u30d5\u30a3\u30fc\u30eb\u30c9\u306e\u8ffd\u52a0<\/h2>\n<p>TestRail \u306e [<strong>\u6b20\u9665\u306e\u30d7\u30c3\u30b7\u30e5<\/strong>] \u30c0\u30a4\u30a2\u30ed\u30b0\u306b\u30d0\u30b0 \u30c8\u30e9\u30c3\u30ab\u30fc\u306e\u7d44\u307f\u8fbc\u307f\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u8ffd\u52a0\u3059\u308b\u3053\u3068\u306f\u3001\u4e0a\u3067\u8aac\u660e\u3057\u305f\u30d0\u30b0 \u30c8\u30e9\u30c3\u30ab\u30fc\u306e\u30ab\u30b9\u30bf\u30e0 \u30d5\u30a3\u30fc\u30eb\u30c9\u306e\u8ffd\u52a0\u3068\u5927\u3057\u305f\u9055\u3044\u306f\u3042\u308a\u307e\u305b\u3093\u3002\u305f\u3060\u3057\u3001\u3053\u308c\u306f\u975e\u5e38\u306b\u4e00\u822c\u7684\u306a\u4f5c\u696d\u3067\u3042\u308a\u3001\u4e00\u90e8\u306e\u30d0\u30b0 \u30c8\u30e9\u30c3\u30ab\u30fc\u306e API \u306f\u7279\u5b9a\u306e\u30d5\u30a3\u30fc\u30eb\u30c9\u306b\u5bfe\u3057\u3066\u7279\u5225\u306a\u898f\u5247\u3092\u5fc5\u8981\u3068\u3059\u308b\u305f\u3081\u3001\u3053\u306e\u30bb\u30af\u30b7\u30e7\u30f3\u3067\u306f\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306b\u30d0\u30b0 \u30c8\u30e9\u30c3\u30ab\u30fc\u306e\u30d3\u30eb\u30c8\u30a4\u30f3\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u8ffd\u52a0\u3059\u308b\u65b9\u6cd5\u306b\u3064\u3044\u3066\u8aac\u660e\u3057\u307e\u3059\u3002<\/p>\n<p>\u5177\u4f53\u7684\u306b\u306f\u3001\u3053\u306e\u30bb\u30af\u30b7\u30e7\u30f3\u3067\u306f Jira \u306e <strong>Affects Version<\/strong> \u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u8ffd\u52a0\u3059\u308b\u65b9\u6cd5\u306b\u3064\u3044\u3066\u8aac\u660e\u3057\u307e\u3059\u304c\u3001\u4ed6\u306e\u30d0\u30b0 \u30c8\u30e9\u30c3\u30ab\u30fc\u306b\u3082\u540c\u69d8\u306e\u30d5\u30a3\u30fc\u30eb\u30c9\u3068\u898f\u5247\u304c\u3042\u308b\u3067\u3057\u3087\u3046\u3002<strong>Affects Version<\/strong> \u30d5\u30a3\u30fc\u30eb\u30c9\u306f\u3001\u65b0\u3057\u3044\u30d0\u30b0\u3092\u5831\u544a\u3059\u308b\u30d0\u30fc\u30b8\u30e7\u30f3\u3092\u9078\u629e\u3059\u308b\u30c9\u30ed\u30c3\u30d7\u30c0\u30a6\u30f3 \u30d5\u30a3\u30fc\u30eb\u30c9\u3068\u3057\u3066\u5b9f\u88c5\u3055\u308c\u3066\u3044\u307e\u3059\u3002\u307e\u305a\u6a19\u6e96\u306e Jira \u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u30ab\u30b9\u30bf\u30e0 \u30c7\u30a3\u30ec\u30af\u30c8\u30ea\u306b\u30b3\u30d4\u30fc\u3057\u3066\u540d\u524d\u3092\u5909\u66f4\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"raw\">\u30aa\u30ea\u30b8\u30ca\u30eb\u30c7\u30a3\u30ec\u30af\u30c8\u30ea: &lt;TestRail&gt;\/app\/plugins\/defects\/Jira.php\n\u30ab\u30b9\u30bf\u30e0\u30c7\u30a3\u30ec\u30af\u30c8\u30ea: &lt;TestRail&gt;\/custom\/defects\/Jira_versions.php<\/pre>\n<pre><\/pre>\n<p>\u307e\u305f\u3001\u30d5\u30a1\u30a4\u30eb\u5148\u982d\u306e\u30af\u30e9\u30b9\u540d\u3092\u5909\u66f4\u3059\u308b\u5fc5\u8981\u304c\u3042\u308a\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">class Jira_versions_defect_plugin extends Defect_plugin\n{\n}<\/pre>\n<p>\u6700\u521d\u306b\u884c\u3046\u5b9f\u8cea\u7684\u306a\u30b3\u30fc\u30c9\u306e\u5909\u66f4\u306f\u3001\u30d5\u30a9\u30fc\u30e0 \u30b9\u30ad\u30fc\u30de\u306b\u65b0\u3057\u3044\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u8ffd\u52a0\u3059\u308b\u3053\u3068\u3067\u3059\u3002\u3053\u306e\u30d5\u30a3\u30fc\u30eb\u30c9\u3092 <strong>affects_version<\/strong> \u3068\u3044\u3046\u540d\u524d\u306b\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">public function prepare_push($context)\n{\n  \/\/ Return a form with the following fields\/properties\n  return array(\n    'fields' =&gt; array(\n      'summary' =&gt; array(\n        'type' =&gt; 'string',\n        'label' =&gt; 'Summary',\n        'required' =&gt; true,\n        'size' =&gt; 'full'\n      ),\n      'type' =&gt; array(\n        'type' =&gt; 'dropdown',\n        'label' =&gt; 'Issue Type',\n        'required' =&gt; true,\n        'remember' =&gt; true,\n        'size' =&gt; 'compact'\n      ),\n      'project' =&gt; array(\n        'type' =&gt; 'dropdown',\n        'label' =&gt; 'Project',\n        'required' =&gt; true,\n        'remember' =&gt; true,\n        'cascading' =&gt; true,\n        'size' =&gt; 'compact'\n      ),\n      'component' =&gt; array(\n        'type' =&gt; 'dropdown',\n        'label' =&gt; 'Component',\n        'required' =&gt; true,\n        'remember' =&gt; true,\n        'depends_on' =&gt; 'project',\n        'size' =&gt; 'compact'\n      ),\n      'affects_version' =&gt; array(\n        'type' =&gt; 'dropdown',\n        'label' =&gt; 'Affects Version',\n        'required' =&gt; false,\n        'remember' =&gt; true,\n        'depends_on' =&gt; 'project',\n        'size' =&gt; 'compact'\n      ),\n      'description' =&gt; array(\n        'type' =&gt; 'text',\n        'label' =&gt; 'Description'\n      )\n    )\n  );\n}<\/pre>\n<p>Jira \u306b\u5229\u7528\u53ef\u80fd\u306a\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u306e\u30d0\u30fc\u30b8\u30e7\u30f3\u3092\u554f\u3044\u5408\u308f\u305b\u308b\u305f\u3081\u306b\u3001Jira_api \u30af\u30e9\u30b9\u306b\u65b0\u3057\u3044 <strong>get_versions<\/strong> \u30e1\u30bd\u30c3\u30c9\u3092\u8ffd\u52a0\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">\/**\n * Get Versions\n *\n * Returns a list of versions for a Jira project. The versions\n * are returned as array of objects, each with its ID and name.\n *\/\t\npublic function get_versions($project_id)\n{\n  $data = array($project_id);\n  $response = $this-&gt;_send_command('getVersions', $data);\n \n  if (!$response)\n  {\n    return array();\n  }\n \n  $result = array();\n  foreach ($response as $version)\n  {\n    $c = obj::create();\n    $c-&gt;id = (string) $version-&gt;id;\n    $c-&gt;name = (string) $version-&gt;name;\n    $result[] = $c;\n  }\n \n  return $result;\n}<\/pre>\n<p>\u307e\u305f\u3001Jira \u304b\u3089\u53d6\u5f97\u3057\u305f\u5229\u7528\u53ef\u80fd\u306a\u30d0\u30fc\u30b8\u30e7\u30f3\u3092\u30c9\u30ed\u30c3\u30d7\u30c0\u30a6\u30f3 \u30d5\u30a3\u30fc\u30eb\u30c9\u306b \u8a2d\u5b9a\u3059\u308b\u5fc5\u8981\u304c\u3042\u308b\u305f\u3081\u3001<strong>prepare_field<\/strong> \u30e1\u30bd\u30c3\u30c9\u3092\u66f4\u65b0\u3057\u3001<strong>2 \u756a\u76ee<\/strong>\u306e<strong> switch<\/strong> \u30b9\u30c6\u30fc\u30c8\u30e1\u30f3\u30c8\u306b\u6b21\u306e\u30b3\u30fc\u30c9\u3092\u8ffd\u52a0\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">case 'affects_version':\n  if (isset($input['project']))\n  {\n    $data['default'] = arr::get($prefs, 'affects_version');\n    $data['options'] = $this-&gt;_to_id_name_lookup(\n      $api-&gt;get_versions($input['project'])\n    );\n  }\n  break;<\/pre>\n<p>\u6700\u5f8c\u306b\u91cd\u8981\u306a\u70b9\u3068\u3057\u3066\u3001\u30e6\u30fc\u30b6\u30fc\u304c\u30d0\u30b0 \u30ec\u30dd\u30fc\u30c8\u3092\u9001\u4fe1\u3057\u305f\u3068\u304d\u3001version \u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u5b9f\u969b\u306b Jira \u306b\u30d7\u30c3\u30b7\u30e5\u3059\u308b\u5fc5\u8981\u304c\u3042\u308a\u307e\u3059\u3002Jira \u306f1\u3064\u306e\u8ab2\u984c\u306b\u5bfe\u3057\u3066\u8907\u6570\u306e\u30d0\u30fc\u30b8\u30e7\u30f3\u306e\u6307\u5b9a\u3092\u30b5\u30dd\u30fc\u30c8\u3057\u3066\u3044\u308b\u305f\u3081\u3001\u3053\u306e\u30d5\u30a3\u30fc\u30eb\u30c9\u3092\u914d\u5217\u3068\u3057\u3066\u9001\u4fe1\u3059\u308b\u5fc5\u8981\u304c\u3042\u308a\u307e\u3059\u3002\u305d\u308c\u306b\u306f\u3001 <strong>add_isue<\/strong> \u30e1\u30bd\u30c3\u30c9\u306b\u6b21\u306e\u30b3\u30fc\u30c9\u3092\u8ffd\u52a0\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">if (isset($options['affects_version']))\n{\n  $version = array(\n    'id' =&gt; $options['affects_version'],\n    'archived' =&gt; false,\n    'released' =&gt; false\n  );\n  $options['affectsVersions'] = array(\n    $version\n  );\n}<\/pre>\n<p><code class=\"php\"><code class=\"php\"><\/code><\/code><\/p>\n<p><code class=\"php\"><code class=\"php\"><\/code><\/code><\/p>\n<p><strong>[\u7ba1\u7406] &gt; [\u7d71\u5408]<\/strong> \u30bf\u30d6\u3067\u65b0\u3057\u3044<strong> Jira_custom<\/strong> \u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u9078\u629e\u3059\u308b\u3068\u3001 [<strong>\u6b20\u9665\u306e\u30d7\u30c3\u30b7\u30e5<\/strong>] \u30c0\u30a4\u30a2\u30ed\u30b0\u306f\u6b21\u306e\u3088\u3046\u306b\u306a\u308a\u307e\u3059\u3002<a href=\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-content\/uploads\/push_defect_version.png\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-content\/uploads\/push_defect_version.png\" alt=\"\" width=\"502\" height=\"396\" class=\"aligncenter size-full wp-image-9088\" srcset=\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-content\/uploads\/push_defect_version.png 502w, https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-content\/uploads\/push_defect_version-480x379.png 480w\" sizes=\"auto, (min-width: 0px) and (max-width: 480px) 480px, (min-width: 481px) 502px, 100vw\" \/><\/a><\/p>\n<p><code class=\"php\"><code class=\"php\"><\/code><\/code><\/p>\n<p><code class=\"php\"><code class=\"php\"><\/code><\/code><\/p>\n<p>\u5b8c\u5168\u306a\u30b5\u30f3\u30d7\u30eb\u306e\u30d5\u30a1\u30a4\u30eb\u306f\u4e0b\u8a18\u304b\u3089\u30c0\u30a6\u30f3\u30ed\u30fc\u30c9\u3067\u304d\u307e\u3059\u3002<\/p>\n<p class=\"callout__title\"><a href=\"\/wp-content\/uploads\/jira_versions.zip\">\u30ab\u30b9\u30bf\u30e0 Jira \u30d0\u30fc\u30b8\u30e7\u30f3\u306e\u30b5\u30f3\u30d7\u30eb<\/a><\/p>\n<h2>\u30e6\u30fc\u30b6\u30fc \u30de\u30c3\u30d4\u30f3\u30b0\u306e\u5b9f\u88c5<em class=\"fas fa-info-circle\" style=\"color: revert; font-size: revert; font-weight: revert;\">\u00a0<\/em><\/h2>\n<div class=\"callout callout--info\">\n<p>[et_pb_text admin_label=&#8221;Note&#8221; _builder_version=&#8221;4.4.2&#8243; background_color=&#8221;#F0F8FF&#8221; hover_enabled=&#8221;0&#8243; border_width_all=&#8221;1px&#8221; border_color_all=&#8221;#b0c4de&#8221;]<\/p>\n<p>\u73fe\u5728\u306f\u3001TestRail \u3068\u30d0\u30b0\u8ffd\u8de1\u30c4\u30fc\u30eb\u306e\u9593\u3067\u30b3\u30fc\u30c9\u3092\u5909\u66f4\u3059\u308b\u3053\u3068\u306a\u304f\u30e6\u30fc\u30b6\u30fc\u3092\u30de\u30c3\u30d4\u30f3\u30b0\u3059\u308b\u305f\u3081\u306e\u3088\u308a\u7c21\u5358\u306a\u65b9\u6cd5\u304c\u3042\u308a\u307e\u3059\u3002\u3053\u308c\u306b\u3064\u3044\u3066\u306f\u3001<a href=\"\/integration-guide\/requirements-and-defects-integrations\/user-variables\/\" target=\"_blank\" rel=\"noopener\"><strong>\u30e6\u30fc\u30b6\u30fc\u5909\u6570<\/strong><\/a>\u3067\u8a73\u3057\u304f\u77e5\u308b\u3053\u3068\u304c\u3067\u304d\u307e\u3059\u3002<\/p>\n<p>[\/et_pb_text]<\/p>\n<p>TestRail \u306b\u4ed8\u5c5e\u306e\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306f\u3001\u5358\u4e00\u306e\u30e6\u30fc\u30b6\u30fc \u30a2\u30ab\u30a6\u30f3\u30c8\u3092\u4f7f\u7528\u3057\u3066\u30b5\u30fc\u30c9\u30d1\u30fc\u30c6\u30a3 \u30b7\u30b9\u30c6\u30e0\u306b\u30d0\u30b0 \u30ec\u30dd\u30fc\u30c8\u3092\u9001\u4fe1\u3057\u307e\u3059\u3002\u3053\u308c\u306f\u591a\u304f\u306e\u72b6\u6cc1\u306b\u5bfe\u5fdc\u3067\u304d\u308b\u4ed5\u7d44\u307f\u3067\u3042\u308a\u3001\u3053\u306e\u305f\u3081\u306b\u30d0\u30b0 \u30c8\u30e9\u30c3\u30ab\u30fc\u306b\u7279\u5225\u306a <em>testrail<\/em> \u30e6\u30fc\u30b6\u30fc\u307e\u305f\u306f\u985e\u4f3c\u306e\u30e6\u30fc\u30b6\u30fc\u3092\u8ffd\u52a0\u3059\u308b\u3053\u3068\u3092\u304a\u52e7\u3081\u3057\u307e\u3059\u3002<\/p>\n<p>\u3057\u304b\u3057\u3001\u30d0\u30b0 \u30ec\u30dd\u30fc\u30c8\u3092\u30d7\u30c3\u30b7\u30e5\u3057\u305f\u30e6\u30fc\u30b6\u30fc\u306b\u5bfe\u5fdc\u3059\u308b\u30d0\u30b0 \u30c8\u30e9\u30c3\u30ab\u30fc\u306e\u30e6\u30fc\u30b6\u30fc \u30a2\u30ab\u30a6\u30f3\u30c8\u3092\u4f7f\u7528\u3057\u305f\u3044\u5834\u5408\u306f\u3001\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306b\u30e6\u30fc\u30b6\u30fc \u30de\u30c3\u30d4\u30f3\u30b0\u3092\u8ffd\u52a0\u3059\u308b\u3053\u3068\u3067\u5b9f\u73fe\u3067\u304d\u307e\u3059\u3002\u3053\u308c\u3092\u5177\u4f53\u7684\u306b\u793a\u3059\u305f\u3081\u306b\u3001Jira.php \u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u3082\u3046\u4e00\u5ea6\u30b3\u30d4\u30fc\u3057\u3066\u540d\u524d\u3092\u5909\u66f4\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"raw\">\u30aa\u30ea\u30b8\u30ca\u30eb\u30c7\u30a3\u30ec\u30af\u30c8\u30ea: &lt;TestRail&gt;\/app\/plugins\/defects\/Jira.php\n\u30ab\u30b9\u30bf\u30e0\u30c7\u30a3\u30ec\u30af\u30c8\u30ea: &lt;TestRail&gt;\/custom\/defects\/Jira_users.php\n<\/pre>\n<p class=\"EnlighterJSRAW\" data-enlighter-language=\"raw\">\u305d\u3057\u3066\u307e\u305f\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u306e\u30af\u30e9\u30b9\u540d\u3092\u66f4\u65b0\u3057\u307e\u3059\u3002<\/p>\n<\/div>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">class Jira_users_defect_plugin extends Defect_plugin\n{\n}<\/pre>\n<p>\u30b9\u30af\u30ea\u30d7\u30c8\u306b\u30e6\u30fc\u30b6\u30fc \u30de\u30c3\u30d4\u30f3\u30b0\u6a5f\u80fd\u3092\u8ffd\u52a0\u3059\u308b\u305f\u3081\u306b\u3001\u8a2d\u5b9a\u306b\u65b0\u3057\u304f <strong>[users] <\/strong>\u30bb\u30af\u30b7\u30e7\u30f3\u3092\u8ffd\u52a0\u3057\u307e\u3059\u3002\u3053\u308c\u306b\u3088\u308a\u3001\u7ba1\u7406\u8005\u306f TestRail \u30e6\u30fc\u30b6\u30fc (\u30e6\u30fc\u30b6\u30fc\u306e\u96fb\u5b50\u30e1\u30fc\u30eb \u30a2\u30c9\u30ec\u30b9\u3067\u8b58\u5225\u3055\u308c\u308b) \u3068\u6b20\u9665\u8ffd\u8de1\u30c4\u30fc\u30eb\u306e\u30ed\u30b0\u30a4\u30f3\u8a8d\u8a3c\u60c5\u5831\u306e\u30de\u30c3\u30d4\u30f3\u30b0\u3092\u8a2d\u5b9a\u3067\u304d\u308b\u3088\u3046\u306b\u306a\u308a\u307e\u3059\u3002\u305f\u3068\u3048\u3070\u3001\u7ba1\u7406\u30a8\u30ea\u30a2\u306e\u8a2d\u5b9a\u306f\u6b21\u306e\u3088\u3046\u306b\u306a\u308a\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"raw\">; Please configure your Jira connection below\n[connection]\naddress=http:\/\/jira\/\nuser=testrail\npassword=secret\n\n[users]\nbob@example.com=bob:secret\njim@example.com=jim:secret\njane@example.com=jane:secret<\/pre>\n<p>Bob \u304c\u30d0\u30b0 \u30ec\u30dd\u30fc\u30c8\u3092\u9001\u4fe1\u3059\u308b\u3068\u3001\u66f4\u65b0\u3055\u308c\u305f\u6b20\u9665\u30b9\u30af\u30ea\u30d7\u30c8\u306f\u3001Bob \u306e Jira \u8a8d\u8a3c\u60c5\u5831\u3092\u4f7f\u7528\u3057\u3066\u30d0\u30b0\u3092\u9001\u4fe1\u3057\u307e\u3059\u3002\u8a8d\u8a3c\u60c5\u5831\u304c\u8a2d\u5b9a\u3055\u308c\u3066\u3044\u306a\u3044\u30e6\u30fc\u30b6\u30fc\u304c\u30d0\u30b0 \u30ec\u30dd\u30fc\u30c8\u3092\u9001\u4fe1\u3057\u3088\u3046\u3068\u3059\u308b\u3068\u3001\u30b9\u30af\u30ea\u30d7\u30c8\u306f\u30b0\u30ed\u30fc\u30d0\u30eb\u306b\u8a2d\u5b9a\u3055\u308c\u305f\u30ed\u30b0\u30a4\u30f3 (<strong> [connection]<\/strong> \u30bb\u30af\u30b7\u30e7\u30f3\u3067\u6307\u5b9a) \u306b\u30d5\u30a9\u30fc\u30eb\u30d0\u30c3\u30af\u3057\u307e\u3059\u3002\u65b0\u3057\u3044\u8a2d\u5b9a\u30aa\u30d7\u30b7\u30e7\u30f3\u3092\u8868\u793a\u3059\u308b\u305f\u3081\u306b\u3001<strong>get_meta<\/strong> \u30e1\u30bd\u30c3\u30c9\u3092\u66f4\u65b0\u3057\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">private static $_meta = array(\n  'author' =&gt; 'Gurock Software',\n  'version' =&gt; '1.0',\n  'description' =&gt; 'Jira defect plugin for TestRail',\n  'can_push' =&gt; true,\n  'can_lookup' =&gt; true,\n  'default_config' =&gt; \n    '; Please configure your Jira connection below\n[connection]\naddress=http:\/\/\/\nuser=testrail\npassword=secret\n \n[users]\nuser@example.com=user:secret'\n);<\/pre>\n<p>\u307e\u305f\u3001configure \u30e1\u30bd\u30c3\u30c9\u3092\u66f4\u65b0\u3057\u3001<strong>[users]<\/strong> \u30bb\u30af\u30b7\u30e7\u30f3\u3092\u5185\u90e8\u30d5\u30a3\u30fc\u30eb\u30c9\u306b\u5272\u308a\u5f53\u3066\u308b\u3088\u3046\u306b\u3057\u307e\u3057\u305f\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">public function configure($config)\n{\n  $ini = ini::parse($config);\n  $this-&gt;_address = str::slash($ini['connection']['address']);\n  $this-&gt;_user = $ini['connection']['user'];\n  $this-&gt;_password = $ini['connection']['password'];\n \n  if (isset($ini['users']))\n  {\n    $this-&gt;_users = $ini['users'];\n  }\n  else\n  {\n    $this-&gt;_users = array();\n  }\n}<\/pre>\n<p>\u6b21\u306b\u5909\u66f4\u3057\u306a\u3051\u308c\u3070\u306a\u3089\u306a\u3044\u306e\u306f\u3001Jira \u306e API \u8a8d\u8a3c\u3067\u3059\u3002\u305d\u308c\u306b\u306f\u3001 \u6b21\u306e\u3088\u3046\u306b\u3001_get_api \u30e1\u30bd\u30c3\u30c9\u306b\u30e6\u30fc\u30b6\u30fc \u30de\u30c3\u30d4\u30f3 \u30b0\u30b3\u30fc\u30c9\u3092\u8ffd\u52a0\u3059\u308b\u5fc5\u8981\u304c\u3042\u308a\u307e\u3059\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">private function _get_api($context = null)\n{\n  if ($this-&gt;_api)\n  {\n    return $this-&gt;_api;\n  }\n \n  $user = $this-&gt;_user;\n  $password = $this-&gt;_password;\n \n  \/\/ Find the appropriate Jira user for the bug reporter\n  \/\/ (by mapping the current TestRail user to her Jira\n  \/\/ account).\n  if ($context &amp;&amp; $this-&gt;_users)\n  {\n    $credentials = arr::get(\n      $this-&gt;_users,\n      str::to_lower($context['user']-&gt;email)\n    );\n \n    if ($credentials)\n    {\n      if (preg_match('\/([^:]+):(.+)\/', $credentials, $matches))\n      {\n        $user = $matches[1];\n        $password = $matches[2];\n      }\n    }\n  }\n \n  $this-&gt;_api = new Jira_api($this-&gt;_address);\n  $this-&gt;_api-&gt;login($user, $password);\n  return $this-&gt;_api;\n}<\/pre>\n<p>\u3053\u306e\u30e1\u30bd\u30c3\u30c9\u306f\u3001\u8a2d\u5b9a\u5185\u3067\u73fe\u5728\u306e\u30e6\u30fc\u30b6\u30fc\u306b\u5bfe\u5fdc\u3059\u308b\u30e6\u30fc\u30b6\u30fc\u8a8d\u8a3c\u60c5\u5831\u3092\u898b\u3064\u3051\u3088\u3046\u3068\u3057\u307e\u3059\u3002\u8a8d\u8a3c\u60c5\u5831\u304c\u898b\u3064\u304b\u3089\u306a\u3044\u5834\u5408\u306f\u3001\u30b0\u30ed\u30fc\u30d0\u30eb\u306b\u8a2d\u5b9a\u3055\u308c\u305f\u8a8d\u8a3c\u60c5\u5831\u3092\u30d5\u30a9\u30fc\u30eb\u30d0\u30c3\u30af\u3068\u3057\u3066\u4f7f\u7528\u3057\u307e\u3059\u3002<strong>_get_api\u00a0<\/strong> \u30e1\u30bd\u30c3\u30c9\u306b <strong>$context<\/strong>\u00a0\u5f15\u6570\u304c\u8ffd\u52a0\u3055\u308c\u305f\u3053\u3068\u306b\u6ce8\u610f\u3057\u3066\u304f\u3060\u3055\u3044\u3002\u3053\u306e\u5f15\u6570\u306f\u3001\u73fe\u5728\u306e TestRail \u30e6\u30fc\u30b6\u30fc\u306e\u96fb\u5b50\u30e1\u30fc\u30eb \u30a2\u30c9\u30ec\u30b9\u3092\u53d6\u5f97\u3059\u308b\u305f\u3081\u306b\u5fc5\u8981\u3067\u3059\u3002<\/p>\n<p>\u3042\u3068\u306f\u3001prepare_filed \u304a\u3088\u3073 push \u30e1\u30bd\u30c3\u30c9\u304b\u3089\u6b21\u306e\u3088\u3046\u306b $context \u5909\u6570\u3092\u6e21\u3059\u3060\u3051\u3067\u3059\uff08lookup \u30e1\u30bd\u30c3\u30c9\u306b\u306f\u30b3\u30f3\u30c6\u30ad\u30b9\u30c8\u60c5\u5831\u304c\u7121\u3044\u305f\u3081\u3001 $context \u5f15\u6570\u3092\u8ffd\u52a0\u3059\u308b\u3079\u304d\u3067\u306f\u306a\u3044\u3053\u3068\u306b\u6ce8\u610f\u3057\u3066\u304f\u3060\u3055\u3044\uff09\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">$api = $this-&gt;_get_api($context);\n\n<\/pre>\n<p>\u3053\u308c\u3067\u7d42\u308f\u308a\u3067\u3059\u3002<strong>_get_api<\/strong> \u00a0\u30e1\u30bd\u30c3\u30c9\u306b\u30e6\u30fc\u30b6\u30fc \u30de\u30c3\u30d4\u30f3\u30b0\u3092\u8ffd\u52a0\u3057\u3001\u3053\u306e\u30e1\u30bd\u30c3\u30c9\u306b\u30b3\u30f3\u30c6\u30ad\u30b9\u30c8\u60c5\u5831\u3092\u6e21\u3057\u305f\u306e\u3067\u3001\u3042\u3068\u306f [<strong>\u7ba1\u7406<\/strong>] &gt; [<strong>\u7d71\u5408<\/strong>] \u3067\u65b0\u3057\u3044\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u9078\u629e\u3057\u3066\u30e6\u30fc\u30b6\u30fc \u30a2\u30ab\u30a6\u30f3\u30c8\u3092\u8a2d\u5b9a\u3059\u308b\u3060\u3051\u3067\u3059\u3002<\/p>\n<h2>\u305d\u306e\u4ed6\u306e\u30e6\u30fc\u30b6\u30fc\u30de\u30c3\u30d4\u30f3\u30b0\u306e\u65b9\u6cd5<\/h2>\n<div class=\"callout callout--info\">\n<p>[et_pb_text admin_label=&#8221;Note&#8221; _builder_version=&#8221;4.4.2&#8243; background_color=&#8221;#F0F8FF&#8221; hover_enabled=&#8221;0&#8243; border_width_all=&#8221;1px&#8221; border_color_all=&#8221;#b0c4de&#8221;]<\/p>\n<p>\u73fe\u5728\u306f\u3001TestRail \u3068\u30d0\u30b0\u8ffd\u8de1\u30c4\u30fc\u30eb\u306e\u9593\u3067\u30b3\u30fc\u30c9\u3092\u5909\u66f4\u3059\u308b\u3053\u3068\u306a\u304f\u30e6\u30fc\u30b6\u30fc\u3092\u30de\u30c3\u30d4\u30f3\u30b0\u3059\u308b\u305f\u3081\u306e\u3088\u308a\u7c21\u5358\u306a\u65b9\u6cd5\u304c\u3042\u308a\u307e\u3059\u3002\u3053\u308c\u306b\u3064\u3044\u3066\u306f\u3001<a href=\"\/integration-guide\/requirements-and-defects-integrations\/user-variables\/\" target=\"_blank\" rel=\"noopener\"><strong>\u30e6\u30fc\u30b6\u30fc\u5909\u6570<\/strong><\/a>\u3067\u8a73\u3057\u304f\u77e5\u308b\u3053\u3068\u304c\u3067\u304d\u307e\u3059\u3002<\/p>\n<p>[\/et_pb_text]<\/p>\n<p>\u4e00\u90e8\u306e\u8ab2\u984c\u304a\u3088\u3073\u6b20\u9665\u8ffd\u8de1\u30b7\u30b9\u30c6\u30e0\u3067\u306f\u3001API \u3092\u4ecb\u3057\u3066\u30ec\u30dd\u30fc\u30bf\u30fc \u30e6\u30fc\u30b6\u30fc\u3092\u8a2d\u5b9a\u3067\u304d\u307e\u3059\u3002\u3053\u306e\u5834\u5408\u3001\u5fc5\u305a\u3057\u3082\u30ed\u30b0\u30a4\u30f3\u306b\u3088\u308b\u5b8c\u5168\u306a\u30e6\u30fc\u30b6\u30fc \u30de\u30c3\u30d4\u30f3\u30b0\u3092\u5b9f\u88c5\u3059\u308b\u5fc5\u8981\u306f\u3042\u308a\u307e\u305b\u3093\u3002\u8ab2\u984c\u3092\u5831\u544a\u3059\u308b\u30e6\u30fc\u30b6\u30fc\u306e\u30e6\u30fc\u30b6\u30fc\u540d\u3092\u6307\u5b9a\u3059\u308b\u3060\u3051\u3067\u6e08\u307f\u307e\u3059\u3002<\/p>\n<p>\u305f\u3068\u3048\u3070\u3001\u7d44\u7e54\u306e\u96fb\u5b50\u30e1\u30fc\u30eb \u30a2\u30c9\u30ec\u30b9\u3068\u305d\u308c\u306b\u5bfe\u5fdc\u3059\u308b JIRA \u30e6\u30fc\u30b6\u30fc\u540d\u304c\u6b21\u306e\u3088\u3046\u306b\u306a\u3063\u3066\u3044\u308b\u3068\u3057\u307e\u3057\u3087\u3046\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"raw\">bob@example.com -&gt; bob\njan@example.com -&gt; jan\nsue@example.com -&gt; sue<\/pre>\n<p class=\"EnlighterJSRAW\" data-enlighter-language=\"raw\">\u3053\u306e\u5834\u5408\u3001\u73fe\u5728\u306e\u30e6\u30fc\u30b6\u30fc\u306e\u96fb\u5b50\u30e1\u30fc\u30eb\u30a2\u30c9\u30ec\u30b9\u304b\u3089 JIRA \u30e6\u30fc\u30b6\u30fc\u540d\u3092\u4f5c\u6210\u3057\u3001<strong>push\u00a0<\/strong><span style=\"font-size: 14px; color: #666666; font-family: 'Open Sans', Arial, sans-serif;\"> \u30e1\u30bd\u30c3\u30c9\u3067<strong> reporter<\/strong> <\/span><span style=\"font-size: 14px; color: #666666; font-family: 'Open Sans', Arial, sans-serif;\">\u30d5\u30a3\u30fc\u30eb\u30c9\u306b\u6b21\u306e\u3088\u3046\u306b\u6307\u5b9a\u3059\u308b\u3060\u3051\u3067\u3059\u3002<\/span><\/p>\n<\/div>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"php\">public function push($context, $input)\n{\n  if (isset($context['user']-&gt;email))\n  {\n    $email = $context['user']-&gt;email;\n    $pos = str::pos($email, '@');\n    if  ($pos !== false)\n    {\n      $input['reporter'] = str::sub($email, 0, $pos);\n    }\n  }\n \n  $api = $this-&gt;_get_api();\n  return $api-&gt;add_issue($input);\n}<\/pre>\n<p>\u3053\u3046\u3059\u308b\u3068\u3001JIRA \u30e6\u30fc\u30b6\u30fc\u306e\u30e6\u30fc\u30b6\u30fc\u540d\u3068\u30d1\u30b9\u30ef\u30fc\u30c9\u3092 TestRail \u306b\u4fdd\u5b58\u3057\u3066\u304a\u304b\u306a\u304f\u3066\u3082\u3001\u8ab2\u984c\u3092\u5831\u544a\u3057\u305f\u30e6\u30fc\u30b6\u30fc\u304c\u6b63\u3057\u304f JIRA \u306b\u9001\u4fe1\u3055\u308c\u307e\u3059\u3002\u63d0\u4f9b\u3055\u308c\u3066\u3044\u308b API \u6a5f\u80fd\u306b\u3088\u3063\u3066\u306f\u3001\u4ed6\u306e\u8ab2\u984c\u304a\u3088\u3073\u6b20\u9665\u8ffd\u8de1\u30c4\u30fc\u30eb\u3082\u3053\u308c\u3092\u30b5\u30dd\u30fc\u30c8\u3057\u3066\u3044\u308b\u53ef\u80fd\u6027\u304c\u3042\u308a\u307e\u3059\u3002<\/p>\n<p><code class=\"php\"><code class=\"php\"><code><\/code><\/code><\/code><\/p>\n<p><code class=\"php\"><code><\/code><\/code><\/p>\n","protected":false},"excerpt":{"rendered":"<p>TestRail \u306b\u306f\u3001Jira\u3001FogBugz\u3001Bugzilla \u306a\u3069\u306e\u4e00\u822c\u7684\u306a\u30d0\u30b0 \u30c8\u30e9\u30c3\u30ab\u30fc\u306b\u5bfe\u5fdc\u3057\u305f\u3059\u3050\u306b\u4f7f\u3048\u308b\u6b20\u9665\u30d7\u30e9\u30b0\u30a4\u30f3\u304c\u4ed8\u5c5e\u3057\u3066\u3044\u307e\u3059\u3002\u30d0\u30b0\u8ffd\u8de1\u30c4\u30fc\u30eb\u304c\u30ab\u30b9\u30bf\u30de\u30a4\u30ba\u3055\u308c\u3066\u3044\u308b\u5834\u5408 (\u30ab\u30b9\u30bf\u30e0 \u30d5\u30a3\u30fc\u30eb\u30c9\u306e [&hellip;]<\/p>\n","protected":false},"author":5,"featured_media":0,"parent":6643,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"class_list":["post-18045","page","type-page","status-publish","hentry"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/pages\/18045","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/comments?post=18045"}],"version-history":[{"count":71,"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/pages\/18045\/revisions"}],"predecessor-version":[{"id":23517,"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/pages\/18045\/revisions\/23517"}],"up":[{"embeddable":true,"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/pages\/6643"}],"wp:attachment":[{"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/media?parent=18045"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}