--- title: "クイック要素更新" slug: "quick-element-update" updated: 2024-10-01T08:47:54Z published: 2024-10-01T08:47:54Z canonical: "help.autify.com/quick-element-update" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.autify.com/llms.txt > Use this file to discover all available pages before exploring further. # クイック要素更新 ## クイック要素更新とは **クイック要素更新**は、テスト結果で意図した要素がタップされていないステップがある場合もしくは要素までスワイプステップで対象要素を見つけられていない場合、テスト結果画面から簡単に要素を再選択し、次のテスト実行時に意図した通りにタップやスワイプされるようにすることができる機能です。 クイック要素更新の魅力は、対象ステップを更新するために、Autifyレコーダーを起動して直前のステップまでを全て再生する必要がなく、再レコーディングせずに瞬時に更新が可能な点です。 またクイック要素更新は、タップ操作および要素までスワイプ操作で利用可能です。 クイック要素更新は、ステップ自体が成功したか失敗したかに関係なく利用できるため、様々な場面で役立ちます。 ## クイック要素更新を使用する テスト結果詳細画面で、意図した対象要素が見つけられていないステップを開き、画面右下「要素を更新する」ボタンをクリックすることでクイック要素更新を利用できます。 ### 1. 画像認識から更新する スクリーンショット画面から更新するとても簡単な方法です。 テスト結果スクリーンショット上で、選択したい要素をクリックし、「要素の更新」ボタンをクリックします。 画像認識による要素探索は、レコーディング時にタップもしくは要素までスワイプ操作で指定された位置周辺の見た目を元に要素を探します。そのため、要素やその要素周辺の見た目が特徴的な領域を選択すると安定して要素をタップできるようになります。 [画像認識に関するTipsの記事](/mobile/docs/ja/tips-to-stabilize-element-selection-image-recognition)もご参照ください。 ### 2. XPathを指定 (更新) する 要素の見た目が頻繁に変わるなど画像認識では安定しない場合、XPathの更新が有効な場合があります。これはページソースから取得した要素のXPathを指定するオプションです。 画面右下にある「要素を更新する」ボタンをクリックします。 そして、画面の上にあるローケータタイプから「Page Source」を選択します。 ![quick_element_update_4_jp.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/quick_element_update_4_jp%281%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A58%3A03Z&se=2026-11-06T22%3A58%3A03Z&sr=c&sp=r&sig=4koSEByH%2F9DVudSGt6NN2GCNDLxdQUOqw5MULSE8Zfk%3D) 実際の画面 (左側) とPage Source画面 (右側) が表示されますので、画面下部にある項目がXPathになっていることを確認します。 XPathとなっていない場合は、プルダウンメニューから選択してください。 ![quick_element_update_9_jp.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/quick_element_update_9_jp.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A58%3A03Z&se=2026-11-06T22%3A58%3A03Z&sr=c&sp=r&sig=4koSEByH%2F9DVudSGt6NN2GCNDLxdQUOqw5MULSE8Zfk%3D) 例えば以下の「WaterMelon」要素を指定する図ですと、Page Source画面から対象としたい要素を選択すると左側に表示されているスクリーンショットで該当箇所がハイライトされます。指定ができたら、「要素の更新」ボタンをクリックします。 ![quick_element_update_5_jp.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/quick_element_update_5_jp%281%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A58%3A03Z&se=2026-11-06T22%3A58%3A03Z&sr=c&sp=r&sig=4koSEByH%2F9DVudSGt6NN2GCNDLxdQUOqw5MULSE8Zfk%3D) また、以下のようにXPathはご自身で直接指定することも可能です。対象要素を選択するために必要な情報を取捨選択することで自動生成されたXPathよりも安定性を向上させることができます。詳しくは[XPathに関するTipsの記事](/mobile/docs/ja/tips-to-stabilize-element-selection-xpath-and-accessibility-id)をご参照ください。 ![quick_element_update_8_jp.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/quick_element_update_8_jp.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A58%3A03Z&se=2026-11-06T22%3A58%3A03Z&sr=c&sp=r&sig=4koSEByH%2F9DVudSGt6NN2GCNDLxdQUOqw5MULSE8Zfk%3D) ### 3. Accessibility IDを指定 (更新) する Accessibility IDとは、テスト自動化のため要素に指定される固有のIDです。 他の手法 (画像認識やXPathの更新) でテストを安定させることができない場合、アプリケーションの実装でAccessibility IDを追加し、テストに利用することを設定をお勧めします。 詳しくは、[Accessibility IDに関するTipsの記事](/mobile/docs/ja/tips-to-stabilize-element-selection-xpath-and-accessibility-id)をご参照ください。 XPath同様にテスト結果画面の右上「要素の更新 (XPath)」をクリックし、プルダウンメニューから「Accessibility ID」選択してください。 選択したい要素のAccessibility IDを入力し、「要素の更新」をクリックします。 ![quick_element_update_12_jp.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/quick_element_update_12_jp.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A58%3A03Z&se=2026-11-06T22%3A58%3A03Z&sr=c&sp=r&sig=4koSEByH%2F9DVudSGt6NN2GCNDLxdQUOqw5MULSE8Zfk%3D) ## クイック要素更新を使用後 いずれの方法で更新した後も、画面左上に「ステップを更新しました。シナリオを再実行」と表示されます。もし、このタイミングで再実行をされたい場合は、「シナリオを再実行」をクリックしていただくと、更新した内容で再実行が可能です。 ![element_update_rerun.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/element_update_rerun.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A58%3A03Z&se=2026-11-06T22%3A58%3A03Z&sr=c&sp=r&sig=4koSEByH%2F9DVudSGt6NN2GCNDLxdQUOqw5MULSE8Zfk%3D) また、画面下に次のいずれかが表示されます。 - 「ロケータ：画像認識」 - 「ロケータ：XPath」、 - 「ロケータ：Accessibility ID」 具体的なXPathやAccessibility IDの詳細はこの画面からは確認できません。 設定した内容を確認したい場合は、更新画面を再度開いてご確認ください。 ![quick_element_update_11.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/quick_element_update_11.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A58%3A03Z&se=2026-11-06T22%3A58%3A03Z&sr=c&sp=r&sig=4koSEByH%2F9DVudSGt6NN2GCNDLxdQUOqw5MULSE8Zfk%3D) また更新後、テスト結果画面では、以下のように「updated」と表示され、対象ステップの要素が更新されたことを確認できます。 ![quick_element_update_6.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/quick_element_update_6%281%29.png?sv=2026-02-06&spr=https&st=2026-11-06T21%3A58%3A03Z&se=2026-11-06T22%3A58%3A03Z&sr=c&sp=r&sig=4koSEByH%2F9DVudSGt6NN2GCNDLxdQUOqw5MULSE8Zfk%3D) ## 注意 - クイック要素更新で要素を更新すると、シナリオの要素とスクリーンショットが更新されます。 - クイック要素更新をしてからシナリオを複製した場合、更新内容は複製先のシナリオにも引き継がれます。シナリオを複製してからクイック要素更新をした場合、複製先のシナリオには引き継がれません。 - 「要素を更新する」は元に戻せません。最初に選択した要素と同じものを再び選択したい場合は、もう一度「要素を更新する」して同じ要素を再選択してください。 - ステップグループ内のステップの要素を更新した場合、そのステップグループを使用するすべてのシナリオに影響があります。