Workiva支持中心

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

转变

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

将文本解析为 JSON

要将文本变量或输出转换为 JSON，请应用 将文本解析为 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. 对于 分隔符，请输入要分割字符串的文本值。

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

4. 选择 接受。

替换字符串中的值

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

1. 在链中，选择要转换的输入的命令，然后在 命令属性下，单击要转换的变量或输出。
2. 选择“替换”，然后单击 “添加添加” 。
3. 在 查找中，输入要替换字符串中值的条件，可以是要匹配的确切文本，也可以是正则表达式。
4. 在 替换中，输入要替换与 查找 条件匹配的文本的值。
5. 在 匹配类型中，选择是通过精确匹配还是正则表达式 (RegEx) 来搜索 查找 条件。

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

6. 点击 接受。

对数字进行加、减、乘、除或四舍五入运算

要对数值执行数学运算，请应用 Add, Subtract, Multiply, Divide或 Round 变换。

提示：要对数值字符串执行数学运算，请先应用 “解析 数字” 转换

• 对于 加 或 减 转换，请输入要增加或减少的数字的数量。
• 对于 乘 或 除 转换，请输入要乘以或除以该数字的数值。
• 对于 四舍五入 转换，请输入要将数字四舍五入到的小数位数。

将日期或时间戳解析为字符串

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

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

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

6. 点击 接受。

添加或减去日期或时间戳

要将一个区间值添加到日期或时间戳变量或输出中，或从中减去该区间值，请应用 添加/减去日期和时间 转换：

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

   注： 要更改时间戳格式，请选择“解析日期/时间”并单击 添加添加 以应用其他转换。

6. 点击 接受。

对列表中的项目进行排序

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

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

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

4. 点击 接受。

从列表中选择元素

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

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

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

4. 点击 接受。

从 JSON 获取值

要将 JSON 变量或输出中的单个元素转换为字符串、列表或 JSON，请应用 从 JSON 获取值 转换。使用此转换时，JSON 列表中的元素使用从零开始的索引，其中第一个值的索引为 0。

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

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

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

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

   注： 要对转换的输出结果进行其他更改，例如格式化日期字符串或对列表进行排序，请选择要应用的其他转换，然后单击 添加添加。

5. 点击 接受。