Excelでテキストを検索して置換する方法 n8n アクション
PDF4me Excelでテキストを置換する Excel ドキュメントで包括的な検索と置換操作を可能にします。 n8n オプションの書式設定アプリケーションを備えた自動化ワークフロー。Excel ファイルを処理する n8n トリガー、バイナリデータ、base64文字列、または公開 URLs テキストをリテラルテキストまたは正規表現(regex)で置換できます。大文字小文字を区別するマッチングオプション、セル全体または部分的なマッチング、1回の操作で複数の置換フレーズ、およびオプションの書式設定変更(フォント、色、サイズ、太字、斜体、下線、取り消し線、下付き文字、上付き文字)が可能です。このソリューションは、包括的な書式設定制御とシームレスな統合により、すべてのワークシートでテキスト置換が必要なデータ標準化、コンテンツ更新、エラー修正、自動テキスト変換、プライバシーマスキングのワークフローに最適です。
設定
追加する PDF4me 「テキスト置換」ノードを n8n ワークフローを実行し、必要なパラメータを設定します。初期設定手順については、こちらをご覧ください。 n8n 統合ガイド。
前提条件:
- PDF4me API 資格
- n8n ワークフローへのアクセス
構成:
- 追加 PDF4me ノードからワークフローへ
- 「テキストの検索と置換」アクションを選択します。
- 入力パラメータを設定します(下記参照)。

