twenty/packages/twenty-docs/l/ja/user-guide/workflows/workflow-features.mdx

---
title: ワークフロー機能
info: 利用可能なすべてのワークフロートリガー、アクション、および管理機能の完全なリファレンス。
image: /images/user-guide/workflows/robot.png
sectionInfo: プロセスを自動化し、外部ツールと統合します
---

<Frame>
  <img src="/images/user-guide/workflows/robot.png" alt="Header" />
</Frame>

## ワークフロートリガー

ワークフローは、常に自動化をいつ実行するかを定義する単一のトリガーで開始されます。

### レコードの作成

新しいレコードが選択されたオブジェクト（人物、会社、機会、または任意のカスタムオブジェクト）で作成されるときに、ワークフローを開始します。

**設定**：新しいレコードを監視するオブジェクトタイプを選択します。

### レコードの更新

既存のレコードに変更が加えられたときにワークフローを開始します。

**設定**：

- オブジェクトタイプを選択
- 変更を監視するフィールドをオプションで指定

### レコードの更新または作成

選択されたオブジェクトでレコードが作成または更新されたときに、ワークフローを開始します。

**なぜ重要か**：このトリガーが特に役立つのは、さまざまな方法で作成されたレコードが異なる動作をするためです。

- **API/CSV インポート**： レコードはすべてのフィールドが即座に入力されて作成されます。
- **手動作成**： レコードは最初に作成され、その後の更新でフィールドが追加されます。

**設定**：

- 監視するオブジェクトタイプを選択
- 変更を監視するフィールドをオプションで指定
- ワークフローは最初の作成時とその後のすべての更新時にトリガーされます。

### レコードの削除

オブジェクトからレコードが削除されたときにワークフローを開始します。

**設定**：削除を監視するオブジェクトタイプを選択します。

### 手動で起動

ユーザーのアクションによってトリガーされたときにワークフローを開始します。 このトリガーは、Cmd+K メニューまたはトップナビバーのカスタムボタンを介してアクセスできます。

**可用性設定**: レコードの選択をワークフローでどのように扱うか選択します。

- **グローバル**： このワークフローをトリガーするためにレコードは必要ありません。 ワークフローはどこからでも（任意のオブジェクトから）トリガーされ、レコードを入力として使用しません。 ワークフローはどこからでも（任意のオブジェクトから）トリガーされ、レコードを入力として使用しません。

- **シングル**：選択したレコードがワークフローに渡されます。 これは特定のオブジェクトに対して設定されます。 ワークフローをトリガーする前に、複数のレコードを選択できます。 選択されたレコードの数だけワークフローが実行されます。 これは特定のオブジェクトに対して設定されます。 ワークフローをトリガーする前に、複数のレコードを選択できます。 選択されたレコードの数だけワークフローが実行されます。

  <Warning>
  You cannot run more than 100 workflows in parallel at any given time.
  </Warning>

- **一括**：選択されたレコードがワークフローに渡されます。 これは特定のオブジェクトに対して設定されています。 ワークフローを起動する前に複数のレコードを選択できます。 ワークフローは一度実行され、すべてのレコードリストを入力として提供します。 これはワークフローにイテレータアクションを含める必要があることを意味します。 これは、ワークフロー実行の数を最適化/制限したい人に最適です。

**追加の設定**：

- 対象オブジェクトを選択（シングルとバルクの可用性用）
- ワークフロートリガーのコマンドアイコンを選択
- ナビゲーションバープレースメントを設定（固定または未固定）

**アクセス方法**：

- Cmd+Kメニューでマニュアルワークフローを見つけて起動
- カスタムボタンをトップナビゲーションバーに配置（設定されている場合）

### スケジュールで

指定された頻度でワークフローを開始します。

**設定**：

- 時間単位を選択（分、時間、日）
- 高度なスケジュール設定には値を入力するか、カスタムcron式を使用

### Webhook

