افزونه Tableauبرای Google Workspaces

تیم هوش تجاری آماتک بلاگ Tableau دیدگاه‌ها بسته هستند

این وبلاگ نحوه نصب، پیکربندی و استفاده از افزونه Tableau برای Google Workspace را توضیح می‌دهد. هدف این افزونه، آسان‌تر کردن دسترسی کاربران نهایی به محتوای Tableau خود در محصولات Google Workspace (مانند Docs و Slides) است.

نصب افزونه

فرآیند نصب بسیار ساده است. ابتدا به Google Workspace Marketplace بروید و فهرست افزونه Tableau را پیدا کنید.

یک دکمه Install (نصب) وجود دارد، اما بسته به تنظیمات امنیتی سازمان شما، ممکن است این دکمه غیرفعال (خاکستری) باشد. اگر غیرفعال بود، یعنی مدیر Google Workspace شما یک لیست مجاز (allow-list) برای افزونه‌های قابل استفاده تعریف کرده است. در این صورت، از مدیر خود بخواهید مراحل [اینجا] را دنبال کند تا افزونه Tableau به لیست مجاز اضافه شود. همچنین ممکن است مدیر Google Workspace افزونه را به صورت خودکار برای کاربران بر اساس گروه‌های کاربری Google نصب کند.

اگر افزونه برای نصب در دسترس است، کافیست روی دکمه نصب کلیک کنید و سپس Google Docs یا Slides را در یک تب جدید مرورگر باز کنید. پس از نصب، باید یک آیکون Tableau جدید در پنل سمت راست مشاهده کنید.

پیکربندی افزونه

هنگامی که برای اولین بار افزونه را باز می‌کنید، از شما خواسته می‌شود تا دسترسی افزونه را تأیید کنید. افزونه نیاز دارد به فایل‌های Google Drive شما (مانند Docs، Slides و غیره) دسترسی داشته باشد تا بتواند محتوای Tableau را وارد یا به‌روزرسانی کند.

با کلیک روی دکمه Authorize Access (صدور دسترسی)، یک پنجره OAuth باز می‌شود که باید مجوزهای دقیق مورد نیاز افزونه را نمایش دهد.

پس از اعطای دسترسی به افزونه، احتمالاً یک پیام دیگر دریافت می‌کنید که می‌پرسد آیا افزونه می‌تواند به همین سند یا اسلاید خاص دسترسی داشته باشد یا خیر. به جای درخواست دسترسی به تمام فایل‌های موجود در Google Drive شما، ما فقط برای فایل‌هایی که می‌خواهید با افزونه استفاده کنید، مجوز می‌خواهیم.

پیکربندی سایت (Configure your site)

هنگامی که برای اولین بار افزونه را باز می‌کنید، از شما خواسته می‌شود که یک Site Configuration اضافه کنید. در این بخش می‌توانید سایت Tableau موردنظر خود را که می‌خواهید با Google Workspace یکپارچه شود، مشخص کنید.

از ادمین Tableau خود بخواهید مراحل را دنبال کند تا یک Tableau Connected App جدید ایجاد شود. این اپلیکیشن متصل (Connected App) به افزونه اجازه می‌دهد تا با استفاده از اطلاعات کاربر Google که وارد شده است، در Tableau احراز هویت انجام دهد.

هنگام ایجاد Connected App، گزینه‌های Access Level و Domain Allowlist را نادیده بگیرید، زیرا این موارد فقط هنگام استفاده از Tableau Embedding API کاربرد دارند، در حالی که این افزونه صرفاً از Tableau REST API استفاده می‌کند. همچنین فراموش نکنید که وضعیت اپلیکیشن را روی Enabled (فعال) قرار دهید، چون به‌طور پیش‌فرض همیشه غیرفعال است.

سپس از ادمین سایت Tableau بخواهید که فیلدهای زیر را در داخل افزونه تکمیل کند. برای افزودن یا حذف پیکربندی سایت‌ها در افزونه Tableau، لازم است کاربر Google یک مدیر (Admin) در سایت Tableau باشد. این کار برای جلوگیری از آن است که کاربران عادی به اشتباه سایت‌هایی را اضافه یا حذف کنند که نباید.

