Workiva 支持中心

为了便于将它们用作链中的命令输入，可以对变量或命令输出进行转换。您可以对一个命令输入应用多种变换，例如进一步变换其数据或变换的输出。

变革

注意： 将 JSON 输出作为其他命令的属性时，可以从输出中选择特定元素，而不是完整的 JSON 字符串。如果您选择的是元素而不是完整字符串，则应用从 JSON 获取值转换来转换其数据类型。

将文本解析为 JSON 格式

要将文本变量或输出转换为 JSON，请应用 Parse Text as JSON 转换：

1. 在链中，选择要转换输入的命令节点，然后单击 编辑  创  建。
2. 在 命令属性下，单击要转换的变量或输出。
3. 选择将文本解析为 JSON，然后单击 添加  添  加。

   注： 要从 JSON 中获取元素，请选择从 JSON 获取值，然后单击 添加  添  加 以应用附加转换。

4. 单击 接受。

更新字符串的大小写

要将文本字符串变量或输出转换为全大写或小写，请应用 Uppercase 或 Lowercase 转换：

To title-case a text string variable or output or convert its characters to all uppercase or lower-case:-->

1. 在链中，选择要转换输入的命令，并在 命令属性下单击要转换的变量或输出。
<!--
2. Select whether to convert the string to Uppercase or Lowercase, and click Add&nbsp;&nbsp;add.
-->
3. 选择要应用的变换：
   • 要将字符串中每个单词的第一个字母大写，请选择标题大写。
   • 要将字符串的字符全部转换为大写，请选择大写或大写。
   • 要将字符串的字符全部转换为小写，请选择小写。

   注： 要转换字符串，请选择要应用的附加转换，然后单击 添加  添  加。

4. 单击 接受。

添加或删除字符串尾部或前部的空格

要在文本字符串变量或输出的开头或结尾添加或删除空格，请应用 Pad 或 Trim 变换：

1. 在链中，选择要转换输入的命令，并在 命令属性下单击要转换的变量或输出。
2. 选择要应用的转换，然后单击 添加  添  加：
   • 要在字符串开头添加前导空格，请选择左填充，然后输入字符串的总长度。
   • 要在字符串末尾添加尾部空格，请选择向右填充，然后输入字符串的总长度。
   • 要删除字符串开头的前导空格，请选择 "修剪前缀"。
   • 要删除字符串末尾的空格，请选择 "修剪后缀"。
   • 要删除字符串开头和结尾的空格，请选择 "修剪"。

   注： 要转换字符串输出，请选择要应用的附加转换，然后单击 添加  添  加。

3. 选择 接受。

分割字符串

要根据分隔符值分割文本字符串变量或输出，请应用分割转换：

1. 在链中，选择要转换输入的命令，并在 命令属性下单击要转换的变量或输出。
2. 选择 "拆分"，然后单击 添加  添加。
3. Delimiter，输入分隔字符串的文本值。

   注： 要转换字符串输出，请选择要应用的附加转换，然后单击 添加  添  加。

4. 选择 接受。

替换字符串中的某个值

要将文本变量或输出中的某个值替换为另一个值，请应用 Replace 转换：

1. 在链中，选择要转换输入的命令，并在 命令属性下单击要转换的变量或输出。
2. 选择替换，然后单击 添加  添加。
3. 在 Find中，输入字符串中要替换的值的标准，作为要匹配的精确文本或正则表达式。
4. 在 Replacement中，输入要替换符合 Find 条件的文本的值。
5. 在 匹配类型中，选择是否通过完全匹配或正则表达式 (RegEx) 搜索 查找 标准。

   注： 要转换字符串输出，请选择要应用的附加转换，然后单击 添加  添  加。

6. 单击 接受。

数字加、减、乘、除或四舍五入

要对数字值进行数学运算，可应用 加, 减, 乘, 除, 或 四舍五入 变换。