外部サービスからのGETまたはPOSTリクエストを受信するとワークフローを開始します。

**設定**：

- 一意のウェブフックURLを受信
- POSTリクエストの場合、予想されるボディ構造を定義
- 必要に応じて認証を設定

## ワークフローアクション

アクションはトリガーが起動した後に何が起こるかを定義します。 複数のアクションを連続してチェーンすることができます。

### レコードを作成

選択したオブジェクトに新しいレコードを追加します。

**設定**：

- 対象オブジェクトを選択
- 必要およびオプションのフィールドに入力
- 前の手順からのデータを使用してフィールドを埋める

**出力**：新しく作成されたレコードのデータが後続の手順で使用可能

### レコードを更新

選択したオブジェクト内の既存のレコードを変更します。

**設定**：

- 対象オブジェクトを選択
- 更新する具体的なレコードを選択
- 変更するフィールドを選択し、新しい値を入力

**出力**：更新されたレコードのデータが後続の手順で使用可能

### レコードを削除

選択したオブジェクトからレコードを削除します。

**設定**：

- 対象オブジェクトを選択
- 削除する具体的なレコードを選択

**出力**：削除されたレコードのデータは後続の手順で使用可能

### レコードを検索

選択したオブジェクト内のフィルター条件を使用してレコードを探します。

**設定**：

- 検索するオブジェクトを選択
- 結果を絞り込むためのフィルター基準を設定
- 並べ替えや制限を設定

**出力**：一致するレコードを返し、後続の手順で使用可能

**ベストプラクティス**：検索レコードの後でブランチを使用し、「見つかった」対「見つからない」シナリオを処理。

### 反復子

前の手順から返されたレコードの配列をループして、各レコードに個別にアクションを実行できるようにします。

**設定**：

- 前の手順からのレコードの配列を選択（例：検索レコードの結果）
- ループ内の各レコードで実行するアクションを定義
- ループ内で各レコードを参照するための変数名を設定

**例**：検索レコードが5人を返し、その後イテレータを使用して各人にメールを送信するか、個別に記録を更新。

**注**：イテレータは現在ベータ版です。 設定→リリース→ラボの下でアクティベート。

### フィルター

指定された条件に基づいてレコードの配列をフィルタリングし、条件を満たすものだけを通過させます。

**設定**：

- フィルターするレコードの配列を選択
- フィルタ条件と基準を定義
- 後続の手順に通過するレコードを設定

**出力**：指定されたフィルター条件に一致するレコードのみを返します。

### メールを送信

ワークフローからメールを送信します。

**前提条件**：設定 > アカウントでメールアカウントを追加

**設定**：

- 受信者のメールアドレスを入力
- 件名を設定
- メッセージ本文を作成
- 前の手順からの変数を参照してパーソナライズ

**注**：メールの添付ファイルは2026年第1四半期に利用可能になります。

### コード

ワークフロー内でカスタムJavaScriptを実行します。

**設定**：

- エディタでJavaScriptコードを記述
- 前の手順からの変数にアクセス
- 後続の手順で使用するための変数を返す
- ステップ内でコードを直接テスト

**アクセス**：設定 → API & WebhooksでAPIキーを管理

### フォーム

ワークフロー実行中にフォームをプロンプトしてユーザー入力を収集します。

**設定**：

- タイプ、ラベル、プレースホルダを定義した入力フィールドを設定
- バリデーションルールを設定
- フォームのタイトルと説明を設定

**出力**：フォームレスポンスが後続の手順で使用可能

<Warning>
フォームは現在、手動トリガー専用に設計されています。 他のトリガーを持つワークフロー（レコード作成、更新など）では、ユーザーが期待する体験とは異なり、フォームにはワークフロー実行インターフェースからのみアクセス可能です。 通知センターは、2026年に自動化されたワークフローでフォームを適切にサポートするためにリリースされます。
</Warning>

### HTTPリクエスト

ワークフローの一部として外部APIにリクエストを送信します。