ویژگی	توضیحات
Label	[اختیاری] نام کاربرپسند برای سایت Tableau شما (در صورت خالی گذاشتن، از نام سایت Tableau استفاده می‌شود)
Tableau Base URL	نام هاست (Hostname) محیط Tableau شما (تصویر زیر را ببینید)
Tableau Site	نام سایت Tableau شما، همان‌طور که در آدرس URL نمایش داده می‌شود (تصویر زیر را ببینید). توجه داشته باشید که این ویژگی به حروف بزرگ و کوچک حساس است. اگر از سایت پیش‌فرض Tableau Server استفاده می‌کنید، این فیلد را خالی بگذارید.
User Mapping	این منوی کشویی مشخص می‌کند که کاربر Google Workspace شما چگونه به نام کاربری شما در Tableau نگاشت شود. در حال حاضر، فقط گزینه ایمیل (Email) پشتیبانی می‌شود.
Client ID	شناسه کلاینت (Client ID) اپلیکیشن متصل Tableau
Secret ID	شناسه مخفی (Secret ID) اپلیکیشن متصل Tableau
Secret Value	مقدار مخفی (Secret Value) اپلیکیشن متصل Tableau

پس از کلیک روی دکمه ذخیره (Save)، باید صفحه وب را تازه‌سازی (Refresh) کنید تا تغییرات اعمال شوند. دفعه بعد که افزونه Tableau را باز کنید، باید یک منوی کشویی ببینید که شامل فهرستی از تمام سایت‌هایی است که پیکربندی کرده‌اید.

اگر می‌خواهید سایت‌های بیشتری را برای کار با افزونه تنظیم کنید، از دکمه Configure (پیکربندی) در پایین افزونه استفاده کنید. این گزینه به شما امکان می‌دهد سایت‌هایی را که با افزونه کار می‌کنند مدیریت کنید.

راهنمای کاربر (User Guide)

تنظیمات کاربر (User Preferences)

از آنجایی که می‌توان افزونه را طوری پیکربندی کرد که با چندین سایت مختلف Tableau کار کند، ممکن است هر بار که افزونه را باز می‌کنید مجبور شوید از منوی کشویی Site Selector استفاده کنید. برای صرفه‌جویی در زمان، از دکمه Configuration (پیکربندی) در پایین افزونه استفاده کنید تا یک سایت را به عنوان پیش‌فرض (Default) علامت‌گذاری کنید.

این تنظیم مخصوص کاربر شما است و باعث می‌شود هر بار که افزونه را باز می‌کنید، فهرست کشویی به‌طور خودکار روی سایت پیش‌فرض شما قرار گیرد. تغییراتی که در صفحه Configuration (پیکربندی) ایجاد می‌کنید، پیش از نمایش نیاز به بارگذاری مجدد (Reload) صفحه وب دارند.

Google Slides

برای استفاده از افزونه در Google Slides، آیکون Tableau را در پنل سمت راست پیدا کنید. با کلیک روی افزونه Tableau، صفحه اصلی افزونه باز می‌شود.

افزونه Tableau Cloud این امکان را می‌دهد که محتوای Tableau خود را به‌صورت تصویر در یک ارائه Google Slides جاسازی کنید. آیکون Tableau را در پنل سمت راست پیدا کرده و سایتی را که محتوای شما از آن می‌آید انتخاب کنید.

راه‌های یافتن محتوا:

URL – آدرس نمای Tableau یا متریک Pulse خود را کپی/پیست کنید تا افزونه پیش‌نمایش نما یا متریک را نشان دهد.
جستجوی Views – یک عبارت جستجو وارد کنید تا سایت Tableau برای یافتن نما جستجو شود، سپس یکی از نتایج را انتخاب کنید تا پیش‌نمایش آن را ببینید.
جستجوی Pulse Metrics – یک عبارت جستجو وارد کنید تا سایت Tableau برای یافتن متریک Pulse جستجو شود، سپس یکی از نتایج را انتخاب کنید تا پیش‌نمایش خط روند آن نمایش داده شود.

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

این قابلیت برای مشتریان Tableau Server در دسترس نیست.

