همگام‌سازی تقویم گوگل¶
با استفاده از امکانات تعبیه شده، تقویم گوگل را با سازمان‌یار همگام کرده و جلسات را در هر دو پلتفرم مشاهده و مدیریت کنید (به‌روزرسانی دو جهته است). این ادغام در برنامه‌ریزی زمانی کمک‌کننده بوده و هیچ جلسه‌ای فراموش نمی‌شود.
همچنین ملاحظه نمائید
انجام تنظیمات در گوگل¶
انتخاب (یا ایجاد) پروژه جدید¶
پروژه API جدیدی در گوگل ایجاد کرده و API تقویم گوگل را در آن فعال کنید. ابتدا وارد Google API Console شده و با حساب گوگل خود ورود کنید.
توجه
اگر برای اولین بار این صفحه را مشاهده می‌کنید، گوگل از کاربر درخواست می‌کند کشور را وارد کرده و شرایط و ضوابط را پذیرش کند. از لیست کشوری را انتخاب کرده و ToS را پذیرش کنید.
در ادامه، Select a project (انتخاب پروژه) را بزنید و یک پروژه API ایجاد کرده و OAuth را پیکربندی کنید. مجوزها و اطلاعات دریافتی را ذخیره و بر روی New Project (پروژه جدید) کلیک کنید.
یک نام واضح به پروژه API بدهید، مانند Odoo Sync، تا قابل شناسایی باشد. سپس روی دکمه ایجاد کلیک کنید.
فعال‌سازی API تقویم گوگل¶
اکنون، روی APIها و سرویس‌های فعال شده در منوی سمت چپ کلیک کنید. اگر نوار جستجو ظاهر نشد، دوباره APIها و سرویس‌های فعال شده را انتخاب کنید.
سپس، در نوار جستجو، Google Calendar API را جستجو کرده و از نتایج جستجو Google Calendar API را انتخاب کنید. بر روی Enable (فعال‌سازی) کلیک کنید.
برگه رضایت OAuth¶
اکنون که پروژه API ایجاد شده است، OAuth باید پیکربندی شود. برای انجام این کار، روی صفحه رضایت OAuth در منوی سمت چپ کلیک کنید، سپس روی دکمه شروع به کار کلیک کنید.
هشدار
حساب‌های جیمیل شخصی تنها می‌توانند نوع کاربر خارجی (External) داشته باشند، که یعنی گوگل شاید تأییدیه درخواست کند و یا حدودی (Scopes) برای آن اضافه شود. با این همه، استفاده از حساب فضای کاری گوگل امکان استفاده از نوع کاربر داخلی را نیز فراهم کرده است.
همچنین توجه داشته باشید که هرگاه اتصال API در حالت تست خارجی باشد، تأییدیه‌ای از طرف گوگل لازم نیست. محدودیت‌های کاربر در وضعیت تست به 100 کاربر تنظیم شده است.
مراحل زیر را به ترتیب دنبال کنید:
در اطلاعات برنامه،
Odooرا در فیلد نام برنامه تایپ کنید، سپس آدرس ایمیل را برای فیلد ایمیل پشتیبانی کاربر وارد کرده و روی دکمه بعدی کلیک کنید.در مخاطب، خارجی را انتخاب کنید، سپس روی دکمه بعدی کلیک کنید.
در اطلاعات تماس، دوباره ایمیل را وارد کنید، سپس روی دکمه بعدی کلیک کنید.
در پایان، کادر انتخاب را برای موافقت با سرویس‌های Google API: خط‌مشی کاربر علامت بزنید. برای آخرین مرحله، روی دکمه ایجاد کلیک کنید.
کاربران آزمایشی¶
برای اینکه کاربران بتوانند با حساب‌های شخصی جیمیل همگام‌سازی کنند، باید به‌عنوان کاربر آزمایشی تنظیم شوند. کاربران آزمایشی را با رفتن به مخاطب در منوی سمت چپ و کلیک کردن روی دکمه افزودن کاربران در بخش کاربران آزمایشی راه‌اندازی کنید. هر ایمیلی که مد نظر است را وارد کرده و روی دکمه ذخیره کلیک کنید.
ایجاد اطلاعات احراز¶
شناسه کلاینت و رمز کلاینت هر دو برای اتصال تقویم گوگل به سازمان‌یار مورد نیاز هستند. این آخرین مرحله در کنسول گوگل است. با کلیک روی کلاینت‌ها در منوی سمت چپ شروع کنید. سپس، روی ایجاد اعتبارنامه کلیک کرده و شناسه کلاینت OAuth را انتخاب کنید، گوگل راهنمایی برای ایجاد اعتبارنامه باز خواهد کرد.
در بخش Create OAuth Client ID گزینه Website application را در فیلد Application Type وارد نمایید و در فیلد Name عبارت My Odoo Database را وارد نمایید.
در بخش Authorized JavaScript Origins بر روی + Add URI کلیک کرده و آدرس URL کامل اودوو را وارد کنید.
در بخش Authorized redirect URIs، روی + Add URI کلیک کرده و آدرس URL کامل اودوو را وارد کرده و در ادامه آن
/google_account/authenticationرا تایپ کنید. در نهایت Create را بزنید.
یک شناسه کلاینت و رمز کلاینت ظاهر می‌شود که باید آنها را در مکانی امن ذخیره کنید.
راه اندازی در سمت سازمان‌یار¶
پس از دریافت شناسه کلاینت و رمز کلاینت، پایگاه داده سازمان‌یار را باز کرده و به بروید و ویژگی تقویم گوگل را پیدا کنید. گزینه تقویم گوگل را فعال کنید.
سپس، Client ID و Client Secret دریافتی را در فیلدهای مربوطه (شناسه Client ID و رمز (Secret) کاربر) زیر گزینه تقویم گوگل وارد کرده و ذخیره کنید.
توجه
کادر انتخاب مکث همگام‌سازی را علامت بزنید تا به‌روزرسانی رویدادها به‌طور موقت متوقف شود. این امکان آزمایش و عیب‌یابی را بدون حذف اعتبارنامه‌ها یا حذف همگام‌سازی فراهم می‌کند. برای از سرگیری همگام‌سازی، گزینه را دوباره غیرفعال کرده و ذخیره کنید.
همگام‌سازی تقویم در سازمان‌یار¶
در نهایت، در سازمان‌یار وارد برنامه شوید و برای شروع همگام‌سازی تقویم، دکمه همگام‌سازی گوگل را بزنید.
توجه
هنگام همگام‌سازی تقویم گوگل با سازمان‌یار برای اولین بار، صفحه به حساب گوگل هدایت می‌شود. از آنجا، حساب ایمیلی را که باید دسترسی داشته باشد انتخاب کنید، سپس ادامه را انتخاب کنید (اگر برنامه تأیید نشده باشد) و در نهایت ادامه را انتخاب کنید (تا اجازه انتقال داده‌ها داده شود).
حالا تقویم سازمان‌یار با موفقیت با تقویم گوگل همگام شد!
هشدار
اودوو شدیداً توصیه می‌کند تقویم گوگل در پایگاه داده تست و با ایمیل تست (که برای اهداف دیگری استفاده نمی‌شود) همگام‌سازی و تست شود و بعداً تقویم گوگل مربوط به پایگاه داده زیربار همگام‌سازی شود.
پس از اینکه کاربر تقویم گوگل خود را با تقویم سازمان‌یار همگام‌سازی کرد:
ایجاد رویداد در سازمان‌یار باعث می‌شود گوگل به تمام شرکت‌کنندگان رویداد ایمیل دعوت ارسال کند.
حذف رویداد در سازمان‌یار باعث می‌شود به تمام شرکت‌کنندگان رویداد اطلاعیه لغو ارسال شود.
افزودن مخاطب به رویداد باعث می‌شود گوگل به تمام شرکت‌کنندگان رویداد دعوتنامه ارسال کند.
حذف مخاطب از رویداد باعث می‌شود به تمام شرکت‌کنندگان ایمیل لغو ارسال شود.
رویدادها را می‌توان در تقویم گوگل بدون ارسال اعلان ایجاد کرد. برای این کار، هنگام درخواست ارسال ایمیل‌های دعوت، گزینه ارسال نشود را انتخاب کنید.
عیب‌یابی همگام‌سازی¶
ممکن است گاهی اوقات حساب تقویم گوگل به درستی با سازمان‌یار همگام نشود. مشکلات همگام‌سازی را می‌توان در گزارش‌های پایگاه داده مشاهده کرد.
در این موارد، حساب کاربری نیاز به عیب‌یابی دارد. با استفاده از دکمه بازنشانی حساب می‌توان تنظیمات را بازنشانی کرد. برای دسترسی به این دکمه به مسیر بروید. سپس کاربری را که می‌خواهید تقویم او را تغییر دهید انتخاب کرده و روی تب تقویم کلیک کنید.
در مرحله بعد، زیر تقویم مورد نظر، روی بازنشانی حساب کلیک کنید.
گزینه‌های بازنشانی¶
گزینه‌های بازنشانی زیر برای عیب‌یابی همگام‌سازی تقویم گوگل با سازمان‌یار در دسترس هستند:
رویدادهای موجود کاربر:
دست نخورده بمانند: تغییری در رویدادها اعمال نشود.
حذف از حساب تقویم گوگل فعلی: رویدادها را از تقویم گوگل حذف کنید.
حذف از سازمان‌یار: رویدادها را از برنامه تقویم سازمان‌یار حذف کنید.
حذف از هر دو: رویدادها را هم از تقویم گوگل و هم از برنامه تقویم سازمان‌یار حذف کنید.
همگام‌سازی بعدی:
فقط رویدادهای جدید همگام‌سازی شوند: رویدادهای جدید را در تقویم گوگل یا برنامه تقویم سازمان‌یار همگام‌سازی کنید.
همه رویدادهای موجود همگام‌سازی شوند: همه رویدادها را در تقویم گوگل یا برنامه تقویم سازمان‌یار همگام‌سازی کنید.
پس از انتخاب، روی تأیید کلیک کنید تا رویدادهای کاربر و همگام‌سازی تقویم اصلاح شود.
سؤالات متداول Google OAuth¶
گاهی اوقات ممکن است خطاهای پیکربندی رخ دهد و برای حل مشکل نیاز به عیب‌یابی باشد. در ادامه رایج‌ترین خطاهایی که ممکن است هنگام پیکربندی تقویم گوگل برای استفاده با سازمان‌یار رخ دهد، آورده شده است.
وضعیت انتشار: زیربار در مقابل تست¶
انتخاب زیربار به عنوان وضعیت انتشار (به جای آزمایش) پیام هشدار زیر را نمایش می‌دهد:
OAuth تا زمانی که صفحه رضایت OAuth تأیید نشود، به 100 ورود دامنه حساس محدود شده است. این ممکن است نیازمند فرآیند تأیید باشد که ممکن است چند روز طول بکشد.
برای رفع این هشدار، وارد پلتفرم Google API شوید. اگر وضعیت انتشار In Production است، برای رفع مشکل روی Back to Testing کلیک کنید.
کاربر آزمایشی اضافه نشده است¶
اگر کاربر تستی به صفحه رضایت OAuth اضافه نشود، خطای Error 403: access_denied نمایش داده می‌شود.
برای رفع این خطا، به صفحه رضایت OAuth در بخش APIs & Services برگردید و کاربران آزمایشی را به برنامه اضافه کنید. ایمیلی که قرار است در سازمان‌یار پیکربندی شود را اضافه کنید.
نوع برنامه¶
هنگام ایجاد اطلاعات ورود (OAuth شناسه کلاینت و رمز کلاینت)، اگر برنامه دسکتاپ برای نوع برنامه انتخاب شده باشد، خطای مجوز ظاهر می شود (خطای 400: redirect_uri_mismatch).
برای رفع این خطا، اطلاعات ورود (Credentials) موجود را حذف کنید و با انتخاب Web Application برای Application Type، اطلاعات ورود جدید ایجاد کنید.
سپس، پس از Authorized redirect URIs، روی افزودن URI کلیک کنید و عبارت https://yourdbname.odoo.com/google_account/authentication را در فیلد وارد کنید. حتماً yourdbname را در URL با نام پایگاه داده واقعی سازمان‌یار جایگزین کنید.
نکته
اطمینان حاصل کنید که دامنه‌ای که در URI استفاده شده است (https://yourdbname.odoo.com/google_account/authentication) دقیقاً همان دامنه‌ای باشد که در پارامتر سیستم web.base.url پیکربندی شده است.
با فعال کردن حالت توسعه‌دهنده و ورود به مسیر به web.base.url دسترسی پیدا کنید.