جاوا اسکرپٹ API کا استعمال کرتے ہوئے ٹیبلو پیرامیٹرز کے لیے ایک انٹرایکٹو ڈراپ ڈاؤن بنانا

ٹیبلو پیرامیٹرز کو کنٹرول کرنے کے لیے ایک انٹرایکٹو ڈراپ ڈاؤن بنانا

جدول ایمبیڈنگ API کے ساتھ جاوا اسکرپٹ کا استعمال پیرامیٹرز کو متحرک طور پر لوڈ اور اپ ڈیٹ کرنے کے لیے

// Solution 1: Basic Implementation Using Async/Await and Tableau API
async function loadMoedaParameter() {
  try {
    const parameters = await viz.workbook.getParametersAsync();
    const moedaParam = parameters.find((p) => p.name === "Moeda");
    if (!moedaParam) {
      console.error("Parameter 'Moeda' not found!");
      return;
    }
    const dropdown = document.createElement("select");
    moedaParam.allowableValues.forEach((value) => {
      const option = document.createElement("option");
      option.text = value.formattedValue;
      option.value = value.value;
      dropdown.appendChild(option);
    });
    dropdown.value = moedaParam.currentValue.value;
    dropdown.addEventListener("change", async (e) => {
      const selectedMoeda = e.target.value;
      try {
        await viz.workbook.changeParameterValueAsync("Moeda", selectedMoeda);
        console.log("Moeda changed to:", selectedMoeda);
      } catch (error) {
        console.error("Error changing the Moeda parameter:", error);
      }
    });
    document.getElementById("Moeda-container-desktop").appendChild(dropdown);
  } catch (error) {
    console.error("Error loading the Moeda parameter:", error);
  }
}
viz.addEventListener(TableauEventType.FirstInteractive, loadMoedaParameter);

ٹیبلو پیرامیٹر اپڈیٹس کے لیے ماڈیولر ڈراپ ڈاؤن منطق کو نافذ کرنا

ماڈیولر فنکشنز اور بہتر ایرر ہینڈلنگ کا استعمال کرتے ہوئے آپٹمائزڈ اپروچ

// Solution 2: Modular and Reusable Code with Error Handling
function createDropdown(options, onChangeCallback) {
  const dropdown = document.createElement("select");
  dropdown.style.cssText = "border:none; width:100%; height:40px; background:#FFF;";
  options.forEach(({ text, value }) => {
    const option = document.createElement("option");
    option.text = text;
    option.value = value;
    dropdown.appendChild(option);
  });
  dropdown.addEventListener("change", (e) => onChangeCallback(e.target.value));
  return dropdown;
}

