اتصال کانفلوئنس به جیرا

اتصال Confluence و Jira به عنوان دو ابزار کلیدی در اکوسیستم Atlassian، امکان همکاری یکپارچه و کارآمد بین تیم‌ها را فراهم می‌کند. این یکپارچگی به شما این امکان را می‌دهد که مستندات و دانش موجود در Confluence را مستقیماً با task ها و issue های Jira مرتبط کنید، از ایجاد خودکار issue های Jira از جداول Confluence استفاده نمایید و یک workflow یکپارچه برای مدیریت پروژه‌ها و مستندات خود داشته باشید. با استفاده از این قابلیت‌ها، می‌توانید در جلسات برنامه‌ریزی خود در Confluence جدول‌های task را ایجاد کرده و به صورت خودکار آن‌ها را به issue های Jira تبدیل کنید. این یکپارچگی باعث افزایش بهره‌وری، کاهش زمان صرف شده برای جابجایی بین ابزارها، بهبود هماهنگی بین اعضای تیم و ایجاد یک منبع واحد حقیقت برای پروژه‌ها می‌شود.

پیش‌نیازها

• سرویس‌های فعال Jira و Confluence با نسخه‌های سازگار
• دسترسی ادمین به Application Links در هر دو سرویس
• آدرس‌های HTTPS قابل دسترس دوطرفه برای Jira و Confluence
• یک پروژه آزمایشی Jira و مجوز ساخت Issue
• تهیه نسخه پشتیبان از تنظیمات پیش از تغییر Application Link

این سند راهنما شامل دو بخش اصلی است:

1. راهنمای اتصال Jira و Confluence: در این بخش مراحل اتصال و پیکربندی ارتباط بین سرویس‌های Jira و Confluence مدیریت شده هم‌روش ارائه شده است. این اتصال پیش‌نیاز استفاده از قابلیت‌های یکپارچه بین این دو ابزار است.

2. ساخت issue جیرا از طریق صفحه Confluence: در این بخش نحوه استفاده از قابلیت ایجاد خودکار issue های Jira از جداول موجود در صفحات Confluence آموزش داده می‌شود. این قابلیت به شما امکان می‌دهد با کلیک راست روی جدول در Confluence و انتخاب گزینه "Create Jira issue"، هر سطر جدول را به یک issue جداگانه در Jira تبدیل کنید.

---

بخش اول: راهنمای اتصال Jira و Confluence

برای استفاده از قابلیت‌های یکپارچه بین Confluence و Jira، ابتدا باید این دو سرویس را به یکدیگر متصل کنید. این اتصال از طریق Application Link در Confluence انجام می‌شود.

گام اول: دسترسی به تنظیمات Application Links

ابتدا وارد تنظیمات Confluence شوید. برای این کار، روی آیکون چرخ‌دنده (⚙️) در بالای صفحه کلیک کنید و از منوی باز شده، گزینه General configuration را انتخاب کنید. و در صفحه تنظیمات، از منوی سمت چپ، بخش Application links را پیدا و روی آن کلیک کنید.

گام دوم: ایجاد Application Link جدید

در صفحه Application Links، روی دکمه Create link کلیک کنید تا صفحه ایجاد لینک جدید باز شود. همانطور که در تصویر زیر مشاهده می‌کنید، این صفحه به شما امکان می‌دهد که یک Application Link جدید بین Confluence و Jira ایجاد کنید.

گزینه مناسب را بر اساس وضعیت سرویس Jira خود انتخاب کنید.

گام سوم: وارد کردن اطلاعات Jira

در صفحه بعدی، اطلاعات مورد نیاز برای اتصال به Jira را وارد کنید:

• Application URL: آدرس کامل سرویس Jira شما (مثلاً https://your-jira-domain.darkube.app)
• Application Name: نامی که می‌خواهید برای این اتصال نمایش داده شود (مثلاً "Jira")

پس از وارد کردن اطلاعات، روی دکمه Continue کلیک کنید.

گام چهارم: تایید اتصال

در مرحله بعد، Confluence از شما می‌خواهد که نوع اتصال را انتخاب کنید. گزینه Two-way (incoming and outgoing) را انتخاب کنید تا امکان ارتباط دوطرفه بین Confluence و Jira فراهم شود.

پس از انتخاب نوع اتصال، روی دکمه Continue کلیک کنید. Confluence به صورت خودکار سعی می‌کند به Jira متصل شود و اتصال را برقرار کند.

گام پنجم: بررسی اتصال موفق

پس از تکمیل مراحل، به صفحه Application Links بازگردید. در این صفحه، باید اتصال بین Confluence و Jira را مشاهده کنید. همانطور که در تصویر زیر نشان داده شده است، لینک ایجاد شده در لیست Application Links نمایش داده می‌شود.

در این صفحه می‌توانید وضعیت اتصال را مشاهده کنید. اگر اتصال به درستی برقرار شده باشد وضعیت آن به صورت Connected نمایش داده می‌شود.

در صورت بروز مشکل در اتصال، مطمئن شوید که:

• آدرس Jira به درستی وارد شده است
• هر دو سرویس (Confluence و Jira) در دسترس هستند
• دسترسی‌های لازم برای اتصال وجود دارد

---

بخش دوم: ساخت issue جیرا از طریق صفحه Confluence

پس از برقرار شدن اتصال بین Confluence و Jira، می‌توانید از قابلیت ایجاد خودکار issue های Jira از جداول موجود در صفحات Confluence استفاده کنید. این قابلیت به ویژه در جلسات برنامه‌ریزی و مدیریت پروژه بسیار کاربردی است.

گام اول: ایجاد صفحه و جدول در Confluence

ابتدا یک صفحه جدید در Confluence ایجاد کنید یا به صفحه موجودی که می‌خواهید جدول را در آن قرار دهید، بروید. برای ایجاد صفحه جدید، روی دکمه Create کلیک کنید.

در صفحه ویرایشگر Confluence، یک جدول ایجاد کنید. این جدول باید حداقل دو ستون داشته باشد:

• Summary: برای عنوان issue در Jira
• Description: برای توضیحات issue در Jira

می‌توانید ستون‌های اضافی نیز اضافه کنید که به عنوان فیلدهای اضافی در issue های Jira استفاده شوند. جدول را با اطلاعات مورد نظر خود تکمیل کنید.

گام دوم: استفاده از قابلیت Create Jira Issue

پس از تکمیل جدول، تمام محتوای آن را مشابه تصویر زیر انتخاب نمایید.

پس از انتخاب محتوای جدول، گزینه Jira در منوی ابزارهای Confluence ظاهر می‌شود. روی این گزینه کلیک کنید. با کلیک روی این گزینه، صفحه Create multiple issues باز می‌شود.

گام سوم: پیکربندی تنظیمات Issue

در صفحه Create multiple issues، باید تنظیمات زیر را انجام دهید:

1. Project: پروژه Jira مورد نظر خود را از منوی dropdown انتخاب کنید. این پروژه همان پروژه‌ای است که می‌خواهید issue ها در آن ایجاد شوند.

2. Issue Type: نوع issue را انتخاب کنید. می‌توانید از انواع مختلف issue مانند Task، Story، Bug و غیره استفاده کنید.

3. Mapping: در این بخش، می‌توانید ستون‌های جدول را به فیلدهای Jira مپ کنید. به طور پیش‌فرض، ستون Summary به فیلد Summary در Jira و ستون Description به فیلد Description در Jira مپ می‌شود.

پس از تکمیل تنظیمات، روی دکمه Create کلیک کنید.

گام چهارم: بررسی Issue های ایجاد شده

پس از کلیک روی دکمه Create، Confluence شروع به ایجاد issue ها در Jira می‌کند. این فرآیند ممکن است چند ثانیه تا چند دقیقه به طول بینجامد، بسته به تعداد سطرهای جدول.

پس از تکمیل فرآیند، به Jira بروید و پروژه مورد نظر خود را باز کنید. همانطور که در تصویر زیر مشاهده می‌کنید، تمام issue های ایجاد شده از جدول Confluence در Jira نمایش داده می‌شوند.

هر issue شامل اطلاعاتی است که در ستون‌های جدول Confluence وارد کرده بودید. می‌توانید روی هر issue کلیک کنید تا جزئیات کامل آن را مشاهده کنید.

نکات مهم

• ساختار جدول: اطمینان حاصل کنید که جدول شما حداقل دارای ستون‌های Summary و Description است.
• نسخه Jira: برای استفاده کامل از این قابلیت، توصیه می‌شود از نسخه Jira 5 یا بالاتر استفاده کنید.
• به‌روزرسانی دستی: در صورت بروز خطا، می‌توانید به صورت دستی به صفحه Confluence بازگردید و پیوندهای issue ها را اضافه کنید.
• استفاده در جلسات برنامه‌ریزی: این قابلیت به ویژه برای جلسات برنامه‌ریزی و تبدیل task های تعریف شده در Confluence به issue های Jira بسیار مفید است.