ホーム>プログラミング関連>AI ソースコード
ダウンロード

RPA フレームワーク

ユーザー入力を要求してください!

開発者がロボットのタスクをスムーズに作成するのに苦労する可能性がある状況に対応するために、キーワードの使用方法を改善することを検討しています。簡単な構文がないために実装速度が遅くなる状況について説明します。

コメントはこちら

導入

RPA フレームワークは、ロボット プロセス オートメーション (RPA) 用のオープンソース ライブラリとツールのコレクションであり、ロボット フレームワークと Python の両方で使用できるように設計されています。目標は、ソフトウェア ロボット開発者向けに、十分に文書化され、積極的に保守されているコア ライブラリを提供することです。

RPA の詳細については、Robocorp のドキュメントをご覧ください。

プロジェクトは次のとおりです。

  • 100% オープンソース
  • ロボコープが後援
  • Robocorp Control Room と開発者ツール用に最適化
  • 外部からの貢献の受け入れ

リンク

  • ホームページ: https://www.github.com/robocorp/rpaframework/
  • ドキュメント: https://rpaframework.org/
  • PyPI: https://pypi.org/project/rpaframework/
  • リリースノート: https://rpaframework.org/releasenotes.html
  • RSS フィード: https://rpaframework.org/releases.xml

パッケージ

上記のパッケージのうち、 rpaframework -coreとrpaframework -recognitionサポート パッケージであり、これのみにはライブラリは含まれません。

図書館

RPA フレームワーク プロジェクトには現在、次のライブラリが含まれています。

たとえば、 PACKAGE列のx 、ライブラリがrpaframeworkパッケージに含まれていることを意味します。 x,pdf 、 RPA.PDFライブラリがrpaframeworkパッケージとrpaframework -pdfパッケージの両方で提供されていることを意味します。

図書館名説明パッケージ
アーカイブTAR および ZIP ファイルのアーカイブ×
アシスタントユーザーに情報を表示し、入力を要求します。アシスタント
ブラウザ.セレンブラウザを制御し、Web を自動化する×
ブラウザ.劇作家ブラウザを制御する新しい方法特別な (詳細は後述)
カレンダー日付と時刻の操作の場合×
クラウド.AWS Amazon AWS サービスを使用するx、AWS
クラウド.アズールMicrosoft Azureサービスを利用する×
クラウド.グーグルGoogle Cloud サービスを使用するグーグル
暗号一般的なハッシュ操作と暗号化操作×
データベースデータベースと対話する×
デスクトップクロスプラットフォームのデスクトップオートメーション×
デスクトップ.クリップボードシステムクリップボードと対話する×
デスクトップ.オペレーティングシステムOS情報を読み取ってプロセスを操作する×
ドキュメントAIインテリジェントなドキュメント処理ラッパー×
DocumentAI.Base64AIインテリジェント文書処理サービス×
DocumentAI.Nanonetsインテリジェント文書処理サービス×
電子メール、交換電子メール操作 (Exchange プロトコル) ×
Email.ImapSmtp電子メール操作 (IMAP および SMTP) ×
Excel.アプリケーションExcel デスクトップ アプリケーションを制御する×
Excel.ファイルExcelファイルを直接操作する×
ファイルシステムファイルとパスの読み取りと操作×
FTP FTPサーバーと通信する×
HTTP Web APIと直接対話する×
ハブスポットHubSpot CRM データオブジェクトへのアクセスハブスポット
画像画像を操作する×
JavaアクセスブリッジJavaアプリケーションの制御×
JSON JSON オブジェクトを操作する×
MFAワンタイムパスワード（OTP）とOAuth2を使用した認証×
通知者さまざまなサービスを使用してメッセージを通知する×
OpenAI人工知能サービスオープンナイ
Outlook.アプリケーションOutlook デスクトップ アプリケーションを制御する×
PDF PDF ドキュメントの読み取りと作成x,pdf
ロボコープのプロセスRobocorp プロセス API を使用する×
Robocorp.WorkItems Robocorp 作業項目 API を使用する×
ロボコープボールトRobocorp Secrets API を使用する×
ロボコープストレージRobocorp Asset Storage API を使用する×
セールスフォースSalesforceの運用×
SAP SAP GUI デスクトップ クライアントの制御×
スマートシートSmartsheet シートにアクセスする×
テーブル表形式データの操作、並べ替え、フィルタリング×
タスクタスクの実行を制御する×
ツイッターTwitter APIインターフェース×
窓Windows オートメーション用の代替ライブラリx、ウィンドウ
Word.アプリケーションWord デスクトップ アプリケーションを制御する×

RPA.Browser.Playwrightのインストール

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

メインのrpaframeworkを使用しない AWS、PDF、Windows ライブラリの個別のインストール: 

 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 以降が必要です

例

インストール後、ライブラリをロボット フレームワーク内に直接インポートできます。 

 *** 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 )

サポートと連絡先

  • ライブラリのドキュメントについてはrpaframework .org
  • Robocorp ガイドとチュートリアルのドキュメント
  • # 未解決の質問がある場合、または貢献したい場合は、Robot Framework Slack のrpaframeworkチャネルを使用してください
  • RPA について議論するロボコープ フォーラム
  • Robocorp Developers Slack でソフトウェア ロボット開発者仲間やロボコープの専門家とコミュニケーションしましょう

貢献する

バグが見つかりましたか?重要な機能が欠けていますか?貢献することに興味がありますか?どこから始めるべきかを確認するには、貢献ガイドにアクセスしてください。

発達

