समुदाय विज़ुअलाइज़ेशन कॉन्फ़िगरेशन संदर्भ

विज़ुअलाइज़ेशन कॉन्फ़िगरेशन, विज़ुअलाइज़ेशन के लिए ज़रूरी डेटा और स्टाइल एट्रिब्यूट तय करता है.

कॉन्फ़िगरेशन इस तरह के स्ट्रक्चर वाली एक JSON फ़ाइल के तौर पर होना चाहिए:

{
  "data": [{
    "id": string,
    "label": string,
    "elements": [{
      "type": enum(DataElement),
      "id": string,
      "label": string,
      "options": object(DataElementOptions)
    }]
  }],
  "style": [{
    "id": string,
    "label": string,
    "elements": [{
      "type": enum(StyleElement),
      "id": string,
      "label": string,
      "defaultValue": string | object
    }]
  }],
  "interactions": [{
    "id": string,
    "supportedActions": array(enum(InteractionType))
  }],
  "features": {
   "enableComparisonDateRange": boolean
  }
}
फ़ील्ड का नाम Type ब्यौरा
data[] Array(object) विज़ुअलाइज़ेशन का डेटा कॉन्फ़िगरेशन. यह कॉन्फ़िगरेशन, प्रॉपर्टी पैनल के डेटा पैनल पर असर डालता है.
data[].id string डेटा सेक्शन का आईडी. यह बिना खाली जगह वाली स्ट्रिंग होनी चाहिए.
data[].label string डेटा सेक्शन के लिए लेबल.
data[].elements[] string रेंडर करने के लिए, डेटा एलिमेंट.
data[].elements[].type string enum(DataElement) रेंडर करने के लिए, डेटा एलिमेंट का टाइप.
data[].elements[].id string डेटा एलिमेंट का आईडी. यह बिना खाली जगह वाली स्ट्रिंग होनी चाहिए.
data[].elements[].label string डेटा एलिमेंट के लिए टूलटिप लेबल.
data[].elements[].options object(DataElementOptions) एलिमेंट के लिए डेटा के विकल्प. यह डेटा एलिमेंट टाइप पर निर्भर करता है.
style[] Array(object) विज़ुअलाइज़ेशन के लिए ज़रूरी स्टाइल कॉन्फ़िगरेशन. यह कॉन्फ़िगरेशन, प्रॉपर्टी पैनल के स्टाइल पैनल पर असर डालता है. कलेक्शन का हर ऑब्जेक्ट, रेंडर करने के लिए किसी स्टाइल एलिमेंट के बारे में बताता है. एलिमेंट के क्रम से तय होता है कि उन्हें किस क्रम में रेंडर किया जाएगा.
style[].id string स्टाइल सेक्शन का आईडी. यह बिना खाली जगह वाली स्ट्रिंग होनी चाहिए.
style[].label string स्टाइल सेक्शन के लिए लेबल.
style[].elements Array(object) रेंडर करने के लिए स्टाइल एलिमेंट.
style[].elements[].id string स्टाइल एलिमेंट का आईडी. यह बिना खाली जगह वाली स्ट्रिंग होनी चाहिए.
style[].elements[].type string enum(StyleElement) स्टाइल एलिमेंट का टाइप. उदाहरण के लिए, फ़ॉन्ट सिलेक्टर.
style[].elements[].label string स्टाइल एलिमेंट के लिए टूलटिप या लेबल. यह एक चेकबॉक्स एलिमेंट के लिए लेबल टेक्स्ट है और अन्य तरह के एलिमेंट के लिए टूलटिप टेक्स्ट है.
style[].elements[].options Array(object) एलिमेंट का options. यह सिर्फ़ SELECT_SINGLE और SELECT_RADIO स्टाइल एलिमेंट टाइप के लिए मान्य है.
style[].elements[].defaultValue string OR object स्टाइल एलिमेंट के लिए डिफ़ॉल्ट वैल्यू. अमान्य वैल्यू को अनदेखा कर दिया जाएगा.*
interactions[] Array(object) विज़ुअलाइज़ेशन का इंटरैक्शन कॉन्फ़िगरेशन. इस कॉन्फ़िगरेशन से तय होता है कि यह फ़िल्टर के तौर पर काम कर सकता है या नहीं.
interactions[].id string इंटरैक्शन एलिमेंट का आईडी. यह बिना खाली जगह वाली स्ट्रिंग होनी चाहिए.
interactions[].supportedActions Array (enum(InteractionType) संभावित इंटरैक्शन की सुविधा
features object वे सुविधाएं जिन्हें आपको अपने विज़ुअलाइज़ेशन में चालू या बंद करना है.
features.enableComparisonDateRange boolean तुलना के लिए तारीख की सीमाएं चालू करें. जानकारी न होने पर, डिफ़ॉल्ट वैल्यू false होती है.

*defaultValue एक स्ट्रिंग है, जिसमें रंग चुनने के टूल के अलावा बाकी सभी चीज़ें शामिल हैं. रंगों के लिए, defaultValue इस फ़ॉर्मैट का ऑब्जेक्ट होना चाहिए:

{
    color: `string`
}

DataElement

डेटा एलिमेंट की वैल्यू, इनमें से कोई एक हो सकती है:

Enum वैल्यू ब्यौरा
मेट्रिक मेट्रिक फ़ील्ड के एलिमेंट को रेंडर करता है.
डाइमेंशन डाइमेंशन फ़ील्ड एलिमेंट को रेंडर करता है.
MAX_RESULTS इससे पता चलता है कि इस विज़ुअलाइज़ेशन से, डेटा की ज़्यादा से ज़्यादा किन लाइनों का अनुरोध किया जा सकता है

डेटा एलिमेंट के विकल्प

डेटा एलिमेंट की वैल्यू, इनमें से कोई एक हो सकती है:

Enum वैल्यू विकल्प का टाइप विकल्प उपलब्ध हैं
मेट्रिक ऑब्जेक्ट ज़्यादा से ज़्यादा: संख्या - मेट्रिक की ज़्यादा से ज़्यादा संख्या
कम से कम: संख्या - कम से कम ज़रूरी मेट्रिक की संख्या
डाइमेंशन ऑब्जेक्ट ज़्यादा से ज़्यादा: संख्या - साथ ही, इससे ज़्यादा डाइमेंशन का इस्तेमाल किया जा सकता है.
कम से कम: संख्या - डाइमेंशन की कम से कम संख्या,
इस्तेमाल करने के टाइप: इस्तेमाल किए जा सकने वाले टाइप की सूची. supportedTypes में TIME, GEO या DEFAULT शामिल हो सकते हैं
MAX_RESULTS ऑब्जेक्ट ज़्यादा से ज़्यादा: संख्या - विज़ुअलाइज़ेशन में अनुरोध की जा सकने वाली लाइनों की ज़्यादा से ज़्यादा संख्या. डिफ़ॉल्ट: 2500

StyleElement

स्टाइल एलिमेंट की वैल्यू इनमें से कोई एक हो सकती है:

Enum वैल्यू ब्यौरा defaultValue डेटा टाइप (कॉन्फ़िगरेशन) value डेटा टाइप (मैसेज) डिफ़ॉल्ट मान
FONT_COLOR फ़ॉन्ट के रंग के सिलेक्टर को रेंडर करता है. मान्य वैल्यू, कलर कोड के हेक्स कोड होते हैं. STRING | OBJECT<Color> STRING | OBJECT<Color> थीम के हिसाब से तय किया जाता है.
FONT_SIZE फ़ॉन्ट साइज़ सिलेक्टर को रेंडर करता है. मान्य वैल्यू नीचे दिए गए पिक्सल हैं: 8, 9, 10, 11, 12, 14, 16, 18, 20, 24, 28, 30, 32, 36, 40, 44, 48, 60, 72, 84, 96. NUMBER NUMBER 12
FONT_FAMILY फ़ॉन्ट फ़ैमिली सिलेक्टर को रेंडर करता है. मान्य वैल्यू ये फ़ॉन्ट हैं: WebGL, Boogaloo, Bubblegum Sans, Chewy, Comic Sans MS, आने वाले समय में, Cormorant Unicase, Courier New, Droid, Droid Sans, ईटर, जॉर्जिया, Google Sans, ग्रेट Vibes, इंडी फूल, Lato, Lora, मॉन्टसेर्राट, ओस्के, ओस्के, ओस्मान, ले, ओस्के, ओस्के, ओस्के, ओस्मान, ओल्गा, ओल्गामान, ओपेन्डुआ STRING STRING थीम के हिसाब से तय किया जाता है.
चेकबॉक्स चेकबॉक्स को रेंडर करता है. BOOLEAN BOOLEAN false
टेक्स्ट इनपुट टेक्स्ट इनपुट बॉक्स रेंडर करता है. STRING STRING ""
टेक्स्टक्षेत्र बड़े टेक्स्ट इनपुट एरिया को रेंडर करता है. STRING STRING ""
SELECT_SINGLE पहले से तय वैल्यू के साथ ड्रॉपडाउन रेंडर करता है. STRING (डिफ़ॉल्ट वैल्यू और ऑप्शन.लेबल और ऑप्शन.वैल्यू के लिए) STRING तय नहीं है
SELECT_RADIO पहले से तय वैल्यू के साथ रेडियो सिलेक्टर को रेंडर करता है. STRING (डिफ़ॉल्ट वैल्यू और ऑप्शन.लेबल और ऑप्शन.वैल्यू के लिए) STRING तय नहीं है
FILL_COLOR फ़िल कलर सिलेक्टर को रेंडर करता है. सही वैल्यू, हेक्स कलर कोड होती हैं. STRING | OBJECT<Color> OBJECT<Color> थीम के हिसाब से तय किया जाता है.
BORDER_COLOR बॉर्डर के रंग चुनने के विकल्प को रेंडर करता है. सही वैल्यू, हेक्स कलर कोड होती हैं. STRING | OBJECT<Color> OBJECT<Color> थीम के हिसाब से तय किया जाता है.
AXIS_COLOR ऐक्सिस के रंग चुनने के लिए बने सिलेक्टर को रेंडर करता है. सही वैल्यू, हेक्स कलर कोड होती हैं. STRING | OBJECT<Color> OBJECT<Color> थीम के हिसाब से तय किया जाता है.
GRID_COLOR ग्रिड के रंग चुनने के विकल्प को रेंडर करता है. सही वैल्यू, हेक्स कलर कोड होती हैं. STRING | OBJECT<Color> OBJECT<Color> थीम के हिसाब से तय किया जाता है.
ओपैसिटी अपारदर्शिता सिलेक्टर को रेंडर करता है, इकाई % है. मान्य वैल्यू 0.1 की बढ़ोतरी में 0 से 1 तक होती हैं NUMBER NUMBER 1
LINE_WEIGHT लाइन की मोटाई चुनने वाले टूल को रेंडर करता है. मान्य वैल्यू 0 से 5 तक हैं. ड्रॉपडाउन में 0 का इस्तेमाल 'कोई नहीं' के तौर पर किया जाएगा. NUMBER NUMBER
LINE_STYLE लाइन स्टाइल पिकर रेंडर करता है. स्वीकार किए जाने वाले डिफ़ॉल्ट वैल्यू: solid, dashed, dotted, double. STRING STRING "solid"
BORDER_RADIUS बॉर्डर के दायरे के सिलेक्टर को रेंडर करता है. मान्य वैल्यू हैं: 0, 1, 2, 3, 4, 5, 10, 15, 20, 25, 30, 40, 50, 60, 70, 80, 90, 100 NUMBER NUMBER थीम के हिसाब से तय किया जाता है.
अंतराल इंटरवल सिलेक्टर को रेंडर करता है. मान पूर्णांक होते हैं. NUMBER NUMBER 0

स्टाइल एलिमेंट, प्रॉपर्टी पैनल के Style टैब में दिखाए गए आइकॉन कॉन्फ़िगर करते हैं.

स्टाइल एलिमेंट के विकल्प

कुछ स्टाइल एलिमेंट, विकल्पों के साथ काम करते हैं

options: array(options)
Enum वैल्यू विकल्प ऑब्जेक्ट
SELECT_SINGLE
        {
            label: `string`,
            value: `string`
        }
        
SELECT_RADIO
        {
            label: `string`,
            value: `string`
        }
        
अंतराल
        {
            max: `number`,
            min: `number`
        }
        

डेटा प्रकार

ऑब्जेक्ट<रंग>

{
  color: STRING<Color>,
  opacity: NUMBER<Opacity>
}

स्ट्रिंग<रंग>

इस स्ट्रिंग की वैल्यू में रंग का हेक्स कोड होता है.

उदाहरण

"color": "#0000ff"

NUMBER<Opacity>

0.10 की बढ़ोतरी के साथ 0 से 1 तक की कोई संख्या वैल्यू

उदाहरण

"opacity": 0.2

InteractionType

इंटरैक्शन टाइप, प्रॉपर्टी पैनल की Data स्टाइल में मौजूद इंटरैक्शन विकल्पों को कॉन्फ़िगर करते हैं. फ़िलहाल, सिर्फ़ "FILTER" को इस्तेमाल किया जा सकता है.

Enum वैल्यू ब्यौरा
"FILTER" उपयोगकर्ताओं को विज़ुअलाइज़ेशन का इस्तेमाल फ़िल्टर के तौर पर करने की अनुमति देता है.

कॉन्फ़िगरेशन का उदाहरण

{
  "data": [{
    "id": "concepts",
    "label": "concepts",
    "elements": [
      {
        "id": "dimension1",
        "label": "first dimension",
        "type": "DIMENSION",
        "options": {
          "min": 1,
          "max": 3,
          "supportedTypes": ["DEFAULT"]
        }
      },
      {
        "id": "metric",
        "label": "metric",
        "type": "METRIC",
        "options": {
          "min": 1,
          "max": 3
        }
      }
    ]
  }],
  "style": [
    {
      "id": "colors",
      "label": "Highlight Colors",
      "elements": [
        {
          "id": "accentColor",
          "label": "Accent Color",
          "type": "SELECT_SINGLE",
          "defaultValue": "rain",
          "options": [
            {
              "label": "Summer",
              "value": "summer"
            },
            {
              "label": "Fall",
              "value": "fall"
            }
          ]
        },
        {
          "id": "reverseColor",
          "label": "Show reverse color",
          "defaultValue": false,
          "type": "CHECKBOX"
        },
        {
          "id": "fillColor",
          "label": "Fill Color",
          "defaultValue": {
            "color": "#0000ff"
          },
          "type": "FILL_COLOR"
        },
        {
          "id": "textOpacity",
          "label": "Text Opacity",
          "defaultValue": 0.2,
          "type": "OPACITY"
        },
        {
          "id": "customText",
          "label": "Custom Text",
          "defaultValue": "0.2",
          "type": "TEXTINPUT"
        }
      ]
    },
    {
      "id": "text",
      "label": "Highlight Text",
      "elements": [
        {
          "id": "textFontSize",
          "label": "Font size",
          "defaultValue": 10,
          "type": "FONT_SIZE"
        },
        {
          "id": "font",
          "label": "Font family",
          "defaultValue": "Arial",
          "type": "FONT_FAMILY"
        }
      ]
    }
  ],
  "interactions": [
    {
      "id": "interactionsConfigId",
      "supportedActions": ["FILTER"]
    }
  ],
  "features": {
    "enableComparisonDateRange": false
  }
}