Refresh Image from Tableau

پس از درج تصاویر از Tableau، باید به یاد داشته باشید که این تصاویر ایستا هستند. با گذشت زمان داده‌های شما تغییر می‌کنند و لازم است تصاویر به‌روزرسانی شوند. برای تازه‌سازی محتوای Tableau در ارائه خود، می‌توانید روی دکمه Refresh All (تازه‌سازی همه) یا Refresh Some (تازه‌سازی برخی) کلیک کنید.

با کلیک روی Refresh Some، فهرستی از تمام تصاویر Tableau موجود در فایل ارائه شما نمایش داده می‌شود. برای هر تصویری که می‌خواهید تازه‌سازی کنید، تیک آن را بزنید و سپس روی دکمه Refresh کلیک کنید.

از آنجا که ممکن است چندین تصویر به‌طور هم‌زمان تازه‌سازی شوند، افزونه وضعیت اجرای فرآیند تازه‌سازی را به‌صورت کامنت در ارائه می‌نویسد. این کار به‌عنوان یک گزارش ثبت رویداد (Audit Trail) عمل می‌کند و به شما می‌گوید چه کسی فرآیند تازه‌سازی را آغاز کرده، این فرآیند چه زمانی اجرا شده و وضعیت هر تصویری که تلاش برای تازه‌سازی آن انجام شده چگونه بوده است.

ممکن است برخی تصاویر با موفقیت تازه‌سازی شوند، در حالی که برخی دیگر خیر. دلایل مختلفی می‌تواند باعث این موضوع شود؛ برای جزئیات بیشتر به بخش سؤالات متداول در ادامه مراجعه کنید تا با دلایل احتمالی شکست تازه‌سازی آشنا شوید.

Preview Links from Tableau

هر شیئی که حاوی یک هایپرلینک به یک نمای Tableau یا متریک Pulse باشد، به‌صورت خودکار به شکل یک PreviewLink باز می‌شود. این پیش‌نمایش‌ها، یک تصویر از نمای مورد نظر یا متریک را همراه با برخی فراداده‌ها (Metadata) نمایش می‌دهند. توجه داشته باشید که در Slides، پیش‌نمایش لینک‌ها از شما می‌خواهد که URL را با یک عنوان جدید جایگزین کنید. این جایگزینی فقط یک‌بار انجام می‌شود و تغییرات بعدی در عنوان نما یا متریک، به‌طور خودکار به‌روزرسانی نخواهد شد. این موضوع به‌ویژه در مورد Pulse metrics بیشتر به چشم می‌آید، چون عنوان تصویر بندانگشتی شامل مقدار متریک است. این مسئله یک محدودیت در نحوه عملکرد PreviewLinks در Slides است (از آنجایی که Smart Chips هنوز پشتیبانی نمی‌شوند).

Google Docs

Insert Image from Tableau

افزونه Tableau این امکان را فراهم می‌کند که محتوای Tableau خود را به‌صورت تصویر در یک سند Google Docs جاسازی کنید. آیکون Tableau را در پنل سمت راست پیدا کرده و سایتی را که محتوای شما از آن می‌آید انتخاب کنید.

برای یافتن محتوا چند روش وجود دارد:

URL – آدرس نمای Tableau یا متریک Pulse را کپی/پیست کنید تا افزونه پیش‌نمایش نما یا متریک را نمایش دهد.

جستجوی Views – یک عبارت جستجو وارد کنید تا سایت Tableau شما برای یافتن یک نما جستجو شود. یکی از نتایج را انتخاب کنید تا پیش‌نمایش آن نما را ببینید.

جستجوی Pulse Metrics – یک عبارت جستجو وارد کنید تا سایت Tableau شما برای یافتن یک متریک Pulse جستجو شود. یکی از نتایج را انتخاب کنید تا پیش‌نمایش خط روند متریک نمایش داده شود.

صفحه پیش‌نمایش، تصویری را که قرار است در سند درج شود نشان می‌دهد و از شما می‌خواهد زبانه‌ای (Tab) را که می‌خواهید تصویر در آن درج شود انتخاب کنید. با کلیک روی دکمه Insert، تصویر واکشی شده و در ابتدای زبانه انتخاب‌شده درج می‌شود. پس از افزودن تصویر، می‌توانید آن را به هر قسمت از سند که خواستید جابه‌جا کنید.

