نوشتن تجسم خود

نوشتن کد تجسم

کتابخانه کمکی Looker Studio یک رابط بین شما و Looker Studio فراهم می کند. برای استفاده از کتابخانه، یک تابع فراخوانی ارائه کنید که تصویرسازی را ارائه می‌کند.

برجسته ترین تابع در کتابخانه subscribeToData است که دو آرگومان می گیرد: یک تابع callback که تصویرسازی را ارائه می دهد و یک شی options که مشخص می کند شما می خواهید داده های شما چه نوع تبدیلی را داشته باشند. برای کسب اطلاعات بیشتر، مرجع کتابخانه را مرور کنید.

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

function drawViz(vizData){
  var height = dscc.getHeight();
  var width = dscc.getWidth();
  console.log(vizData);
  // this is where you write your viz code
}

dscc.subscribeToData(drawViz, {transform: dscc.objectTransform})

هنگام نوشتن تجسم جامعه، چند نکته کلیدی وجود دارد که باید در نظر داشته باشید.

به‌روزرسانی‌ها از تابع subscribeToData زمانی رخ می‌دهند که داده‌ها، استایل یا اندازه iframe تغییر کند.

مثلا:

// create and add the canvas
// do this one time
var canvasElement = document.createElement('canvas');
var ctx = canvasElement.getContext('2d');
canvasElement.id = 'myViz';
document.body.appendChild(canvasElement);

function drawViz(data){
  // clear the canvas
  var ctx = canvasElement.getContext('2d');
  ctx.clearRect(0, 0, canvasElement.width, canvasElement.height);

  // viz code goes here

}

Looker Studio فایل های جاوا اسکریپت را بارگیری و اجرا می کند نه HTML. تمام دستکاری های DOM باید از طریق جاوا اسکریپت انجام شود.

به عنوان مثال: کد زیر یک div به DOM تعریف و اضافه می کند.

// create and add the canvas
var chartElement = document.createElement('div');
chartElement.id = 'myViz';
document.body.appendChild(chartElement);

بسته بندی کد

تجسم های جامعه Looker Studio فقط به شما اجازه می دهد یک فایل جاوا اسکریپت را بارگیری کنید. کد آپلود شده باید یک فایل واحد باشد که شامل کتابخانه کمکی dscc، هر کتابخانه تجسم جاوا اسکریپت و کد تجسم شما باشد.

برای انجام این کار در bash می توانید از دستور cat مانند زیر استفاده کنید.

cat dscc.min.js vizLibrary.js myVizSource.js > myViz.js

تعریف مانیفست

فایل مانیفست تجسم، فراداده‌ای درباره تجسم و همچنین اطلاعاتی درباره مکان منابع تجسم ارائه می‌کند. محل فایل مانیفست به عنوان "شناسه مؤلفه" نامیده می شود و برای بارگیری تصویری انجمن استفاده می شود.

برای مشاهده نمونه مانیفست، مرجع مانیفست را مرور کنید.

پارامتر devMode مانیفست رفتار حافظه پنهان تصویرسازی را تعیین می کند. هنگام توسعه تصویرسازی، devMode باید true باشد تا اطمینان حاصل شود که به‌روزرسانی‌های سخت آخرین نسخه منابع را بارگیری می‌کنند. هنگامی که کد پایدار است، devMode باید false باشد تا اطمینان حاصل شود که گزارش‌های دارای تجسم‌های انجمن به سرعت بارگیری می‌شوند. برای اطلاعات بیشتر در مورد حافظه پنهان، راهنمای پیشرفته ذخیره سازی را ببینید.

مراحل بعدی

اکنون که کد تجسم خود را نوشته اید، یاد بگیرید که چگونه تجسم خود را میزبانی کنید .