リポジトリの開発は Python ベースであり、開発マシンには少なくとも Python バージョン 3.8 以降がインストールされている必要があります。 Robocorp ロボット テンプレートで使用されるデフォルトの Python バージョンは 3.9.16 なので、インストールするバージョンとしてはこれが適切な選択です。 3.7.6 および 3.8.1 のバージョンは、 rpaframeworkに関連する依存関係の一部に問題があるため、推奨されません。現時点では、一部の依存関係によって問題が発生する可能性があるため、3.11 以降の新しい Python バージョンも推奨されません。

リポジトリ開発ツールは詩と呼び出しに基づいています。 Poetry は、パッケージのコンパイル、ビルド、実行に使用される基礎となるツールです。 Invoke は、タスクの lint、テスト、公開などのスクリプト作成の目的で使用されます。

コードを記述する前に、広範な開発ガイドを読んで了承してください。

開発を開始するための最初のステップ:

  1. 初期の詩の構成
poetry config virtualenvs.path null
poetry config virtualenvs.in-project true
poetry config repositories.devpi " https://devpi.robocorp.cloud/ci/test "

  1. git clone リポジトリ

  2. 新しい Git ブランチを作成するか、正しいブランチに切り替えるか、master ブランチに留まります

    • 一部のブランチの命名規則機能/機能名、ホットフィックス/問題名、リリース/リリース番号

  3. poetry installパッケージとその依存関係をパッケージの.venvディレクトリにインストールします (例: package/main/.venv)

  4. devdata/env.json を使用している Robocorp Robot に対してテストする場合

    • 環境変数を設定する
    • またはpoetry build 、結果の .whl ファイル ( dist/ディレクトリ内) をロボットのconda.yamlで使用します。
    • またはpoetry build 、結果の .whl ファイル ( dist/ディレクトリ内) をリポジトリにプッシュし、生の URL を使用してロボットのconda.yamlに含めます。
    • Robocorp 内部開発のもう 1 つの可能性は、Robocorp devpiインスタンスを使用することです。これは、 poetry publish --ciによって行い、devpi でrpaframeworkバージョンを使用するようにconda.yamlを指定します。

  5. poetry run python -m robot <ROBOT_ARGS> <TARGET_ROBOT_FILE>

    • Robocorp ロボット テンプレートからの共通ROBOT_ARGS : --report NONE --outputdir output --logtitle "Task log"

  6. poetry run python <TARGET_PYTHON_FILE>

  7. invoke lintコードのフォーマットがrpaframeworkリポジトリのガイドラインに従っていることを確認します。開発者がコード変更をリントしなかった場合、Github アクションは失敗する可能性があり、その可能性が高くなります。コードの書式設定は black と flake8 に基づいており、これらはinvoke lintて実行されます。

  8. ライブラリのドキュメントはリポジトリ ルート (いわゆる「メタ」パッケージ レベル) で作成できます。ドキュメントは、プロジェクトのローカルにインストールされたバージョンを使用して docgen ツールによって構築されます。メイン パッケージのローカル変更はドキュメントを生成するたびに反映されますが、オプション パッケージのローカル変更を確認したい場合は、 invoke install-local --package <package_name>使用する必要があります。 invoke install-local --package <package_name>には、適切なパッケージ名 (例: rpaframework -aws ) を使用します。これにより、そのパッケージが PyPI からではなくローカルの編集可能なバージョンとして再インストールされます。 --packageオプションを繰り返し使用することで、このようなパッケージを複数追加できます。これをリセットするには、 invoke install --reset 。

    • poetry updateおよび/またはinvoke install-local --package <package name>
    • make docs
    • ブラウザでdocs/build/html/index.html開いて変更を表示するか、 make localを実行してlocalhost:8000に移動してドキュメントをライブ ローカル Web ページとして表示します。 
     # 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 "

  9. invoke test (これにより、パッケージtesting/ ディレクトリで定義された Python 単体テストとロボットフレームワーク テストの両方が実行されます)

    • 特定の Python テストを実行するには： poetry run pytest path/to/test.py::test_function
    • 特定の Robotframework テストを実行するには: inv testrobot -r <robot_name> -t <task_name>

  10. git コミットの変更

  11. git Push はリモートに変更を加えます

  12. 説明に含まれる変更を説明するブランチからプルリクエストを作成します

  13. docs/source/releasenotes.rst を変更して更新します (コミットとプッシュ)

パッケージ化と公開は、変更が master ブランチにマージされた後に行われます。以下のすべての手順は、master ブランチ内で実行する必要があります。

  1. git は最新の変更を master ブランチにプルします
  2. 変更を含むパッケージ ディレクトリで、 invoke lintてinvoke test
  3. セマンティック バージョニングに従ってpyproject.toml を新しいバージョンで更新します
  4. docs/source/releasenotes.rstを変更して更新します
  5. リポジトリルート（いわゆる「メタ」パッケージレベル）でコマンドpoetry update実行します。
  6. git commit は、「PACKAGE. version xyz」というメッセージを含む、 poetry.lockファイル (メタおよびターゲット パッケージ レベル)、 releasenotes.rst 、およびpyproject.toml を変更しました。
  7. gitプッシュ
  8. master ブランチの Github アクションがすべて緑色になった後にinvoke publish

開発に推奨されるツールのいくつか

  • 次の拡張機能を備えたコード エディターとしての Visual Studio Code:

    • ロボコープコード
    • ロボット フレームワーク言語サーバー
    • GitLens
    • Python 拡張機能

  • GitHub Desktop によりバージョン管理でエラーが発生しにくくなります

ライセンス

このプロジェクトはオープンソースであり、Apache License 2.0 の条件に基づいてライセンスされています。

拡大する
追加情報
関連アプリ
おすすめ
関連情報 すべて