Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

Ekstrak Lembar Kerja dari Excel di dalam Power Automate

PDF4me Lembar Kerja Ekstrak adalah sebuah Power Automate tindakan yang mengubah satu, beberapa, atau semua lembar kerja dari satu Excel buku kerja menjadi terstruktur JSON, menggunakan baris pertama setiap lembar sebagai judul kolom. Gunakan ini untuk memasukkan data lembar kerja ke dalam sebuah API, impor basis data, atau JSON mengarsipkan tanpa menulis kode parsing apa pun.

Apa yang dilakukan oleh tindakan ini?

PDF4me Lembar Kerja Ekstrak mengambil sebuah Excel berkas ditambah pilihan lembar kerja opsional dan mengembalikan JSON Objek dengan satu kunci untuk setiap nama lembar kerja yang diekstrak. Setiap kunci menyimpan array objek baris yang dibangun dari baris header dan baris data lembar kerja tersebut, dengan angka, tanggal, boolean, dan teks yang dipertahankan dalam format aslinya. JSON jenis.

Postingan Blog Terkait
Belum ada postingan blog untuk fitur ini — akan segera hadir.
Sementara itu, jelajahi blog PDF4me untuk menemukan tutorial dan alur kerja di berbagai platform.
Kunjungi blog ini →

Memverifikasi Identitas Anda API Meminta​

Untuk mengakses PDF4me Web API melalui Power AutomateSetiap permintaan harus menyertakan validitas API Kunci. Otentikasi memvalidasi identitas Anda dan memungkinkan konektor untuk terhubung. PDF4me'S Excel Layanan ekstraksi lembar kerja dari alur kerja Anda.

Get your API Key

Fakta Penting yang Tidak Boleh Anda Lewatkan​

Pilihan kosong berarti semua lembar kerja
Biarkan kolom Nama Lembar Kerja dan Indeks Lembar Kerja kosong untuk mengekstrak semua lembar kerja dalam buku kerja dalam satu kali panggilan.
Nama dan pilihan indeks digabungkan sebagai satu kesatuan.
Jika kedua kolom diisi, setiap lembar kerja yang cocok dengan salah satu daftar akan diekstrak sekali, bukan hanya yang cocok dengan keduanya.
Indeks lembar kerja berbasis 0.
Indeks 0 adalah lembar kerja pertama, indeks 1 adalah lembar kerja kedua, dan seterusnya. Perbandingan Nama Lembar Kerja peka terhadap huruf besar dan kecil.
Tindakan Power Automate PDF4me Excel Extract Worksheets yang menampilkan kolom File Content, File Name, Worksheet Names, dan Worksheet Indexes.

Petakan Konten File dan Nama File dari tindakan sebelumnya, lalu atur Nama Lembar Kerja dan/atau Indeks Lembar Kerja, atau biarkan keduanya kosong untuk mengekstrak semua lembar kerja.

Parameter​

Diperlukan: Isi berkas dan Nama berkas harus selalu disertakan. Nama Lembar Kerja dan Indeks Lembar Kerja bersifat opsional; membiarkannya kosong akan mengekstrak semua lembar kerja.

ParameterDiperlukanApa fungsinya?Contoh
File ContentRequiredBase64 or buffer content of the source Excel file, typically mapped from a prior action like SharePoint or OneDrive Get File Content.[File Content from Get File]
File NameConditionalName of the Excel file including its extension. Shown as a plain field in the connector UI and used for processing and output naming; supply it even though the connector does not mark it with an asterisk.data.xlsx
Worksheet NamesOptionalComma-separated list of worksheet names to extract. Case-sensitive, and combines with Worksheet Indexes as a union when both are set.Employees,Sales
Worksheet IndexesOptionalComma-separated list of 0-based worksheet indexes to extract, for example "0,2,4" for the first, third, and fifth sheets.0,2,4

Apa yang Dikembalikan oleh Lembar Kerja Ekstraksi?​

