اتصال به Figma

اتصال Figma در تسکیـ فعالیت طراحی را به کارهای قابل پیگیری وصل می‌کند. وقتی وب‌هوک Figma برای فضای کاری ثبت شود، رویدادهای فایل، کامنت، نسخه و Dev Mode دریافت می‌شوند و اگر در نام فایل، متن کامنت یا پیام Dev Mode شناسهٔ وظیفه آمده باشد، همان فایل Figma به وظیفه لینک می‌شود.

دامنهٔ نسخه فعلی: این نسخه روی دریافت امن وب‌هوک و لینک خودکار فایل Figma به وظیفه تمرکز دارد. پیش‌نمایش غنی لینک‌های Figma، پنل اختصاصی Figma در Task view، ساخت فایل یا FigJam از داخل تسکیـ و اتصال OAuth شخصی در فاز بعدی اضافه می‌شوند.

پیش از شروع

• فقط مالک یا مدیر فضای کاری می‌تواند اتصال Figma فضای کاری را بسازد یا قطع کند.
• وب‌هوک Figma باید از API خود Figma ساخته شود؛ Figma در حال حاضر رابط گرافیکی جداگانه برای ساخت وب‌هوک ندارد.
• برای ساخت وب‌هوک به توکن Figma با دسترسی لازم و یک passcode امن نیاز دارید.
• در تسکیـ، شناسهٔ وب‌هوک Figma در فیلد «شناسه وب‌هوک» ذخیره می‌شود و passcode به‌صورت رمزنگاری‌شده نگهداری می‌شود.
• اتصال شخصی، پیش‌نمایش لینک و فرمان‌های Figma در نسخه فعلی فعال نیستند.

ساخت اتصال فضای کاری

1. در Figma API یک وب‌هوک برای context مناسب مثل file، project یا team بسازید و endpoint تسکیـ را به‌عنوان نشانی دریافت رویداد وارد کنید.
2. همان passcode که هنگام ساخت وب‌هوک به Figma داده‌اید را نگه دارید؛ تسکیـ هر رویداد را با همین مقدار بررسی می‌کند.
3. در مرکز اپ‌های تسکیـ، Figma را باز کنید و تب «فضای کاری» را انتخاب کنید.
4. شناسهٔ وب‌هوک، passcode، توکن اختیاری و برچسب اتصال را وارد کنید.
5. اتصال را ذخیره کنید و یک رویداد آزمایشی Figma بفرستید تا زمان آخرین رویداد در تنظیمات به‌روزرسانی شود.

امنیت passcode: Figma passcode را داخل payload رویداد می‌فرستد. تسکیـ قبل از ذخیرهٔ تحویل وب‌هوک، این مقدار را از payload حذف می‌کند و فقط بعد از مقایسهٔ امن با مقدار رمزنگاری‌شده، رویداد را وارد صف می‌کند.

لینک خودکار طراحی به وظیفه

برای لینک خودکار، شناسهٔ وظیفه را در نام فایل Figma، متن کامنت، توضیح نسخه یا پیام Dev Mode بنویسید. شکل‌های زیر پشتیبانی می‌شوند:

• TASK-12 — نوشتن مستقیم شناسه.
• #TASK-12 — با پیشوند #.
• CU-TASK-12 — با پیشوند CU-.
• #9fq2b1 — شناسهٔ هش‌شدهٔ وظیفه، فقط با پیشوند # یا CU-.

برای نمونه، فایل TASK-31 checkout redesign یا پیام Dev Mode با متن Ready for TASK-32 implementation به وظیفهٔ مربوط لینک می‌شود.

وضعیت وظیفه و دستورهای وضعیت

Figma در نسخه فعلی وضعیت وظیفه را تغییر نمی‌دهد. اگر عبارت TASK-31[Done] را در نام فایل یا کامنت بنویسید، فایل به وظیفه لینک می‌شود اما وضعیت وظیفه تغییر نمی‌کند. تغییر وضعیت خودکار فعلاً برای رویدادهای GitHub و GitLab فعال است.

مدیریت و قطع اتصال

وضعیت اتصال و زمان آخرین رویداد در تب «یکپارچه‌سازی» تنظیمات فضای کاری دیده می‌شود. مالک یا مدیر می‌تواند اتصال را از تسکیـ قطع کند. برای توقف کامل ارسال رویداد، وب‌هوک را در Figma API هم حذف یا غیرفعال کنید.

اشتباه‌های رایج

• اشتباه وارد کردن شناسهٔ وب‌هوک؛ مقدار باید با webhook_id موجود در payload برابر باشد.
• فراموش کردن passcode یا وارد کردن مقدار متفاوت از Figma؛ تسکیـ در این حالت رویداد را با پاسخ 400 رد می‌کند.
• انتظار داشتن پیش‌نمایش زنده یا پنل اختصاصی Figma در وظیفه؛ این قابلیت‌ها در نسخه فعلی هنوز فعال نیستند.
• نوشتن شناسهٔ وظیفه در جایی که Figma در payload وب‌هوک نمی‌فرستد؛ لینک خودکار فقط از فیلدهای رویداد دریافت‌شده خوانده می‌شود.
• انتظار تغییر وضعیت با کروشهٔ وضعیت؛ Figma فقط لینک می‌کند و وضعیت را تغییر نمی‌دهد.

گام بعدی: اگر فایل‌های طراحی در کنار فایل‌های ابری هم استفاده می‌شوند، راهنمای اتصال به Dropbox را ببینید. برای تغییر وضعیت خودکار با کار توسعه، اتصال به GitHub و اتصال به GitLab را مرور کنید.