kintone plugin series

关于多重选择字段的处理

1. 从字段值到字符串的转换

   对于像复选框或用户选择字段这样允许多重选择的字段，它们的值会自动转换为逗号分隔的字符串进行处理。在函数中使用这些字段作为参数时，请参考此信息。

   复选框 多重选择	将已选的值转换为逗号分隔的字符串。 示例 "sample1,sample2"
   用户选择	将用户名转换为逗号分隔的字符串。 示例 "Noboru Sato,Misaki Kato"
   组织选择	将组织名转换为逗号分隔的字符串。 示例 "Development Department,Human Resources Department"
   组选择	将组名转换为逗号分隔的字符串。 示例 "Managers,Leaders"
   作业者	将作业者名转换为逗号分隔的字符串。 示例 "Noboru Sato,Misaki Kato"
   创建者	转换为创建者名称。 示例 "Creator"
   更新者	转换为更新者名称。 示例 "Modifier"

2. 每种字段格式都需要特定格式的字符串

   对于像复选框或用户选择字段这样允许多选的字段，无论值是固定的还是计算结果，都需要从字符串转换为符合每个字段格式的数据形式。因此，需要按照每个字段所需的字符串格式进行格式化。

   复选框 多重选择	将值（无论是固定值还是计算结果）格式化为以逗号分隔的字符串。 示例 "sample1,sample2"
   用户选择	将值（无论是固定值还是计算结果）按照“登录名:显示名”顺序格式化为以逗号分隔的字符串。 示例 "sato:Noboru Sato,kato:Misaki Kato"
   组织选择	将值（无论是固定值还是计算结果）按照“组织代码:组织名”顺序格式化为以逗号分隔的字符串。 示例 "dev:Development Department,hr:Human Resources Department"
   组选择	将值（无论是固定值还是计算结果）按照“组代码:组名”顺序格式化为以逗号分隔的字符串。 示例 "mgr:Managers,ldr:Leaders"

指定字段作为函数参数

当指定字段作为函数参数以使用其值时，用百分号包围所需的字段代码。

示例

对于名为“日期1”的字段代码，它返回对应于进程执行时间的年龄。
AGE(%日期1%)

字符串连接

如果你想将字符串或函数返回值的连接结果传递给一个字段，请用“+”号连接它们。

示例

将“数字1”字段的值转换为字符串，并返回与另一个字符串合并的结果。
"ABC"+TO_STRING(%数字1%)

IF

使用IF函数，您可以根据设置的条件表达式更改输出值。

• 输入

  IF(条件, 真值, 假值)

• 参数

  条件

  使用比较运算符比较您要判断的字段的值、固定值或函数的结果值。
  真值

  当条件为真时指定输出内容（固定值/函数结果值/算术运算）。
  假值

  当条件为假时指定输出内容（固定值/函数结果值/算术运算）。

  请用百分比符号包围字段代码，用双引号包围固定值。

• 用法

  如果数字1字段大于100，则返回"1"，否则返回"0"。
  IF(%数字1%>100,1,0)

• 比较运算符

  =

  如果字符串或数值相等，则返回真，否则返回假。
  !=

  它是"="的反结果。
  <

  如果左边的值小于右边的值，则返回真，否则返回假。
  <=

  如果左边的值小于或等于右边的值，则返回真，否则返回假。
  >

  如果左边的值大于右边的值，则返回真，否则返回假。
  >=

  如果左边的值大于或等于右边的值，则返回真，否则返回假。

LIKE

在IF函数的条件表达式中，您使用此方法来判断指定的字符串是否包含搜索值。

• 输入

  LIKE(搜索目标字符串, 搜索字符串)

• 参数

  搜索目标字符串

  您可以指定字段代码、固定值或函数的结果值。
  搜索字符串

  您可以指定字段代码、固定值或函数的结果值。

  请用百分比符号包围字段代码，用双引号包围固定值。

• 用法

  如果“字符串1”字段中包含“ABC”，则返回“1”。否则，返回“0”。
  IF(LIKE(%字符串1%,"ABC"),1,0)