Refresh Image from Tableau

پس از درج تصاویر از Tableau، باید به خاطر داشته باشید که این تصاویر ایستا هستند. با گذشت زمان، داده‌های شما تغییر می‌کنند و لازم است این تصاویر به‌روزرسانی شوند. برای تازه‌سازی محتوای Tableau در سند خود، می‌توانید روی دکمه Refresh All (تازه‌سازی همه) یا Refresh Some (تازه‌سازی برخی) کلیک کنید.

با کلیک روی Refresh Some، فهرستی از تمام تصاویر Tableau موجود در سند نمایش داده می‌شود. تیک تصاویر موردنظر برای تازه‌سازی را بزنید و سپس روی دکمه Refresh کلیک کنید.

از آنجا که ممکن است چندین تصویر به‌طور هم‌زمان تازه‌سازی شوند، افزونه وضعیت اجرای فرآیند تازه‌سازی را به‌صورت کامنت در سند ثبت می‌کند. این کار به‌عنوان یک گزارش رویداد (Audit Trail) عمل می‌کند و نشان می‌دهد چه کسی فرآیند تازه‌سازی را آغاز کرده، این فرآیند چه زمانی اجرا شده و وضعیت هر تصویری که تلاش برای تازه‌سازی آن انجام شده چگونه بوده است.

ممکن است برخی تصاویر با موفقیت تازه‌سازی شوند و برخی دیگر خیر. دلایل مختلفی می‌تواند باعث این اتفاق شود؛ برای آشنایی با دلایل احتمالی شکست تازه‌سازی تصاویر، به بخش سؤالات متداول (FAQ) در ادامه مراجعه کنید.

Smartchips from Tableau

هر شیئی که حاوی یک هایپرلینک به یک نمای Tableau یا متریک Pulse باشد، به‌طور خودکار به شکل یک Smartchip باز می‌شود. این اسمارت‌چیپ‌ها یک تصویر پیش‌نمایش از نما یا متریک، به همراه برخی فراداده‌ها (Metadata) نمایش می‌دهند.

سؤالات متداول

۱. آیا این افزونه برای هر دو Tableau Cloud و Tableau Server کار می‌کند؟

بله، این افزونه از هر دو Tableau Cloud و Tableau Server (نسخه 2023.3 و جدیدتر) پشتیبانی می‌کند.

برای مشتریان Tableau Server، ویژگی‌های PreviewLink و Smartchip در دسترس نیستند. دلیل این موضوع این است که افزونه‌های Google Workspace نیاز دارند یک لیست مجاز جهانی (allowlist) برای URLها تعیین کنند تا مطابقت داشته باشند. برای Tableau Cloud این کار ساده است، زیرا تمام URLها با https://.online.tableau.com آغاز می‌شوند. اما هر مشتری URLهای منحصر به فردی برای محیط Tableau Server خود دارد و راهی برای تنظیم دینامیک این لیست وجود ندارد.

علاوه بر این، مشتریان Tableau Server باید مطمئن شوند که افزونه ما می‌تواند با سرور Tableau شما ارتباط برقرار کند. بسیاری از مشتریان سرورهای Tableau خود را پشت فایروال یا VPC قرار می‌دهند تا دسترسی عمومی محدود شود. در این صورت، تیم امنیت شبکه شما باید یک قانون ورودی (ingress rule) اضافه کند که اجازه ترافیک از افزونه ما را بدهد. افزونه ما در https://addon.googleworkspaces.tableau.com میزبانی می‌شود که با آدرس IP ثابت 34.8.136.91:443 مطابقت دارد، بنابراین از این آدرس برای قانون لیست مجاز استفاده کنید.

۲. چه داده‌هایی در این افزونه ذخیره می‌شوند؟

در مورد داده‌هایی که به اشتراک گذاشته می‌شوند، می‌توان بین داده‌هایی که با افزونه ما به اشتراک گذاشته می‌شوند و داده‌هایی که در Google Docs/Slides ذخیره می‌شوند تفاوت قائل شد:

