اتصال به Dropbox

اتصال Dropbox در تسکیـ برای تیم‌هایی است که می‌خواهند تغییر فایل‌های مهم را کنار وظیفه‌ها ببینند. وقتی حساب Dropbox فضای کاری وصل باشد، تسکیـ وب‌هوک‌های امضاشدهٔ Dropbox را می‌پذیرد و فایل‌هایی را که در نام یا مسیرشان شناسهٔ وظیفه آمده باشد، به همان وظیفه لینک می‌کند.

دامنهٔ نسخه فعلی: این نسخه روی دریافت امن وب‌هوک و لینک خودکار فایل به وظیفه تمرکز دارد. جستجوی محتوای Dropbox، انتخابگر پیوست فایل، پیش‌نمایش غنی لینک Dropbox، دستور /dropbox و اتصال OAuth کامل در فاز بعدی اضافه می‌شوند.

پیش از شروع

• فقط مالک یا مدیر فضای کاری می‌تواند اتصال Dropbox فضای کاری را بسازد یا قطع کند.
• باید در تنظیمات اپ Dropbox، نشانی وب‌هوک تسکیـ را ثبت کنید.
• در تنظیمات سرور تسکیـ باید کلید محرمانهٔ اپ Dropbox تنظیم شده باشد تا امضای X-Dropbox-Signature بررسی شود.
• برای نگاشت رویدادها به اتصال درست، شناسهٔ حساب Dropbox از نوع dbid:... را در فرم اتصال وارد کنید.
• تعداد اتصال‌های فضای کاری تابع محدودیت پلن است؛ اتصال‌های شخصی Dropbox در نسخه فعلی فعال نیستند.

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

1. در مرکز اپ‌ها، Dropbox را باز کنید و تب «فضای کاری» را انتخاب کنید.
2. شناسهٔ حساب Dropbox را با قالب dbid:... وارد کنید.
3. اگر برای پردازش‌های بعدی به توکن دسترسی نیاز دارید، آن را در فیلد اختیاری توکن وارد کنید؛ توکن به‌صورت رمزنگاری‌شده ذخیره می‌شود.
4. یک برچسب کوتاه برای اتصال بنویسید و «اتصال Dropbox» را بزنید.
5. در کنسول اپ Dropbox، نشانی وب‌هوک تسکیـ را ثبت و درخواست تأیید را کامل کنید.

تأیید وب‌هوک: Dropbox ابتدا یک درخواست GET با پارامتر challenge می‌فرستد. تسکیـ همان مقدار را با پاسخ متنی و هدر nosniff برمی‌گرداند. درخواست‌های POST بعدی فقط وقتی پذیرفته می‌شوند که امضای HMAC آن‌ها معتبر باشد.

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

برای اینکه فایل Dropbox خودکار به یک وظیفه لینک شود، شناسهٔ وظیفه را در نام فایل یا مسیر پوشه قرار دهید. همان الگوی شناسهٔ GitHub و GitLab پشتیبانی می‌شود:

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

برای نمونه، فایل TASK-24 brief.pdf یا مسیر /Campaign/TASK-24/assets به وظیفهٔ TASK-24 لینک می‌شود، مشروط بر اینکه آن وظیفه در همان فضای کاری قابل مشاهده باشد.

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

Dropbox در نسخه فعلی وضعیت وظیفه را تغییر نمی‌دهد. اگر در نام فایل عبارتی مثل TASK-24[Done] بنویسید، فایل همچنان به وظیفه لینک می‌شود اما وضعیت وظیفه جابه‌جا نمی‌شود. تغییر وضعیت خودکار فعلاً فقط برای رویدادهای GitHub و GitLab فعال است.

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

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

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

• وارد کردن شناسهٔ حساب اشتباه؛ مقدار باید همان حسابی باشد که Dropbox در list_folder.accounts می‌فرستد.
• تنظیم نکردن کلید محرمانهٔ اپ Dropbox؛ در این حالت همهٔ درخواست‌های POST رد می‌شوند.
• انتظار داشتن جستجوی محتوایی یا پیوست مستقیم فایل از Dropbox؛ این قابلیت‌ها در نسخه فعلی هنوز فعال نیستند.
• نوشتن شناسهٔ وظیفه در توضیح داخلی Dropbox به‌جای نام فایل یا مسیر؛ لینک خودکار از متن رویداد فایل خوانده می‌شود.
• انتظار تغییر وضعیت با کروشهٔ وضعیت؛ Dropbox فقط لینک می‌کند و وضعیت را تغییر نمی‌دهد.

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