AND

在IF函数的条件表达式中，您使用AND来判断是否满足所有条件。

• 输入

  AND(条件1,条件2,...)

• 用法

  如果数字1大于100且字符串1为"ABC"，则返回"1"，否则返回"0"。
  IF(AND(%数字1%>100,%字符串1%="ABC"),1,0)

OR

在IF函数的条件表达式中，您使用OR来判断是否满足任何条件。

• 输入

  OR(条件1,条件2,...)

• 用法

  如果数字1大于100或字符串1为"ABC"，则返回"1"，否则返回"0"。
  IF(OR(%数字1%>100,%字符串1%="ABC"),1,0)

TO_NUMBER

使用TO_NUMBER函数，您可以将字段值或函数的结果值从字符串转换为数字。

• 输入

  TO_NUMBER(%字段代码%或函数的结果值)

• 参数

  字段代码或函数

  指定包含要转换的值的字段代码或函数的结果值。

  请用百分比符号包围字段代码，用双引号包围固定值。

  如果要转换的值中包含非数字的值，则返回0。

• 用法

  将字符串1字段的值转换为数字，并返回乘以2的结果。
  TO_NUMBER(%字符串1%)*2

TO_STRING

使用TO_STRING函数，您可以将字段值或函数的结果值从数字转换为字符串。

• 输入

  TO_STRING(%字段代码%或函数的结果值)

• 参数

  字段代码或函数

  指定包含要转换的值的字段代码或函数的结果值。

  请用百分比符号包围字段代码，用双引号包围固定值。

• 用法

  将数字1字段的值转换为字符串，并与其他字符串连接返回结果。
  "ABC"+TO_STRING(%数字1%)

TODAY

使用TODAY函数，您可以在执行时获得日期1。

• 输入

  TODAY()

NOW

使用NOW函数，您可以在执行时获得日期和时间。

• 输入

  NOW()

AGE

使用AGE函数，您可以获得与指定日期相对应的处理执行时的年龄。

• 输入

  AGE(%字段代码%或函数的结果值)

• 参数

  字段代码或函数

  指定输入了计算日期值的字段代码或函数的结果值。

  请用百分比符号包围字段代码，用双引号包围固定值。

• 用法

  返回与日期1字段值相对应的处理执行时的年龄。
  AGE(%日期1%)

DATE_CALC

使用DATE_CALC函数，您可以基于指定的内容执行日期计算。

• 输入

  DATE_CALC(%字段代码%或函数的结果值,"计算模式 (加/减值 单位)")。

• 参数

  字段代码或函数

  指定输入了计算日期值的字段代码或函数的结果值。
  计算模式 (加/减值)

  指定要从基值中添加或减去的数字。
  可以使用字段代码代替固定值。
  计算模式 (单位)

  指定加法或减法的单位。
  年year 月month 日day 时hour 分minute 年初first-of-year 月初first-of-month 周初first-of-week 对于年初、月初或周初，不需要输入加/减值。

  请用百分比标记括起字段代码，并用双引号括起计算模式。

  在计算模式的加/减值和单位之间插入半角空格。

  如果您想使用多个模式进行计算，请用逗号分隔每个模式。

• 用法

  根据日期1字段返回2个月前的日期。
  DATE_CALC(%日期1%,"-2 month")

  根据日期1字段返回该月的最后一天日期。
  DATE_CALC(%日期1%,"first-of-month,1 month,-1 day")

  根据日期1字段返回加上数字1字段值的日期。
  DATE_CALC(%日期1%,"%数字1% day")

  根据日期1字段返回从周初开始的10天后的日期。
  DATE_CALC(%日期1%,"first-of-week,10 day")

DATE_DIFF

使用DATE_DIFF函数，您可以获取指定周期的已过天数。

• 输入

  DATE_DIFF(%字段代码%的开始日期,%字段代码%的结束日期或"TODAY","显示格式")

