Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Unggul
Tindakan Excel memungkinkan Anda membaca, memperbarui, dan membuat file Excel di otomatisasi Anda. Semua tindakan Excel mendukung format file.xlsx dan .xlsm. Pengidentifikasi buku kerja mempertahankan referensi di beberapa operasi.
catatan
Sementara nilai dapat dibaca dari file.xlsm, eksekusi makro tidak didukung.
Buat Buku Kerja Baru
Membuat file Excel kosong. Mengeluarkan pengenal buku kerja yang dapat Anda gunakan untuk memperbarui spreadsheet pada langkah selanjutnya.
Properti:
Pengidentifikasi Buku Kerja (output): Nama variabel yang menyimpan referensi buku kerja untuk tindakan masa depan (default:)
workbook_id
Buka Buku Kerja yang Ada
Memuat file Excel yang ada. Mengembalikan pengenal buku kerja yang dapat Anda gunakan untuk memperbarui spreadsheet dalam langkah selanjutnya. Hanya mendukung file Excel (.xlsx).
Properti:
File Excel (wajib): File xlsx yang akan dibuka, biasanya disimpan dalam variabel (mis.,)
my_filePengidentifikasi Buku Kerja (output): Nama variabel menyimpan referensi buku kerja (default:)
workbook_id
Persyaratan File:
Harus berupa file Excel (.xlsx) yang valid
File harus dapat diakses sebagai objek file media
Simpan Buku Kerja
Menyimpan pembaruan ke file Excel. Memungkinkan Anda memperbarui nama file dan jenis file untuk buku kerja yang disimpan.
Properti:
Nama File (wajib): Nama untuk file yang disimpan tanpa ekstensi (mis., “Laporan Bulanan”)
Jenis File (dropdown): Format output - saat ini mendukung XLSX (default: XLSX)
File Tersimpan (output): Variabel menyimpan objek file yang disimpan (default:
saved_file)
Baca Lembar
Mendapat data dari berbagai sel. Tindakan menyimpan output dalam variabel tabel data.
Properti:
Pengenal Buku Kerja (wajib): Buku kerja untuk dibaca (mis.,)
workbook_idNama Lembar (wajib): Lembar kerja atau nama tab (default: “Sheet1")
Rentang Sel (opsional): Spesifikasi rentang - mendukung berbagai format:
Sel awal: “A2" (membaca semua data dari titik jangkar)
Rentang yang tepat: “A1: B10"
Rentang kolom: “A: B”
Rentang baris: "1:3”
Kosong: membaca seluruh lembar
Sertakan Header (kotak centang): Memperlakukan baris pertama sebagai header kolom saat diaktifkan. Saat dinonaktifkan, gunakan penamaan default (Kolom0, Kolom1, dll.) (default: BENAR)
Tabel Data (output): Variabel menyimpan data yang diekstraksi (default:
excel_table)
Penanganan Formula:
Tindakan secara otomatis menghitung rumus dan menyimpan hasil dalam tabel data.
Baca Sel
Mendapat nilai dari sel. Digunakan untuk membaca nilai sel individu dari lembar kerja.
Properti:
Pengenal Buku Kerja (wajib): Buku kerja untuk dibaca (mis.,)
workbook_idNama Lembar (wajib): Nama lembar kerja (default: “Sheet1")
Referensi Sel (wajib): Lokasi sel (misalnya, “A1")
Nilai Sel (output): Variabel menyimpan konten sel (default:
cell_value)
Menulis ke Lembar
Mengeluarkan tabel data ke lembar. Digunakan untuk menulis berbagai baris dan kolom ke lembar kerja.
Properti:
Tabel Data (wajib): Tabel data untuk menulis (misalnya,
my_table)Pengidentifikasi Buku Kerja (wajib): Buku kerja target (mis.,)
workbook_idNama Lembar (wajib): Lembar kerja target (default: “Sheet1")
Mulai di Sel (opsional): Posisi awal untuk penempatan data (default: “A1")
Sertakan Header (kotak centang): Menulis header kolom saat diaktifkan (default: TRUE)
Menulis ke Cell
Mengeluarkan nilai ke sel. Digunakan untuk memperbarui sel individual dalam lembar kerja.
Properti:
Nilai untuk Ditulis (wajib): Konten untuk sel (mis., “Urutan #12345 “)
Pengidentifikasi Buku Kerja (wajib): Buku kerja target (mis.,)
workbook_idNama Lembar (wajib): Lembar kerja target (default: “Sheet1")
Referensi Sel (wajib): Lokasi sel target (misalnya, “A1")
Tulis Baris Baru
Menambahkan deretan data ke lembar. Baris baru ditambahkan ke akhir data yang ada.
Properti:
Nilai Baris (wajib): Array nilai untuk baris baru, mulai dari kolom pertama (misalnya, ["Q1", “Sales”, 100])
Pengidentifikasi Buku Kerja (wajib): Buku kerja target (mis.,)
workbook_idNama Lembar (wajib): Lembar kerja target (default: “Sheet1")
Validasi Data:
Harus memberikan nilai sebagai format array
Nilai ditulis secara berurutan mulai dari kolom pertama
Buat Lembar Baru
Menambahkan lembar kerja kosong. Lembar baru ditambahkan ke akhir buku kerja.
Properti:
Pengidentifikasi Buku Kerja (wajib): Buku kerja target (mis.,)
workbook_idNama Lembar (wajib): Nama untuk lembar kerja baru (mis., “Data Penjualan”)
Lembar Salinan
Membuat salinan lembar kerja. Lembar baru dibuat dalam buku kerja yang sama.
Properti:
Pengidentifikasi Buku Kerja (wajib): Buku kerja target (mis.,)
workbook_idNama Lembar untuk Disalin (wajib): Nama lembar kerja sumber (misalnya, “Lembar Asli”)
Nama Lembar Baru (wajib): Nama untuk lembar duplikat (mis., “Lembar Asli (Salin)”)
Ganti Nama Lembar
Memperbarui nama lembar kerja yang ada.
Properti:
Pengidentifikasi Buku Kerja (wajib): Buku kerja target (mis.,)
workbook_idNama Lembar Saat Ini (wajib): Nama lembar kerja yang ada (misalnya, “Sheet1")
Nama Lembar yang Diperbarui (wajib): Nama baru untuk lembar kerja (misalnya, “Data Q1")
Hapus Lembar
Menghapus lembar dari buku kerja. Tidak dapat menghapus lembar terakhir buku kerja yang tersisa.
Properti:
Pengidentifikasi Buku Kerja (wajib): Buku kerja target (mis.,)
workbook_idNama Lembar untuk Dihapus (wajib): Lembar kerja untuk dihapus (misalnya, “Sheet1")
Kendala:
Tidak dapat menghapus lembar terakhir yang tersisa di buku kerja
Atur Warna Sel
Memperbarui warna latar belakang sel. Digunakan untuk menyoroti rentang sel tertentu.
Properti:
Warna Sel (wajib): Format kode hex RGB (misalnya, “FF0000" untuk merah)
Pengidentifikasi Buku Kerja (wajib): Buku kerja target (mis.,)
workbook_idNama Lembar (wajib): Lembar kerja target (misalnya, “Sheet1")
Rentang Sel (wajib): Rentang ke format - mendukung:
Sel tunggal: “A1"
Rentang yang tepat: “A1: B10"
Rentang kolom: “A: B”
Rentang baris: "1:3”
Dapatkan Warna Sel
Membaca warna latar belakang sel. Mengeluarkan warna dalam format kode hex RGB (misalnya, "FF0000" untuk merah).
Properti:
Pengidentifikasi Buku Kerja (wajib): Buku kerja sumber (mis.,)
workbook_idNama Lembar (wajib): Lembar kerja sumber (misalnya, “Sheet1")
Referensi Sel (wajib): Sel untuk dibaca (mis., “A1")
Warna Sel (output): Variabel menyimpan kode hex RGB (default:)
cell_color
Sembunyikan Baris
Membuat baris tersembunyi di lembar. Data tetap utuh tetapi tidak terlihat.
Properti:
Pengidentifikasi Buku Kerja (wajib): Buku kerja target (mis.,)
workbook_idNama Lembar (wajib): Lembar kerja target (misalnya, “Sheet1")
Start Row (wajib): Nomor baris pertama untuk disembunyikan (penomoran Excel dimulai pada 1)
Baris Akhir (opsional): Nomor baris terakhir untuk disembunyikan. Jika kosong, hanya baris awal yang disembunyikan
Penomoran Baris:
Nomor baris Excel mulai dari 1 (bukan 0)
Harus memberikan nilai integer
Perlihatkan Baris
Membuat baris tersembunyi terlihat. Digunakan untuk menampilkan baris yang sebelumnya tersembunyi.
Properti:
Pengidentifikasi Buku Kerja (wajib): Buku kerja target (mis.,)
workbook_idNama Lembar (wajib): Lembar kerja target (misalnya, “Sheet1")
Start Row (wajib): Nomor baris pertama untuk ditampilkan (penomoran Excel dimulai pada 1)
Baris Akhir (opsional): Nomor baris terakhir untuk ditampilkan. Jika kosong, hanya baris awal yang dibuat terlihat
Praktik dan batasan terbaik
Manajemen Pengidentifikasi Buku Kerja
Simpan pengidentifikasi buku kerja dalam variabel deskriptif (misalnya,,)
sales_workbookreport_fileGunakan kembali pengenal yang sama di beberapa tindakan pada buku kerja yang sama
Selalu buat atau buka buku kerja sebelum melakukan operasi data
Spesifikasi Rentang
Gunakan rentang yang tepat (“A1: B10") untuk operasi data yang tepat
Gunakan rentang kolom (“A: B”) saat bekerja dengan seluruh kolom
Gunakan rentang baris (” 1:3 “) untuk operasi header atau ringkasan
Biarkan rentang kosong untuk memproses seluruh lembar
Optimalisasi Kinerja
Baca seluruh rentang bila memungkinkan, bukan sel individu
Operasi penulisan batch menggunakan tabel data daripada penulisan sel individu
Simpan buku kerja hanya ketika semua modifikasi selesai
Batasan
Kompatibilitas file terbatas pada format Excel modern (.xlsx) saja - file Excel lama (.xls) tidak didukung.