行を抽出する Excel - JSON エクスポート対象 Zapier

PDF4me 行を抽出する は Zapier 範囲を変換するアクション Excel 行と列を構造化 JSONワークシートと行/列の範囲を設定するか、すべてを抽出するか、値をネイティブ型のままにするかテキストとしてエクスポートするかを選択します。抽出された行のダウンロードリンクが返され、 APIs、データベース、または次のZapステップ。

このアクションが何をするか

ワークシートを読み込む Excel 前の Zap ステップでマッピングされたファイルに対して、設定した行/列範囲とフィルタリングオプションを適用し、各行が JSON オブジェクト。Has Header Row を使用して、各オブジェクトのキーを最初の行の後に名前を付け、Exclude オプションで非表示または空の行をスキップし、数値と日付をネイティブのままにするかどうかを選択します。 JSON 入力するか、プレーンテキストとしてエクスポートします。

認証 API リクエスト

アクセスするには PDF4me ウェブ API を通して Zapierすべてのリクエストには適切な認証情報を含める必要があります。認証により安全な通信が保証され、承認されたユーザーとしての身元が検証され、シームレスな統合が可能になります。 Zapier ワークフローと PDF4meの強力な Excel データ抽出サービス。

Get your API Key

見逃してはならない重要な事実

ファイルのみ必須

ファイル名、ワークシート名、およびすべての範囲、フィルタリング、書式設定フィールドはオプションです。 Zapier 構成。

行番号と列番号は1から始まり、 Excel

最初の行1は Excel 1行目、1列目はA列です。データの末尾に到達するには、最終行または最終列に-1を使用してください。

「値をテキストとしてエクスポート」では、値ではなく型が変更されます。

文字列のみを出力する場合は True に設定し (フォーマット検証に便利)、数値、日付、ブール値をネイティブ形式で保持する場合は False に設定します。 JSON 種類。

:::ヒント：前の手順でマップファイルとファイル名を取得してください + 隣のボタン ファイル そして ファイル名 以前の Zap ステップからマッピングするには、たとえば、 ファイル名全体 以前の PDF4me Excel 行動。 Excelファイルには完全なコンテンツを提供する必要があり、「存在するが表示されない」参照は認められません。 :::

:::警告ファイル: (存在しますが表示されません) ファイルフィールドに「ファイル: (存在しますが表示されません)」と表示され、「ファイルが空です」エラーが発生する場合は、 ファイルの内容全体 代わりに。参照 Zapier ＆ Power Automate ヒント詳細は :::

PDF4me Excel 行抽出 Zapier 設定 - ファイル、ファイル名、ワークシート名、1 ベースの行と列の範囲、ヘッダー行あり — 「ファイル」のみにアスタリスクが付きます。「最初の行」、「最後の行」、「最初の列」、「最後の列」には、Excel独自の1から始まる番号が使用され、ここでは1、7、1、4と表示されます。