• 参数

  开始日期字段

  指定输入期间的第一个日期的字段代码或函数的结果值。
  结束日期字段

  指定输入期间的最后一个日期的字段代码或函数的结果值。
  如果您想获取从当前日期开始的已过天数，请输入"TODAY"。
  显示格式

  指定显示格式。
  年Y 月M (此显示格式包含经过的年份后的剩余月份。)  FM (此显示格式包含经过的总月数。) 日D (此显示格式包含经过的月份后的剩余天数。)  FD (此显示格式包含经过的总天数。) 如果您想获取从当前日期开始的已过天数，请输入"TODAY"。

  示例

  以年和月的格式显示已过的天数
  Y年M个月

  以年、月和剩余天数的格式显示已过的天数
  Y年M个月和D天

  请用百分比符号包围字段代码，并用双引号包围显示格式。

• 用法

  使用日期1字段作为开始日期，日期2字段作为结束日期，返回转换为年和月显示格式的字符串。
  DATE_DIFF(%日期1%,%日期2%,"Y年M个月")

  使用日期1字段作为开始日期，今天作为结束日期，返回转换为年、月和剩余天数显示格式的字符串
  DATE_DIFF(%日期1%,"TODAY","Y年M个月和D天")

DATE_FORMAT

使用DATE_FORMAT函数，您可以按指定的格式将日期转换为字符串。

• 输入

  DATE_FORMAT(%字段代码%或函数的结果值,"显示格式")

• 参数

  字段代码或函数

  指定输入了计算日期值的字段代码或函数的结果值。
  显示格式

  指定显示格式。
  年Y 月m (零填充的两位数字) 日d (零填充的两位数字) 时H (零填充的两位数字) 分i (零填充的两位数字) 您可以组合年、月、日、时和分的各种方式。

  示例

  用破折号连接年和月。
  Y-m

  用冒号连接小时和分钟。
  H:i

  请用百分比符号包围字段代码，并用双引号包围显示格式。

• 用法

  返回日期1的值，格式为年、月、日。
  DATE_FORMAT(%日期1%,"Y-m-d")

  返回当前时间，格式为时和分。
  DATE_FORMAT(NOW(),"H:i")

LPAD

使用LPAD函数，您可以从左侧使用另一个字符串填充当前字符串，使结果字符串达到指定的长度。

• 输入

  LPAD(%字段代码%或函数的结果值,字符串的长度,用于填充的字符)

• 参数

  字段代码或函数

  指定包含要转换的值的字段代码或函数的结果值。
  字符串的长度

  指定您希望作为结果获得的字符数。
  用于填充的字符

  指定要填充到指定长度的字符。

  字段代码用百分号括起来，填充字符用双引号括起来。

• 用法

  数字1字段的值返回时，直到成为10位数都用0填充。
  LPAD(%数字1%,10,"0")

RPAD

使用RPAD函数，您可以从右侧使用另一个字符串填充当前字符串，使结果字符串达到指定的长度。

• 输入

  RPAD(%字段代码%或函数的结果值,字符串的长度,用于填充的字符)

• 参数

  字段代码或函数

  指定包含要转换的值的字段代码或函数的结果值。
  字符串的长度

  指定您希望作为结果获得的字符数。
  用于填充的字符

  指定要填充到指定长度的字符。

  字段代码用百分号括起来，填充字符用双引号括起来。

• 用法

  数字1字段的值返回时，直到成为10位数都用0填充。
  RPAD(%数字1%,10,"0")

LEFT

使用LEFT函数，您可以从字符串的左侧获取指定字符数的字符串。

• 输入

  LEFT(%字段代码%或函数的结果值,提取的字符数)

• 参数

  字段代码或函数

  指定包含要转换的值的字段代码或函数的结果值。
  要提取的字符数

  指定您要提取的字符数。

  请用百分比符号包围字段代码，用双引号包围固定值。

• 用法

  它返回从字符串1左侧提取的前5个字符的结果。
  LEFT(%字符串1%,5)

RIGHT

使用RIGHT函数，您可以从字符串的右侧获取指定字符数的字符串。

• 输入

  RIGHT(%字段代码%或函数的结果值,提取的字符数)