BidangJenisIsi di dalamnya
documentBase64The extracted JSON data as a byte array, saved as a .txt file, keyed by worksheet name.
FileNameStringOutput file name with a .txt extension.
SuccessBooleantrue when extraction completed, false if the request failed validation or processing.
Error MessageStringDescription of what went wrong, null when Success is true.
ErrorsArrayDetailed error entries, empty when Success is true.
{
  "document": "[Base64 JSON Data]",
  "FileName": "report.txt",
  "Success": true,
  "ErrorMessage": null,
  "Errors": []
}

Contoh isi dokumen yang telah didekode:

{
  "Employees": [
    {"Name": "John Doe", "Age": 30, "Department": "IT"},
    {"Name": "Jane Smith", "Age": 28, "Department": "HR"}
  ],
  "Sales": [
    {"Product": "Widget", "Units": 100, "Revenue": 2500.00},
    {"Product": "Gadget", "Units": 75, "Revenue": 1875.00}
  ]
}

Pesan Kesalahan Umum​

Pesan KesalahanMenyebabkanLarutan
Request is emptyRequest object is null.Provide a valid request object.
Document is emptyDocument object is null or DocData is null.Provide a valid Excel document.
Workbook contains no worksheetsExcel file has 0 worksheets.Provide a valid Excel file with at least one worksheet.
Invalid worksheet selectionWorksheet name does not exist or index is out of range.Use valid worksheet names or 0-based indexes.
Available worksheets in workbook (X total)Informational message appended when worksheet selection validation fails.Review worksheet names or indexes and use valid values from the X available worksheets listed.

Bagaimana Cara Saya Menyiapkan Lembar Kerja Ekstraksi di Power Automate?​

  1. Menambahkan PDF4me → Lembar Kerja Ekstrak untuk Anda Power Automate mengalir.
  2. Peta Isi File Dan Nama File dari tindakan sebelumnya, seperti SharePoint atau OneDrive Dapatkan Isi File.
  3. Mengatur Nama Lembar Kerja, Indeks Lembar Kerja, keduanya, atau biarkan keduanya kosong untuk mengekstrak semua lembar kerja.
  4. Jalankan alur kerja. Baris pertama dari setiap lembar kerja yang dipilih akan menjadi... JSON kunci, dan hasilnya dikembalikan sebagai document, dikodekan Base64 JSON Objek diindeks berdasarkan nama lembar kerja.

Kapan Sebaiknya Saya Menggunakan Nama Lembar Kerja Dibandingkan Indeks Lembar Kerja?​

Menggunakan Nama Lembar Kerja Saat lembar target memiliki nama yang stabil dan dikenal, seperti "Summary" atau "ClientData", karena pilihan tetap benar meskipun urutan lembar berubah. Gunakan Indeks Lembar Kerja Ketika alur kerja menghasilkan buku kerja dengan urutan lembar yang dapat diprediksi tetapi nama yang bervariasi. Mengatur keduanya akan mengekstrak gabungan dari kedua pilihan, sehingga tumpang tindih di antara keduanya tidak akan menduplikasi lembar kerja dalam output.

Pengaturan Umum​

Contoh Alur KerjaCommon Power Automate flow patterns using Extract Worksheets from Excel.
Buku kerja multi-lembar untuk API memberi makan
  1. Alur dipicu ketika beberapa lembar Excel buku kerja diunggah ke SharePoint Folder "Ekspor Data".
  2. Fungsi Get File Content mengambil isi buku kerja.
  3. Fungsi Extract Worksheets dijalankan dengan Nama Lembar Kerja dan Indeks Lembar Kerja dibiarkan kosong untuk mengonversi setiap lembar kerja.
  4. Menguraikan JSON memproses hasilnya, dan sebuah perulangan "Terapkan ke setiap" mengirimkan data setiap lembar kerja ke lembar kerjanya masing-masing. API titik akhir.
Terjadwal JSON arsip
  1. Pemicu pengulangan menjalankan alur pengarsipan bulanan.
  2. Get File Content mengambil proyek yang sudah selesai. Excel berkas dari SharePoint.
  3. Extract Worksheets mengkonversi setiap buku kerja menjadi JSON dengan semua seprai disertakan.
  4. Yang JSON output disimpan ke Azure Blob Storage atau SharePoint bersama dengan file arsip aslinya.