提示： 要对数字字符串值执行数学运算，首先要应用 解析数字 变换。

• 对于 Add 或 Subtract 转换，请输入数字的增减幅度。
• 对于 Multiply 或 Divide 转换，请输入要乘以或除以多少数字。
• 对于 Round 转换，请输入数字四舍五入到小数点后多少位。

以字符串形式解析日期或时间戳

要将日期或时间戳变量或输出转换为特定格式和时区，请应用 Parse Date/Time 转换：

1. 在链中，选择要转换输入的命令，并在 命令属性下单击要转换的变量或输出。
2. 选择 "解析日期/时间"，然后单击 添加  添加。
3. 选择是使用国际标准化组织 (ISO) 的标准格式，还是使用日期或时间戳的自定义格式。
4. 输入如何使用 strftime 格式 和分隔符（如 ., ,, :, 或 /）来格式化日期或时间值。例如， %m-%d-%Y 表示 01-30-2020，或 %H:%M 表示 21:08。
5. 要更改日期或时间戳的时区，请为输入值和输出值选择时区。

   注： 要转换字符串输出，请选择要应用的附加转换，然后单击 添加  添  加。

6. 单击 接受。

添加或减去日期或时间戳

要在日期或时间戳变量或输出中添加或减去区间值，请应用 Add/Subtract Date and Time 转换：

1. 在链中，选择要转换输入的命令，并在 命令属性下单击要转换的变量或输出。
2. 选择 "添加/减去日期和时间"，然后单击 添加  添加。
3. 选择使用国际标准化组织 (ISO) 的标准格式还是 自定义格式。
4. 对于 Operation，选择添加还是减去时间戳。
5. 输入时间戳的增量，如 1 天。

   注： 要更改时间戳的格式，请选择 "解析日期/时间"，然后单击 添  加  添加 以应用附加转换。

6. 单击 接受。

对列表中的项目进行排序

要对列表变量或输出中的项目按升序或降序排序，请应用 Sort List 转换：

1. 在链中，选择要转换输入的命令，并在 命令属性下单击要转换的变量或输出。
2. 选择排序列表，然后单击 添加  添加。
3. 选择按升序还是降序对列表排序。

   注： 要从列表中选取字符串元素，请选择从列表中选取，然后单击 添  加  添加 以应用附加转换。

4. 单击 接受。

从列表中挑选元素

要从列表变量或输出中提取单个元素，请应用 Pick from List 转换：

1. 在链中，选择要转换输入的命令，并在 命令属性下单击要转换的变量或输出。
2. 选择 "从列表中挑选"，然后单击 添加  添加。
3. 对于 值，输入要选取元素的索引号； 0 代表第一个元素， -1 代表最后一个元素。

   注： 要变换字符串元素，请选择要应用的附加变换，然后单击 添加  添  加。

4. 单击 接受。

从 JSON 获取值

要将 JSON 变量或输出中的单个元素转换为字符串、列表或 JSON，请应用 Get Value from JSON 转换。在使用转换时，JSON 中列表中的元素使用基于零的索引，其中第一个值的索引为 0。

注： 要确定要通过转换解析的元素索引和名称，请单击 Monitor  flight_takeoff，并查看命令的 JSON 输出。

1. 在链中，选择要转换输入的命令，并在 命令属性下单击要转换的变量或输出。
2. 选择从 JSON 获取值，然后单击 添加  添  加。 
   
3. 选择是将元素输出为文本字符串 title，列表 list，还是 JSON code。
4. Value, 输入：
   • 如果 JSON 包含 多个 对象，请输入要提取的对象的索引，从 0 开始。例如，对于 的第二个 对象，请输入 1。

     注意： 仅当 JSON 包含多个对象时才输入索引。

   • 要选取的元素名称，如 id。

   注： 要转换转换的输出，如格式化日期字符串或对列表排序，请选择要应用的附加转换，然后单击 添加  添  加。

5. 单击 接受。