• 参数

  字段代码或函数

  指定包含要转换的值的字段代码或函数的结果值。
  要提取的字符数

  指定您要提取的字符数。

  请用百分比符号包围字段代码，用双引号包围固定值。

• 用法

  它返回从字符串1右侧提取的最后5个字符的结果。
  RIGHT(%字符串1%,5)

MID

使用MID函数，您可以从指定位置获取指定字符数的字符串。

• 输入

  MID(%字段代码%或函数的结果值,开始位置,提取的字符数)

• 参数

  字段代码或函数

  指定包含要转换的值的字段代码或函数的结果值。
  开始位置

  指定要从哪个字符位置开始提取。(起始索引为1)
  要提取的字符数

  指定您要提取的字符数。

  请用百分比符号包围字段代码，用双引号包围固定值。

• 用法

  它返回从字符串1的第三个字符开始提取的5个字符的结果。
  MID(%字符串1%,3,5)

REPLACE

使用REPLACE函数，您可以将一个字符串替换为另一个字符串。

• 输入

  REPLACE(%字段代码%或函数的结果值,"搜索字符串","替换字符串")

• 参数

  字段代码或函数

  指定字段代码或函数结果值中作为替换原始值的值。
  搜索字符串

  指定您要搜索的字符串。 (也可以指定正则表达式)
  替换字符串

  指定您要替换的字符串。

  请用百分比符号包围字段代码，用双引号包围固定值。

• 用法

  如果字符串1字段的值包含“Co., Ltd.”，则返回将其更改为“有限公司”的结果。
  REPLACE(%字符串1%,"Co., Ltd.","有限公司")

LEN

使用LEN函数，您可以获取字符串的字符数。

• 输入

  LEN(%字段代码%或函数的结果值)

• 参数

  字段代码或函数

  指定有输入值的字段代码或函数的结果值。

  请用百分比符号包围字段代码，用双引号包围固定值。

• 用法

  它返回字符串1字段值的字符数。
  LEN(%字符串1%)

LENB

使用LENB函数，您可以获取字符串的字节数。

• 输入

  LENB(%字段代码%或函数的结果值)

• 参数

  字段代码或函数

  指定有输入值的字段代码或函数的结果值。

  请用百分比符号包围字段代码，用双引号包围固定值。

• 用法

  它返回字符串1字段值的字节数。
  LENB(%字符串1%)

LINES

使用LINES函数，您可以从多行字符串中仅获取指定的文本行。

• 输入

  LINES(%字段代码%或函数的结果值,检索行号)

• 参数

  字段代码或函数

  指定有输入值的字段代码或函数的结果值。
  检索行号

  指定所需的行位置（行号）。

  请用百分比符号包围字段代码，用双引号包围固定值。

• 用法

  它返回字符串多行1字段值的第三行文本。
  LINES(%字符串多行1%,3)

LOOP

使用LOOP函数，您可以迭代指定表格的每一行，并生成值（固定字符串、函数、公式），从而获取作为新的多行字符串的结果。

• 输入

  LOOP(%字段代码%, /*公式*/, 用于限制目标行的布尔值)

• 参数

  字段代码

  指定要检索的表的字段代码。
  公式

  指定用于生成值的固定字符串、函数或公式。

  公式用"/*"和"*/"括起来。

  如果需要在公式中换行，请在换行位置插入"\\n"。

  用于限制目标行的布尔值

  如果基于某个条件，您只想检索表中与表字段中指定值匹配的行，请指定“true”。

  请用百分号符号包围字段代码。

• 用法

  									对于字段代码为“表格1”的表格，利用表内的字段（一个“字符串1”字段和一个“数字1”字段）为每行生成值，并返回多行文本。
  
  									LOOP(%表格1%,/*"Item: "+%字符串1%+"\\nQuantity: "+TO_STRING(%数字1%)+"\\n"*/)
  
  									结果值»
  
  									Item: Orange
  Quantity: 10
  
  Item: Apple
  Quantity: 15
  
  Item: Kiwi
  Quantity: 5
  								

  以下示例与Boost! Action有关。

  指定表内的单选按钮的值为特定值的条件，并对符合此条件的行返回新的多行文本。
  LOOP(%表格1%,/*"String: "+%字符串1%+"\\nNumber: "+TO_STRING(%数字1%)+"\\n"*/,true)