1. داده‌های ذخیره شده در اپلیکیشن ما (میزبانی‌شده در پروژه GCP متعلق به Salesforce):

جزئیات پیکربندی سایت (Site Config Details) – اطلاعات مورد نیاز افزونه برای احراز هویت کاربران شما در Tableau، شامل URL و نام سایت Tableau و جزئیات Connected App (Client ID، Secret ID، Secret Value).
تنظیمات کاربر (User Preferences) – وقتی یک سایت را به عنوان پیش‌فرض (Default) انتخاب می‌کنید، این انتخاب در پایگاه داده ذخیره می‌شود.
تله‌متری (Telemetry) – فعالیت‌های داخل افزونه ثبت می‌شوند، مانند باز کردن داشبوردی با نام X. هیچ داده واقعی‌ای ذخیره نمی‌شود، تنها metadata از Tableau ثبت می‌شود.

2. داده‌های ذخیره شده در Google Docs/Slides:

تصاویر (Images) – وقتی نمایی یا متریکی را در یک سند یا اسلاید جاسازی می‌کنید، فقط یک تصویر ایستا درج می‌شود. این مشابه گرفتن اسکرین‌شات از داشبورد و جای‌گذاری آن در سند است.

دسترسی‌ها و مجوزها:
افزونه به اطلاعات پروفایل کاربر نهایی نیاز دارد تا بتواند آنها را در Tableau Server/Cloud احراز هویت کند. همچنین برای درج و تازه‌سازی تصاویر Tableau، دسترسی به فایل‌های فردی مورد استفاده در افزونه لازم است. این جزئیات در صفحه Marketplace افزونه و هنگام نصب آن مشخص شده است.

۳. آیا تصاویر live هستند یا static؟

تمام تصاویر داخل Google Workspace ثابت هستند. گوگل اجازه‌ی جاسازی محتوای زنده (iframe) را نمی‌دهد، بنابراین هیچ شخص ثالثی نمی‌تواند داشبورد تعاملی زنده را جاسازی کند. همه‌ی تصاویر، عکس‌هایی از نمای داشبورد یا معیارها در لحظه‌ای هستند که در سند یا اسلاید وارد شده‌اند.

۴. اگر یک تصویر تولیدشده توسط Tableau را برش داده، کپی و جای‌گذاری کنم، چه اتفاقی می‌افتد؟

خلاصه: نسخه‌های کپی‌شده از تصویر هم قابل به‌روزرسانی خواهند بود. پاسخ دقیق: وقتی یک تصویر Tableau (نمای داشبورد یا معیار) در یک سند یا اسلاید جاسازی می‌شود، ما یک لینک به محتوای Tableau هم اضافه می‌کنیم. این کار به ما اجازه می‌دهد تشخیص دهیم کدام تصاویر از افزونه Tableau آمده‌اند و کدام تصویر معمولی هستند. بنابراین، اگر لینک را به‌صورت دستی از تصویر حذف کنید، دیگر امکان به‌روزرسانی آن وجود نخواهد داشت.

۵. authentication چگونه کار می‌کند؟

زمانی که افزونه برای اولین بار نصب می‌شود، از کاربر خواسته می‌شود تا آن را با یک سایت Tableau Cloud/Server پیکربندی کند. این پیکربندی از Tableau Connected Apps برای ارائه تجربه‌ی ورود یک‌باره (Single Sign-On) برای مشتری استفاده می‌کند. پس از اینکه افزونه یک‌بار پیکربندی شد، همه‌ی کاربران دیگر همان مشتری می‌توانند از همان پیکربندی استفاده کنند و دیگر نیازی به ورود به Tableau نخواهند داشت.

وقتی کاربر افزونه Tableau را باز می‌کند، ما مقداری اطلاعات درباره‌ی آن کاربر از طریق API‌های گوگل دریافت می‌کنیم. آدرس ایمیل او را گرفته و از آن برای احراز هویت در Tableau Cloud/Server استفاده می‌کنیم تا بتوانیم درخواست‌های REST API را انجام دهیم. بنابراین هر زمان که کاربر نمایی (view) یا معیاری (metric) جست‌وجو می‌کند یا تصویری تولید می‌کند، هویت گوگل او را به نام کاربری Tableau نگاشت می‌کنیم و از آن برای اطمینان از اعمال مجوزهای Tableau استفاده می‌کنیم.

