伍拾壹- Tableau Extension 获取的工作表数据如何转换为行列表的绝望之旅 (五) - How Tableau Summary Data turn to data table?

0. 获取食材的方法

在前期的文章中有介绍如何在 Tableau 中调试( debug )，还有获取数据的基础结构介绍，本期的内容多数为在前期的基础上进行介绍：
肆拾捌- 当我们在用 Tableau Dashboard Extension 时，我们到底看到什么？ 绝望之旅 (三)

1. 从食材到料理

首先我们从 Tableau Extension 获取工作薄的 API 中得到的是：

而我们想在内存中以数组形式存放：

我们该怎样做呢？

2.稍微描述

对 Tableau Extension 获取信息的 API 介绍可以参考：
肆拾捌- 当我们在用 Tableau Dashboard Extension 时，我们到底看到什么？ 绝望之旅 (三)
然后我们会得到一个类似键值表（但它本质上其实又是一个数组），我们怎么去定义转化呢？

3.一个函数走天下

先放代码：

// 定义一个全局变量装当前设置
var objData = {};
// 所有数据的存放位置
objData.source = [];
// 定义我们需要读取 工作薄 的名字
objData.wsName = "Paradise";
// 定义在 Tableau 上行标题所属维度的变量名
objData.dimension = "Parlor";
// 尽在 Tableau 上读取数据时有用
objData.dictForRow = {};
// 定义在 Tableau 上列标题所属维度的变量名
objData.colName = "Content";
// 预先输入列标题内容
objData.arrCol = ["店铺","欧式","泰式","中式-1小时","中式-2小时","中式-过夜"];
// 预设列标题个数
objData.colCount = objData.arrCol.length;
// 定义值所在的字段名
objData.valueName = "总和(Income)";

// 链接时，需先对 Extensions 进行初始化
tableau.extensions.initializeAsync().then(function() {

	// 读取 工作薄 的内容
	tableau.extensions.dashboardContent.dashboard.worksheets.find(function(w) { if (w.name === objData.wsName) { return true; }; }).getSummaryDataAsync().then(function(sumdata) {
		// sumdata 为从 API 得到的数据，习惯会重新改变量名，其实可以不用
        var worksheetData = sumdata;
        // 值所在的 Tableau 原始 Data 中的各维度标识位置
        var intDim = 0;
        var intCol = 0;
        var intVal = 0;
        // 循环读取每个列字段名
        for (var intI = 0; intI < worksheetData.columns.length; intI++) {
            // 因不同语言的 Tableau 字段会不同，所以需要使用函数把不同语言的预留字段统一，并进行小写处理
            var strNowColName = funFixReservedWords(worksheetData.columns[intI].fieldName.toLowerCase());
            var strDimName = funFixReservedWords(objData.dimension.toLowerCase());
            var strShowColName = funFixReservedWords(objData.colName.toLowerCase());
            var strValueName = funFixReservedWords(objData.valueName.toLowerCase());
            
            // 此处进行行标题位置查询
            if (strNowColName == strDimName) {
                intDim = intI;
            };

            // 此处进行列标题维度汇总
            if (strNowColName == strShowColName) {
                intCol = intI;
            };

            // 此处进行值的位置查询
            if (strNowColName == strValueName) {
                intVal = intI;
            };
        };

        // 对每个值进行查询处理
        for (var intI = 0; intI < worksheetData.data.length; intI++) {
            // 读取每一颗数据
            var eleRow = worksheetData.data[intI];
            // 读取行标题，行标题必须使用 FromattedValue ，不然用户自定义的 “别名” 无法生效
            var strStoreCode = eleRow[intDim].formattedValue;

            // 列标题位置查找
            var strCol = eleRow[intCol].formattedValue;

            // 读取当前数据行的数据
            var dblVal = eleRow[intVal].value;

            // 如果前期未存在该行标题
            if (typeof(objData.dictForRow[strStoreCode]) == "undefined") {
                var intNowStore = objData.source.length;
                // 创建空白行数据
                var arrNewStoreInfo = new Array(objData.colCount);
                // 行标题先存入
                arrNewStoreInfo[0] = strStoreCode;
                // 把行标题跟存放在数组中的数据存入字典
                objData.dictForRow[strStoreCode] = intNowStore;
                // 存入数据
                objData.source.push(arrNewStoreInfo);
            };
            // Tableau 中 空数据 为 null 字符，改为 undefined
            if (dblVal == "%null%") {
                dblVal = undefined;
            };
            // 存入数据值
            objData.source[objData.dictForRow[strStoreCode]][objData.arrCol.indexOf(strCol)] = dblVal;
        };
        console.log(objData.source);

	});
});

// 因为不同语言的 Tableau 会自动对 度量名称/度量值 重新命名，而客户不能更改
// 故在此对 Tableau 保留字段进行统一化
function funFixReservedWords(strTitle) {
    var strReturn = strTitle;
    var arrMN = ["measure names", "度量名称", "度量名稱"];
    var arrMV = ["measure values", "度量值", "度量值"];
    if (arrMN.indexOf(strTitle) >= 0) {
        strReturn = "measure names";
    };
    if (arrMV.indexOf(strTitle) >= 0) {
        strReturn = "measure values";
    };
    return strReturn;
};

4.运行结果

5.关于 SummaryData

在 Tableau 中，能获取的数据分为两种：

• Summary Data
• Full Data

或者简单的来说，Summary Data 就是你能在 Tableau 上让你看到的数据，而 Full Data 是构成你在 Tableau 上能让你看到的数据，官方介绍如下：
Get Data from the Dashboard

那么，为什么我们要千辛万苦的来只获取 Summary Data，而不直接获取 底层数据 (Underlying Data ) 来直接在 Extensions 上来计算呢？
原因在于：
Accessing Underlying Data

我们在获取任何 底层数据 ( Underlying Data )的时候，都是需要允许扩展一个叫做 " full-data " 的权限的。而为了安全性而言，我们一般是不允许开启这个权限的，所以就造成为什么我们千辛万苦的来把 Summary Data 来改造成表格样式的原因。

6.我们未来会做什么呢？

首先我们会试着把上述那一个函数把 Summary Data 转化为 表格 形式的 JS 代码，写成一个包，让以后开发 Extensions 的时间缩短，然后。
就没有然后了。