Ekspor klien selektif
  1. Permintaan pengiriman melalui Microsoft Forms meminta ekspor data khusus klien.
  2. Get File Content mengambil buku kerja utama dari lokasi yang aman. SharePoint perpustakaan.
  3. Fungsi Ekstrak Lembar Kerja dijalankan dengan Nama Lembar Kerja yang hanya diatur ke lembar kerja yang diizinkan untuk dilihat oleh klien, misalnya "Ringkasan,DataKlien".
  4. Hasilnya JSON Dikirim melalui email kepada pemohon, dengan sepenuhnya mengabaikan lembar internal yang tidak terkait dari ekspor.

Tips Praktis​

Leave both selection fields blank for a full export
Extracting every worksheet in one call is simpler than chaining several Extract Worksheets actions when a flow needs the whole workbook as JSON.
Match Worksheet Names exactly, including case
Worksheet name comparison is case-sensitive. A mismatch returns an invalid worksheet selection error even if the name looks correct at a glance.
Remember Worksheet Indexes start at 0
Index 0 is the first sheet, not the second. Off-by-one index values are a common source of the wrong worksheet being extracted.
Combining names and indexes extracts a union, not an intersection
If a worksheet matches either list, it is included once. Use only one selection method if you need precise, predictable output.
Parse JSON before looping through worksheets
The output document decodes to an object keyed by worksheet name, so a Parse JSON action followed by Apply to each on the object's keys is the standard pattern for per-sheet processing.

Lembar Panduan Singkat​

BidangNilai
ActionExtract Worksheets
File ContentMapped from a prior file-retrieval action
File Namee.g. data.xlsx
Worksheet NamesComma-separated, case-sensitive, or blank
Worksheet Indexes0-based, comma-separated, or blank
Blank + blankExtracts all worksheets
Both filledUnion of name matches and index matches
Outputdocument (Base64 JSON, .txt), FileName, Success, Error Message, Errors

Pertanyaan Umum​

How do I convert an Excel worksheet to JSON in Power Automate?+
Add the PDF4me Extract Worksheets action, map File Content and File Name from a prior action, then set Worksheet Names or Worksheet Indexes to choose which sheets to convert. Leaving both blank extracts every worksheet, returning a JSON document keyed by worksheet name. See the connector reference below for the full action list.
What happens if I leave Worksheet Names and Worksheet Indexes both blank?+
The action extracts every worksheet in the workbook and returns them all as JSON, one array per worksheet name in the output document. This is the simplest setup for a full workbook-to-JSON export.
Can I select worksheets by name and by index in the same request?+
Yes. If both Worksheet Names and Worksheet Indexes are provided, the action extracts the union of the two selections, so any worksheet matching either the name list or the index list is included once in the result.
Are Worksheet Indexes 0-based or 1-based?+
Worksheet Indexes are 0-based, so index 0 refers to the first worksheet, index 1 to the second, and so on. See <a href="https://learn.microsoft.com/en-us/office/dev/scripts/resources/samples/get-table-data" target="_blank" rel="noopener noreferrer">Microsoft's guide to reading Excel table data</a> for how worksheet and range indexing works natively in Excel.
What does the output JSON look like?+
The output document is a JSON object with one key per extracted worksheet name, and each key holds an array of row objects built from that sheet's header row and data rows, with numbers, dates, booleans, and text preserved in their native JSON types. See <a href="https://learn.microsoft.com/en-us/connectors/pdf4meconnect/" target="_blank" rel="noopener noreferrer">the PDF4me Power Automate connector reference</a> for the full action list.

Studi Kasus & Aplikasi Industri​

Studi Kasus Integrasi TI & Sistem

  • Migrasi SistemEkspor seluruh buku kerja Excel sebagai JSON untuk migrasi sistem.
  • Integrasi Multi-API: Mengirim lembar kerja yang berbeda ke titik akhir API yang berbeda
  • Pencadangan DataBuat cadangan JSON dari file Excel multi-lembar.
  • Migrasi CloudKonversikan buku kerja Excel ke JSON untuk penyimpanan cloud.

Tindakan Terkait​

Tugas yang Sama di Platform Lain​

Dapatkan Bantuan​

PDF4me ConnectGet your API KeyPower Automate Documentation