Peek - 脚本函数

示例 1

将示例脚本添加到应用程序并运行。要查看结果，将结果列中列出的字段添加到应用程序中的工作表。

FirstCode = 101，因为 Peek('EmployeeCode',0, 'EmployeeDates') 返回表格 EmployeeDates 的 EmployeeCode 中的第一个值。

LastCode = 106，因为 Peek('EmployeeCode',-1, 'EmployeeDates') 返回表格 EmployeeDates 的 EmployeeCode 中的最后一个值。

替代参数 row_no 返回表格中其他行的值，如下所示：

Peek('EmployeeCode',2, 'EmployeeDates') 用于返回表格中的第三个值 103（作为 FirstCode）。

但是，请注意，如果在这些示例中没有将表格指定为第三个参数 table_name，此函数引用当前表格（在此例中，为内部表格）。

示例 2

如果要访问表中更深层的数据，需要分两步进行：首先，将整个表加载到临时表中，然后在使用 Peek() 时对其重新排序。

将示例脚本添加到应用程序并运行。要查看结果，将结果列中列出的字段添加到应用程序中的工作表。

Create a table in a sheet in your app with ID, List, and Value as the dimensions.

IF() 语句是根据临时表格 T1 构建。
Peek('ID') 引用当前表格 T2 的上一行中的字段 ID。
Peek('List') 引用当前表格 T2 的上一行中的字段 List，目前正在构建要解算的表达式。

如下运算语句：
如果 ID 的当前值与 ID 的上一个值相同，则写入 Peek('List') 的值串联 Value 的当前值。否则，只写入 Value 的当前值。

如果 Peek('List') 已经包含串联结果，则会将 Peek('List') 的新结果串联至其当前值。

示例 3

将示例脚本添加到应用程序并运行。要查看结果，将结果列中列出的字段添加到应用程序中的工作表。

字段 AmountMonthBefore 将保存上个月的金额。

这里省略了 row_no 和 table_name 参数，因此使用默认值。在本例中，以下三个函数调用是等效的：

• Peek(Amount)
• Peek(Amount,-1)
• Peek(Amount,-1,'Amounts')

将 -1 用作 row_no 并不意味着将使用前一行中的值。通过替换该值，可以获取表中其他行的值：

Peek(Amount,2) 用于返回表格中的第三个值：7。

示例 4：

数据需要正确排序才能得到正确的结果，但遗憾的是，情况并非总是如此。此外，Peek() 函数不能用于引用尚未加载的数据。通过使用临时表并对数据进行多次传递，可以避免此类问题。

将示例脚本添加到应用程序并运行。要查看结果，将结果列中列出的字段添加到应用程序中的工作表。

tmp1Amounts:
Load * Inline
[Month,Product,Amount
2022-01,B,3
2022-01,A,8
2022-02,B,4
2022-02,A,6
2022-03,B,1
2022-03,A,6
2022-04,A,5
2022-04,B,5
2022-05,B,6
2022-05,A,7
2022-06,A,4
2022-06,B,8];

tmp2Amounts:
Load *,
If(Product=Peek(Product),Peek(Amount)) as AmountMonthBefore
Resident tmp1Amounts
Order By Product, Month Asc; 
Drop Table tmp1Amounts;

Amounts:
Load *,
If(Product=Peek(Product),Peek(Amount)) as AmountMonthAfter
Resident tmp2Amounts
Order By Product, Month Desc; 
Drop Table tmp2Amounts;

解释

初始表是按月份排序的，这意味着 peek() 函数在很多情况下会返回错误产品的金额。因此，该表需要重新排序。这是通过运行第二次数据传递并创建一个新表来完成的。注意，Order by 子句。它先按产品将记录排序，然后按月份升序排序。

需要 If() 函数，因为如果前一行包含同一产品但属于上一个月的数据，则只应计算 AmountMonthBefore。通过将当前行的产品与前一行的产品进行比较，可以验证此条件。

创建第二个表时，使用 Drop 创建第二个表时，使用Drop Table 语句删除第一个表。

最后，对数据进行第三次遍历，但现在月份的排序是相反的。这样，也可以计算 AmountMonthAfter。

结果

示例 5

将示例脚本添加到应用程序并运行。要查看结果，将结果列中列出的字段添加到应用程序中的工作表。

结果

解释

Load 语句 Load *, rangesum(SumVal,peek('AccSumVal')) as AccSumVal 包括一个递归调用，其中以前的值被添加到当前值。此操作用于计算脚本中值的累积。