async function updateParameter(parameterName, value) {
  try {
    await viz.workbook.changeParameterValueAsync(parameterName, value);
    console.log(\`${parameterName} changed to: \${value}\`);
  } catch (error) {
    console.error("Error updating parameter:", error);
  }
}

async function loadParameterDropdown(containerId, parameterName) {
  try {
    const parameters = await viz.workbook.getParametersAsync();
    const param = parameters.find((p) => p.name === parameterName);
    if (!param) throw new Error(\`Parameter '\${parameterName}' not found!\`);
    const options = param.allowableValues.map((val) => ({
      text: val.formattedValue,
      value: val.value,
    }));
    const dropdown = createDropdown(options, (value) => {
      updateParameter(parameterName, value);
    });
    document.getElementById(containerId).appendChild(dropdown);
  } catch (error) {
    console.error("Error loading parameter dropdown:", error);
  }
}

viz.addEventListener(TableauEventType.FirstInteractive, () => {
  loadParameterDropdown("Moeda-container-desktop", "Moeda");
});

مختلف ماحول میں ٹیبلو پیرامیٹر کے تعامل کی جانچ کرنا

پیرامیٹر اپڈیٹس کی توثیق کرنے کے لیے جاوا اسکرپٹ کے ساتھ یونٹ ٹیسٹ لکھنا

// Solution 3: Unit Test to Validate Parameter Changes
function mockVizWorkbook() {
  return {
    parameters: [{
      name: "Moeda",
      allowableValues: [{ value: "USD", formattedValue: "USD" }],
      currentValue: { value: "USD" },
    }],
    changeParameterValueAsync: jest.fn().mockResolvedValue(),
  };
}

test("Dropdown updates Moeda parameter correctly", async () => {
  const vizMock = { workbook: mockVizWorkbook() };
  const updateSpy = vizMock.workbook.changeParameterValueAsync;
  document.body.innerHTML = '<div id="Moeda-container-desktop"></div>'; 

  await loadParameterDropdown("Moeda-container-desktop", "Moeda");
  const dropdown = document.querySelector("select");
  dropdown.value = "USD";
  dropdown.dispatchEvent(new Event("change"));

  expect(updateSpy).toHaveBeenCalledWith("Moeda", "USD");
});

Tableau API میں پیرامیٹرز کے استعمال کے بارے میں اکثر پوچھے گئے سوالات

1. ٹیبلو میں پیرامیٹر اور فلٹر میں کیا فرق ہے؟
2. پیرامیٹرز صارفین کو مخصوص اقدار کو ڈیش بورڈ میں منتقل کرنے کی اجازت دیتے ہیں، جبکہ فلٹرز معیار کی بنیاد پر دکھائے گئے ڈیٹا کو محدود کرتے ہیں۔ فلٹرز ڈیٹا سیٹس پر کام کرتے ہیں، جبکہ پیرامیٹرز مخصوص فیلڈز یا حسابات کو متاثر کرتے ہیں۔
3. پیرامیٹرز کی بازیافت کرتے وقت میرا ڈراپ ڈاؤن خالی کیوں رہتا ہے؟
4. یقینی بنائیں کہ getParametersAsync() فنکشن کامیابی سے پیرامیٹر کو بازیافت کرتا ہے۔ اگر ایسا نہیں ہوتا ہے تو، ورک بک کی پابندیوں کی وجہ سے پیرامیٹر پوشیدہ یا قابل رسائی نہیں ہو سکتا ہے۔
5. میں کیسے یقینی بناؤں کہ ڈراپ ڈاؤن پیرامیٹر کی موجودہ حالت سے میل کھاتا ہے؟
6. استعمال کریں۔ currentValue.value ڈراپ ڈاؤن میں ڈیفالٹ آپشن سیٹ کرنے کے لیے پراپرٹی۔ یہ UI اور ڈیش بورڈ کو سیدھ میں رکھتا ہے۔
7. ٹیبلو میں پیرامیٹرز کو اپ ڈیٹ کرتے وقت میں غلطیوں کو کیسے سنبھال سکتا ہوں؟
8. لپیٹیں۔ changeParameterValueAsync() اندر کال کرنا try-catch پیرامیٹر کو اپ ڈیٹ کرنے پر ہونے والی کسی بھی خرابی کو سنبھالنے کے لیے بلاک کریں۔
9. کون سا واقعہ یقینی بناتا ہے کہ ڈیش بورڈ حسب ضرورت سے پہلے تیار ہے؟
10. دی FirstInteractive Tableau API میں واقعہ اس بات کا اشارہ کرتا ہے کہ ڈیش بورڈ مکمل طور پر لوڈ ہو چکا ہے اور ڈراپ ڈاؤن کو شامل کرنے جیسے مزید تعاملات کے لیے تیار ہے۔

انٹرایکٹو پیرامیٹر ہینڈلنگ پر حتمی خیالات

پیرامیٹرائزڈ ڈراپ ڈاؤن کے ساتھ انٹرایکٹو ڈیش بورڈز کو سرایت کرنا صارفین کو زیادہ لچک فراہم کرتا ہے۔ ایک مناسب سیٹ اپ کے ساتھ، ڈویلپرز جیسے پیرامیٹرز حاصل کر سکتے ہیں۔ موئدہ اور ڈیش بورڈ کنٹرول کو بڑھانے کے لیے Tableau API کا استعمال کریں۔ یہ سیٹ اپ صارفین کو ڈیٹا کو زیادہ مؤثر طریقے سے دریافت کرنے کی اجازت دیتا ہے۔

کلیدی عناصر، جیسے پہلا انٹرایکٹو ایونٹ اور مضبوط ایرر ہینڈلنگ، یقینی بنائیں کہ ڈراپ ڈاؤن مینو ایپلی کیشن کے اندر آسانی سے کام کرتے ہیں۔ اس نقطہ نظر کی پیروی کرتے ہوئے، ڈویلپر پیرامیٹرز کو مؤثر طریقے سے منظم کر سکتے ہیں اور اختتامی صارفین کو ایک متحرک اور ذمہ دار ڈیش بورڈ تجربہ پیش کر سکتے ہیں۔