パラメータ
テキスト置換アクションのパラメータ一覧です。これらのパラメータを設定することで、テキスト置換を制御できます。
重要: アスタリスク(***)が付いているパラメータは必須です。このアクションは、 すべてのワークシート Excelファイル内。
| パラメータ | タイプ | 説明 | 例 |
|---|---|---|---|
| 入力データ型*** | String | Excelの入力形式選択 • Excelデータの入力形式を選択してください • PDF4me 複数の入力タイプをサポートしています • オプション: バイナリデータ、 Base64 文字列、または URL | Binary Data |
| 入力バイナリフィールド*** | バイナリ | バイナリExcelファイル入力 (バイナリデータの場合必須) • 前のExcelファイル(.xlsx、.xls)を参照 n8n ノードまたはファイルのアップロード • PDF4me バイナリ Excel ファイルを自動フォーマット検出で処理します ・入力データタイプが「バイナリデータ」の場合に必須 | {{ $binary.data }} |
| Base64形式のExcelコンテンツ*** | String | Base64 エンコードされたExcel入力 (Base64文字列の場合に必須) • Excelコンテンツ(.xlsx、.xls)をbase64エンコードされた文字列として提供する • PDF4me Excelコンテンツを自動的にデコードして処理します • 入力データ型が「Base64文字列」の場合に必須です。 | UEsDBBQABgAI... |
| Excel URL*** | String | パブリックExcel URL 入力 (URLの場合は必須) • 公開/オープンな許可を提供する URL Excelファイル(.xlsx、.xls)に変換 • PDF4me 提供されたExcelファイルをダウンロードして処理します URL ・入力データタイプが「URL」の場合に必須です。 | https://abc.com/data.xlsx |
| Excel名*** | String | Excel入力ファイル名 ・入力するExcelファイルの名前を適切な拡張子(.xlsx、.xls)とともに指定してください。 • PDF4me フォーマット検出と処理最適化にこれを使用します | data.xlsx |
| フレーズ*** | String | JSON 交換作業の配列 • JSON ReplacementPhraseオブジェクトの配列を含む文字列 • 各オブジェクト: 検索テキスト* (弦)、 置換テキスト* (文字列、削除する場合は空にできます) IsExpression (ブール値、デフォルト値: false - true = 正規表現、false = リテラルテキスト) 大文字と小文字を区別 (ブール値、デフォルト値: false) セル全体をマッチする (ブール値、デフォルト値:false - true = セル全体に一致、false = 部分一致) 書式設定 (テキスト書式オブジェクト - オプション:フォント名、フォント色、フォントサイズ、太字/斜体、下線タイプ、取り消し線タイプ、スクリプトタイプなど) ・少なくとも1つのフレーズが含まれている必要があります ・配列順に順次処理される • マッチング: リテラルテキストは文字列比較を使用します。正規表現はパターンとグループ($1、$2)をサポートします。 | [{"SearchText":"old","ReplacementText":"new"}] |
| バイナリデータ出力名*** | String | バイナリデータ出力マッピング • 生成されたExcelバイナリデータにアクセスするための変数名を定義します。 • 後続のワークフローアクションで使用される ・ワークフロー自動化に不可欠 | document |
出力
出力パラメータ
| パラメータ | タイプ | 説明 | 例 |
|---|---|---|---|
| ファイル名 | String | テキストを置き換えたExcelドキュメントのファイル名 - テキスト置換後の出力Excelドキュメントファイルの名前 | excel_replaced.xlsx |
| ファイルサイズ | 番号 | ファイルサイズ(バイト単位) - テキスト置換後のExcelドキュメントのサイズ(バイト単位) | 212808 |
| 成功 | Boolean | PDF4me 動作状況 - Boolean テキスト置換処理の成否を示すフラグ。 PDF4me リターン true 業務の成功と false エラーが発生した場合 | true |
| オリジナルファイル名 | String | 元のExcelドキュメントのファイル名 - 入力Excelドキュメントファイルの名前 | myExcelFile.xlsx |
| 操作数 | 番号 | 交換作業の回数 - 処理された交換作業の総数 | 1 |
| 業務 | Array | Array 交換作業 - Array 実行された各置換操作の詳細を含むオブジェクト。これには、searchText、replacementText、isExpression、matchEntireCell、caseSensitive、formattingApplied が含まれます。 | [{"searchText": "old ", "replacementText": "New", "isExpression": false, "matchEntireCell": false, "caseSensitive": false, "formattingApplied": false}] |
| カルチャー名 | String | 文化/地域コード - 文書処理に使用される文化コード(例:「en-US」、「de-DE」、「fr-FR」) | en-US |
| メッセージ | String | 作戦メッセージ - テキスト置換操作の結果を示す説明メッセージ(完了した操作数を含む) | Text replacement completed successfully with 1 operation(s) |
N8N 行動対応
の PDF4me テキストの検索と置換 API 複数の形式で表示可能なレスポンスを返します。ニーズに最適な表示形式を選択してください。
- JSON
- Table
- Schema
- Binary
JSON 回答形式
生 JSON からの応答 API:
[
{
"fileName": "excel_replaced.xlsx",
"fileSize": 212808,
"success": true,
"originalFileName": "myExcelFile.xlsx",
"operationsCount": 1,
"operations": [
{
"searchText": "old ",
"replacementText": "New",
"isExpression": false,
"matchEntireCell": false,
"caseSensitive": false,
"formattingApplied": false
}
],
"cultureName": "en-US",
"message": "Text replacement completed successfully with 1 operation(s)"
}
]
テーブルビュー
構造化された表形式の応答データ:
| パラメータ | 価値 |
|---|---|
| ファイル名 | excel_replaced.xlsx |
| ファイルサイズ | 212808 |
| 成功 | true |
| オリジナルファイル名 | myExcelFile.xlsx |
| 操作数 | 1 |
| 業務 | Array 交換作業対象 |
| カルチャー名 | en-US |
| メッセージ | Text replacement completed successfully with 1 operation(s) |
操作配列の詳細:
| パラメータ | 価値 |
|---|---|
| 検索テキスト | old |
| 置換テキスト | New |
| isExpression | false |
| セル全体を一致させる | false |
| 大文字と小文字を区別 | false |
| 書式設定適用済み | false |
スキーマビュー
レスポンスのデータ構造と型:
1 item
fileName: T excel_replaced.xlsx
fileSize: # 212808
success: ☑ true
originalFileName: T myExcelFile.xlsx
operationsCount: # 1
operations: [] Array
[0]: {} Object
searchText: T old
replacementText: T New
isExpression: ☑ false
matchEntireCell: ☑ false
caseSensitive: ☑ false
formattingApplied: ☑ false
cultureName: T en-US
message: T Text replacement completed successfully with 1 operation(s)
タイプ指標:
T= String (文章)#= 番号☑= Boolean[]= Array
バイナリデータビュー
実際のExcelドキュメントファイルのデータとメタデータ:
data
─────────────────────────────
File Name: excel_replaced.xlsx
File Extension: xlsx
Mime Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
File Size: 212.8 kB
バイナリデータアクセス:
- n8n バイナリオブジェクト:
$binary.data.data - Base64 コンテンツ直接使用可能
- ファイル操作ダウンロード、メール送信、または保存の準備ができました
注記: 無効なフレーズは警告としてログに記録されますが、処理は停止しません。その他の有効なフレーズは引き続き処理されます。
ユースケース
データ標準化とフォーマット変換
- Excelドキュメント全体で、一貫性のない値を標準形式に置き換える
- 日付、電話番号、または識別子を標準形式に変換する
- 通貨記号と数値形式を標準化する
エラー修正とコンテンツの更新
- スペルミスやデータ入力エラーを自動的に修正します
- 複数のワークシートにわたって、製品名、価格、またはステータス値を更新する
- よくあるタイプミスや書式の不整合を修正する
プライバシーマスキングとデータ保護
- 外部共有のために、機密データをマスクされた値に置き換える
- マスク PII (個人識別情報)正規表現パターンを使用
- コンプライアンスおよびプライバシー要件を満たすために、データの匿名化を適用します。