PDF4me Excel 行抽出 - オブジェクトとしてエクスポート、非表示行の除外、非表示列の除外、カルチャ — その他のオプション: オブジェクトとしてエクスポート、非表示行/列の除外 ( UI それ自体には「非表示の列を除外」とカルチャーが表示されます。

行抽出の主な機能は何ですか？

JSON 出力：抽出する Excel 構造化されたデータ JSONファイルとして返されます
柔軟な範囲: 最初/最後の行と最初/最後の列を指定します Excel独自の1ベースの数字
ヘッダー行のサポート: ヘッダー行は最初の行を JSON キー
フィルタリング: 非表示の行、非表示の列、空の行を除外する
データ型制御: 値をテキストとしてエクスポートして、すべてのテキストを出力します
オブジェクトとしてエクスポート: 構造出力として JSON オブジェクトまたは配列

パラメータ

行抽出アクションのパラメーターの完全なリスト。パラメーター名は、 Zapier 構成 UI 上記のスクリーンショットに示されています。

クイックセットアップチェックリスト

地図 ファイル （Excelトリガーまたは前のステップから
オプションでマッピング ファイル名 そして設定する ワークシート名 （例：シート1）
セット 最前列、 最後列、 最初の列、 最後の列 （1から始まる；-1＝終了）
セット ヘッダー行があります、 オブジェクトとしてエクスポート必要に応じてその他のオプションも

パラメータ	必須	その機能	例
File	Optional	Excel file to extract rows from. Map from a previous step. Must provide full file content.	`[2. File from Step 2]`
File Name	Optional	Excel filename, used for output file identification.	`add_header_sample_file.xlsx`
Worksheet Name	Optional	Target worksheet to extract from. Empty extracts from the first worksheet.	`Sheet1`
Has Header Row	Optional	True uses the first row in the range as JSON property names.	`True`
First Row	Optional	Starting row, 1-based. 1 = Excel row 1.	`1`
Last Row	Optional	Ending row, 1-based. -1 = last row with data.	`7`
First Column	Optional	Starting column, 1-based. 1 = column A.	`1`
Last Column	Optional	Ending column, 1-based. -1 = last column with data.	`4`
Exclude Empty Rows	Optional	True skips rows with no data.	`False`
Export Values As Text	Optional	True exports every value as a string; False preserves native types.	`False`
Hyperlink Format	Optional	How to represent cell hyperlinks in the output.	`-`
Export As Object	Optional	Controls whether the output is structured as a JSON object or array.	`True`
Exclude Hidden Rows	Optional	True skips rows hidden in the worksheet.	`False`
Exclude Hidden Columns	Conditional	True skips columns hidden in the worksheet. Zapier labels this field "Exclud Hidden Columns".	`False`
Culture	Optional	Locale for date/number formatting.	`en-US`
File URL (Either provide a File or File URL)	Optional	Link to the Excel workbook to extract the rows from, as an alternative to File. Map a file URL from a previous step.
Exclud Hidden Columns	Optional	Skip hidden columns in extraction

重要： のみ ファイル が必要です。 + 各フィールドの横にあるボタンを使用してデータをマッピングします。最初の行/最後の行と最初の列/最後の列を使用します Excel自身の 1ベース 番号付け（1行目、A列目＝1）であり、ゼロベースのインデックスではありません。

行抽出機能は何が返されますか？

の PDF4me 行を抽出する Excel アクションは包括的な結果を返します JSON シームレスな出力データ Zapier ワークフロー統合。

分野	タイプ	内容物
`jobId`	Text	ID of the PDF4me job that processed the request.
`traceId`	Text	Trace ID of the request, when PDF4me returns one. Give it to PDF4me support when reporting a problem.
`documentId`	Text	ID PDF4me gives the resulting document.
`File Name`	Text	Name of the resulting file, without extension.
`File Extension`	Text	Extension of the resulting file, for example `.pdf`.
`Full File Name`	Text	Name of the resulting file, with extension.
`File Url`	Text	Download link of the file with the extracted rows. Map it into any later step that needs the data.
`Alternate File Url`	Text	Alternative download link of the resulting file, with the file name at the end of the URL.
`File Size`	Number	Size of the resulting file, as reported by PDF4me.

JSON
Zap Integration

例 JSON 応答:

{
"jobId": "9f1c2e7a-4b7d-4f2a-8c31-0d5b6e9a1f44",
"traceId": "4b7d2e18-9c3a-4f55-b0e2-7a1d8c6f3b02",
"documentId": "07386627-184a-44b2-a040-5ea2712a4bc5",
"File Name": "extracted_rows",
"File Extension": ".json",
"Full File Name": "extracted_rows.json",
"File Url": "https://api.pdf4me.com/Zapier/GetDocument/...",
"Alternate File Url": "https://api.pdf4me.com/Zapier/GetAltDocument/.../extracted_rows.json",
"File Size": 3072
}

ファイルURLにあるファイルの内容：

[
{"Name": "John Doe", "Age": 30, "Salary": 50000.50},
{"Name": "Jane Smith", "Age": 28, "Salary": 55000.00}
]

走るとき テストアクション Zapエディタでは、 Zapier 生の PDF4me 回答結果これらのファイルフィールドの代わりに。

典型的な構成

ワークフローの例Common Zapier workflow patterns using Extract Rows.

予定 Excel-to-API同期

スケジュールされたトリガーは、一定の間隔で実行されます。
PDF4me 行の抽出は、ファイルとファイル名をマッピングし、「ヘッダー行を持つ」をTrueに設定し、「値をテキストとしてエクスポート」をFalseに設定して、ネイティブの数値型と日付型を保持します。
ダウンロードステップではファイルURLを取得し、ループステップでは各行オブジェクトをPOSTします。 REST API 終点。

データベースに新しいファイルをロードします

新しい Excel ファイルはストレージフォルダにアップロードされます。
PDF4me 「行の抽出」では、タイトル行をスキップするために「最初の行」を2に設定し、残りのデータについては「最後の行」を-1に設定し、「空の行を除外」をTrueに設定します。
データベースステップでは、ダウンロードしたファイルから行を一括挿入します。 SQL テーブル。

処理前のフォーマット検証

日次トリガーは、下流の処理ジョブの前に実行されます。
PDF4me 「行の抽出」では、「値をテキストとしてエクスポート」が「True」に設定されているため、日付や数値を含むすべての値が、パターンチェック用のプレーンな文字列として取得されます。
フィルターまたはコードステップによって、データ処理が続行される前に、各行のテキストが想定される形式と照合されます。

実践的なヒント

File: (Exists but not shown) causes errors

Select the mapping option that provides the file's full binary content instead of a reference. See Zapier & Power Automate Tips for the exact steps.

Row and column numbers start at 1, not 0

First Row 1 is Excel row 1 and First Column 1 is column A. This trips up developers used to zero-based indexing.

Use -1 for Last Row or Last Column, not a guessed high number

Setting -1 tells PDF4me to extract through the last row or column that actually has data, so you do not need to know the exact size in advance.

Export Values As Text is for validation, not display

True is useful when you need to pattern-match every value as a string. For most database or API loads, keep it False to preserve native types.

The Zapier field is labeled "Exclud Hidden Columns"

This is a real label in the Zapier UI, not a typo in this documentation. Both Exclude Hidden Rows and Exclude Hidden Columns default to False.

チートシート

分野	価値
Action	`Extract Rows`
File	`[Mapped from previous step]`
Worksheet Name	`Sheet1`
First Row / Last Row	`1 / 7 (1-based, -1 = to end)`
First Column / Last Column	`1 / 4 (1-based, -1 = to end)`
Has Header Row	`True`
Export Values As Text	`False (preserve types)`

よくある質問

How do I convert Excel rows to JSON in Zapier?+

Add the PDF4me Extract Rows action to a Zap, map the Excel file from a previous step using the full-content option, set Worksheet Name and the row/column range, then map File Url in the next step to download the extracted rows as JSON. See Zapier's guide to working with files for how file fields pass between steps.

Are First Row and First Column 0-based or 1-based?+

They are 1-based, matching Excel's own row and column numbers. First Row 1 is Excel row 1 and First Column 1 is column A. Use -1 for Last Row or Last Column to extract through the end of the data.

Can I extract only a specific range of rows and columns?+

Yes. Set First Row, Last Row, First Column, and Last Column to the exact range you need, for example First Row 1 and Last Row 7 for the first seven rows. Leaving Last Row or Last Column as -1 extracts through the end of the data.

Is File the only required parameter?+

Yes. In the Zapier configuration, only File is marked required. File Name, Worksheet Name, and every range, filtering, and formatting field are optional.

Does Export Values As Text change the extracted data?+

It changes the JSON data types only, not the underlying Excel values. Set it to True to get every value as a string, or False to preserve numbers, dates, and booleans as native JSON types.