--- sourceDocument: Yokohama データと自動化 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama データと自動化 ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Universal App Connector の使用 # Universal App Connector の使用 {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：9分 Universal App Connector (UAC) を使用して、Windows、Java、Google Chrome、Edge ブラウザーベースのアプリケーションの自動化を作成します。単一の統合コネクタからアプリケーションを構成し、画面と要素、またはチェックボックスやボタンなどの画面コントロールをキャプチャします。こうした画面と要素のメソッドを使用して、自動化をビルドします。 ## 始める前に コネクタを使用する前に、プラグインマネージャーから Universal App Connector プラグインを追加します。SSH プラグインの追加の詳細については、「[RPA デスクトップデザインスタジオ でのプラグインの管理](https://servicenow-prod.fluidtopics.net/yasEQWHklAT3eKexTMB9tA "RPA デスクトップデザインスタジオ で無人および有人の自動化プロジェクトを作成する際に、自動化を設計するためのプラグインをインストール、更新、削除します。")」を参照してください。 開いているかアクティブな Windows、Java、Google Chrome または Edge アプリケーションがあることを検証します。 必要なロール：なし ## 手順 1. \[ツールボックス\] ペインで、\[コネクタ\] に移動し、\[Universal App Connector\] を \[プロジェクトエクスプローラー (Project Explorer)\] ペインの \[グローバルオブジェクト (Global Objects)\] にドラッグします。 コネクタは、\[UniversalApplication\] として、\[グローバルオブジェクト (Global Objects)\] に追加されます。 2. \[Universal App Connector\] のコネクタレベルでメソッドを使用するには、\[UniversalApplication\] オブジェクトをダブルクリックします。 | メソッド名 | 参照 | | クリック | [Universal App Connector の Click メソッドの使用](https://servicenow-prod.fluidtopics.net/DCy~6rlsMfAsk~Z0K2J3Mw "Click メソッドを使用して、要素に対してクリックアクションを実行します。") | | GetValue | [Universal App Connector の GetValue メソッドの使用](https://servicenow-prod.fluidtopics.net/sZhJCIsB3d7IqMFeaU3kGQ "GetValue メソッドを使用して、要素から値を取得します。") | | SetValue | [Universal App Connector の SetValue メソッドの使用](https://servicenow-prod.fluidtopics.net/ilzRRgdza9ZYNwlrk0D8tg "SetValue メソッドを使用して、指定した値を要素にアサインします。") | | 左寄せ | [Universal App Connector の Start メソッドの使用](https://servicenow-prod.fluidtopics.net/u4XCYhb2J95sO73FxD6yzw "Start メソッドを使用して、Universal App Connector (UAC) オブジェクトのブラウザーまたはアプリケーションを起動します。このメソッドは、アプリケーション画面または要素を操作する前にブラウザーまたはアプリケーションを起動する場合に使用できます。") | | WaitForAnyScreen | [Universal App Connector での WaitForAnyScreen メソッドの使用](https://servicenow-prod.fluidtopics.net/DMlVCuTbzInL92mZeXY8ow "1 つ以上のアプリケーション画面を検索し、必要に応じて指定した期間内にそれらの子要素を検索し、指定したアクションを実行します。") | |-|-| {#configure-uac__choicetable_cfy_s5s_bfc} たとえば、アプリケーション画面または要素を操作する前にブラウザーまたはアプリケーションを起動する場合は、Start メソッドを使用します。 メソッドが \[オブジェクトエクスプローラー (Object Explorer)\] ペインに表示されます。 3. UAC で画面と要素を構成するには、次の手順を実行します。 1. \[グローバルオブジェクト (Global Objects)\] で \[UniversalApplication\] を右クリックし、\[構成\] を選択します。 2. \[画面と要素の構成 (Configure screens and elements)\] ウィンドウで、\[ 開いているウィンドウから選択 (Choose from an open window )\] ドロップダウン (\[ ![開いているウィンドウから選択\] ドロップダウン]()) を選択し、アプリケーション画面を選択します。 注: * サポートされているアプリケーションが開いていない場合は、「`アプリウィンドウが見つかりません (App window not found)`」というメッセージが表示されます。 * 新しく開いたアプリケーション画面をリストに表示するには、\[クリックしてウィンドウを更新 (Click to refresh windows)\] アイコン (![\[クリックしてウィンドウを更新 (Click to refresh windows)\] アイコン]())を選択します。 {#configure-uac__ul_nht_fq1_rzb} 3. **オプション:** 開いているアプリケーションをタイプでフィルタリングするには、\[ アプリケーションタイプのすべて をフィルタリング\] アイコン ( \[ ![アプリケーションタイプをフィルタリング\] アイコン)]()を選択し、\[すべて\] またはアプリケーションタイプを選択します。 たとえば、\[Chrome\] を選択すると、Google Chrome Web ページのみが、\[開いているウィンドウから選択 (Choose from an open window)\] リストに表示されます。 たとえば、\[Windowsアプリケーション\] を選択した場合、\[開いているウィンドウから選択\] リストにはWindows画面のみが表示されます。 図 : 1. 開いているアプリケーションをフィルタリングする 4. 選択したアプリケーション画面を追加するには、\[画面の追加 (Add screen)\] を選択します。 この手順を実行した後に、画面要素をキャプチャしてアクションを実行できます。 アプリケーション画面が \[画面と要素 (Screens and elements)\] ペインに表示されます。 5. 画面から要素をキャプチャするには、\[画面と要素 (Screen and elements)\] ペインで、追加した画面を右クリックし、\[要素をキャプチャ (Capture Element)\] を選択します。 キャプチャしたアプリケーション画面にフォーカスが設定され、\[要素をキャプチャ (capture elements)\] ダイアログが表示されます。 たとえば、メモ帳などの Windows アプリケーションの要素をキャプチャする場合などです。UIA モード (UI オートメーション) を選択すると、メモ帳のスクロールバーもキャプチャされます。図 : 2. Windows アプリケーションのキャプチャダイアログ:メモ帳:UIA モード AA モード (アクティブアクセシビリティ) を選択すると、メモ帳のスクロールバーはキャプチャされません。図 : 3. Windows アプリケーションのキャプチャダイアログ:メモ帳:AA モード 6. UI 自動化とアクティブアクセシビリティの 2 つのモードに対して Universal App Connector コネクタレベルのメソッドを使用するには、 UniversalApplication オブジェクトをダブルクリックします。 UI オートメーション モードとアクティブ アクセシビリティ モードのメソッドの詳細については、「 」を参照してください。 メソッドが \[オブジェクトエクスプローラー (Object Explorer)\] ペインに表示されます。 {#configure-uac__substeps_yyp_tn1_rzb} 4. 目的のアクションについて、次のいずれかのオプションを実行します。 | オプション | アクション | | UniversalApplication の名前を変更するには | \[プロジェクトエクスプローラー (Project Explorer)\] ペインの \[グローバルオブジェクト (Global Objects )\] に移動し、 UniversalApplication を右クリックして \[ 名前の変更 (Rename)\] を選択します。 図 : 4. UniversalApplication の名前を変更 | | 画面と要素の構成中に画面の名前を変更するには | 1. \[画面と要素 (Screens and elements)\] ペインでアプリケーション画面の名前を選択します。選択したアプリケーション画面の情報が \[プロパティ\] ペインの下に表示されます。 2. \[名前\] フィールドでアプリケーション画面の名前を更新し、Enter キーを押します。 アプリケーションの名前が \[画面と要素 (Screens and elements)\] ペインで更新されます。 {#configure-uac__ol_xv1_fws_bfc} 図 : 5. アプリケーション画面名を更新する | | 画面を一意に識別するには | 画面一致ルールを使用して、画面を識別して見つけます。 実行中、プラグインは画面上のアクションを自動化するために、ターゲット画面を一意に識別する必要があります。属性の例としては、アプリケーション画面のタイトルや URL があります。属性は、\[画面と要素の構成 (Configure screens and elements)\] ウィンドウの \[画面一致ルール (Screen match rules)\] ペインに表示されます。UAC は、画面一致ルールを使用して最初に画面を識別し、要素一致ルールを使用して要素を識別してから、Click や Get Text などの要素に対してアクションを実行します。 次の図は、\[属性の一致 (Match Attributes)\] セクションで指定した同じ基準に一致する複数の要素の例を示しています。キャプチャされた要素を更新すると、複数のインスタンス (存在する場合) が表示され、括弧内に赤色で示されます。このような場合は、属性を微調整して、自動化する必要のある要素を正確に選択する必要があります。ユーザーは更新を行って、選択した条件が 1 つの要素と正確に一致するかどうかを確認できます。 | | 要素を一意に識別するには | 要素一致ルールを使用して、用意されている \[ロケーター \] セクションと \[属性の一致\] セクションの値を編集します。 実行中、プラグインは要素上のアクションを自動化するために、ターゲット画面を一意に識別する必要があります。属性は、\[画面と要素の構成 (Configure screens and elements)\] ウィンドウの \[属性の一致 (Match Attributes)\] ペインに表示されます。UAC は、画面一致ルールを使用して最初に画面を識別し、要素一致ルールを使用して要素を識別してから、Click や Get Text などの要素に対してアクションを実行します。 この画像は、キャプチャされた要素の一致ルールを示しています。 | | アプリケーション画面の要素を検索するには | キャプチャされた要素のロケーターを使用します。 詳細については、「[アプリケーション画面の要素を見つける](https://servicenow-prod.fluidtopics.net/sZXOIQkxMYfPql6CLJXsjQ "RPA デスクトップデザインスタジオで Universal App Connector (UAC) を使用しているときに、キャプチャされた要素のロケーターを使用してアプリケーション画面上の要素を検索します。")」を参照してください。 | | キャプチャされた要素内の iframe (存在する場合) へのパスを表示するには | 1. \[画面と要素 (Screens and elements)\] ペインで、要素を選択します。 2. \[詳細\] タブを選択します。 iframe が表示されます。 3. \[ロケーター\] リストからロケーターを選択して、iframe へのパスを検索します。 {#configure-uac__ol_cxl_hzs_bfc} | |-|-| {#configure-uac__choicetable_zm4_lwz_vrb} 5. **オプション:** アプリケーション画面または要素を右クリックして、\[ リフレッシュ\]、\[ 画面と要素をリフレッシュ\]、\[ フォーカス\]、\[ カスタム要素を追加\]、\[ 要素を表示\]、\[ 削除\] などの追加操作を実行します。 アプリケーション画面および要素に対して実行できるさまざまな追加操作の詳細については、「[Universal App Connector のアプリケーション画面と要素の追加オプション](https://servicenow-prod.fluidtopics.net/Znn07ZKPsScTriTLVo~0tw "追加されたアプリケーション画面とそのキャプチャされた要素に対する追加操作を検証して実行します。アプリケーション画面の追加オプションは、アプリケーションタイプに基づいて分類されます。")」を参照してください。 6. アプリケーション画面または要素の構成が完了したら、\[完了\] を選択します。 アプリケーション画面とその要素は、\[グローバルオブジェクト (Global Objects)\] の UAC オブジェクト配下に表示されます。 7. 必要なアプリケーション画面または要素をダブルクリックすると、関連するメソッドを一覧表示する \[オブジェクトエクスプローラー (Object Explorer)\] ペインが表示されます。 たとえば、Java アプリケーション画面または要素を選択すると、Java コネクタメソッドが \[オブジェクトエクスプローラー (Object Explorer)\] に表示されます。 * Java コネクタメソッドの詳細については、「[Java コネクタのメソッド](https://servicenow-prod.fluidtopics.net/NMWUwlQsZ_xQCid1E5K~nA "Java コネクタは、コネクタ、画面、および要素の各レベルのメソッドを公開します。すべてのタイプの要素には共通のメソッドがありますが、異なるメソッドもあります。")」を参照してください。 * Google Chrome および Microsoft Edge のコネクタメソッドの詳細については、「[Chromium コネクタのメソッド](https://servicenow-prod.fluidtopics.net/5TMnM8ydx5s0AuafOxdzaA "Chromium コネクタのメソッドは、アプリケーション、画面、および Google Chrome と Microsoft Edge ブラウザーの画面上の要素に対して異なるタスクを実行します。")」を参照してください。 * Windows コネクタメソッドの詳細については、「[Windows コネクタのメソッド](https://servicenow-prod.fluidtopics.net/ztK7PoCCb_dhPdPX6wEmZg "RPA デスクトップデザインスタジオ の Windows メソッドは、Windows アプリケーションとやり取りして、さまざまなタスクを実行します。コネクタは、Windows アプリケーションのさまざまなレベルでメソッドを提供します。")」を参照してください。 * {#configure-uac__ul_isz_5mx_gwb} 8. \[要素をキャプチャ (Capture elemen)\] ダイアログを使用して、必要な数の画面要素をキャプチャします。 \[要素をキャプチャ (Capture element)\] ダイアログの使用方法については、「[\[要素をキャプチャ\] ダイアログの使用](jPZ6cSpTBjWPi~RFXs4aaQ "[要素をキャプチャ] ダイアログを使用して、Web ベース、Java、または Windows アプリケーションの画面上の要素を識別してキャプチャします。")」を参照してください。 キャプチャされた画面要素は、キャプチャされたアプリケーション画面の下に要素として表示されます。 9. 必要なメソッドを、\[オブジェクトエクスプローラー (Object Explorer)\] ペインから \[デザイン面 (Design surface)\] にドラッグします。 メソッドは、\[デザイン面 (Design surface)\] にアプリケーション画面または要素名とともに表示されます。 ## 次のタスク アプリケーション画面と要素に対してさまざまなメソッドを使用して自動化を設計し、自動化を保存します。