リストから要素を取得

アクションの場所:Uitility > データ > リストから要素を取得

 

入力されたデータから指定した要素を取得します。

入力データが複数行の場合は指定された行のデータ全体を取得します。入力データが1行だけの場合は指定された番号の列の値のみを返します。

設定方法(簡単)

get_element_from_list_action.png

 

①「Utility/データ」カテゴリにある「リストから要素を取得」アクションをクリックします。

② 入力データ 参照:リストタイプのアクション結果を参照し、入力するデータに設定します。

設定方法(便利)

③ 値を選択(任意):操作対象の値を選択することができます。詳しくは、「値を選択」を参照してください。

④ 戻り値にラベルを付ける(任意):アクションが返す値の各要素に任意のラベル(名称)を付けることが出来ます。後続アクションからの参照時にこのラベルを指定してデータを操作することが出来ます。

オプション設定

以下の設定項目は任意です。

エラーを無視

アクション使用例

kintoneからレコードを取得し、案件名・案件ステータス・担当の各項目を抽出します。
取得した情報をもとに、担当者宛のメッセージ文を自動生成するシナリオです。

< 全体図 >

「kintoneのレコードを取得」→「キーを指定して要素を取得」→「リストから要素を取得」→「キーを指定して要素を取得」→「キーを指定して要素を取得」→「キーを指定して要素を取得」→「kintoneのレコードにコメントを投稿」

184bd1c0-62c1-4669-b1aa-490bf2088f18.webp

< 各アクション詳細 >

・ kintoneのレコードを取得

kintoneのアプリからレコードを取得し、レコード番号・案件名・案件ステータス・担当者の条件を指定して対象データを抽出します。取得結果は、各レコードを要素とする配列形式で返され、各フィールドはキーとvalueを持つオブジェクトとして格納されています。

そのため、以降の処理ではまず「records」キーから配列データを取得し、次に配列から対象レコードを取り出します。
その後、キーを指定して各フィールドのvalueを取得し、案件名・案件ステータス・担当情報を抽出します。

取得したデータ:

{


     "records": [
         {
             "担当": {
                 "type": "SINGLE_LINE_TEXT",
                 "value": "横田"
              },
             "レコード番号": {
                 "type": "RECORD_NUMBER",
                 "value": "4"
              },
             "案件ステータス": {
                 "type": "DROP_DOWN",
                 "value": "見積もり依頼"
              },
             "案件名": {
                 "type": "SINGLE_LINE_TEXT",
                 "value": "CCC"
              }
          }
      ],
     "totalCount": null
}

ea27b915-2a48-45da-9a4d-ba984395f33b.webp

・ キーを指定して要素を取得
取得したデータは「records」キーの中に格納されているため、「records」を指定して配列データを取得します。。取得後のデータは以下の通りです。

キー:
records

取得後のデータ:

[
     {
         "担当": {
             "type": "SINGLE_LINE_TEXT",
             "value": "横田"
          },
         "レコード番号": {
             "type": "RECORD_NUMBER",
             "value": "4"
         },
         "案件ステータス": {
             "type": "DROP_DOWN",
             "value": "見積もり依頼"
          },
         "案件名": {
             "type": "SINGLE_LINE_TEXT",
             "value": "CCC"
          }
     }
]

e2618102-d6d2-4af1-bcb9-32a7c1fdbcc4.webp

・ リストから要素を取得

先ほど、「キーを指定して要素を取得」によって取得したデータは配列であったため、このアクションでは、配列から1件のレコードを取り出します。
これにより、以降の処理で各フィールドのvalueを取得できるようになります。

b4c3e743-5c29-4e96-8846-be0adee708c2.webp

・ キーを指定して要素を取得
各フィールドは、「フィールド名」をキーとして、その中に「type」と「value」を持つオブジェクトとして格納されています。
そのため、「レコード番号.value」のようにキーとvalueを指定することで、実際の値を取得できます。
同様に、「案件ステータス.value」や「案件名.value」など、他のフィールドについても同じ方法で値を取得できます。

キー:
レコード番号.value

d14600e9-50d5-40d7-93dc-a7f391af8d6e.webp

キー:
案件ステータス.value

92e10105-1608-4511-9e61-4f4d437b08ed.webp

キー:
担当.value

8a4e64a8-77be-4795-93e8-d938fbfd1e93.webp

・ kintoneのレコードにコメントを投稿
取得したレコード番号・担当・案件ステータスの各情報を用いて、kintoneのレコードにコメントを投稿します。
担当者名および案件ステータスの情報を本文に埋め込み、担当者宛の対応依頼メッセージを自動生成しています。
レコード番号:
「キーを指定して要素を取得 (レコード番号) 」を参照

コメント:

「キーを指定して要素を取得 (担当) 」を参照 さん
ステータス:
「キーを指定して要素を取得 (案件ステータス) 」

上記の件に関して、ご対応よろしくお願いいたします。
 

5e68e007-3684-4fec-8e5e-8bda5736f98c.webp

 

コメント

0件のコメント

サインインしてコメントを残してください。