**設定**：

- APIエンドポイントURLを入力
- HTTPメソッドを選択（GET, POST, PUT, PATCH, DELETE）
- 必要なヘッダと値を追加
- POST/PUT/PATCHリクエストのためのリクエストボディを含める
- 構造プレビューのためにサンプルレスポンスを提供

## ワークフロー管理

### ワークフローの作成

1. 「+ ワークフローを追加」をクリックして開始
2. 「無題」をクリックしてワークフローに名前を付ける
3. ワークフロートリガーを選択して設定
4. ワークフローにアクションを追加
5. テストと反復
6. 編集が完了したら、ドラフトモードのワークフローを有効にしてください。

ワークフローセクションが見えない場合、これは権限の問題です。 ワークフローセクションが見えない場合、これは権限の問題です。 アクセスを許可するためにワークスペースの管理者に連絡してください。

### ワークフローのステータス

- **ドラフト**：編集中、まだ公開されていない
- **アクティブ**：トリガーに応答するライブバージョン
- **非アクティブ**：以前アクティブだったが手動で停止
- **アーカイブ**：保存された過去のバージョン

### ワークフローのアクティベーション

**有効化**をクリックしてドラフトを新しいバージョンとして公開 これにより、トリガー時に実行される資格を与えるが、すぐには実行されません。 これにより、トリガー時に実行される資格を与えるが、すぐには実行されません。

### ワークフローのテスト

有効化前のワークフローを次の方法でテスト：

- レコード未選択時の手動トリガー
- 個別のアクションテスト（特にコードアクション）
- ドラフトモードのテストではワークフローが有効化されない

### ワークフロー実行

**実行**：ワークフロー実行の記録には次が含まれます：

- ステータス（成功、失敗、実行中）
- 各ステップの出力データ
- 作成者とタイムスタンプ
- 適用可能な場合、エラーメッセージ

**実行の表示**：

- ワークフローエディタの**実行**パネルを確認
- すべてのワークフローにわたる監視のために**ワークフロー実行**ビューを開く

**パフォーマンステップ**：ページの読み込みを改善するために「すべてのワークフロー」ページなどからワークフロー実行を非表示に

### バージョン履歴

- **バージョン**フィールドの下にすべてのバージョンを表示
- 詳細表示のために任意のバージョンをクリック
- 前のバージョンを復元するには**下書きとして使用**
- 下書きの競合をオーバーライドまたはリターンオプションで処理

## ベストプラクティス

### ワークフローの組織化

- **説明的な名前**：明確で具体的なワークフロー名を使用
- **ステップ命名**：ステップの機能を説明する名前に変更
- **ドキュメンテーション**：コードアクションにコメントを追加
- **カテゴライズ**：関連するワークフローを論理的にグループ化
- **カスタムフィールド**：ワークフローオブジェクトにフィールドを追加し、データモデル内でカスタムプロパティを使用してワークフローを整理および分類

### パフォーマンス最適化

- **API呼び出しの最小化**：可能な限りバッチ操作を実行
- **効率的な検索**：特定のフィルター基準を使用
- **エラーハンドリング**：失敗シナリオを計画
- **レート制限**：外部APIの制限を遵守

### Data Flow Management

- **ブランチロジック**：検索レコードの後にブランチを使用
- **変数の使用**：前の手順からのデータを活用
- **データ検証**：コードアクションで入力値を検証
- **フィールドマッピング**：データ変換を注意深く計画

### 監視と保守

- **Regular Monitoring**: Check workflow runs for errors
- **パフォーマンスレビュー**：実行時間と成功率を分析
- **アップデート管理**：アクティベーション前に下書きで変更をテスト
- **Team Coordination**: Document workflows for team members

For practical examples of these features in action, see our [Internal Automations](/l/ja/user-guide/workflows/internal-automations) and [External Tool Integration](/l/ja/user-guide/workflows/external-tool-integration) guides.