> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 打刻情報の照会

> YiDAプラットフォームでフォームとコネクタを活用し、社員の打刻情報（打刻状態・時刻・場所）を照会する方法を解説します。フォーム作成から条件設定、結果記録までの手順を紹介します。

## 1. ユースケース

YiDA内でフォームを送信し、社員の打刻情報（打刻状態、打刻時刻、打刻場所）を照会します。

## 2. 手順

### 2.1 ステップ1：フォームの作成

通常フォームを2つ作成します。「打刻照会フォーム」はコネクタをトリガーして照会を実行し、「照会結果記録」はコネクタから返される結果を受け取り、確認しやすくします。

#### 2.1.1 照会フォームの作成

**手順：**

1. 通常フォームを作成し、「打刻照会フォーム」と名付けます。
2. 日付コンポーネントを2つ追加し、「照会開始日」「照会終了日」と名付けます。フォーマットを「YYYY-MM-DD HH:mm」に設定し、必須項目としてマークします。（図2.1-1参照）

図2.1-1 日付コンポーネントの追加と設定

3. メンバーコンポーネントを追加し、「照会対象社員」と名付けます。必須項目としてマークします。（図2.1-2参照）

図2.1-2 メンバーコンポーネントの追加と設定

4. ページ右上の**保存**をクリックします。

#### 2.1.2 結果記録フォームの作成

**手順：**

1. 通常フォームを作成し、「照会結果記録」と名付けます。
2. 一行テキストコンポーネントを4つ追加し、「コネクタ実行状態」「打刻状態」「打刻時刻」「打刻場所」と名付けます。（図2.1-3参照）

図2.1-3 一行テキストコンポーネントの追加と設定

3. 右上の**保存**をクリックします。

### 2.2 ステップ2：「打刻照会フォーム」のフォームコネクタの設定

<Note>
  コネクタの概要については、[統合と自動化 - コネクタ](/ja/yida/integration/gqmveiswrxkgxu9s)を参照してください。
</Note>

「打刻照会フォーム」のフォームコネクタを設定することで、打刻照会機能を実装し、照会結果を「照会結果記録」フォームに自動的に追加します。

**手順：**

1. 管理者ページで「打刻照会フォーム」を選択し、**統合と自動化**タブに切り替え、**統合と自動化の作成**をクリックします。（図2.2-1参照）

図2.2-1 コネクタの入り口

2. コネクタに「打刻照会」という名前を付け、トリガー種類を「フォームイベントトリガー」に設定し、**確認**をクリックします。（図2.2-2参照）

図2.2-2 コネクタの作成

3. **フォームイベントトリガー**ノードをクリックします。トリガーイベントを「作成成功」に、データフィルタを「すべてのデータ」に設定します。（図2.2-3参照）

図2.2-3 フォームイベントトリガーの設定

4. **コネクタ**ノードをクリックし、「打刻」アプリを選択して**次へ**をクリックします。（図2.2-4参照）

図2.2-4 コネクタアプリの選択

5. アクションを「個人打刻記録の取得」に設定し、**次へ**をクリックします。（図2.2-5参照）

図2.2-5 コネクタアクションの選択

6. アクションを設定し、**保存**をクリックします。（図2.2-6参照）

図2.2-6 コネクタアクションの設定

7. **コネクタ**ノードの下の領域にカーソルを合わせ、\*\*+\*\*をクリックして、**データ作成**ノードを選択します。（図2.2-7参照）

図2.2-7 「データ作成」ノードの追加

8. **データ作成**ノードを設定します。作成方法で「フォームで作成」を選択し、フォームを「照会結果記録」に設定します。作成するデータで「単一レコードの作成」を選択します。フィールドマッピングを設定し、**保存**をクリックします。（図2.2-8参照）

図2.2-8 「データ作成」ノードの設定

9. **データ作成**ノードのフィールド設定で「コネクタ実行状態」を設定します。（図2.2-9参照）

図2.2-9 「コネクタ実行状態」フィールドの数式設定

10. **データ作成**ノードのフィールド設定で「打刻状態」を設定します。（図2.2-10参照）

図2.2-10 「打刻状態」フィールドの数式設定

11. **データ作成**ノードのフィールド設定で「打刻時刻」を設定します。（図2.2-11参照）

図2.2-11 「打刻時刻」フィールドの数式設定

12. **データ作成**ノードのフィールド設定で「打刻場所」を設定します。（図2.2-12参照）

図2.2-12 「打刻場所」フィールドの数式設定

13. 右上の**保存**をクリックし、続いて**公開**をクリックします。

### 2.3 ステップ3：「打刻照会フォーム」を送信してコネクタをトリガー

図2.3-1 フォームの送信

## 3. 実行結果

図3-1 実行結果