۶. اگر ایمیل گوگل مشتری با نام کاربری Tableau او مطابقت نداشته باشد، چه می‌شود؟

در عرضه‌ی اولیه‌ی این افزونه، نیاز است که ایمیل گوگل با نام کاربری Tableau مطابقت داشته باشد. با این حال، ما می‌دانیم که این موضوع برای بسیاری از مشتریان Tableau Server مشکل‌ساز خواهد بود. این موضوع کمی چالش‌برانگیز است، زیرا نام‌های کاربری Tableau ممکن است اصلاً در Google Workspace وجود نداشته باشند. مدیران Google Workspace می‌توانند ویژگی‌های کاربری سفارشی ایجاد کنند، بنابراین احتمالاً این روش در آینده مورد استفاده قرار خواهد گرفت. با این حال، هنوز باید راهی برای پرس‌وجو درباره‌ی این ویژگی‌های کاربری سفارشی از طریق افزونه‌ی ما پیدا کنیم.

۷. آیا این از نماهای سفارشی پشتیبانی می‌کند؟

بله، اگر لینک یک نمای سفارشی را در افزونه کپی/پیست کنید، همانند هر نمای دیگر کار خواهد کرد.

۸. چه نوع آدرس‌های اینترنتی (URL) پشتیبانی می‌شوند؟

آدرس‌های اینترنتی (URL) که به نماها، نماهای سفارشی و معیارهای Pulse لینک می‌شوند، پشتیبانی می‌شوند. یک استثنا مربوط به URLهایی است که با کلیک راست روی لینک یک نما در Tableau به‌دست می‌آیند. این URLها معمولاً الگوی زیر را دارند:

https://.online.tableau.com/#/site//redirect_to_view/

متأسفانه، هیچ راهی برای تعیین اینکه این شماره مربوط به کدام نما است وجود ندارد. در عوض، نما را در مرورگر وب خود باز کنید و URL نما را از پنجره‌ی مرورگر دریافت کنید .

۹.در حال تلاش برای پیکربندی Tableau Server هستید، اما با خطایی مانند «امکان ارتباط با Tableau Server در xxx وجود ندارد» مواجه می‌شوید؟

این پیام خطا زمانی رخ می‌دهد که افزونه Google Workspace ما نتواند به Tableau Server شما دسترسی پیدا کند. به‌طور کلی، این مشکل مربوط به دسترسی شبکه است، جایی که افزونه ما یک درخواست API ارسال می‌کند اما هرگز به Tableau Server نمی‌رسد. دلایل زیادی ممکن است باعث این مشکل شوند (مانند فایروال یا VPC که دسترسی را مسدود می‌کند، نبود گواهی SSL معتبر و غیره) که می‌تواند عیب‌یابی را دشوار کند.

اگر با این مشکل مواجه شدید، می‌توانید از ابزار زیر استفاده کنید. این ابزار شامل نمونه کدی است که ورودی‌های شما (config.js) را می‌گیرد و سعی می‌کند به Tableau Server شما احراز هویت کند. اگر مشکلی در اتصال وجود داشته باشد، جزئیات بیشتری درباره دلیل شکست اتصال نمایش داده خواهد شد.

برای استفاده از این ابزار، به یک حساب کاربری رایگان در Replit.com نیاز دارید. پس از ثبت‌نام، از این لینک برای «Remix the app» استفاده کنید. این کار یک نسخه جداگانه از برنامه فقط برای شما ایجاد می‌کند. فایل config.json را ویرایش کرده و جزئیات Tableau Server خود را وارد کنید، سپس دکمه سبز RUN را کلیک کنید. خروجی باید اطلاعات بیشتری درباره دلیل عدم موفقیت تلاش احراز هویت به شما بدهد. فقط به خاطر داشته باشید که پروژه‌های رایگان Replit عمومی هستند، بنابراین پس از اتمام تست، آن‌ها را حذف کنید.