تعریف پیکربندی تجسم

توجه: ویژگی تجسم جامعه در «پیش‌نمایش توسعه‌دهندگان» است. برای کسب اطلاعات بیشتر در مورد ویژگی‌ها و بهبودهای آینده در این دوره، از صفحه پیش‌نمایش توسعه‌دهندگان دیدن کنید.

گزینه‌های داده و سبک برای تجسم جامعه در یک فایل پیکربندی JSON تعریف می‌شوند. پیکربندی data ، تعداد ابعاد و معیارهایی را که تجسم پشتیبانی می‌کند، تعیین می‌کند. پیکربندی style ، انتخابگرهای سبک موجود در پنل ویژگی‌ها را تعریف می‌کند.

پیکربندی داده‌ها

پیکربندی data ، عناصر DIMENSION و METRIC را که Looker Studio در پنل ویژگی‌ها رندر می‌کند، تعریف می‌کند. هر عنصر مربوط به فیلدهای ابعاد و عناصری است که کاربر نهایی به عنوان ورودی به تجسم ارائه می‌دهد.

عنصر داده نمونه:

{
  "id": "twoDimensionsPlease",
  "label": "Dimension Element Heading",
  "type": "DIMENSION",
  "options": {
    "min": 2,
    "max": 2,
  }
}

id که در عنصر داده تعریف می‌کنید، در اطلاعاتی که Looker Studio با آن پاسخ می‌دهد، گنجانده شده است. label متنی را که کاربران در بالای بخش داده می‌بینند، تعریف می‌کند و type ، بُعد یا متریک بودن آن را مشخص می‌کند. شیء options ، حداقل و حداکثر تعداد فیلدهایی را که کاربر می‌تواند به عنصر داده اضافه کند، تعریف می‌کند.

در یک عنصر داده DIMENSION، شیء options از یک کلید اختیاری supportedTypes پشتیبانی می‌کند. در صورت تعریف، Looker Studio نوع فیلدهای بُعدی را که می‌توانند به عنصر اضافه شوند، محدود می‌کند. مقدار supportedTypes آرایه‌ای است که می‌تواند شامل هر ترکیبی از "DEFAULT"، "TIME" و "GEO" باشد.

یک بخش داده، چندین عنصر داده را با هم گروه‌بندی می‌کند. Looker Studio label به عنوان یک عنوان برای چندین عنصر داده ارائه می‌دهد.

بخش داده‌های نمونه:

{
  "id": "dimensionSection1",
  "label": "Dimension Section Heading",
  "elements":[
    // array of data elements
  ]
}

این اسکرین‌شات نشان می‌دهد که Looker Studio چگونه بخش داده و عنصر داده‌ی بالا را رندر می‌کند:

پیکربندی سبک

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

یک عنصر سبک نمونه:

{
  "id": "linkOpacity",
  "label": "Link opacity",
  "type": "OPACITY",
  "defaultValue": "0.2"
}

label ، متنی را که کاربران به عنوان یک tooltip می‌بینند تعریف می‌کند و type ، نوع انتخابگر سبکی را که Looker Studio ارائه می‌دهد، تعریف می‌کند. به صورت اختیاری، defaultValue یک مقدار پیش‌فرض برای هر عنصر سبک تعریف می‌کند.

مشابه عناصر داده، عناصر سبک درون بخش‌هایی تعریف می‌شوند که عنوان‌ها و گروه‌بندی‌های منطقی را ارائه می‌دهند. برای مشاهده لیست کامل انتخابگرهای موجود، به مرجع پیکربندی مراجعه کنید.

یک نمونه بخش استایل:

{
  "id": "styleGroup1",
  "label": "Header for style group",
  "elements": [
    // insert Style Elements here
  ]
}

تصویر زیر نمونه‌ای از یک پنل استایل با انتخابگر میزان شفافیت را نشان می‌دهد که در آن، راهنمای ابزار "Link Opacity" متناظر با label موجود در عنصر استایل است.

پیکربندی تعامل

پیکربندی interaction ، نحوه‌ی عملکرد تعاملات نمودار را برای تجسم جامعه تعریف می‌کند. این مورد اختیاری است.

مثال:

{
  "id": "onClick",
  "supportedActions": ["FILTER"]
}

در حال حاضر، فقط FILTER پشتیبانی می‌شود. اگر تعاملات را پیکربندی کنید، یک کادر انتخاب در پنل ویژگی‌ها نمایش داده می‌شود.

پیکربندی ویژگی‌ها

پیکربندی features می‌تواند ویژگی‌های مختلفی را در تجسم جامعه شما فعال یا غیرفعال کند. این بخش اختیاری است. لیستی از ویژگی‌ها را می‌توانید در مرجع پیکربندی پیدا کنید.

مثال:

  "features": {
    "enableComparisonDateRange": true
  }

مثال

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

مراحل بعدی

پس از تعریف پیکربندی خود، تجسم را بنویسید .