<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>ノウハウ - テスト自動化ツール 『Ranorex』</title>
	<atom:link href="https://ranorex.techmatrix.jp/blog/category/know-how/feed/" rel="self" type="application/rss+xml" />
	<link>https://ranorex.techmatrix.jp</link>
	<description>Windowsデスクトップ・Web・モバイルアプリ対応</description>
	<lastBuildDate>Fri, 06 Nov 2026 02:37:33 +0000</lastBuildDate>
	<language>ja</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.1.4</generator>

<image>
	<url>https://ranorex.techmatrix.jp/wp-content/uploads/cropped-RNX-new_favicon-32x32.png</url>
	<title>ノウハウ - テスト自動化ツール 『Ranorex』</title>
	<link>https://ranorex.techmatrix.jp</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>複数のプラットフォームで画像比較を成功させるための方法</title>
		<link>https://ranorex.techmatrix.jp/blog/2026/11/06/multi-platform-image-validate/</link>
		
		<dc:creator><![CDATA[Ranorex編集部]]></dc:creator>
		<pubDate>Fri, 06 Nov 2026 02:36:42 +0000</pubDate>
				<category><![CDATA[Ranorex機能]]></category>
		<category><![CDATA[ノウハウ]]></category>
		<category><![CDATA[事例・ソリューション]]></category>
		<guid isPermaLink="false">https://ranorex.techmatrix.jp/?p=33065</guid>

					<description><![CDATA[<p>※本記事は、Ranorexの画像検証に関する基礎知識をお持ちの方を対象としています。※Ranorex ハンズオンセミナー(初級・中級)を受講することで、Ranorexの画像検証について学習いただけます。 Ranorexの [&#8230;]</p>
<p>The post <a href="https://ranorex.techmatrix.jp/blog/2026/11/06/multi-platform-image-validate/">複数のプラットフォームで画像比較を成功させるための方法</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></description>
										<content:encoded><![CDATA[<div class="veu_autoEyeCatchBox"><img fetchpriority="high" decoding="async" width="693" height="504" src="https://ranorex.techmatrix.jp/wp-content/uploads/画像を成功させるための方法アイキャッチ1.jpg" class="attachment-large size-large wp-post-image" alt="" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/画像を成功させるための方法アイキャッチ1.jpg 693w, https://ranorex.techmatrix.jp/wp-content/uploads/画像を成功させるための方法アイキャッチ1-300x218.jpg 300w" sizes="(max-width: 693px) 100vw, 693px" /></div>
<p class="has-small-font-size wp-block-paragraph"><em>※本記事は、Ranorexの画像検証に関する基礎知識をお持ちの方を対象としています。</em><br><em>※Ranorex ハンズオンセミナー(<a href="https://ranorex.techmatrix.jp/handson-details/" target="_blank" rel="noopener">初級</a>・<a href="https://ranorex.techmatrix.jp/handson-intermediate-details/" target="_blank" rel="noopener">中級</a>)を受講することで、Ranorexの画像検証について学習いただけます。</em></p>



<p class="wp-block-paragraph">Ranorexの画像比較は、ピクセル単位でRGB値(赤・緑・青の色を組み合わせた数値)を参照した厳密で高精度な検証です。そのため、複数のテスト実行環境でテストする場合に、期待画像との微細な色の違いや文字・グラフィックの位置の微妙なズレなどが発生すると、規定の設定では失敗しやすくなります。</p>



<p class="wp-block-paragraph">本記事では、テスト実行環境の違いにより、人の目で認識できない微細な差分で失敗する画像比較を成功させるための設定方法について説明します。</p>



<p class="wp-block-paragraph">本記事の最後に、詳細資料を公開しておりますので、ダウンロードください。</p>



<div class="toc-001">
    <div>
        目次
        <label><input type="checkbox" checked=""></label>
    </div>
    <ol>
        <li><a href="#validation">Ranorexの画像比較</a></li>
        <li><a href="#factor">画像比較が失敗する主な要因</a></li>
        <li><a href="#solution">画像比較が失敗する主な要因の解決策</a></li>
        <li><a href="#download">資料ダウンロードのご案内</a></li>
    </ol>
</div>



<h3 id="validation" class="wp-block-heading"><strong><a>Ranorex</a>の画像比較</strong></h3>



<p class="wp-block-paragraph">テスト実行時に表示された画像が期待画像と一致しているかを判断する指標として、類似度 (Similarity)が使用されます。類似度は0.0から1.0の範囲で表され、1.0は100%の一致を意味します。具体的には、比較対象の画像のすべてのピクセルにおいて、赤（R）、緑（G）、青（B）の各色の値が完全に一致している状態を指します。このため、類似度が1.0の場合、完全一致となり、画像検証の結果は成功と判断されます。</p>



<p class="wp-block-paragraph">詳しくは、以下のイメージバリデーションのブログをご確認ください。</p>



<ul class="wp-block-list">
<li><a href="https://ranorex.techmatrix.jp/blog/2020/02/21/image-validation-summary/" target="_blank" rel="noopener"><strong>イメージ バリデーション（概要）#1</strong></a></li>
</ul>



<h3 id="factor" class="wp-block-heading"><strong>画像比較が失敗する主な要因</strong></h3>



<p class="wp-block-paragraph">Ranorexの画像比較が失敗する主な要因は、以下の通りです。</p>



<ul class="wp-block-list">
<li><strong>マシンの解像度やウィンドウサイズが統一されていない複数環境でのテスト</strong></li>



<li><strong>Windows OSの異なるバージョンでのテスト</strong></li>



<li><strong>クラウド環境でのテスト</strong></li>



<li><strong>リモートデスクトップ接続によるリモートテスト</strong></li>



<li><strong>検証対象の画像内に動的なコンテンツが含まれるテスト</strong></li>
</ul>



<h3 id="solution" class="wp-block-heading"><strong>画像比較が失敗する主な要因の解決策</strong></h3>



<p class="wp-block-paragraph">「画像比較が失敗する主な要因」であげた内容は、大きく分けて次の3パターンに分類できます。それぞれの要因に対応する解決策をお試しください。</p>



<ul class="wp-block-list">
<li><strong>解像度・ウィンドウサイズの違いが原因の場合</strong>
<ul class="wp-block-list">
<li>マシンの解像度やテスト対象アプリケーションのウィンドウサイズを統一する</li>
</ul>
</li>
</ul>



<ul class="wp-block-list">
<li><strong>Windows OSバージョン・クラウド環境・リモートデスクトップ環境の違いが原因の場合</strong>
<ul class="wp-block-list">
<li>Ranorexの標準機能（<a href="https://ranorex.techmatrix.jp/blog/2023/03/31/image-validation-application/" target="_blank" rel="noopener">プリプロセスフィルター・類似度</a>）で差分を許容する</li>



<li>他ツール連携により、文字・画像の位置ズレを自動検出して検証する (例：<a href="https://ranorex.techmatrix.jp/blog/2026/08/17/opencv-imagevalidation/" target="_blank" rel="noopener">OpenCV利用</a>)</li>



<li>環境ごとに期待画像を切り替えて、テストを実行する (<a href="https://ranorex.techmatrix.jp/blog/2020/10/16/user-code-reference_image_validation/" target="_blank" rel="noopener">ユーザーコード利用</a>)</li>
</ul>
</li>
</ul>



<ul class="wp-block-list">
<li><strong>動的なコンテンツやテスト環境によって変化するコンテンツが含まれる場合</strong>
<ul class="wp-block-list">
<li>差分が発生しやすい箇所や動的に変わる箇所を<a href="https://ranorex.techmatrix.jp/blog/2020/07/03/v9-3_image-validation/" target="_blank" rel="noopener">マスキング</a>して検証する</li>
</ul>
</li>
</ul>



<h3 id="download" class="wp-block-heading anchor"><strong>資料ダウンロードのご案内</strong></h3>



<p class="wp-block-paragraph">複数のプラットフォームでの画像比較を成功させるための方法に関する詳細資料は、以下のリンクからダウンロード可能です。<br>※ファイルをダウンロードできない場合は、ブラウザーのセキュリティ設定をご確認ください。</p>



<div style="width: 500px; margin: 0 auto; text-align: center;"><a href="https://ranorex.techmatrix.jp/wp-content/uploads/複数のプラットフォームで画像比較を成功させるための方法.zip" class="btn btn_commonpages" target="_blank">資料のダウンロードはこちら</a><a></a></div>



<p class="wp-block-paragraph"></p><p>The post <a href="https://ranorex.techmatrix.jp/blog/2026/11/06/multi-platform-image-validate/">複数のプラットフォームで画像比較を成功させるための方法</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>変更に強いRanoreXPathの設計方法</title>
		<link>https://ranorex.techmatrix.jp/blog/2026/09/09/ranorexpath_generate/</link>
		
		<dc:creator><![CDATA[Ranorex編集部]]></dc:creator>
		<pubDate>Wed, 09 Sep 2026 08:03:48 +0000</pubDate>
				<category><![CDATA[Ranorex機能]]></category>
		<category><![CDATA[ノウハウ]]></category>
		<guid isPermaLink="false">https://ranorex.techmatrix.jp/?p=32577</guid>

					<description><![CDATA[<p>※本記事は、RanoreXPathに関する基礎知識をお持ちの方向けの内容となります。※Ranorex ハンズオンセミナーを受講することで、RanoreXPathについて学習いただけます。 ブラウザー/Window OS/ [&#8230;]</p>
<p>The post <a href="https://ranorex.techmatrix.jp/blog/2026/09/09/ranorexpath_generate/">変更に強いRanoreXPathの設計方法</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></description>
										<content:encoded><![CDATA[<div class="veu_autoEyeCatchBox"><img decoding="async" width="678" height="515" src="https://ranorex.techmatrix.jp/wp-content/uploads/iStock-自動テスト.jpg" class="attachment-large size-large wp-post-image" alt="" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/iStock-自動テスト.jpg 678w, https://ranorex.techmatrix.jp/wp-content/uploads/iStock-自動テスト-300x228.jpg 300w" sizes="(max-width: 678px) 100vw, 678px" /></div>
<p class="has-small-font-size wp-block-paragraph"><em>※本記事は、RanoreXPathに関する基礎知識をお持ちの方向けの内容となります。</em><br><em>※Ranorex <a href="https://ranorex.techmatrix.jp/handson-details/" title="">ハンズオンセミナー</a>を受講することで、RanoreXPathについて学習いただけます。</em></p>



<p class="wp-block-paragraph">ブラウザー/Window OS/テスト対象アプリケーションのアップデートや、テスト対象アプリケーションの特性などにより、オブジェクト情報が意図せず変化しRanoreXPathの修正が必要となることで、メンテナンス工数が発生する場合があります。</p>



<p class="wp-block-paragraph">本記事では、RanoreXPathの変化にともなうメンテナンス工数を抑えるための、RanoreXPathの設計方法について説明します。</p>



<p class="wp-block-paragraph">本記事の最後に、RanoreXPathの設計方法に関する詳細資料を公開しておりますので、ダウンロードください。</p>



<div class="toc-001">
    <div>
        目次
        <label><input type="checkbox" checked=""></label>
    </div>
    <ol>
        <li><a href="#factor">RanoreXPathに影響を与える主な要因</a></li>
        <li><a href="#point">変更に強いRanoreXPath設計のポイント</a></li>
        <li><a href="#method">メンテナンス工数を抑えるための方法</a></li>
        <li><a href="#setting">RanoreXPath設計の進め方と推奨設定</a></li>
        <li><a href="#download">資料ダウンロードのご案内</a></li>
    </ol>
</div>



<h3 id="factor" class="wp-block-heading anchor"><strong>RanoreXPathに影響を与える主な要因</strong></h3>



<p class="wp-block-paragraph">RanoreXPathは主に以下の要因で変化します。これらの要因をあらかじめ理解し、堅牢なRanoreXPathを設計することが重要です。</p>



<ul class="wp-block-list">
<li>ブラウザーのアップデート</li>



<li>Windows OSのアップデート</li>



<li>テスト対象アプリケーションのアップデート</li>



<li>動的な属性の使用</li>
</ul>



<h3 id="point" class="wp-block-heading anchor"><strong>変更に強いRanoreXPath設計のポイント</strong></h3>



<p class="wp-block-paragraph">RanoreXPathのメンテナンス工数を抑えるためには、さまざまな変更要因の影響を受けにくいパス設計をおこなうことが重要です。その対応として、以下の方法があります。</p>



<h4 class="wp-block-heading"><strong>1. 変更されにくい属性を使用する</strong></h4>



<p class="wp-block-paragraph">テスト対象アプリケーションのユーザーインターフェース（UI）は操作や開発によって変化しやすく、それにともない、RanoreXPath内の属性情報も変化する場合があります。RanoreXPath内の属性情報に、UI変化の影響を受けにくいものを使用することで、RanoreXPathの耐久性を向上させ、テストの安定性とメンテナンス効率の改善が期待されます。</p>



<p class="wp-block-paragraph">例として、以下のようなRanoreXPathにおいて、text属性に動的な値（<mark style="background-color:rgba(0, 0, 0, 0)" class="has-inline-color has-vivid-cyan-blue-color">img_w3bnz2p1t58q2xi0</mark>）が使用されている場合、変更されにくい他の属性を使用することで、RanoreXPathを堅牢にすることができます。</p>



<ul style="background-color:#f0f0f0" class="wp-block-list has-background">
<li><strong>変更前のRanoreXPath例：</strong><br><strong><strong><strong>/form[@controlname=&#8217;RxMainFrame&#8217;]/?/?/tabpage[@controlname=&#8217;RxTabDynamic&#8217;]/text[<mark style="background-color:rgba(0, 0, 0, 0)" class="has-inline-color has-vivid-cyan-blue-color">@text=&#8217;img_w3bnz2p1t58q2xi0&#8242;</mark>]</strong></strong></strong></li>
</ul>



<p class="wp-block-paragraph">対象のリポジトリアイテムのパスエディター画面のツリー要素から、対象の要素（<strong>text</strong>要素）を選択し、属性の編集画面の<strong>text</strong>属性のチェックを無効にし<strong>、controlname</strong>属性などの他の属性を有効にします。</p>


<div class="wp-block-image">
<figure class="aligncenter size-full is-resized"><img decoding="async" width="580" height="275" src="https://ranorex.techmatrix.jp/wp-content/uploads/image-176.png" alt="" class="wp-image-32581" style="width:515px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/image-176.png 580w, https://ranorex.techmatrix.jp/wp-content/uploads/image-176-300x142.png 300w" sizes="(max-width: 580px) 100vw, 580px" /></figure>
</div>


<div class="wp-block-group"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul style="background-color:#f0f0f0" class="wp-block-list has-background">
<li><strong>変更後のRanoreXPath例：</strong><br><strong><strong>/form[@controlname=&#8217;RxMainFrame&#8217;]/?/?/tabpage[@controlname=&#8217;RxTabDynamic&#8217;]/text[<mark style="background-color:rgba(0, 0, 0, 0)" class="has-inline-color has-vivid-cyan-blue-color">@controlname=&#8217;txtBoxID&#8217;</mark>]</strong></strong></li>
</ul>
</div></div>



<h4 class="wp-block-heading"><strong>2. 属性値を正規表現で指定する</strong></h4>



<p class="wp-block-paragraph">自動生成されたRanoreXPathの中に、特定の形式の動的な属性値が存在する場合は、その形式に合わせて属性値を正規表現で指定することが可能です。属性値が変わった場合も、設定した正規表現に一致することにより、対象の要素を認識することができます。</p>



<p class="wp-block-paragraph">例として、以下のようなRanoreXPathにおいて、text属性に特定の形式で変化する値（<mark style="background-color:rgba(0, 0, 0, 0)" class="has-inline-color has-vivid-cyan-blue-color">img_w3bnz2p1t58q2xi0</mark>）が使用されている場合、正規表現で指定することで、RanoreXPathを堅牢にすることができます。</p>



<ul style="background-color:#f0f0f0" class="wp-block-list has-background">
<li><strong>変更前のRanoreXPath例：</strong><br><strong>/form[@controlname=&#8217;RxMainFrame&#8217;]/?/?/tabpage[@controlname=&#8217;RxTabDynamic&#8217;]/text[<mark style="background-color:rgba(0, 0, 0, 0)" class="has-inline-color has-vivid-cyan-blue-color">@text=&#8217;img_w3bnz2p1t58q2xi0&#8242;</mark>]</strong></li>
</ul>



<p class="wp-block-paragraph">対象のリポジトリアイテムのパスエディター画面のツリーの要素から、対象の要素（<strong>text</strong>要素）を選択し、属性の編集画面の<strong>text</strong>属性の演算子を、<strong>～（Regex Match）</strong>に変更し、属性値を指定する入力フォームに正規表現を使用した値を（<strong>img_.*</strong>）を設定します。</p>


<div class="wp-block-image">
<figure class="aligncenter size-full is-resized"><img loading="lazy" decoding="async" width="568" height="92" src="https://ranorex.techmatrix.jp/wp-content/uploads/image-177.png" alt="" class="wp-image-32583" style="width:519px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/image-177.png 568w, https://ranorex.techmatrix.jp/wp-content/uploads/image-177-300x49.png 300w" sizes="(max-width: 568px) 100vw, 568px" /></figure>
</div>


<ul style="background-color:#f0f0f0" class="wp-block-list has-background">
<li><strong>変更後のRanoreXPath例：</strong><br><strong><strong>/form[@controlname=&#8217;RxMainFrame&#8217;]/?/?/tabpage[@controlname=&#8217;RxTabDynamic&#8217;]/text[<mark style="background-color:rgba(0, 0, 0, 0)" class="has-inline-color has-vivid-cyan-blue-color">@text=&#8217;img_.*&#8217;</mark>]</strong></strong></li>
</ul>



<h4 class="wp-block-heading"><strong>3. パス構造を簡略化する</strong></h4>



<p class="wp-block-paragraph">アプリケーションのアップデートにより画面に変更が加えられることで、ツリー構造が変わり、既存のRanoreXPathでオブジェクトを認識できなくなる場合があります。このような場合、ワイルドカード演算子を使用してパス構造を簡略化することで、パス構造の変更に柔軟に対応できます。</p>



<p class="wp-block-paragraph">例として、以下のようなRanoreXPathにおいて、Tabpage内の画面構成が今後変更される可能性がある場合は、<strong>//（any descendants）</strong>を使用することで、画面変更の影響を受けないRanoreXPathにすることができます。</p>



<ul class="wp-block-list">
<li><strong>アップデート前のアプリケーションとツリー構造例：</strong></li>
</ul>


<div class="wp-block-image">
<figure class="aligncenter size-full"><img loading="lazy" decoding="async" width="525" height="256" src="https://ranorex.techmatrix.jp/wp-content/uploads/image-181.png" alt="" class="wp-image-32620" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/image-181.png 525w, https://ranorex.techmatrix.jp/wp-content/uploads/image-181-300x146.png 300w" sizes="(max-width: 525px) 100vw, 525px" /></figure>
</div>


<ul style="background-color:#f0f0f0" class="wp-block-list has-background">
<li><strong>変更前のRanoreXPath例：</strong><br><strong><strong>/form[@title=&#8217;〇〇アプリ&#8217;]/tabpage[@controlname=&#8217;HOME&#8217;]<mark style="background-color:rgba(0, 0, 0, 0)" class="has-inline-color has-vivid-cyan-blue-color">/</mark>button[@controltext=&#8217;ログイン&#8217;]</strong></strong></li>
</ul>



<ul class="wp-block-list">
<li><strong>アップデート後のアプリケーションとツリー構造例：</strong></li>
</ul>


<div class="wp-block-image">
<figure class="aligncenter size-full"><img loading="lazy" decoding="async" width="574" height="292" src="https://ranorex.techmatrix.jp/wp-content/uploads/image-182.png" alt="" class="wp-image-32621" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/image-182.png 574w, https://ranorex.techmatrix.jp/wp-content/uploads/image-182-300x153.png 300w" sizes="(max-width: 574px) 100vw, 574px" /></figure>
</div>


<ul style="background-color:#f0f0f0" class="wp-block-list has-background">
<li><strong>変更後のRanoreXPath例：</strong><br><strong><strong><strong>/form[@title=&#8217;〇〇アプリ&#8217;]/tabpage[@controlname=&#8217;HOME&#8217;]<mark style="background-color:rgba(0, 0, 0, 0)" class="has-inline-color has-vivid-cyan-blue-color">//</mark>button[@controltext=&#8217;ログイン&#8217;]</strong></strong></strong></li>
</ul>



<h3 id="method" class="wp-block-heading anchor"><strong>メンテナンス工数を抑えるための方法</strong></h3>



<p class="wp-block-paragraph">RanoreXPathの自動生成に関する設定として、<strong>「速度と堅牢性の設定」</strong>と<strong>「重み付けルールの設定」</strong>があります。これらの設定は、RanoreXPathを生成する前に、テスト対象アプリケーションの特性や運用方針に応じてあらかじめ設定しておくことで、変更に強いRanoreXPathを生成しやすくなり、後から修正する工数を抑えることができます。</p>



<h4 class="wp-block-heading"><strong>1. 速度と堅牢性の設定</strong></h4>



<p class="wp-block-paragraph">テスト実行時におけるオブジェクトの認識の速さや、アプリケーションの画面の変更にともなうオブジェクトの認識の強さは、RanoreXPathの構造に大きく依存しますが、RanoreXPathは<strong>「速度」</strong>と<strong>「堅牢性（壊れにくさ）」</strong>の２つの軸を基にバランスを見て生成されます。</p>



<p class="wp-block-paragraph">どちらの設定に重点を置くかは、テスト対象アプリケーションの内部構造や改修頻度に合わせて調整する必要がありますが、テスト実行時にオブジェクト認識の速さに影響しない場合は、将来発生する可能性のあるメンテナンス工数を抑えるために、原則として<strong>「堅牢性」</strong>重視の設定をおこなうことを推奨します。</p>



<h4 class="wp-block-heading"><strong>2. 重み付けルールの設定</strong></h4>



<p class="wp-block-paragraph">Ranorexで自動生成されたRanoreXPathに使用される属性には、動的な情報が含まれる場合がありますが、テスト実行の度に属性値が変わることでオブジェクトが検出できずに失敗する場合があります。そのため、対象のオブジェクトのRanoreXPathを修正し、他のユニークな属性に変更するなどの修正が必要となります。</p>



<p class="wp-block-paragraph">RanoreXPathの生成時に、どの属性を使用するかは <strong>「重み付けルール」</strong>の設定で管理されます。重み付けルールでは、各属性に数値が設定されており、数値が高い属性から優先的に使用されます。</p>



<p class="wp-block-paragraph"><em>※各設定方法の詳細は、以下Blog記事の<strong>「<a href="https://ranorex.techmatrix.jp/blog/2021/11/05/ranorexpath_basic/" title="">RanoreXPathの生成条件</a>」</strong>または本記事でダウンロード可能な<strong>「<a href="https://ranorex.techmatrix.jp/wp-content/uploads/変更に強いRanoreXPathの設計方法.zip" target="_blank" rel="noopener" title="">RanoreXPathの設計方法に関する詳細資料</a>」</strong>をご参照ください。</em></p>



<figure class="wp-block-embed is-type-wp-embed is-provider-ranorex wp-block-embed-ranorex"><div class="wp-block-embed__wrapper">
<blockquote class="wp-embedded-content" data-secret="YWoZfqUVrj"><a href="https://ranorex.techmatrix.jp/blog/2021/11/05/ranorexpath_basic/">RanoreXPathの基本構造</a></blockquote><iframe class="wp-embedded-content" sandbox="allow-scripts" security="restricted"  title="“RanoreXPathの基本構造” — テスト自動化ツール 『Ranorex』" src="https://ranorex.techmatrix.jp/blog/2021/11/05/ranorexpath_basic/embed/#?secret=H1UuiHiLNC#?secret=YWoZfqUVrj" data-secret="YWoZfqUVrj" width="600" height="338" frameborder="0" marginwidth="0" marginheight="0" scrolling="no"></iframe>
</div></figure>



<h3 id="setting" class="wp-block-heading anchor"><strong>RanoreXPath設計の進め方と推奨設定</strong></h3>



<p class="wp-block-paragraph">RanoreXPathのメンテナンス工数を抑えるためには、変更に強いパス構造を理解したうえで、目的や状態に応じて適切な設計方法を選択することが重要です。以下では、RanoreXPath設計における基本的な進め方と、代表的なケースごとに推奨される設定について説明します。</p>



<h4 class="wp-block-heading"><strong>1. 基本的な進め方</strong></h4>



<h5 class="wp-block-heading"><strong>Step1. 変更に強いRanoreXPath構造を理解する</strong></h5>



<ul class="wp-block-list">
<li>RanoreXPathに影響を与える主な要因を理解する</li>



<li>変更に強い（メンテナンス工数を抑える）RanoreXPathの考え方を理解する</li>
</ul>



<h5 class="wp-block-heading"><strong>Step2. 変更に強いRanoreXPathを作成する</strong></h5>



<ul class="wp-block-list">
<li>変更されにくい属性を使用する</li>



<li>属性値を正規表現で指定する</li>



<li>パス構造を簡略化する</li>
</ul>



<h5 class="wp-block-heading"><strong>Step3. ケースに応じたRanoreXPathの生成設定をおこなう</strong></h5>



<ul class="wp-block-list">
<li>速度と堅牢性の設定をおこなう</li>



<li>重み付けルールの設定をおこなう</li>
</ul>



<h4 class="wp-block-heading"><strong>2. ケース別の推奨設定</strong></h4>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td class="has-text-align-center" data-align="center"><strong>ケース</strong></td><td class="has-text-align-center" data-align="center"><strong>推奨される設定</strong></td></tr><tr><td class="has-text-align-center" data-align="center">一部のテスト対象オブジェクトのRanoreXPathに動的な属性が使用されている場合</td><td class="has-text-align-center" data-align="center">変更されにくい属性をパスエディターから指定</td></tr><tr><td class="has-text-align-center" data-align="center">属性値の一部が特定の形式で変化する場合</td><td class="has-text-align-center" data-align="center">属性値を正規表現で指定</td></tr><tr><td class="has-text-align-center" data-align="center">一部のオブジェクトの階層構造が変更された/今後変更される可能性のある場合</td><td class="has-text-align-center" data-align="center">パス構造の簡略化</td></tr><tr><td class="has-text-align-center" data-align="center">テスト対象アプリケーションのアップデートにより、内部構造に変更が発生する可能性がある場合</td><td class="has-text-align-center" data-align="center">速度と堅牢性の設定（堅牢性重視型）</td></tr><tr><td class="has-text-align-center" data-align="center">ブラウザーやWindows OSのアップデート後に、テスト対象オブジェクトの認識が安定しない場合</td><td class="has-text-align-center" data-align="center">速度と堅牢性の設定（堅牢性重視型）</td></tr><tr><td class="has-text-align-center" data-align="center">オブジェクト認識速度の向上を優先したい場合</td><td class="has-text-align-center" data-align="center">速度と堅牢性の設定（速度重視型）</td></tr><tr><td class="has-text-align-center" data-align="center">複数のテスト対象オブジェクトのRanoreXPathに動的な属性が使用されている場合</td><td class="has-text-align-center" data-align="center">重み付けルールの設定</td></tr><tr><td class="has-text-align-center" data-align="center">テスト対象アプリケーションの特徴に応じて、特定の属性を優先的に使用したい場合</td><td class="has-text-align-center" data-align="center">特定の属性をパスエディターから指定<br>重み付けルールの設定</td></tr></tbody></table></figure>



<h4 class="wp-block-heading"><strong>3. まとめ</strong></h4>



<p class="wp-block-paragraph">メンテナンス工数を抑えるためには、アプリケーションの内部構造や生成されるRanoreXPathの特性を理解したうえで、どのような設定をおこなうかを検討することが重要です。</p>



<p class="wp-block-paragraph">すべてのテストケースを作成した後にRanoreXPathの設定やパスの修正をしようとすると、本来修正しなくても良いパスも修正することになり、メンテナンス工数が掛かります。初期段階で適切な設定をおこなうことで、将来的にパスを修正する工数も軽減されます。</p>



<h3 id="download" class="wp-block-heading anchor"><strong>資料ダウンロードのご案内</strong></h3>



<p class="wp-block-paragraph">RanoreXPathの設計方法に関する詳細資料は、以下のリンクからダウンロード可能です。<br>※ファイルをダウンロードできない場合は、ブラウザーのセキュリティ設定をご確認ください。</p>



<div style="width: 500px; margin: 0 auto; text-align: center;"><a href="https://ranorex.techmatrix.jp/wp-content/uploads/変更に強いRanoreXPathの設計方法.zip" class="btn btn_commonpages" target="_blank">資料のダウンロードはこちら</a><a></a></div>



<p class="wp-block-paragraph"></p><p>The post <a href="https://ranorex.techmatrix.jp/blog/2026/09/09/ranorexpath_generate/">変更に強いRanoreXPathの設計方法</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>TMX Automation Helpers リファレンス７：画像ファイルを使用した画像比較</title>
		<link>https://ranorex.techmatrix.jp/blog/2026/06/19/tmx_automation_helpers_compareimagefiles/</link>
		
		<dc:creator><![CDATA[Ranorex編集部]]></dc:creator>
		<pubDate>Fri, 19 Jun 2026 02:00:18 +0000</pubDate>
				<category><![CDATA[ノウハウ]]></category>
		<guid isPermaLink="false">https://ranorex.techmatrix.jp/?p=29183</guid>

					<description><![CDATA[<p>2025年1月にリリースしたTMX版のオートメーションヘルパーについて、利用ケースや提供しているメソッドの使い方を「TMX Automation Helpers リファレンス」として解説していきたいと思います。今回の記事 [&#8230;]</p>
<p>The post <a href="https://ranorex.techmatrix.jp/blog/2026/06/19/tmx_automation_helpers_compareimagefiles/">TMX Automation Helpers リファレンス７：画像ファイルを使用した画像比較</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></description>
										<content:encoded><![CDATA[<div class="veu_autoEyeCatchBox"><img loading="lazy" decoding="async" width="788" height="443" src="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg" class="attachment-large size-large wp-post-image" alt="" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg 788w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-300x169.jpg 300w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-768x432.jpg 768w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-320x180.jpg 320w" sizes="(max-width: 788px) 100vw, 788px" /></div>
<p class="wp-block-paragraph">2025年1月にリリースした<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noreferrer noopener"><strong>TMX版のオートメーションヘルパー</strong></a>について、利用ケースや提供しているメソッドの使い方を「<strong>TMX Automation Helpers リファレンス</strong>」として解説していきたいと思います。今回の記事では、オートメーションヘルパーの<strong><strong>CompareImageFiles</strong></strong>メソッドによるスクリーンショットを出力する方法について解説します。<br><em>※Ranorexはバージョン12.3.0を使用しています。</em></p>



<h3 class="wp-block-heading"><strong>利用ケース</strong></h3>



<p class="wp-block-paragraph">システムマイグレーションなどによる現新比較（新旧比較）において、ビジュアルリグレッションテストを使用したい場合に有効な方法となります。</p>



<h3 class="wp-block-heading"><strong>使用するオートメーションヘルパーのメソッド</strong></h3>



<p class="wp-block-paragraph">・<strong>CompareImageFiles</strong>：指定した2つの画像ファイルを比較します。</p>



<h3 class="wp-block-heading"><strong>実装方法</strong></h3>



<p class="wp-block-paragraph"><em>※事前準備として、TMXオートメーションヘルパーをRanorexソリューションに追加しておきます。<br>対応方法は、<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noreferrer noopener">TMXオートメーションヘルパー</a>のBlog記事でダウロードできる「TMX版のオートメーションヘルパー」に含まれる資料（ranorex_automation_helpers_ユーザガイド.pdf）を参照してください。</em></p>



<p class="wp-block-paragraph">１）アクションテーブルの&nbsp;<strong>新しいアクションの追加</strong>&nbsp;から&nbsp;<strong>ユーザーコード（User code）</strong>－&nbsp;<strong>ライブラリから選択</strong>&nbsp;を選択します。</p>



<figure class="wp-block-image is-resized"><img loading="lazy" decoding="async" width="781" height="379" src="https://sp-ao.shortpixel.ai/client/to_webp,q_glossy,ret_img,w_781,h_379/https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png" alt="" class="wp-image-29394" style="width:614px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png 781w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-300x146.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-768x373.png 768w" sizes="(max-width: 781px) 100vw, 781px" /></figure>



<p class="wp-block-paragraph">２）ライブラリから選択 画面にて、<strong>TmxValidationLibrary&nbsp;</strong>–&nbsp;<strong><strong><strong><strong>CompareImageFiles</strong></strong></strong></strong>メソッド選択し、<strong>選択項目を追加</strong>&nbsp;ボタンをクリックします。</p>



<figure class="wp-block-image size-large is-resized"><img loading="lazy" decoding="async" width="1024" height="591" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img05-1024x591.png" alt="" class="wp-image-31520" style="width:749px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img05-1024x591.png 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img05-300x173.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img05-768x443.png 768w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img05-1536x886.png 1536w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img05-2048x1182.png 2048w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<p class="wp-block-paragraph">３）追加された&nbsp;<strong>User code</strong>&nbsp;アクションにて、選択したメソッドのパラメーターを設定します。</p>



<figure class="wp-block-image size-large is-resized"><img loading="lazy" decoding="async" width="1024" height="79" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img06-1024x79.png" alt="" class="wp-image-31522" style="width:825px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img06-1024x79.png 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img06-300x23.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img06-768x59.png 768w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img06.png 1094w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<ul class="wp-block-list">
<li><strong>baseImgFullPath</strong>：比較元となる画像ファイル（期待する画像）のパス（画像ファイル名を含む絶対パス）を指定します。（<em>※1</em>）</li>



<li><strong>targetImgFullPath</strong>：比較対象の画像ファイルのパス（画像ファイル名を含む絶対パス）を指定します。（<em>※1</em>）</li>



<li><strong>similarity</strong>：類似度を指定します。（1＝100%の一致となります。）</li>
</ul>



<p class="wp-block-paragraph"><em>※1．<em>パラメーターは変数化し、動的な値を設定することができます</em>。<em>変数化は、パラメーターのプルダウンメニュー（▼）にある “As new variable…” から設定できます</em>。 変数化については、ユーザーガイドの&nbsp;<a href="https://support.ranorex.com/hc/en-us/articles/38039242355473-Define-test-and-variables" target="_blank" rel="noreferrer noopener"><strong>テストと変数の定義</strong></a>&nbsp;を参照ください。</em></p>



<p class="wp-block-paragraph">４）対象のアクション（User code）が実行されると、指定した２つの画像ファイルの比較結果がレポートされます。</p>



<p class="wp-block-paragraph">比較した画像ファイルに差異が無かった場合：</p>



<figure class="wp-block-image size-full is-resized"><img loading="lazy" decoding="async" width="890" height="306" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img07.png" alt="" class="wp-image-31524" style="width:676px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img07.png 890w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img07-300x103.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img07-768x264.png 768w" sizes="(max-width: 890px) 100vw, 890px" /></figure>



<p class="wp-block-paragraph">比較した画像ファイルに差異があった場合：</p>



<figure class="wp-block-image size-full is-resized"><img loading="lazy" decoding="async" width="891" height="639" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img08.png" alt="" class="wp-image-31525" style="width:637px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img08.png 891w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img08-300x215.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img08-768x551.png 768w" sizes="(max-width: 891px) 100vw, 891px" /></figure>



<h3 class="wp-block-heading"><strong>関連情報</strong></h3>



<ul class="wp-block-list">
<li><a href="https://ranorex.techmatrix.jp/blog/2021/04/09/user-code-reference_full-screen-shot_image_validation/" target="_blank" rel="noopener" title="">ユーザー コード リファレンス：フルスクリーンショットのイメージ比較</a></li>



<li><a href="https://ranorex.techmatrix.jp/blog/2022/05/27/ranorex_visual_testing/" target="_blank" rel="noopener" title="">Ranorex＋reg-cli連携によるビジュアルテスト</a></li>
</ul><p>The post <a href="https://ranorex.techmatrix.jp/blog/2026/06/19/tmx_automation_helpers_compareimagefiles/">TMX Automation Helpers リファレンス７：画像ファイルを使用した画像比較</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>TMX Automation Helpers リファレンス６：スクリーンショットの出力</title>
		<link>https://ranorex.techmatrix.jp/blog/2026/06/12/tmx_automation_helpers_reportpagescreenshot/</link>
		
		<dc:creator><![CDATA[Ranorex編集部]]></dc:creator>
		<pubDate>Fri, 12 Jun 2026 02:00:41 +0000</pubDate>
				<category><![CDATA[ノウハウ]]></category>
		<guid isPermaLink="false">https://ranorex.techmatrix.jp/?p=29873</guid>

					<description><![CDATA[<p>2025年1月にリリースしたTMX版のオートメーションヘルパーについて、利用ケースや提供しているメソッドの使い方を「TMX Automation Helpers リファレンス」として解説していきたいと思います。今回の記事 [&#8230;]</p>
<p>The post <a href="https://ranorex.techmatrix.jp/blog/2026/06/12/tmx_automation_helpers_reportpagescreenshot/">TMX Automation Helpers リファレンス６：スクリーンショットの出力</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></description>
										<content:encoded><![CDATA[<div class="veu_autoEyeCatchBox"><img loading="lazy" decoding="async" width="788" height="443" src="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg" class="attachment-large size-large wp-post-image" alt="" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg 788w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-300x169.jpg 300w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-768x432.jpg 768w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-320x180.jpg 320w" sizes="(max-width: 788px) 100vw, 788px" /></div>
<p class="wp-block-paragraph">2025年1月にリリースした<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noreferrer noopener"><strong>TMX版のオートメーションヘルパー</strong></a>について、利用ケースや提供しているメソッドの使い方を「<strong>TMX Automation Helpers リファレンス</strong>」として解説していきたいと思います。今回の記事では、オートメーションヘルパーの<strong>ReportPageScreenshot</strong>メソッドによるスクリーンショットを出力する方法について解説します。<br><em>※Ranorexはバージョン12.3.0を使用しています。</em></p>



<h3 class="wp-block-heading"><strong>利用ケース</strong></h3>



<p class="wp-block-paragraph">テスト対象アプリにおいて、特定のオブジェクトのスクリーンショットをエビデンスとして残したい場合などに利用できます。</p>



<h3 class="wp-block-heading"><strong>使用するオートメーションヘルパーのメソッド</strong></h3>



<ul class="wp-block-list">
<li><strong>ReportPageScreenshot</strong>メソッド：取得したスクリーンショットを指定したファイル名と場所に保存します。</li>
</ul>



<h3 class="wp-block-heading"><strong>実装方法</strong></h3>



<p class="wp-block-paragraph"><em>※事前準備として、TMXオートメーションヘルパーをRanorexソリューションに追加しておきます。<br>対応方法は、<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noreferrer noopener">TMXオートメーションヘルパー</a>のBlog記事でダウロードできる「TMX版のオートメーションヘルパー」に含まれる資料（ranorex_automation_helpers_ユーザガイド.pdf）を参照してください。</em></p>



<p class="wp-block-paragraph">１）アクションテーブルの&nbsp;<strong>新しいアクションの追加</strong>&nbsp;から&nbsp;<strong>ユーザーコード（User code）</strong>－&nbsp;<strong>ライブラリから選択</strong>&nbsp;を選択します。</p>



<figure class="wp-block-image is-resized"><img loading="lazy" decoding="async" width="781" height="379" src="https://sp-ao.shortpixel.ai/client/to_webp,q_glossy,ret_img,w_781,h_379/https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png" alt="" class="wp-image-29394" style="width:614px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png 781w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-300x146.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-768x373.png 768w" sizes="(max-width: 781px) 100vw, 781px" /></figure>



<p class="wp-block-paragraph">２）ライブラリから選択 画面にて、<strong>TmxValidationLibrary&nbsp;</strong>–&nbsp;<strong><strong><strong>ReportPageScreenshot</strong></strong></strong>メソッド選択し、<strong>選択項目を追加</strong>&nbsp;ボタンをクリックします。</p>



<figure class="wp-block-image size-large is-resized"><img loading="lazy" decoding="async" width="1024" height="579" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img01-1024x579.png" alt="" class="wp-image-31510" style="width:911px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img01-1024x579.png 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img01-300x170.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img01-768x434.png 768w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img01-1536x868.png 1536w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img01-2048x1157.png 2048w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img01-320x180.png 320w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<p class="wp-block-paragraph">３）追加された&nbsp;<strong>User code</strong>&nbsp;アクションにて、選択したメソッドのパラメーターを設定します。</p>



<figure class="wp-block-image size-full is-resized"><img loading="lazy" decoding="async" width="1129" height="89" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img02.png" alt="" class="wp-image-31511" style="width:1042px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img02.png 1129w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img02-300x24.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img02-1024x81.png 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img02-768x61.png 768w" sizes="(max-width: 1129px) 100vw, 1129px" /></figure>



<ul class="wp-block-list">
<li><strong>repoInfo</strong>：スクリーンショットを出力したいリポジトリアイテムを指定します。</li>



<li><strong>outputDirPath</strong>：スクリーンショットの出力場所を指定します。（<em>※絶対パスで指定します。</em>）（<em>※1</em>）</li>



<li><strong>outputImgName</strong>：出力するスクリーンショットの画像ファイル名を指定します。（<em>※1</em>）（<em>※2</em>）</li>



<li><strong>createDir</strong>：<strong>outputDirPath</strong>のパラーメーターで指定したパスのフォルダーが存在しない場合に作成する（<strong>true</strong>）・しない（<strong>false</strong>）を指定します。（初期値：<strong>false</strong>）</li>
</ul>



<p class="wp-block-paragraph"><em>※1．<em>パラメーターは変数化し、動的な値を設定することができます</em>。<em>変数化は、パラメーターのプルダウンメニュー（▼）にある “As new variable…” から設定できます</em>。 変数化については、ユーザーガイドの&nbsp;<a href="https://support.ranorex.com/hc/en-us/articles/38039242355473-Define-test-and-variables" target="_blank" rel="noreferrer noopener"><strong>テストと変数の定義</strong></a>&nbsp;を参照ください。</em><br><em><strong>※2．</strong>画像ファイル名は、”{モジュール名}_{日時:yyyyMMdd_HHmm}_{指定したファイル名}&#8221;の形式で保存されます。また、ファイルはpngファイル形式で保存されます。</em></p>



<p class="wp-block-paragraph">４）対象のアクション（User code）が実行されると、実行された際のリポジトリアイテムの画像が指定先のフォルダーに出力されます。また、スクリーンショットが取得されたことがレポートされます。<br><strong>出力された画像ファイル：</strong></p>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="610" height="91" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img03.png" alt="" class="wp-image-31515" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img03.png 610w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img03-300x45.png 300w" sizes="(max-width: 610px) 100vw, 610px" /></figure>



<p class="wp-block-paragraph"><strong>テスト結果レポート：</strong></p>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="892" height="154" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img04.png" alt="" class="wp-image-31516" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img04.png 892w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img04-300x52.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260605_img04-768x133.png 768w" sizes="(max-width: 892px) 100vw, 892px" /></figure><p>The post <a href="https://ranorex.techmatrix.jp/blog/2026/06/12/tmx_automation_helpers_reportpagescreenshot/">TMX Automation Helpers リファレンス６：スクリーンショットの出力</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>TMX Automation Helpers リファレンス５：アクションスポット（座標値）チェック</title>
		<link>https://ranorex.techmatrix.jp/blog/2026/03/10/tmx_automation_helpers_validatelocation/</link>
		
		<dc:creator><![CDATA[Ranorex編集部]]></dc:creator>
		<pubDate>Tue, 10 Mar 2026 02:00:48 +0000</pubDate>
				<category><![CDATA[ノウハウ]]></category>
		<guid isPermaLink="false">https://ranorex.techmatrix.jp/?p=29871</guid>

					<description><![CDATA[<p>2025年1月にリリースしたTMX版のオートメーションヘルパーについて、利用ケースや提供しているメソッドの使い方を「TMX Automation Helpers リファレンス」として解説していきたいと思います。今回の記事 [&#8230;]</p>
<p>The post <a href="https://ranorex.techmatrix.jp/blog/2026/03/10/tmx_automation_helpers_validatelocation/">TMX Automation Helpers リファレンス５：アクションスポット（座標値）チェック</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></description>
										<content:encoded><![CDATA[<div class="veu_autoEyeCatchBox"><img loading="lazy" decoding="async" width="788" height="443" src="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg" class="attachment-large size-large wp-post-image" alt="" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg 788w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-300x169.jpg 300w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-768x432.jpg 768w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-320x180.jpg 320w" sizes="(max-width: 788px) 100vw, 788px" /></div>
<p class="wp-block-paragraph">2025年1月にリリースした<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noreferrer noopener"><strong>TMX版のオートメーションヘルパー</strong></a>について、利用ケースや提供しているメソッドの使い方を「<strong>TMX Automation Helpers リファレンス</strong>」として解説していきたいと思います。今回の記事では、オートメーションヘルパーの<strong>ValidateLocation</strong>メソッドによるアクションスポット（座標値）の中心が期待する座標値と一致するかを検証する方法について解説します。<br><em>※Ranorexはバージョン12.3.0を使用しています。</em></p>



<h3 class="wp-block-heading"><strong>利用ケース</strong></h3>



<p class="wp-block-paragraph">画像を扱うテスト対象アプリにおいて、表示されるオブジェクト（画像）の中心座標値が正しいかを検証したい場合などに利用できます。</p>



<h3 class="wp-block-heading"><strong>使用するオートメーションヘルパーのメソッド</strong></h3>



<ul class="wp-block-list">
<li><strong>ValidateLocation</strong>メソッド：オブジェクト（画像）の中心座標値が期待する座標値と一致するかを検証します。</li>
</ul>



<h3 class="wp-block-heading"><strong>実装方法</strong></h3>



<p class="wp-block-paragraph"><em>※事前準備として、TMXオートメーションヘルパーをRanorexソリューションに追加しておきます。<br>対応方法は、<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noreferrer noopener">TMXオートメーションヘルパー</a>のBlog記事でダウロードできる「TMX版のオートメーションヘルパー」に含まれる資料（ranorex_automation_helpers_ユーザガイド.pdf）を参照してください。</em></p>



<p class="wp-block-paragraph">１）アクションテーブルの&nbsp;<strong>新しいアクションの追加</strong>&nbsp;から&nbsp;<strong>ユーザーコード（User code）</strong>－&nbsp;<strong>ライブラリから選択</strong>&nbsp;を選択します。</p>



<figure class="wp-block-image is-resized"><img loading="lazy" decoding="async" width="781" height="379" src="https://sp-ao.shortpixel.ai/client/to_webp,q_glossy,ret_img,w_781,h_379/https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png" alt="" class="wp-image-29394" style="width:614px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png 781w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-300x146.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-768x373.png 768w" sizes="(max-width: 781px) 100vw, 781px" /></figure>



<p class="wp-block-paragraph">２）ライブラリから選択 画面にて、<strong>TmxValidationLibrary&nbsp;</strong>–&nbsp;<strong><strong>ValidateLocation</strong></strong>メソッド選択し、<strong>選択項目を追加</strong>&nbsp;ボタンをクリックします。</p>



<figure class="wp-block-image size-large is-resized"><img loading="lazy" decoding="async" width="1024" height="582" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img1-1024x582.png" alt="" class="wp-image-30316" style="width:911px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img1-1024x582.png 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img1-300x170.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img1-768x436.png 768w, https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img1-1536x872.png 1536w, https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img1-2048x1163.png 2048w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<p class="wp-block-paragraph">３）追加された&nbsp;<strong>User code</strong>&nbsp;アクションにて、選択したメソッドのパラメーターを設定します。</p>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="916" height="84" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img2.png" alt="" class="wp-image-30317" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img2.png 916w, https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img2-300x28.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img2-768x70.png 768w" sizes="(max-width: 916px) 100vw, 916px" /></figure>



<ul class="wp-block-list">
<li><strong>taginfo</strong>：確認したいリポジトリアイテムを指定します。</li>



<li><strong>x</strong>：期待するy軸の座標値（中心）を指定します。（<em>※1</em>）</li>



<li><strong>y</strong>：期待するy軸の座標値（中心）を指定します。（<em>※1</em>）</li>
</ul>



<p class="wp-block-paragraph"><em>※1．<em>パラメーターは変数化し、動的な値を設定することができます</em>。<em>変数化は、パラメーターのプルダウンメニュー（▼）にある “As new variable…” から設定できます</em>。 変数化については、ユーザーガイドの&nbsp;<a href="https://support.ranorex.com/hc/en-us/articles/38039242355473-Define-test-and-variables" target="_blank" rel="noreferrer noopener"><strong>テストと変数の定義</strong></a>&nbsp;を参照ください。</em></p>



<p class="wp-block-paragraph">４）対象のアクション（User code）が実行されると、各メソッドにおける比較結果がレポートされます。オブジェクト（画像）の中心座標値が期待する座標値と一致する場合（中心座標値である場合）は成功としてレポートされ、一致しない場合（中心座標値でない場合）失敗としてレポートされます。</p>



<p class="wp-block-paragraph"><strong>成功時：</strong></p>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="642" height="96" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img3.png" alt="" class="wp-image-30318" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img3.png 642w, https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img3-300x45.png 300w" sizes="(max-width: 642px) 100vw, 642px" /></figure>



<p class="wp-block-paragraph"><strong>失敗時：</strong></p>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="900" height="522" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img4.png" alt="" class="wp-image-30319" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img4.png 900w, https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img4-300x174.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260226_img4-768x445.png 768w" sizes="(max-width: 900px) 100vw, 900px" /></figure><p>The post <a href="https://ranorex.techmatrix.jp/blog/2026/03/10/tmx_automation_helpers_validatelocation/">TMX Automation Helpers リファレンス５：アクションスポット（座標値）チェック</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>TMX Automation Helpers リファレンス４：テキスト比較</title>
		<link>https://ranorex.techmatrix.jp/blog/2026/01/23/tmx_automation_helpers_validatedifftext_validatedifftextfile/</link>
		
		<dc:creator><![CDATA[Ranorex編集部]]></dc:creator>
		<pubDate>Fri, 23 Jan 2026 02:00:13 +0000</pubDate>
				<category><![CDATA[ノウハウ]]></category>
		<guid isPermaLink="false">https://ranorex.techmatrix.jp/?p=29869</guid>

					<description><![CDATA[<p>2025年1月にリリースしたTMX版のオートメーションヘルパーについて、利用ケースや提供しているメソッドの使い方を「TMX Automation Helpers リファレンス」として解説していきたいと思います。今回の記事 [&#8230;]</p>
<p>The post <a href="https://ranorex.techmatrix.jp/blog/2026/01/23/tmx_automation_helpers_validatedifftext_validatedifftextfile/">TMX Automation Helpers リファレンス４：テキスト比較</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></description>
										<content:encoded><![CDATA[<div class="veu_autoEyeCatchBox"><img loading="lazy" decoding="async" width="788" height="443" src="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg" class="attachment-large size-large wp-post-image" alt="" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg 788w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-300x169.jpg 300w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-768x432.jpg 768w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-320x180.jpg 320w" sizes="(max-width: 788px) 100vw, 788px" /></div>
<p class="wp-block-paragraph">2025年1月にリリースした<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noreferrer noopener"><strong>TMX版のオートメーションヘルパー</strong></a>について、利用ケースや提供しているメソッドの使い方を「<strong>TMX Automation Helpers リファレンス</strong>」として解説していきたいと思います。今回の記事では、オートメーションヘルパーの<strong><strong>ValidateDiffText</strong></strong>メソッド、および<strong><strong>ValidateDiffTextFile</strong></strong>メソッドによる２つのテキストを比較する方法について解説します。<br><em>※Ranorexはバージョン12.3.0を使用しています。</em></p>



<h3 class="wp-block-heading"><strong>利用ケース</strong></h3>



<p class="wp-block-paragraph">テスト対象アプリに表示されるテキストや出力したテキストファイルの比較をおこないたい場合に利用できます。</p>



<h3 class="wp-block-heading"><strong>使用するオートメーションヘルパーのメソッド</strong></h3>



<ul class="wp-block-list">
<li><strong>ValidateDiffText</strong>：2つのテキストを比較します。</li>



<li><strong>ValidateDiffTextFile</strong>：2つのテキストファイルを比較します。</li>
</ul>



<h3 class="wp-block-heading"><strong>実装方法</strong></h3>



<p class="wp-block-paragraph"><em>※事前準備として、TMXオートメーションヘルパーをRanorexソリューションに追加しておきます。<br>対応方法は、<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noreferrer noopener">TMXオートメーションヘルパー</a>のBlog記事でダウロードできる「TMX版のオートメーションヘルパー」に含まれる資料（ranorex_automation_helpers_ユーザガイド.pdf）を参照してください。</em></p>



<p class="wp-block-paragraph">１）アクションテーブルの <strong>新しいアクションの追加</strong> から <strong>ユーザーコード（User code）</strong>－ <strong>ライブラリから選択</strong> を選択します。</p>



<figure class="wp-block-image size-full is-resized"><img loading="lazy" decoding="async" width="781" height="379" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png" alt="" class="wp-image-29394" style="width:536px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png 781w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-300x146.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-768x373.png 768w" sizes="(max-width: 781px) 100vw, 781px" /></figure>



<p class="wp-block-paragraph">２）ライブラリから選択 画面にて、<strong>TmxValidationLibrary </strong>&#8211; <strong><strong><strong><strong>ValidateDiffText</strong></strong></strong></strong>メソッド、または<strong><strong><strong><strong>ValidateDiffTextFile</strong></strong></strong></strong>メソッド選択し、<strong>選択項目を追加</strong> ボタンをクリックします。</p>



<p class="wp-block-paragraph"></p>



<p class="wp-block-paragraph">３）追加された <strong>User code</strong> アクションにて、選択したメソッドのパラメーターを設定します。</p>



<p class="wp-block-paragraph"><strong><strong><strong><strong><strong><strong><strong><strong>ValidateDiffText</strong></strong></strong></strong></strong></strong></strong></strong>メソッド：<br>2つのテキストを比較し、比較結果をレポートをします。</p>



<ul class="wp-block-list">
<li><strong>baseTxt</strong>：期待するテキストを指定します。（<em>※1</em>）</li>



<li><strong>targetTxt</strong>：比較対象となるテキストを指定します。（<em>※1</em>）</li>
</ul>



<figure class="wp-block-image size-full is-resized"><img loading="lazy" decoding="async" width="947" height="97" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260108_img1-1.png" alt="" class="wp-image-29883" style="width:808px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260108_img1-1.png 947w, https://ranorex.techmatrix.jp/wp-content/uploads/20260108_img1-1-300x31.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260108_img1-1-768x79.png 768w" sizes="(max-width: 947px) 100vw, 947px" /></figure>



<p class="wp-block-paragraph"><strong><strong><strong><strong><strong><strong>ValidateDiffTextFile</strong></strong></strong></strong></strong></strong>メソッド：</p>



<p class="wp-block-paragraph">2つのテキストファイルを比較し、比較結果をレポートします。</p>



<ul class="wp-block-list">
<li><strong>baseTxtFullPath</strong>：期待するテキストファイルを指定します。（<em>※1</em>）</li>



<li><strong>targetTxtFullPath</strong>：比較対象となるテキストファイルを指定します。（<em>※1</em>）</li>
</ul>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="947" height="83" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260108_img2-1.png" alt="" class="wp-image-29884" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260108_img2-1.png 947w, https://ranorex.techmatrix.jp/wp-content/uploads/20260108_img2-1-300x26.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260108_img2-1-768x67.png 768w" sizes="(max-width: 947px) 100vw, 947px" /></figure>



<p class="wp-block-paragraph"><em>※1．<em>パラメーターは変数化し、動的な値を設定することができます</em>。<em>変数化は、パラメーターのプルダウンメニュー（▼）にある “As new variable…” から設定できます</em>。 変数化については、ユーザーガイドの <a href="https://support.ranorex.com/hc/en-us/articles/38039242355473-Define-test-and-variables" target="_blank" rel="noopener" title=""><strong>テストと変数の定義</strong></a> を参照ください。</em></p>



<p class="wp-block-paragraph">４）対象のアクション（User code）が実行されると、各メソッドにおける比較結果がレポートされます。</p>



<h6 class="wp-block-heading"><strong>ValidateDiffTextメソッドのレポート結果</strong></h6>



<p class="wp-block-paragraph">比較結果として差分が無い場合は、成功としてレポートされます。</p>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="901" height="66" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img1.png" alt="" class="wp-image-29903" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img1.png 901w, https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img1-300x22.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img1-768x56.png 768w" sizes="(max-width: 901px) 100vw, 901px" /></figure>



<p class="wp-block-paragraph">また、差分があった場合は、失敗として差分箇所（追加・削除）がレポートされます。</p>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="894" height="340" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img2.png" alt="" class="wp-image-29904" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img2.png 894w, https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img2-300x114.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img2-768x292.png 768w" sizes="(max-width: 894px) 100vw, 894px" /></figure>



<p class="wp-block-paragraph"><strong>ValidateDiffTextFileメソッドのレポート結果</strong></p>



<p class="wp-block-paragraph">比較結果として差分が無い場合は、成功としてレポートされます。</p>



<p class="wp-block-paragraph">期待するテキストファイル（TextFile1.txt）の内容：<br><strong>テキスト１<br>テキスト２<br>テキスト３</strong></p>



<p class="wp-block-paragraph">比較対象となるテキストファイル（TextFile2.txt）の内容：<br><strong>テキスト１<br>テキスト②<br>テキスト３<br>テキスト４</strong></p>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="885" height="404" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img3.png" alt="" class="wp-image-29905" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img3.png 885w, https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img3-300x137.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img3-768x351.png 768w" sizes="(max-width: 885px) 100vw, 885px" /></figure>



<p class="wp-block-paragraph">また、差分があった場合は、失敗として差分箇所（追加・削除）がレポートされます。</p>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="898" height="70" src="https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img4.png" alt="" class="wp-image-29906" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img4.png 898w, https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img4-300x23.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20260109_img4-768x60.png 768w" sizes="(max-width: 898px) 100vw, 898px" /></figure>



<p class="wp-block-paragraph"></p><p>The post <a href="https://ranorex.techmatrix.jp/blog/2026/01/23/tmx_automation_helpers_validatedifftext_validatedifftextfile/">TMX Automation Helpers リファレンス４：テキスト比較</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>TMX Automation Helpers リファレンス３：数の大小比較</title>
		<link>https://ranorex.techmatrix.jp/blog/2025/12/19/tmx_automation_helpers_validatebiggerthan2_validatesmallerthan2/</link>
		
		<dc:creator><![CDATA[Ranorex編集部]]></dc:creator>
		<pubDate>Fri, 19 Dec 2025 00:00:41 +0000</pubDate>
				<category><![CDATA[ノウハウ]]></category>
		<guid isPermaLink="false">https://ranorex.techmatrix.jp/?p=29671</guid>

					<description><![CDATA[<p>2025年1月にリリースしたTMX版のオートメーションヘルパーについて、利用ケースや提供しているメソッドの使い方を「TMX Automation Helpers リファレンス」として解説していきたいと思います。今回の記事 [&#8230;]</p>
<p>The post <a href="https://ranorex.techmatrix.jp/blog/2025/12/19/tmx_automation_helpers_validatebiggerthan2_validatesmallerthan2/">TMX Automation Helpers リファレンス３：数の大小比較</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></description>
										<content:encoded><![CDATA[<div class="veu_autoEyeCatchBox"><img loading="lazy" decoding="async" width="788" height="443" src="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg" class="attachment-large size-large wp-post-image" alt="" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg 788w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-300x169.jpg 300w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-768x432.jpg 768w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-320x180.jpg 320w" sizes="(max-width: 788px) 100vw, 788px" /></div>
<p class="wp-block-paragraph">2025年1月にリリースした<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noreferrer noopener"><strong>TMX版のオートメーションヘルパー</strong></a>について、利用ケースや提供しているメソッドの使い方を「<strong>TMX Automation Helpers リファレンス</strong>」として解説していきたいと思います。今回の記事では、オートメーションヘルパーの<strong>ValidateBiggerThan2</strong>メソッド、および<strong>ValidateSmallerThan2</strong>メソッドによる２つの数の大小比較をおこなう方法について解説します。<br><em>※Ranorexはバージョン12.3.0を使用しています。</em></p>



<h3 class="wp-block-heading"><strong>利用ケース</strong></h3>



<p class="wp-block-paragraph">テスト対象アプリで出力された数の大小比較をおこないたい場合に利用できます。</p>



<h3 class="wp-block-heading"><strong>使用するオートメーションヘルパーのメソッド</strong></h3>



<ul class="wp-block-list">
<li><strong>ValidateBiggerThan2</strong>：2つの数の大小を比較し、期待する数が大きいかを検証します。</li>



<li><strong>ValidateSmallerThan2</strong>：2つの数の大小を比較し、期待する数が小さいかを検証します。</li>
</ul>



<h3 class="wp-block-heading"><strong>実装方法</strong></h3>



<p class="wp-block-paragraph"><em>※事前準備として、TMXオートメーションヘルパーをRanorexソリューションに追加しておきます。<br>対応方法は、<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noreferrer noopener">TMXオートメーションヘルパー</a>のBlog記事でダウロードできる「TMX版のオートメーションヘルパー」に含まれる資料（ranorex_automation_helpers_ユーザガイド.pdf）を参照してください。</em></p>



<p class="wp-block-paragraph">１）アクションテーブルの <strong>新しいアクションの追加</strong> から <strong>ユーザーコード（User code）</strong>－ <strong>ライブラリから選択</strong> を選択します。</p>



<figure class="wp-block-image size-full is-resized"><img loading="lazy" decoding="async" width="781" height="379" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png" alt="" class="wp-image-29394" style="width:536px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png 781w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-300x146.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-768x373.png 768w" sizes="(max-width: 781px) 100vw, 781px" /></figure>



<p class="wp-block-paragraph">２）ライブラリから選択 画面にて、<strong>TmxValidationLibrary </strong>&#8211; <strong><strong><strong>ValidateBiggerThan2</strong></strong></strong>メソッド、または<strong><strong><strong>ValidateSmallerThan2</strong></strong></strong>メソッド選択し、<strong>選択項目を追加</strong> ボタンをクリックします。</p>



<figure class="wp-block-image size-large is-resized"><img loading="lazy" decoding="async" width="1024" height="618" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img1-1024x618.png" alt="" class="wp-image-29769" style="width:803px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img1-1024x618.png 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img1-300x181.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img1-768x463.png 768w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img1-1536x926.png 1536w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img1-2048x1235.png 2048w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<p class="wp-block-paragraph">３）追加された <strong>User code</strong> アクションにて、選択したメソッドのパラメーターを設定します。</p>



<p class="wp-block-paragraph"><strong><strong><strong><strong>ValidateBiggerThan2</strong></strong></strong></strong>メソッド：<br>2つの数の大小を比較し、パラメーター &#8220;<strong>a</strong>&#8221; のほうが<strong>大きい</strong>場合に検証が成功します。</p>



<ul class="wp-block-list">
<li><strong>a</strong>：比較する数を指定します。（<em>※1</em>）</li>



<li><strong>b</strong>：比較する数を指定します。（<em>※1</em>）</li>



<li><strong>equalSuccess</strong>：比較結果が同数の場合に結果を成功/失敗のどちらにするかを指定します。（<em>※2</em>）</li>
</ul>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="811" height="77" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img2.png" alt="" class="wp-image-29772" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img2.png 811w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img2-300x28.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img2-768x73.png 768w" sizes="(max-width: 811px) 100vw, 811px" /></figure>



<p class="wp-block-paragraph"><strong><strong><strong><strong><strong>ValidateSmallerThan2</strong></strong></strong></strong></strong>メソッド：</p>



<p class="wp-block-paragraph">2つの数の大小を比較し、パラメーター &#8220;<strong>a</strong>&#8221; のほうが<strong>小さい</strong>場合に検証が成功します。</p>



<ul class="wp-block-list">
<li><strong>a</strong>：比較する数を指定します。（<em>※1</em>）</li>



<li><strong>b</strong>：比較する数を指定します。（<em>※1</em>）</li>



<li><strong><strong>equalSuccess</strong></strong>：比較結果が同数の場合に結果を成功/失敗のどちらにするかを指定します。（<em>※2</em>）</li>
</ul>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="809" height="70" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img3.png" alt="" class="wp-image-29771" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img3.png 809w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img3-300x26.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img3-768x66.png 768w" sizes="(max-width: 809px) 100vw, 809px" /></figure>



<p class="wp-block-paragraph"><em>※1．<em>パラメーターは変数化し、動的な値を設定することができます</em>。<em>変数化は、パラメーターのプルダウンメニュー（▼）にある “As new variable…” から設定できます</em>。 変数化については、ユーザーガイドの <a href="https://support.ranorex.com/hc/en-us/articles/38039242355473-Define-test-and-variables" target="_blank" rel="noopener" title=""><strong>テストと変数の定義</strong></a> を参照ください。</em><br><em>※2．&#8221;True&#8221; を指定した場合、比較結果が同数の場合に結果を成功にします。&#8221;False&#8221; を指定した場合、<em>比較結果が同数の場合に結果を</em>失敗にします。（初期値：False）</em></p>



<p class="wp-block-paragraph">４）対象のアクション（User code）が実行されると、各メソッドにおける比較結果がレポートされます。本メソッドを使用することで、テスト対象アプリに表示される数に対する大小、および同数の検証をおこないたい場合に利用できます。</p>



<p class="wp-block-paragraph"><strong><strong><strong><strong>ValidateBiggerThan2</strong></strong></strong></strong>メソッド：</p>



<figure class="wp-block-image size-large is-resized"><img loading="lazy" decoding="async" width="1024" height="661" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img4-1024x661.png" alt="" class="wp-image-29774" style="width:728px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img4-1024x661.png 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img4-300x194.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img4-768x495.png 768w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img4-1536x991.png 1536w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img4-2048x1321.png 2048w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<figure class="wp-block-image size-large is-resized"><img loading="lazy" decoding="async" width="1024" height="594" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img5-1024x594.png" alt="" class="wp-image-29775" style="width:810px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img5-1024x594.png 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img5-300x174.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img5-768x445.png 768w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img5-1536x890.png 1536w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img5-2048x1187.png 2048w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<p class="wp-block-paragraph"><strong><strong><strong><strong>ValidateSmallerThan2</strong></strong></strong></strong>メソッド：</p>



<figure class="wp-block-image size-large is-resized"><img loading="lazy" decoding="async" width="1024" height="665" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img6-1024x665.png" alt="" class="wp-image-29776" style="width:723px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img6-1024x665.png 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img6-300x195.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img6-768x499.png 768w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img6-1536x998.png 1536w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img6-2048x1331.png 2048w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<figure class="wp-block-image size-large is-resized"><img loading="lazy" decoding="async" width="1024" height="590" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img7-1024x590.png" alt="" class="wp-image-29777" style="width:805px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img7-1024x590.png 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img7-300x173.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img7-768x443.png 768w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img7-1536x885.png 1536w, https://ranorex.techmatrix.jp/wp-content/uploads/20251205_img7-2048x1180.png 2048w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<p class="wp-block-paragraph"></p><p>The post <a href="https://ranorex.techmatrix.jp/blog/2025/12/19/tmx_automation_helpers_validatebiggerthan2_validatesmallerthan2/">TMX Automation Helpers リファレンス３：数の大小比較</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>無影響確認テスト(リグレッションテスト)の自動化で効率化！</title>
		<link>https://ranorex.techmatrix.jp/blog/2025/12/10/impact-verification-test/</link>
		
		<dc:creator><![CDATA[Ranorex編集部]]></dc:creator>
		<pubDate>Wed, 10 Dec 2025 06:51:05 +0000</pubDate>
				<category><![CDATA[ノウハウ]]></category>
		<category><![CDATA[事例・ソリューション]]></category>
		<guid isPermaLink="false">https://ranorex.techmatrix.jp/?p=29706</guid>

					<description><![CDATA[<p>無影響確認テストは、変更が既存の機能や他のシステム部分に悪影響を及ぼしていないかを確認する重要なテストです。これはリグレッションテストとも呼ばれますが、特に金融業界のようにセキュリティ要件や法的規制が厳しい分野では、この [&#8230;]</p>
<p>The post <a href="https://ranorex.techmatrix.jp/blog/2025/12/10/impact-verification-test/">無影響確認テスト(リグレッションテスト)の自動化で効率化！</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></description>
										<content:encoded><![CDATA[<div class="veu_autoEyeCatchBox"><img loading="lazy" decoding="async" width="1024" height="788" src="https://ranorex.techmatrix.jp/wp-content/uploads/iStock-2207357962-1024x788.jpg" class="attachment-large size-large wp-post-image" alt="" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/iStock-2207357962-1024x788.jpg 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/iStock-2207357962-300x231.jpg 300w, https://ranorex.techmatrix.jp/wp-content/uploads/iStock-2207357962-768x591.jpg 768w, https://ranorex.techmatrix.jp/wp-content/uploads/iStock-2207357962.jpg 1167w" sizes="(max-width: 1024px) 100vw, 1024px" /></div>
<p class="wp-block-paragraph"></p>



<p class="wp-block-paragraph">無影響確認テストは、変更が既存の機能や他のシステム部分に悪影響を及ぼしていないかを確認する重要なテストです。これはリグレッションテストとも呼ばれますが、特に<strong>金融業界</strong>のように<strong>セキュリティ要件</strong>や<strong>法的規制が厳しい分野</strong>では、このテストの目的や重要性をより正確に表すために「<strong>無影響確認テスト</strong>」という用語が一般的に使われています。</p>



<p class="wp-block-paragraph">本記事では、この無影響確認テストの自動化についてご紹介します。</p>



<h2 class="wp-block-heading h2-blog"><strong>無影響確認テストが必要な背景</strong></h2>



<p class="wp-block-paragraph">「無影響確認テスト」という用語を使用する<strong>金融業界</strong>では、<strong>個人や法人の資金</strong>、<strong>機密情報</strong>を取り扱うため、<strong>システムのセキュリティ確保は極めて重要</strong>です。金融業界のシステムは、<strong>古いシステム(レガシーシステム)</strong>であることが多いですが、古いテクノロジーの使用やセキュリティパッチの未適用による脆弱性が懸念されます。</p>



<p class="wp-block-paragraph">そのため、以下のような対策をおこなう企業が多く、この際に無影響確認テストもします。</p>



<ul style="background-color:#f0f0f0" class="wp-block-list has-background">
<li><strong>ハードウェア・ソフトウェアの刷新</strong></li>



<li><strong>セキュリティパッチの適用</strong></li>



<li><strong>OSやソフトウェアのバージョンアップ</strong></li>
</ul>



<p class="wp-block-paragraph">これらのタイミングで無影響確認テストを怠ると、以下のような理由でソフトウェアの品質が低下する可能性が高くなります。</p>



<ul style="background-color:#f0f0f0" class="wp-block-list has-background">
<li><strong>互換性の低下</strong></li>



<li><strong>パフォーマンスの低下</strong></li>



<li><strong>セキュリティの脆弱性</strong></li>
</ul>



<p class="wp-block-paragraph">このようなリスクを抑えるために、無影響確認テストは、製品開発において非常に重要なプロセスです。</p>



<h2 class="wp-block-heading h2-blog"><strong>UIテストによる、無影響確認テスト</strong></h2>



<p class="wp-block-paragraph">無影響確認テストは、さまざまなテスト手法でおこなうことができますが、UIテストのフェーズに絞って紹介します。UIテストは、アプリケーション画面のユーザーインターフェースに対し、ユーザーが実際におこなう操作をシミュレーションして、アプリケーションの振る舞いや表示が期待どおりであるかを確認するテストです。</p>


<div class="wp-block-image">
<figure class="alignleft size-full is-resized"><img loading="lazy" decoding="async" width="968" height="374" src="https://ranorex.techmatrix.jp/wp-content/uploads/image-95.png" alt="" class="wp-image-29743" style="width:855px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/image-95.png 968w, https://ranorex.techmatrix.jp/wp-content/uploads/image-95-300x116.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/image-95-768x297.png 768w" sizes="(max-width: 968px) 100vw, 968px" /><figcaption class="wp-element-caption">UIテスト</figcaption></figure>
</div>


<div style="height:0px" aria-hidden="true" class="wp-block-spacer"></div>



<p class="wp-block-paragraph">通常、UIテストは最終段階のシナリオテストや受け入れテストで実施されることが多く、完成形のシステムに対しておこなうため、システム間の連携が正常に機能しているかどうか(E2Eテスト)を確認することもできます。</p>


<div class="wp-block-image">
<figure class="alignleft size-full"><img loading="lazy" decoding="async" width="486" height="340" src="https://ranorex.techmatrix.jp/wp-content/uploads/image-94.png" alt="" class="wp-image-29709" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/image-94.png 486w, https://ranorex.techmatrix.jp/wp-content/uploads/image-94-300x210.png 300w" sizes="(max-width: 486px) 100vw, 486px" /><figcaption class="wp-element-caption">ソフトウェア開発V字モデルにおけるUIテストの実施部分</figcaption></figure>
</div>


<div style="height:0px" aria-hidden="true" class="wp-block-spacer"></div>



<p class="wp-block-paragraph">このUIテストを自動化することで、作業効率やシステムの品質向上に繋がります。</p>



<div class="wp-block-group has-white-background-color has-background"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<div style="height:15px" aria-hidden="true" class="wp-block-spacer"></div>



<p class="wp-block-paragraph">弊社(<a href="https://www.techmatrix.co.jp/index.html" title=""><strong>テクマトリックス株式会社</strong></a>)で、UIテスト自動化ツール「<strong><a href="https://ranorex.techmatrix.jp/" title="">Ranorex</a></strong>」を取り扱っています。アプリ画面操作のレコーディングで簡単にテスト作成できるため、テスト初心者でも扱いやすいツールです。Ranorexの特長などの製品紹介資料は以下からダウンロードいただけます。</p>



<div id=rx-banner_gray>
<a href="https://s.techmatrix.co.jp/form/RXdoc0003IND?k3ad=rx-blog_regressiontest" target="_blank" rel="noopener noreferrer">
  <img decoding="async" src="https://ranorex.techmatrix.jp/wp-content/uploads/Ranorex_popup-2504_930x100_html.png">
</a>
</div>



<div style="height:21px" aria-hidden="true" class="wp-block-spacer"></div>



<p class="wp-block-paragraph">また、Ranorexは、14日間の体験版を無償でご利用いただけます。UIテスト自動化を検討のお客様は、ぜひ<strong><a href="https://s.techmatrix.co.jp/form/RXtry0001IND/k3ad=rx_blog_post" title="">こちら</a></strong>からダウンロードしてご評価ください。</p>
</div></div>



<div style="height:0px" aria-hidden="true" class="wp-block-spacer"></div>



<h2 class="wp-block-heading h2-blog"><strong>無影響確認テストが自動化に向いている理由</strong></h2>



<p class="wp-block-paragraph">自動化に向いているテストの特徴として、「<strong>頻繁に繰り返しおこなわれるテスト</strong>」があり、テスト回数が多ければ多いほど自動化の効果が出やすくなります。無影響確認テストは、<strong>セキュリティパッチ適用</strong>や<strong>OS・ソフトウェアバージョンアップ</strong>時におこない、頻繁に繰り返しおこなう必要があるため、自動化に向いています。</p>



<p class="wp-block-paragraph">無影響確認テストを自動化することで得られる効果は以下が挙げられます。</p>



<ul style="background-color:#f0f0f0" class="wp-block-list has-background">
<li><strong>テスト効率の向上</strong></li>



<li><strong>確認ミスや漏れの防止</strong></li>



<li><strong>開発者のモチベーション向上</strong></li>
</ul>



<h2 class="wp-block-heading h2-blog"><strong>無影響確認テストの自動化</strong></h2>



<p class="wp-block-paragraph">無影響確認テストを自動化するためには、テスト自動化ツールが必要です。テスト自動化ツールを利用して、無影響確認テストを自動化する具体的な方法については、<a href="https://ranorex.techmatrix.jp/whitepaper/" title=""><strong>ホワイトペーパー</strong></a>でご紹介しています。</p>



<p class="wp-block-paragraph">また、弊社で取り扱っている UIテスト自動化ツール「<strong><a href="https://ranorex.techmatrix.jp/" title="">Ranorex</a></strong>」を利用した無影響確認テストの事例やテスト方法についても記載していますので、ぜひ資料をダウンロードしてご確認ください。</p>



<div class="wp-block-group has-background" style="background-color:#f0f0f0"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<div style="height:9px" aria-hidden="true" class="wp-block-spacer"></div>



<p class="has-text-align-center has-medium-font-size wp-block-paragraph"><strong>無影響確認テストの自動化のホワイトペーパーは</strong><br><strong>以下からダウンロードください。</strong></p>



<p class="has-text-align-center wp-block-paragraph">※過去のホワイトペーパーもすべてダウンロードいただけます。</p>



<div style="width: 500px; margin: 0 auto;"><a href="https://s.techmatrix.co.jp/form/RXdoc0001IND?k3ad=rx_blog_regressiontest" class="btn btn_commonpages" target="_blank">ホワイトペーパーのダウンロードはこちら<a></div>



<div style="height:8px" aria-hidden="true" class="wp-block-spacer"></div>
</div></div>



<div style="height:62px" aria-hidden="true" class="wp-block-spacer"></div><p>The post <a href="https://ranorex.techmatrix.jp/blog/2025/12/10/impact-verification-test/">無影響確認テスト(リグレッションテスト)の自動化で効率化！</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>TMX Automation Helpers リファレンス２：英語ロケールでのシステム日付の取得</title>
		<link>https://ranorex.techmatrix.jp/blog/2025/11/21/tmx_automation_helpers_getdatetimeasstring_en/</link>
		
		<dc:creator><![CDATA[Ranorex編集部]]></dc:creator>
		<pubDate>Fri, 21 Nov 2025 02:00:00 +0000</pubDate>
				<category><![CDATA[ノウハウ]]></category>
		<guid isPermaLink="false">https://ranorex.techmatrix.jp/?p=29306</guid>

					<description><![CDATA[<p>2025年1月にリリースしたTMX版のオートメーションヘルパーについて、利用ケースや提供しているメソッドの使い方を「TMX Automation Helpers リファレンス」として解説していきたいと思います。今回の記事 [&#8230;]</p>
<p>The post <a href="https://ranorex.techmatrix.jp/blog/2025/11/21/tmx_automation_helpers_getdatetimeasstring_en/">TMX Automation Helpers リファレンス２：英語ロケールでのシステム日付の取得</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></description>
										<content:encoded><![CDATA[<div class="veu_autoEyeCatchBox"><img loading="lazy" decoding="async" width="788" height="443" src="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg" class="attachment-large size-large wp-post-image" alt="" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg 788w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-300x169.jpg 300w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-768x432.jpg 768w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-320x180.jpg 320w" sizes="(max-width: 788px) 100vw, 788px" /></div>
<p class="wp-block-paragraph">2025年1月にリリースした<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noreferrer noopener"><strong>TMX版のオートメーションヘルパー</strong></a>について、利用ケースや提供しているメソッドの使い方を「<strong>TMX Automation Helpers リファレンス</strong>」として解説していきたいと思います。今回の記事では、オートメーションヘルパーの<strong><strong><strong>GetDateTimeAsString_en</strong></strong></strong>メソッドによる英語ロケールでシステム日付を取得する方法について解説します。<br><em>※Ranorexはバージョン12.3.0を使用しています。</em></p>



<h3 class="wp-block-heading"><strong>利用ケース</strong></h3>



<p class="wp-block-paragraph">複数言語に対応したアプリ開発などにおいて、英語ロケールでシステム日付を取得したい場合に利用できます。</p>



<h3 class="wp-block-heading"><strong>使用するオートメーションヘルパーのメソッド</strong></h3>



<p class="wp-block-paragraph">・<strong><strong><strong><strong><strong>GetDateTimeAsString_en</strong></strong></strong></strong></strong>：英語ロケールでシステム日付を取得するメソッド。本メソッドでは、英語ロケールでシステム日付を受け取るため、受け取る情報に曜日を含めると英語で取得されます。</p>



<h3 class="wp-block-heading"><strong>実装方法</strong></h3>



<p class="wp-block-paragraph"><em>※事前準備として、TMXオートメーションヘルパーをRanorexソリューションに追加しておきます。<br>対応方法は、<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noreferrer noopener">TMXオートメーションヘルパー</a>のBlog記事でダウロードできる「TMX版のオートメーションヘルパー」に含まれる資料（ranorex_automation_helpers_ユーザガイド.pdf）を参照してください。</em></p>



<p class="wp-block-paragraph">１）アクションテーブルの <strong>新しいアクションの追加</strong> から <strong>ユーザーコード（User code）</strong>－ <strong>ライブラリから選択</strong> を選択します。</p>



<figure class="wp-block-image size-full is-resized"><img loading="lazy" decoding="async" width="781" height="379" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png" alt="" class="wp-image-29394" style="width:536px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png 781w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-300x146.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-768x373.png 768w" sizes="(max-width: 781px) 100vw, 781px" /></figure>



<p class="wp-block-paragraph">２）ライブラリから選択 画面にて、<strong>TmxSystemLibrary </strong>&#8211; <strong><strong><strong><strong><strong><strong><strong>GetDateTimeAsString_en</strong></strong></strong></strong></strong></strong></strong>メソッドを選択し、<strong>選択項目を追加</strong> ボタンをクリックします。</p>



<figure class="wp-block-image size-large is-resized"><img loading="lazy" decoding="async" width="1024" height="677" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251117_img1-1024x677.png" alt="" class="wp-image-29663" style="width:643px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251117_img1-1024x677.png 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/20251117_img1-300x198.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251117_img1-768x508.png 768w, https://ranorex.techmatrix.jp/wp-content/uploads/20251117_img1-1536x1016.png 1536w, https://ranorex.techmatrix.jp/wp-content/uploads/20251117_img1-2048x1355.png 2048w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<p class="wp-block-paragraph">３）追加された <strong>User code</strong> アクションにて、選択したメソッドのパラメーターを設定します。</p>



<ul class="wp-block-list">
<li><strong>return</strong>：システム日付の値を受け取る変数を指定します。（<em>※パラメーターのプルダウンメニュー（▼）にある &#8220;As new variable&#8230;&#8221; から設定できます</em>）</li>



<li><strong>expectedFormatimg</strong>：日付フォーマットを指定します。（※1）（指定しない場合は、”<strong>dd.MM.yyyy</strong>”のフォーマットが指定されます。）</li>



<li><strong>typeCase</strong>：英字の大文字/小文字の表示をタイプ（<strong>none</strong>、<strong>upper</strong>、<strong>lower</strong>）で指定します。（※2）（受け取る値に、曜日を指定した場合に適用されます。）</li>
</ul>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="910" height="76" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251117_img2.png" alt="" class="wp-image-29665" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251117_img2.png 910w, https://ranorex.techmatrix.jp/wp-content/uploads/20251117_img2-300x25.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251117_img2-768x64.png 768w" sizes="(max-width: 910px) 100vw, 910px" /></figure>



<p class="wp-block-paragraph"><em>※1．フォーマットは、.NETカスタム日時書式指定文字列が使用できます。 詳しくは、<a href="https://learn.microsoft.com/ja-jp/dotnet/standard/base-types/custom-date-and-time-format-strings?redirectedfrom=MSDN" target="_blank" rel="noopener" title=""><strong>Microsoftの公式ページ</strong></a>をご参照ください。 </em><br><em>※2．<strong>none</strong>：先頭が大文字、それ以外は小文字 / <strong>upper</strong>：すべて大文字 / <strong>lower</strong>：すべて小文字</em></p>



<p class="wp-block-paragraph">４）対象のアクション（User code）が実行されると、メソッドの<strong>return</strong>パラメーターで設定した変数に英語ロケールで現在日付が格納されます。この変数をバリデーションの期待値や入力フォームへの入力値として使用することが可能です。<br><strong>※英語ロケール（曜日を含めない）に関係なく、システム日付を取得したい場合は、開発元が提供している<a href="https://ranorex.techmatrix.jp/blog/2019/09/13/method-list-for-automation-helpers/" target="_blank" rel="noopener" title="">オートメーションヘルパー</a>のGetDateTimeAsStringメソッドを使用することも可能です。</strong></p><p>The post <a href="https://ranorex.techmatrix.jp/blog/2025/11/21/tmx_automation_helpers_getdatetimeasstring_en/">TMX Automation Helpers リファレンス２：英語ロケールでのシステム日付の取得</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>TMX Automation Helpers リファレンス１：数値の加算と減算</title>
		<link>https://ranorex.techmatrix.jp/blog/2025/10/24/tmx_automation_helpers_calculateaddition-calculatesubtraction/</link>
		
		<dc:creator><![CDATA[Ranorex編集部]]></dc:creator>
		<pubDate>Fri, 24 Oct 2025 02:00:44 +0000</pubDate>
				<category><![CDATA[ノウハウ]]></category>
		<guid isPermaLink="false">https://ranorex.techmatrix.jp/?p=29303</guid>

					<description><![CDATA[<p>2025年1月にリリースしたTMX版のオートメーションヘルパーについて、利用ケースや提供しているメソッドの使い方を「TMX Automation Helpers リファレンス」として解説していきたいと思います。今回の記事 [&#8230;]</p>
<p>The post <a href="https://ranorex.techmatrix.jp/blog/2025/10/24/tmx_automation_helpers_calculateaddition-calculatesubtraction/">TMX Automation Helpers リファレンス１：数値の加算と減算</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></description>
										<content:encoded><![CDATA[<div class="veu_autoEyeCatchBox"><img loading="lazy" decoding="async" width="788" height="443" src="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg" class="attachment-large size-large wp-post-image" alt="" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード.jpg 788w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-300x169.jpg 300w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-768x432.jpg 768w, https://ranorex.techmatrix.jp/wp-content/uploads/プログラミング言語コード-320x180.jpg 320w" sizes="(max-width: 788px) 100vw, 788px" /></div>
<p class="wp-block-paragraph">2025年1月にリリースした<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noopener" title=""><strong>TMX版のオートメーションヘルパー</strong></a>について、利用ケースや提供しているメソッドの使い方を「<strong>TMX Automation Helpers リファレンス</strong>」として解説していきたいと思います。今回の記事では、オートメーションヘルパーの<strong>CalculateAddition</strong>メソッドと、<strong>CalculateSubtraction</strong>メソッドによる加算、減算をおこなう方法について解説します。<br><em>※Ranorexはバージョン12.3.0を使用しています。</em></p>



<h3 class="wp-block-heading"><strong>利用ケース</strong></h3>



<p class="wp-block-paragraph">数値のバリデーションを実施する際に期待値となる値（数値）に対して加算、減算をおこなった数値を使用したい場合などで利用できます。</p>



<h3 class="wp-block-heading"><strong>使用するオートメーションヘルパーのメソッド</strong></h3>



<p class="wp-block-paragraph">・<strong><strong>CalculateAddition</strong></strong>：数値の加算をおこなうメソッド</p>



<p class="wp-block-paragraph">・<strong><strong>CalculateSubtraction</strong></strong>：数値の減算をおこなうメソッド</p>



<h3 class="wp-block-heading"><strong>実装方法</strong></h3>



<p class="wp-block-paragraph"><em>※事前準備として、TMXオートメーションヘルパーをRanorexソリューションに追加しておきます。<br>対応方法は、<a href="https://ranorex.techmatrix.jp/blog/2025/01/31/ranorex_automation_helpers_v1-0_release/" target="_blank" rel="noopener" title="">TMXオートメーションヘルパー</a>のBlog記事でダウロードできる「TMX版のオートメーションヘルパー」に含まれる資料（ranorex_automation_helpers_ユーザガイド.pdf）を参照してください。</em></p>



<p class="wp-block-paragraph">１）アクションテーブルの <strong>新しいアクションの追加</strong> から <strong>ユーザーコード（User code）</strong>－ <strong>ライブラリから選択</strong> を選択します。</p>



<figure class="wp-block-image size-full is-resized"><img loading="lazy" decoding="async" width="781" height="379" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png" alt="" class="wp-image-29394" style="width:536px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4.png 781w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-300x146.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img4-768x373.png 768w" sizes="(max-width: 781px) 100vw, 781px" /></figure>



<p class="wp-block-paragraph">２）ライブラリから選択 画面にて、<strong>TmxReportLibrary </strong>&#8211; <strong><strong>CalculateAddition</strong></strong>メソッド、または<strong><strong>CalculateSubtraction</strong></strong>メソッド選択し、<strong>選択項目を追加</strong> ボタンをクリックします。</p>



<figure class="wp-block-image size-large is-resized"><img loading="lazy" decoding="async" width="1024" height="653" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img1-1024x653.png" alt="" class="wp-image-29390" style="width:643px;height:auto" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img1-1024x653.png 1024w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img1-300x191.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img1-768x490.png 768w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img1-1536x980.png 1536w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img1-2048x1307.png 2048w" sizes="(max-width: 1024px) 100vw, 1024px" /></figure>



<p class="wp-block-paragraph">３）追加された <strong>User code</strong> アクションにて、選択したメソッドのパラメーターを設定します。</p>



<p class="wp-block-paragraph"><strong><strong>CalculateAddition</strong></strong>メソッド：</p>



<ul class="wp-block-list">
<li><strong>return</strong>：加算した値を受け取る変数を指定します。（<em>※パラメーターのプルダウンメニュー（▼）にある &#8220;As new variable&#8230;&#8221; から設定できます</em>）</li>



<li><strong>d1</strong>：加算する数値を指定します。</li>



<li><strong>d2</strong>：加算する数値を指定します。</li>
</ul>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="788" height="88" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img2.png" alt="" class="wp-image-29391" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img2.png 788w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img2-300x34.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img2-768x86.png 768w" sizes="(max-width: 788px) 100vw, 788px" /></figure>



<p class="wp-block-paragraph"><strong><strong>CalculateSubtraction</strong></strong>メソッド：</p>



<ul class="wp-block-list">
<li><strong>return</strong>：加算した値を受け取る変数を指定します。（<em>※パラメータ<em>ー</em>のプルダウンメニュー（▼）にある &#8220;As new variable&#8230;&#8221; から設定できます</em>）</li>



<li><strong>d1</strong>：加算される数値を指定します。</li>



<li><strong>d2</strong>：加算する数値を指定します。</li>
</ul>



<figure class="wp-block-image size-full"><img loading="lazy" decoding="async" width="788" height="88" src="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img3.png" alt="" class="wp-image-29392" srcset="https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img3.png 788w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img3-300x34.png 300w, https://ranorex.techmatrix.jp/wp-content/uploads/20251010_img3-768x86.png 768w" sizes="(max-width: 788px) 100vw, 788px" /></figure>



<p class="wp-block-paragraph"><em>※各メソッドで指定できるパラメータ<em>ー</em>には変数を設定することも可能です。</em><br><em>※各メソッドで指定可能な数値の小数は、小数第28位までになり、指定可能な数値の最大桁数は29桁までになります。</em></p>



<p class="wp-block-paragraph">４）対象のアクション（User code）が実行されると、各メソッドの<strong>return</strong>パラメーターで設定した変数に加算、または減算した結果（数値）が格納されます。この変数をバリデーションの期待値や入力フォームへの入力値として使用することが可能です。</p><p>The post <a href="https://ranorex.techmatrix.jp/blog/2025/10/24/tmx_automation_helpers_calculateaddition-calculatesubtraction/">TMX Automation Helpers リファレンス１：数値の加算と減算</a> first appeared on <a href="https://ranorex.techmatrix.jp">テスト自動化ツール 『Ranorex』</a>.</p>]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
