rpaframework
1.0.0
我們正在考慮改進關鍵字的使用，以涵蓋開發人員可能難以順利地為機器人編寫任務的情況。描述由於缺乏更簡單的語法而導致實現速度變慢的情況。
在這裡評論
RPA Framework 是機器人流程自動化 (RPA) 的開源程式庫和工具的集合，旨在與 Robot Framework 和 Python 一起使用。目標是為軟體機器人開發人員提供記錄良好且積極維護的核心庫。
在 Robocorp 文件中了解有關 RPA 的更多資訊。
該項目是：
從上面的套件中， rpaframework -core和rpaframework -recognition是支援包，它們本身不包含任何函式庫。
RPA框架專案目前包含以下程式庫：
PACKAGE欄位中的x表示該函式庫包含在rpaframework套件中，例如。 x,pdf表示rpaframework和rpaframework -pdf套件中都提供了RPA.PDF庫。
| 圖書館名稱 | 描述 | 包裹 |
| 檔案 | 歸檔 TAR 和 ZIP 文件 | x |
| 助理 | 向使用者顯示資訊並請求輸入。 | 助理 |
| 瀏覽器.Selenium | 控制瀏覽器並使網頁自動化 | x |
| 瀏覽器劇作家 | 控制瀏覽器的新方法 | 特別（更多見下文） |
| 日曆 | 用於日期和時間操作 | x |
| 雲.AWS | 使用亞馬遜AWS服務 | x,AWS |
| 雲.Azure | 使用微軟Azure服務 | x |
| Google雲 | 使用 Google Cloud 服務 | |
| 加密貨幣 | 常見的哈希和加密操作 | x |
| 資料庫 | 與資料庫交互 | x |
| 桌面 | 跨平台桌面自動化 | x |
| 桌面.剪貼板 | 與系統剪貼簿交互 | x |
| 桌面作業系統 | 讀取作業系統資訊並操作進程 | x |
| 文件人工智慧 | 智慧型文檔處理包裝器 | x |
| 文檔AI.Base64AI | 智慧型文件處理服務 | x |
| DocumentAI.Nanonets | 智慧型文件處理服務 | x |
| 電子郵件交換 | 電子郵件操作（Exchange 協定） | x |
| 電子郵件.ImapSmtp | 電子郵件操作（IMAP 和 SMTP） | x |
| Excel.應用程式 | 控制 Excel 桌面應用程式 | x |
| Excel.文件 | 直接操作Excel文件 | x |
| 檔案系統 | 讀取和操作檔案和路徑 | x |
| 文件傳輸協定 | 與 FTP 伺服器交互 | x |
| HTTP協定 | 直接與 Web API 交互 | x |
| 集線器點 | 存取 HubSpot CRM 資料對象 | 中心點 |
| 圖片 | 操作影像 | x |
| Java訪問橋 | 控制Java應用程式 | x |
| JSON | 操作 JSON 對象 | x |
| 藝術碩士 | 使用一次性密碼 (OTP) 和 OAuth2 進行身份驗證 | x |
| 通知者 | 使用不同的服務通知訊息 | x |
| 開放人工智慧 | 人工智慧服務 | 開放性 |
| 展望.應用 | 控制 Outlook 桌面應用程式 | x |
| 閱讀和建立 PDF 文檔 | x,pdf | |
| Robocorp流程 | 使用 Robocorp 流程 API | x |
| Robocorp.工作項目 | 使用 Robocorp 工作項 API | x |
| Robocorp.Vault | 使用 Robocorp Secrets API | x |
| Robocorp.Storage | 使用 Robocorp 資產儲存 API | x |
| 銷售人員 | 銷售人員營運 | x |
| 樹液 | 控制 SAP GUI 桌面用戶端 | x |
| 智慧表 | 造訪 Smartsheet 工作表 | x |
| 表格 | 操作、排序和篩選表格數據 | x |
| 任務 | 控制任務執行 | x |
| 嘰嘰喳喳 | 推特API介面 | x |
| 視窗 | Windows 自動化的替代函式庫 | x、視窗 |
| 文字應用 | 控制 Word 桌面應用程式 | x |
RPA.Browser.Playwright目前需要特殊安裝，因為套件大小和安裝後步驟需要完全安裝。
安裝 Playwright 所需的最低 conda.yaml：
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 在安裝 Python 套件中了解有關安裝 Python 套件的資訊。
使用 conda.yaml 的 Robocorp 開發人員工具的預設安裝方法：
channels :
- conda-forge
dependencies :
- python=3.9.16
- pip=22.1.2
- pip :
- rpaframework ==24.1.2要安裝所有額外的軟體包（包括 Playwright 依賴項），您可以使用：
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單獨安裝 AWS、PDF 和 Windows 庫，無需主rpaframework ：
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 default使用Python venv透過pip安裝方法：
python -m venv .venv
source .venv/bin/activate
pip install rpaframework筆記
需要 Python 3.8 或更高版本
安裝後，可以將程式庫直接匯入到 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 }這些函式庫也可以在 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 )發現錯誤？缺少一個關鍵功能？有興趣貢獻嗎？請參閱貢獻指南以了解從哪裡開始。
儲存庫開發基於 Python，並且至少需要在開發電腦上安裝 Python 版本 3.8+。 Robocorp Robot 範本中使用的預設 Python 版本是 3.9.16，因此它是安裝版本的好選擇。不建議的版本是 3.7.6 和 3.8.1，因為它們與rpaframework相關的一些依賴項有問題。目前也不建議從 3.11 開始使用較新的 Python 版本，因為某些依賴項可能會導致問題。
存儲庫開發工具基於詩歌和調用。 Poetry 是用於編譯、建置和運行套件的底層工具。 Invoke 用於腳本編寫目的，例如用於 linting、測試和發布任務。
在編寫任何程式碼之前，請閱讀並確認我們廣泛的開髮指南。
開始開發的第一步：
poetry config virtualenvs.path null
poetry config virtualenvs.in-project true
poetry config repositories.devpi " https://devpi.robocorp.cloud/ci/test "git 克隆儲存庫
建立一個新的 Git 分支或切換到正確的分支或保留在 master 分支
poetry install將套件及其依賴項安裝到套件的.venv目錄中，例如packages/main/.venv
如果針對使用devdata/env.json 的Robocorp 機器人進行測試
poetry build在 Robot conda.yaml中建立並使用生成的 .whl 檔案（在dist/目錄中）poetry build並將生成的 .whl 檔案（在dist/目錄中）推送到儲存庫中，並使用原始 url 將其包含在 Robot conda.yaml中poetry publish --ci並點conda.yaml在devpi中使用rpaframework版本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以確保程式碼格式符合rpaframework儲存庫指南。如果開發人員沒有檢查程式碼更改，Github 操作很可能會失敗。程式碼格式化基於 black 和 flake8，並且透過invoke lint運行。
庫文件可以在儲存庫根目錄（所謂的「元」包層級）中建立。該文件是由 docgen 工具使用項目的本機安裝版本構建的，每次生成文件時都會反映主包的本地更改，但如果您想查看可選包的本地更改，則必須使用invoke install-local --package <package_name>使用適當的套件名稱（例如rpaframework -aws ）。這會將該套件重新安裝為本機可編輯版本，而不是從 PyPI 重新安裝。可以透過重複使用--package選項來新增多個此類套件。為了重置它，請使用invoke install --reset 。
poetry update和/或invoke install-local --package <package name>make docsdocs/build/html/index.html以查看變更或執行make local並導航至localhost:8000以將文件作為即時本機網頁檢視。 # 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 （這將運行包中定義的Python單元測試和robotframework測試/目錄）
poetry run pytest path/to/test.py::test_functioninv testrobot -r <robot_name> -t <task_name>git 提交更改
git 將更改推送到遠端
從分支建立拉取請求，描述描述中包含的更改
更新docs/source/releasenotes.rst進行更改（提交和推送）
打包和發布是在更改合併到主分支後完成的。以下所有步驟應在 master 分支內完成。
invoke lint和invoke testpoetry updateinvoke publish一些推薦的開發工具
Visual Studio Code 作為程式碼編輯器，具有以下擴充功能：
- 機器人公司程式碼
- 機器人框架語言伺服器
- 吉特透鏡
- Python 擴充
GitHub Desktop 將使版本管理不易出錯
該專案是開源的，並根據 Apache License 2.0 的條款獲得許可。
