rpaframework
1.0.0
Kami berupaya meningkatkan penggunaan kata kunci untuk mencakup situasi di mana pengembang mungkin kesulitan menulis tugas untuk Robot dengan lancar. Jelaskan situasi ketika kecepatan implementasi Anda melambat karena kurangnya sintaksis yang lebih mudah.
Beri komentar DI SINI
RPA Framework adalah kumpulan pustaka dan alat sumber terbuka untuk Robotic Process Automation (RPA), dan dirancang untuk digunakan dengan Robot Framework dan Python. Tujuannya adalah untuk menawarkan perpustakaan inti yang terdokumentasi dengan baik dan dipelihara secara aktif untuk Pengembang Robot Perangkat Lunak.
Pelajari lebih lanjut tentang RPA di Dokumentasi Robocorp.
Proyek ini adalah:
Dari paket di atas, rpaframework -core dan rpaframework -recognition merupakan paket dukungan, yang tidak berisi pustaka apa pun.
Proyek Kerangka RPA saat ini mencakup perpustakaan berikut:
Tanda x pada kolom PACKAGE berarti perpustakaan tersebut termasuk dalam paket rpaframework dan misalnya. x,pdf berarti pustaka RPA.PDF disediakan dalam paket rpaframework dan rpaframework -pdf .
| NAMA PERPUSTAKAAN | KETERANGAN | KEMASAN |
| Arsip | Mengarsipkan file TAR dan ZIP | X |
| Asisten | Menampilkan informasi kepada pengguna dan meminta masukan. | asisten |
| Peramban.Selenium | Kontrol browser dan otomatisasi web | X |
| Browser.Penulis drama | Cara baru untuk mengontrol browser | spesial (selengkapnya di bawah) |
| Kalender | Untuk manipulasi tanggal dan waktu | X |
| Awan.AWS | Gunakan layanan Amazon AWS | x, aduh |
| Cloud.Azure | Gunakan layanan Microsoft Azure | X |
| Cloud.Google | Gunakan layanan Google Cloud | |
| kripto | Operasi hashing dan enkripsi umum | X |
| Basis data | Berinteraksi dengan database | X |
| Desktop | Otomatisasi desktop lintas platform | X |
| Desktop.Papan Klip | Berinteraksi dengan clipboard sistem | X |
| Desktop.Sistem Operasi | Membaca informasi OS dan memanipulasi proses | X |
| DokumenAI | Pembungkus Pemrosesan Dokumen Cerdas | X |
| DokumenAI.Base64AI | Layanan Pemrosesan Dokumen Cerdas | X |
| DocumentAI.Nanonets | Layanan Pemrosesan Dokumen Cerdas | X |
| Email.Pertukaran | Operasi email (Protokol pertukaran) | X |
| Email.ImapSmtp | Pengoperasian email (IMAP & SMTP) | X |
| Excel.Aplikasi | Kontrol aplikasi desktop Excel | X |
| Excel.File | Memanipulasi file Excel secara langsung | X |
| Sistem File | Membaca dan memanipulasi file dan jalur | X |
| FTP | Berinteraksi dengan server FTP | X |
| HTTP | Berinteraksi langsung dengan API web | X |
| titik hub | Akses objek data HubSpot CRM | hubspot |
| Gambar | Memanipulasi gambar | X |
| JavaAccessBridge | Kontrol aplikasi Java | X |
| JSON | Memanipulasi objek JSON | X |
| Kementerian Luar Negeri | Otentikasi menggunakan kata sandi satu kali (OTP) & OAuth2 | X |
| Pemberitahu | Beri tahu pesan menggunakan layanan yang berbeda | X |
| OpenAI | Layanan Kecerdasan Buatan | terbuka |
| Outlook.Aplikasi | Kontrol aplikasi desktop Outlook | X |
| Membaca dan membuat dokumen PDF | x,pdf | |
| Robocorp.Proses | Gunakan API Proses Robocorp | X |
| Robocorp.Item Kerja | Gunakan API Item Kerja Robocorp | X |
| Robocorp.Vault | Gunakan API Rahasia Robocorp | X |
| Robocorp.Penyimpanan | Gunakan API Penyimpanan Aset Robocorp | X |
| Tenaga penjualan | Operasi tenaga penjualan | X |
| GETAH | Kontrol klien desktop SAP GUI | X |
| Lembar Cerdas | Akses lembar Smartsheet | X |
| Tabel | Memanipulasi, mengurutkan, dan memfilter data tabel | X |
| Tugas | Kontrol pelaksanaan tugas | X |
| Antarmuka API Twitter | X | |
| jendela | Perpustakaan alternatif untuk otomatisasi Windows | x, jendela |
| Kata.Aplikasi | Kontrol aplikasi desktop Word | X |
RPA.Browser.Playwright saat ini memerlukan instalasi khusus, karena ukuran paket dan langkah pasca instalasi, maka perlu diinstal sepenuhnya.
Conda.yaml minimum yang diperlukan untuk menginstal Playwright:
channels :
- conda-forge
dependencies :
- python=3.9.16
- nodejs=16.14.2
- pip=22.1.2
- pip :
- robotframework-browser==17.2.0
- rpaframework ==24.1.2
rccPostInstall :
- rfbrowser init Pelajari tentang menginstal paket Python di Menginstal Paket Python.
Metode instalasi default dengan Alat Pengembang Robocorp menggunakan conda.yaml:
channels :
- conda-forge
dependencies :
- python=3.9.16
- pip=22.1.2
- pip :
- rpaframework ==24.1.2Untuk menginstal semua paket tambahan (termasuk dependensi Playwright), Anda dapat menggunakan:
channels :
- conda-forge
dependencies :
- python=3.9.16
- tesseract=4.1.1
- nodejs=16.14.2
- pip=22.1.2
- pip :
- robotframework-browser==17.2.0
- rpaframework ==24.1.2
- rpaframework -aws==5.2.8
- rpaframework -google==7.0.3
- rpaframework -recognition==5.1.2
rccPostInstall :
- rfbrowser init Instalasi terpisah perpustakaan AWS, PDF, dan Windows tanpa rpaframework utama :
channels :
- conda-forge
dependencies :
- python=3.9.16
- pip=22.1.2
- pip :
- rpaframework -aws==5.2.8 # included in the rpaframework as an extra
- rpaframework -pdf==7.1.5 # included in the rpaframework by default
- rpaframework -windows==7.3.2 # included in the rpaframework by defaultMetode instalasi dengan pip menggunakan Python venv:
python -m venv .venv
source .venv/bin/activate
pip install rpaframeworkCatatan
Diperlukan Python 3.8 atau lebih tinggi
Setelah instalasi, perpustakaan dapat langsung diimpor ke dalam Robot Framework:
*** Settings ***
Library RPA.Browser.Selenium
*** Tasks ***
Login as user
Open available browser https://example.com
Input text id:user-name ${ USERNAME }
Input text id:password ${ PASSWORD }Perpustakaan juga tersedia di dalam Python:
from RPA . Browser . Selenium import Selenium
lib = Selenium ()
lib . open_available_browser ( "https://example.com" )
lib . input_text ( "id:user-name" , username )
lib . input_text ( "id:password" , password )Menemukan bug? Hilangnya fitur penting? Tertarik untuk berkontribusi? Buka panduan Kontribusi untuk mengetahui cara memulainya.
Pengembangan repositori berbasis Python dan memerlukan minimal Python versi 3.8+ yang diinstal pada mesin pengembangan. Versi Python default yang digunakan dalam template Robot Robocorp adalah 3.9.16 sehingga merupakan pilihan yang baik untuk menginstal versi tersebut. Versi yang tidak disarankan adalah 3.7.6 dan 3.8.1, karena memiliki masalah dengan beberapa dependensi terkait rpaframework . Saat ini versi Python yang lebih baru mulai dari 3.11 juga tidak disarankan, karena beberapa dependensi mungkin menyebabkan masalah.
Perkakas pengembangan repositori didasarkan pada puisi dan doa. Puisi adalah alat dasar yang digunakan untuk menyusun, membangun, dan menjalankan paket. Invoke digunakan untuk tujuan pembuatan skrip, misalnya untuk tugas linting, pengujian, dan penerbitan.
Sebelum menulis kode apa pun, harap baca dan pahami Panduan Pengembang kami yang ekstensif.
Langkah pertama untuk mulai mengembangkan:
poetry config virtualenvs.path null
poetry config virtualenvs.in-project true
poetry config repositories.devpi " https://devpi.robocorp.cloud/ci/test "git mengkloning repositori
buat cabang Git baru atau beralih ke cabang yang benar atau tetap di cabang master
poetry install yang menginstal paket dengan dependensinya ke direktori .venv paket tersebut, misalnya paket/main/.venv
jika menguji terhadap Robot Robocorp yang menggunakan devdata/env.json
poetry build dan gunakan file .whl yang dihasilkan (di direktori dist/ ) di Robot conda.yamlpoetry build dan dorong file .whl yang dihasilkan (di direktori dist/ ) ke dalam repositori dan gunakan url mentah untuk memasukkannya ke dalam Robot conda.yamlpoetry publish --ci dan mengarahkan conda.yaml untuk menggunakan versi rpaframework di devpi poetry run python -m robot <ROBOT_ARGS> <TARGET_ROBOT_FILE>
--report NONE --outputdir output --logtitle "Task log" poetry run python <TARGET_PYTHON_FILE>
invoke lint untuk memastikan bahwa pemformatan kode sesuai dengan pedoman repositori rpaframework . Ada kemungkinan dan kemungkinan besar tindakan Github akan gagal jika pengembang belum melaporkan perubahan kode. Pemformatan kode didasarkan pada black dan flake8 dan dijalankan dengan invoke lint .
dokumentasi perpustakaan dapat dibuat di root repositori (disebut tingkat paket "meta"). Dokumentasi dibuat oleh alat docgen menggunakan versi proyek yang diinstal secara lokal, perubahan lokal untuk paket utama akan terlihat setiap kali Anda membuat dokumen, tetapi jika Anda ingin melihat perubahan lokal untuk paket opsional, Anda harus menggunakan invoke install-local --package <package_name> menggunakan nama paket yang sesuai (misal, rpaframework -aws ). Ini akan menginstal ulang paket itu sebagai versi lokal yang dapat diedit, bukan dari PyPI. Beberapa paket tersebut dapat ditambahkan dengan mengulangi penggunaan opsi --package . Untuk mengatur ulang ini, gunakan invoke install --reset .
poetry update dan/atau invoke install-local --package <package name>make docsdocs/build/html/index.html dengan browser untuk melihat perubahan atau jalankan make local dan navigasikan ke localhost:8000 untuk melihat dokumen sebagai halaman web lokal langsung. # Before
[ tool . poetry . dependencies ]
python = " ^3.8 "
rpaframework = { path = " packages/main " , extras = [ " cv " , " playwright " , " aws " ] }
rpaframework -google = " ^4.0.0 "
rpaframework -windows = " ^4.0.0 "
# After
[ tool . poetry . dependencies ]
python = " ^3.8 "
rpaframework = { path = " packages/main " , extras = [ " cv " , " playwright " ] }
rpaframework -aws = { path = " packages/aws " }
rpaframework -google = " ^4.0.0 "
rpaframework -windows = " ^4.0.0 " invoke test (ini akan menjalankan tes unittests dan robotframework Python yang ditentukan dalam direktori paket tes/ )
poetry run pytest path/to/test.py::test_functioninv testrobot -r <robot_name> -t <task_name>git melakukan perubahan
git Push berubah menjadi jarak jauh
buat permintaan tarik dari cabang yang menjelaskan perubahan yang disertakan dalam deskripsi
perbarui docs/source/releasenotes.rst dengan perubahan (komit dan dorong)
Pengemasan dan penerbitan dilakukan setelah perubahan digabungkan ke dalam cabang master. Semua langkah berikut harus dilakukan dalam cabang master.
invoke lint dan invoke testpoetry updateinvoke publish setelah tindakan Github di cabang master semuanya berwarna hijauBeberapa alat yang direkomendasikan untuk pengembangan
Visual Studio Code sebagai editor kode dengan ekstensi berikut:
- Kode Robocorp
- Server Bahasa Kerangka Robot
- Lensa Git
- Ekstensi ular piton
GitHub Desktop akan membuat manajemen versi tidak terlalu rentan terhadap kesalahan
Proyek ini bersifat open-source dan dilisensikan berdasarkan ketentuan Lisensi Apache 2.0.