MATH

使用MATH函数，您可以从指定的计算公式中获得结果。

• 输入

  MATH(计算公式)

• 参数

  计算公式

  如果您想在计算公式中嵌入字段的值，请使用由百分号包围的%字段代码%来指定。

• 可用的操作符

  +

  加法
  -

  减法
  *

  乘法
  /

  除法
  **

  乘方

• 用法

  返回数字1加上"2"的结果。
  MATH(%数字1%+2)

  返回数字1除以数字2的结果。
  MATH(%数字1%/%数字2%)

MAX

使用MAX函数，您可以从指定的表字段中获取最大值。

• 输入

  MAX(%字段代码%，用于限制目标行的布尔值)

• 参数

  字段代码

  指定表中包含您想要检索的日期或数字值的字段代码。
  用于限制目标行的布尔值

  如果基于某个条件，您只想检索表中与表字段中指定值匹配的行，请指定“true”。

  请用百分号符号包围字段代码。

• 用法

  检索Numeric1字段中包含的最大值，并返回加1后的结果。
  MAX(%数字1%)+1

  以下示例与Boost! Action有关。

  指定条件，即Numeric1字段所在的表中的单选按钮的值有特定的值，并在满足此条件的行范围中包含的最大值加1后返回结果。
  MAX(%数字1%,true)+1

MIN

使用MIN函数，您可以从指定的表字段中检索最小值。

• 输入

  MIN(%字段代码%，用于限制目标行的布尔值)

• 参数

  字段代码

  指定表中包含您想要检索的日期或数字值的字段代码。
  用于限制目标行的布尔值

  如果基于某个条件，您只想检索表中与表字段中指定值匹配的行，请指定“true”。

  请用百分号符号包围字段代码。

• 用法

  返回数字1字段中包含的最小值减去1的结果。
  MIN(%数字1%)-1

  以下示例与Boost! Action有关。

  指定一个条件，其中数字1字段所在的表中的单选按钮值为特定值，并返回该行范围内的最小值减1的结果。
  MIN(%数字1%,true)-1

ROWS

使用ROWS函数，您可以检索指定表的行数。

• 输入

  ROWS(%字段代码%，用于限制目标行的布尔值)

• 参数

  字段代码

  指定要检索的表的字段代码。
  用于限制目标行的布尔值

  如果基于某个条件，您只想检索表中与表字段中指定值匹配的行，请指定“true”。

  请用百分号符号包围字段代码。

• 用法

  返回表的行数。
  ROWS(%表%)

  以下示例与Boost! Action有关。

  指定一个条件，其中表内的单选按钮值为特定值，并返回符合该条件的表行数。
  ROWS(%表%,true)

WEEK_CALC

使用WEEK_CALC函数，您可以获取指定日期的星期索引。

• 输入

  WEEK_CALC(%字段代码%或函数的结果值)

• 参数

  字段代码或函数

  指定输入了计算日期值的字段代码或函数的结果值。

  请用百分比符号包围字段代码，用双引号包围固定值。

  获得的星期索引是以星期日为“0”，星期六为“6”。

• 用法

  返回日期1的值的星期索引。
  WEEK_CALC(%日期1%)

Boost!系列的插件都可以免费下载和使用，但经过3个月的试用期后，每个已安装的应用每天都会显示一个提示您购买许可证的消息。要想不显示此消息而使用它，您需要支付10,000日元的年费。

检查消息内容

Boost!基于域名许可，因此用户数量没有上限。

许可和费用适用于整个Boost!系列，而不是基于每个产品。

本网站介绍了一系列扩展kintone功能的插件。如果您已尝试使用kintone，但觉得它不适合您公司的运营，我们还提供了一个免费的开源Web应用程序构建器。即使您没有系统开发的知识，也可以轻松创建适合您业务流程的系统。如果您感兴趣，请访问以下URL。