Ranorex機能 - テスト自動化ツール『Ranorex』

MESCIUS(旧GrapeCity)コンポーネントを使用したデスクトップアプリのテスト自動化

Ranorex編集部 — Mon, 05 Oct 2026 06:24:04 +0000

MESCIUS（メシウス）社のコンポーネントは、多くのデスクトップおよびWebアプリケーションで採用されています。アプリケーションの品質維持にはUIテストが不可欠であり、その自動化には、利用するツールが対象のコンポーネントに対応していることが重要です。

これまでRanorexは、一部のMESCIUS社コンポーネントの自動化に対応していましたが、このたびデスクトップアプリケーション向けの主要コンポーネントについても正式にサポートを開始しました。

本記事では、新たにRanorexが対応した「SPREAD for Windows Forms」、「SPREAD for WPF」、「MultiRowPlus for Windows Forms」のテスト自動化についてご紹介します。

MESCIUSコンポーネントとは

MESCIUSコンポーネントは、ソフトウェア開発者向けの高品質なUIコンポーネントおよびツール群で、特にスプレッドシート機能や明細書作成機能で広く利用されています。ここでは、Ranorexが新たにサポートした3つのデスクトップアプリ用のコンポーネントについて紹介します ※そのほかのコンポーネントや詳細情報については、MESCIUS社のWebサイトをご参照ください。

SPREAD for Windows Forms

SPREAD for Windows Formsは、Windows Formsアプリ向けのスプレッドシートコンポーネントです。Windows Formsアプリに組み込むだけで、使いやすい表計算機能を簡単に実装できます。

SPREAD for Windows Formsのサンプルイメージ

SPREAD for WPF

SPREAD for WPFは、WPFアプリ向けのスプレッドシートコンポーネントで、WPF技術を活用した豊かな表現力と柔軟なカスタマイズ性を備えています。Windows Forms版に比べ、より細かなUI調整が可能です。

SPREAD for WPFのサンプルイメージ

MultiRowPlus for Windows Forms

MultiRowPlus for Windows Formsは、Windows Formsアプリ向けのデータグリッドコンポーネントで、複数行にまたがるセル構成や複雑なレイアウトを自由に表現できる点が特徴です。Windows Forms標準のDataGridViewよりも柔軟で多彩なセルテンプレートを使うことができます。

MultiRowPlus for Windows Formsのサンプルイメージ

そのほか、帳票・レポート開発コンポーネント「ActiveReports」や入力支援コンポーネント「InputMan」、コンポーネントセット「ComponentOne」などがあります。デスクトップアプリだけでなく、Webアプリ用のコンポーネントもあります。

テスト自動化ツール「Ranorex」とは

Ranorexで、MESCIUSコンポーネントを使用したデスクトップアプリのUIテストを自動化できます。アプリ改修時などにリグレッションテストを自動化することで、テスト工数を削減できます。また、人為的ミスも回避できるためシステムの品質も維持できます。

RanorexによるMESCIUSコンポーネントのテスト自動化

テスト操作をレコーディングすることで、簡単に自動化するためのテストを作成できます。

Ranorexのレコーディングによる自動テストの作成

Ranorexの特長などの製品紹介資料は以下からダウンロードいただけます。

Ranorexは、14日間の体験版を無償でご利用いただけます。MESCIUSコンポーネントを使用したデスクトップアプリのUIテスト自動化を検討のお客様は、体験版をダウンロードしてご評価ください。

Ranorexは、14日間の体験版を無償でご利用いただけます。
体験版をダウンロードしてご評価ください。

Ranorex体験版のダウンロードはこちら

「Ranorex」によるMESCIUSコンポーネントを使用したデスクトップアプリのテスト自動化

RanorexによるMESCIUSコンポーネントを使用したデスクトップアプリのテスト自動化については、ホワイトペーパーをご用意しています。ぜひ資料をダウンロードしてご確認ください。

ホワイトペーパーは
以下からダウンロードください。

※過去のホワイトペーパーもすべてダウンロードいただけます。

ホワイトペーパーのダウンロードはこちら

The post MESCIUS(旧GrapeCity)コンポーネントを使用したデスクトップアプリのテスト自動化 first appeared on テスト自動化ツール『Ranorex』.

変更に強いRanoreXPathの設計方法

Ranorex編集部 — Wed, 09 Sep 2026 08:03:48 +0000

※本記事は、RanoreXPathに関する基礎知識をお持ちの方向けの内容となります。
※Ranorex ハンズオンセミナーを受講することで、RanoreXPathについて学習いただけます。

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

本記事では、RanoreXPathの変化にともなうメンテナンス工数を抑えるための、RanoreXPathの設計方法について説明します。

本記事の最後に、RanoreXPathの設計方法に関する詳細資料を公開しておりますので、ダウンロードのうえ、是非ご活用ください。

RanoreXPathに影響を与える主な要因

RanoreXPathは主に以下の要因で変化します。これらの要因をあらかじめ理解し、堅牢なRanoreXPathを設計することが重要です。

ブラウザーのアップデート
Windows OSのアップデート
テスト対象アプリケーションのアップデート
動的な属性の使用

変更に強いRanoreXPath設計のポイント

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

1. 変更されにくい属性を使用する

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

例として、以下のようなRanoreXPathにおいて、text属性に動的な値（img_w3bnz2p1t58q2xi0）が使用されている場合、変更されにくい他の属性を使用することで、RanoreXPathを堅牢にすることができます。

変更前のRanoreXPath例：
/form[@controlname=’RxMainFrame’]/?/?/tabpage[@controlname=’RxTabDynamic’]/text[@text=’img_w3bnz2p1t58q2xi0′]

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

変更後のRanoreXPath例：
/form[@controlname=’RxMainFrame’]/?/?/tabpage[@controlname=’RxTabDynamic’]/text[@controlname=’txtBoxID’]

2. 属性値を正規表現で指定する

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

例として、以下のようなRanoreXPathにおいて、text属性に特定の形式で変化する値（img_w3bnz2p1t58q2xi0）が使用されている場合、正規表現で指定することで、RanoreXPathを堅牢にすることができます。

変更前のRanoreXPath例：
/form[@controlname=’RxMainFrame’]/?/?/tabpage[@controlname=’RxTabDynamic’]/text[@text=’img_w3bnz2p1t58q2xi0′]

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

変更後のRanoreXPath例：
/form[@controlname=’RxMainFrame’]/?/?/tabpage[@controlname=’RxTabDynamic’]/text[@text=’img_.*’]

3. パス構造を簡略化する

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

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

アップデート前のアプリケーションとツリー構造例：

変更前のRanoreXPath例：
/form[@title=’〇〇アプリ’]/tabpage[@controlname=’HOME’]/button[@controltext=’ログイン’]

アップデート後のアプリケーションとツリー構造例：

変更後のRanoreXPath例：
/form[@title=’〇〇アプリ’]/tabpage[@controlname=’HOME’]//button[@controltext=’ログイン’]

メンテナンス工数を抑えるための方法

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

1. 速度と堅牢性の設定

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

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

2. 重み付けルールの設定

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

RanoreXPathの生成時に、どの属性を使用するかは 「重み付けルール」の設定で管理されます。重み付けルールでは、各属性に数値が設定されており、数値が高い属性から優先的に使用されます。

※各設定方法の詳細は、以下Blog記事の「RanoreXPathの生成条件」または本記事でダウンロード可能な「RanoreXPathの設計方法に関する詳細資料」をご参照ください。

RanoreXPathの基本構造

RanoreXPath設計の進め方と推奨設定

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

1. 基本的な進め方

Step1. 変更に強いRanoreXPath構造を理解する

RanoreXPathに影響を与える主な要因を理解する
変更に強い（メンテナンス工数を抑える）RanoreXPathの考え方を理解する

Step2. 変更に強いRanoreXPathを作成する

変更されにくい属性を使用する
属性値を正規表現で指定する
パス構造を簡略化する

Step3. ケースに応じたRanoreXPathの生成設定をおこなう

速度と堅牢性の設定をおこなう
重み付けルールの設定をおこなう

2. ケース別の推奨設定

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

3. まとめ

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

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

資料ダウンロードのご案内

本記事に関する、RanoreXPathの設計方法に関する詳細資料は、以下のリンクからダウンロード可能です。

資料ダウンロード

The post 変更に強いRanoreXPathの設計方法 first appeared on テスト自動化ツール『Ranorex』.

環境差に対応した柔軟な画像比較 (Ranorex + OpenCV連携)

Ranorex編集部 — Mon, 17 Aug 2026 00:00:00 +0000

テスト環境の違いにより、人の目では判別しにくい微細な差異が原因で画像検証が失敗するケースがあります。OSSツールであるOpenCVとRanorexを連携し、OpenCVの高度な画像検証アルゴリズムを活用することで、微細な差分を自動的に許容して検証成功と判定できることを確認しました。

今回の記事では、RanorexとOpenCVを組み合わせた画像検証手法についてご紹介します。

OpenCVとは

OpenCV（Open Source Computer Vision Library）は、Intelが開発した画像処理・画像解析・コンピュータビジョン向けのオープンソースライブラリです。

2,500以上の最適化されたアルゴリズムが含まれており、画像の読み込み、保存、リサイズ、回転、グレースケール化、ノイズ除去などの基本的な処理に加え、画像比較に使われる構造類似度指標（SSIM: Structural Similarity Index Measure）などの高度なアルゴリズムも備えています。

SSIMは単純なピクセル差分ではなく、画像の明るさ、コントラスト、構造の類似性を評価し、人間の視覚に近い形で画像の差異を検出することができます。OpenCVはこのように幅広い画像処理機能に加え、高度な画像比較技術も提供しており、幅広い分野で利用されています。

OpenCVの公式サイトは以下です。(2026年8月時点)
https://opencv.org/

RanorexとOpenCVの連携でできること

Ranorexの画像検証機能は、ピクセル単位での厳密な比較で高精度な画像比較ができます。さらに、OpenCVと連携することで、OpenCVの構造類似度指標（SSIM）を用いたより高度な画像比較を利用できるようになります。この連携により、表示環境の違いによる微細な差分を柔軟に許容した画像検証が可能になります。

たとえば、ブラウザーや実行環境の違いにより発生する文字やグラフィックのわずかなズレや揺れを自動検知・調整することで、人間の目では認識できない微細な差分を許容し、より実用的な判定をおこなうことができます。※画像の複雑さなどで対応できないケースもあります。

RanorexとOpenCVの連携

Ranorexは C# / .NET Framework ベースで動作するツールのため、C#用のオープンソースラッパーである OpenCvSharp を利用します。ここでは、弊社環境で検証した画像比較の設定をご紹介します。※2026年8月時点の情報です。

1.RanorexプロジェクトにOpenCvSarpを追加する

1.Ranorexのプロジェクトで、NuGet パッケージマネージャーを開く。
メニューバー「プロジェクト」>「パッケージの管理」

2.検索ボックスに「OpenCvSharp」を入力し、OpenCvSharp core library と OpenCvSharp4 native bindings for Windows x64 をプロジェクトにインストールする。

※今回、ご紹介するユーザーコードでは StronglyTyped.PixelMatch.net のパッケージも利用しますので、追加が必要です。

2.ビルド対象（プラットフォームターゲット）を統一する

1.Ranorexのプロジェクトで、プロジェクトオプションを開く。
メニューバー プロジェクト > パッケージの管理

2.ターゲットCPUをインストールしたOpenCsSharpのビット数に合わせる。上記でインストールしたパッケージは64bitのため、64-bit Intel-compatible processor に設定する。

3.期待画像のスクリーンショットを用意する

今回、ご紹介するユーザーコードでは、手動で取得したスクリーンショットを期待画像として設定できますので、期待画像をローカルマシンに保存ください。また、今回の画像形式はPNGにしています。

4.TMX提供のオートメーションヘルパーの「ReportPageScreenshot」でスクリーンショットの取得アクションを追加する

TMX Automation Helpers リファレンス６：スクリーンショットの出力をご参照ください。
アクションを追加すると以下のような設定ができます。画像ファイルは モジュール名_yyyyMMdd_HHmm_出力画像ファイル名.png の名前で出力されます。

5.OpenCVを利用して、期待画像と実行時に取得した画像を比較するコードを記述する

1.ユーザーコードコレクションをプロジェクトに追加する

追加方法やメソッドの作成についての詳細はソースコードを使用したテスト作成 / ユーザーコードコレクションをご参照ください。

2.作成されたユーザーコードコレクションファイルに使用するパッケージを追加する

using System.IO;
using OpenCvSharp;         
using OpenCvSharp.Quality;

3.クラスに以下のメソッドを記述する

  
//取得したスクリーンショットの検索メソッド
private static string FindExistingImagePath(string currentImgDirPath, string mdName, string currentImgName, System.DateTime baseTime)
{
    int[] offsets = { -1, 0, 1 };  // ここでoffsetsを定義

    foreach (int offset in offsets)
    {
        System.DateTime checkTime = baseTime.AddMinutes(offset);
        string nowTimeStr = checkTime.ToString("yyyyMMdd_HHmm");
        string candidateFileName = $"{mdName}_{nowTimeStr}_{currentImgName}.png";
        string candidatePath = Path.Combine(currentImgDirPath, candidateFileName);

        if (File.Exists(candidatePath))
        {
            Report.Info($"存在する画像ファイルを発見: {candidatePath}");
            return candidatePath;
        }
    }
    return null;
}

//OpenCVを利用したSSIMによる画像検証メソッド
public static bool CompareImageBySSIM(string baseImgPath, string currentImgDirPath, string currentImgName, double ssimThreshold = 0.95)
{
    var curModule = TestModuleLeaf.Current;
    string mdName = curModule.Name;
    System.DateTime datetime = System.DateTime.Now;

    string currentImgPath = FindExistingImagePath(currentImgDirPath, mdName, currentImgName, datetime);
    if (currentImgPath == null)
    {
        Report.Error("±1分差のファイルが見つかりませんでした。ファイル名やディレクトリを確認してください。");
        return false;
    }

    using (Mat mat1Gray = Cv2.ImRead(baseImgPath, ImreadModes.Grayscale))
    using (Mat mat2Gray = Cv2.ImRead(currentImgPath, ImreadModes.Grayscale))
    {
        if (mat1Gray.Empty() || mat2Gray.Empty())
        {
            Report.Error("画像の読み込みに失敗しました。ファイルパスを確認してください。");
            return false;
        }

        // 背景（白）ではない「文字が存在する最小の四角枠」を自動検出
        Rect textRegion;
        using (Mat inverted = new Mat())
        {
            Cv2.Threshold(mat1Gray, inverted, 250, 255, ThresholdTypes.BinaryInv);
            textRegion = Cv2.BoundingRect(inverted);
        }

        if (textRegion.Width == 0 || textRegion.Height == 0)
        {
            textRegion = new Rect(0, 0, mat1Gray.Width, mat1Gray.Height);
        }
        else
        {
            textRegion.X = Math.Max(0, textRegion.X - 20);
            textRegion.Y = Math.Max(0, textRegion.Y - 20);
            textRegion.Width = Math.Min(mat1Gray.Width - textRegion.X, textRegion.Width + 40);
            textRegion.Height = Math.Min(mat1Gray.Height - textRegion.Y, textRegion.Height + 40);
        }

        // 割り出した「文字エリア」をテンプレート画像として切り出す
        using (Mat templateMat = new Mat(mat1Gray, textRegion))
        using (Mat matchResult = new Mat())
        {
            Cv2.MatchTemplate(mat2Gray, templateMat, matchResult, TemplateMatchModes.CCoeffNormed);
            Cv2.MinMaxLoc(matchResult, out _, out _, out _, out OpenCvSharp.Point maxLoc);

            float shiftX = textRegion.X - maxLoc.X;
            float shiftY = textRegion.Y - maxLoc.Y;

            Report.Info($"[位置補正自動計算] 検出された文字エリアのズレ -> X方向: {shiftX}px, Y方向: {shiftY}px");

            // アフィン変換行列を作成してテスト対象画像を全体シフト
            using (Mat translationMatrix = new Mat(2, 3, MatType.CV_32FC1))
            {
                translationMatrix.Set(0, 0, 1.0f);
                translationMatrix.Set(0, 1, 0.0f);
                translationMatrix.Set(0, 2, shiftX);
                translationMatrix.Set(1, 0, 0.0f);
                translationMatrix.Set(1, 1, 1.0f);
                translationMatrix.Set(1, 2, shiftY);

                using (Mat resizedMat2AlignedAll = new Mat())
                {
                    OpenCvSharp.Size baseSize = mat1Gray.Size();
                    Cv2.WarpAffine(mat2Gray, resizedMat2AlignedAll, translationMatrix, baseSize);

                    // 文字エリア（ROI）を切り出す
                    using (Mat roiBaseRaw = new Mat(mat1Gray, textRegion))
                    using (Mat roiTargetAlignedRaw = new Mat(resizedMat2AlignedAll, textRegion))
                    {
                        // --- 【修正】二値化＋モルフォロジー演算でエッジのガタつきを平滑化 ---
                        using (Mat binBase = new Mat())
                        using (Mat binTarget = new Mat())
                        using (Mat roiBase = new Mat())
                        using (Mat roiTargetAligned = new Mat())
                        {
                            // 固定値（200）で一律二値化し、判定基準のブレを無くす
                            Cv2.Threshold(roiBaseRaw, binBase, 200, 255, ThresholdTypes.Binary);
                            Cv2.Threshold(roiTargetAlignedRaw, binTarget, 200, 255, ThresholdTypes.Binary);

                            // 3x3の構造要素（カーネル）を作成
                            using (Mat kernel = Cv2.GetStructuringElement(MorphShapes.Rect, new OpenCvSharp.Size(3, 3)))
                            {
                                // クロージング処理（文字のフチの微細なギザギザ・ノイズを埋めて滑らかにする）
                                Cv2.MorphologyEx(binBase, roiBase, MorphTypes.Close, kernel);
                                Cv2.MorphologyEx(binTarget, roiTargetAligned, MorphTypes.Close, kernel);
                            }

                            // 平滑化された画像同士でSSIMを計算
                            using (var ssimCalc = QualitySSIM.Create(roiBase))
                            {
                                Scalar score = ssimCalc.Compute(roiTargetAligned);
                                double meanSSIM = score.Val0;

                                Report.Info($"[SSIM判定] エッジ平滑化後のスコア: {meanSSIM:F4} (閾値: {ssimThreshold})");

                                // 差分画像の保存処理
                                try
                                {
                                    using (Mat diffMat = new Mat())
                                    {
                                        Cv2.Absdiff(roiBase, roiTargetAligned, diffMat);
                                        using (Mat threshDiff = new Mat())
                                        {
                                            Cv2.Threshold(diffMat, threshDiff, 1, 255, ThresholdTypes.Binary);
                                            using (Mat highlightMat = new Mat())
                                            {
                                                Cv2.CvtColor(roiTargetAlignedRaw, highlightMat, ColorConversionCodes.GRAY2BGR);
                                                highlightMat.SetTo(new Scalar(0, 0, 255), threshDiff);

                                                string directory = Path.GetDirectoryName(currentImgPath);
                                                string filename = Path.GetFileNameWithoutExtension(currentImgPath);
                                                string diffImgPath = Path.Combine(directory, filename + "_diff.png");

                                                Cv2.ImWrite(diffImgPath, highlightMat);
                                                Report.Info($"差分画像を保存しました: {diffImgPath}");
                                            }
                                        }
                                    }
                                }
                                catch (Exception ex)
                                {
                                    Report.Warn($"差分画像の生成中にエラーが発生しました: {ex.Message}");
                                }

                                if (meanSSIM >= ssimThreshold)
                                {
                                    Report.Success("文字の位置ズレ、滲み、微細なガタつきはすべて許容されました。");
                                    return true;
                                }
                                else
                                {
                                    Report.Failure("形状平滑化後もスコアが低いため、文字の欠落やレイアウト崩れが発生しています。");
                                    return false;
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
  

記述内容：

文字が存在する領域（最小の四角枠）を自動検出
文字領域をテンプレートして、文字領域の位置ズレを補正
文字領域のクロージング処理で文字の輪郭の微細なギザギザやノイズを滑らかに補正
SSIM（構造類似度指数）を用いた画像比較
2つの画像の異なる箇所を赤色でハイライトした差分画像を保存

4.手順3で作成したメソッドを使ったユーザーコードアクションを「ReportPageScreenshot」メソッドのユーザーコードアクションの次に追加する

レコーディングモジュールの 新しいアクションの追加 のプルダウンメニューから、ユーザーコード（User code）‐ライブラリから選択を選択します。

以下の CompareImageBySSIM メソッドを選択します。

アクションを追加すると以下のような設定ができます。閾値は1に近い数値を設定することで、人の目では分からない微差のみを成功とできます。
※0.98以下になると人の目でも認識できる差分が成功となるケースがあります。

検証結果

検証対象の画像

環境の違いにより、全体的な文字ズレと文字の滲み・ギザギザ感が発生している画像を検証対象とします。たとえば、Chromeブラウザーで取得した期待画像を設定しており、テスト実行環境ではEdge Chromiumブラウザーでテストするケースなど。

検証結果レポート

文字の位置ズレや微細なガタつきを自動検出して、画像検証された結果、スコアは1で完全に一致と判定され、画像検証は成功しました。

成功パターン

人の目でも認識できる差分がある場合は、画像検証が失敗します。

失敗パターン

差分画像は出力先(currentImgDirPath)に保存されます。

差分画像

サンプルソリューション

本検証ができるサンプルソリューションは、以下のボタンからダウンロードできます。
※ダウンロードが始まらない場合は、Edgeブラウザーでお試しください。

画像検証_OpenCV連携ソリューションダウンロード

まとめ

Ranorexの画像検証機能は、ピクセル単位での厳密な比較で高精度な画像比較ができます。さらに、OpenCVと連携することで、OpenCVの構造類似度指標（SSIM）を用いたより高度な画像比較を利用できるようになり、人の目では判別しづらい微細な文字のズレやガタつきを補正し、許容範囲として正確に判定できます。

今回ご紹介したコードのように、お客様ご自身でOpenCVと連携したカスタム画像検証を実装することで、より実用的で柔軟な画像比較が可能になります。ぜひOpenCVの強力なアルゴリズムを活用し、お客様のニーズに合った画像検証環境を構築ください。

The post 環境差に対応した柔軟な画像比較 (Ranorex + OpenCV連携) first appeared on テスト自動化ツール『Ranorex』.

iOS 証明書・プロビジョニングプロファイルの作成手順

Ranorex編集部 — Thu, 18 Jun 2026 23:44:14 +0000

Appleの配布ポリシーの変更により、アプリケーションの配布および利用に関する制限が強化されました。
これまでは、Ranorex（外部企業）が署名した各アプリケーション（例：RxServiceApp、RxBrowser、RxMiniKeePass）をユーザー様環境でそのままご利用いただくことが可能でしたが、今後は、iOSのモバイルアプリケーションテストの際に、アプリケーションの署名元と利用元が一致している必要があります。
この変更にともない、RanorexでiOSのモバイルアプリケーションのテストをおこなう際は、ユーザー様ご自身で証明書およびプロビジョニングプロファイルを事前に作成のうえ、Ranorexが提供する各アプリケーションをインストールしてご利用いただく必要があります。

本記事では、証明書およびプロビジョニングプロファイルの概要と作成の流れを説明します。
本記事の最後に、作成手順の詳細資料を公開しておりますので、ダウンロードのうえ、是非ご活用ください。

事前準備

証明書の作成には、インターネット接続が可能なmacOS端末が必要となります。
証明書の作成およびプロビジョニングプロファイルの作成には、Apple社が提供するApple Developer Programのメンバーシップ（有料）への登録が必要となります。

証明書作成の流れ

証明書は、iOSアプリケーションの署名に使用される電子証明書を指します。
テスト対象のiOS端末にアプリケーションをインストールするためには、有効な証明書による署名が必要となります。

証明書要求（.certSigningRequest）の作成
証明書（.cer）の作成
証明書ファイル（.p12）の作成

プロビジョニングプロファイル作成の流れ

プロビジョニングプロファイルは、テスト対象のアプリケーションや証明書、実行端末の各情報がまとまったファイルを指します。
テスト対象のiOS端末でアプリケーションを実行するために必要となります。

アプリ識別子（Identifiers）の作成
端末の登録
プロビジョニングプロファイル（.mobileprovision）の作成

作成手順資料のご案内

証明書およびプロビジョニングプロファイルの詳細手順に関する資料は、以下のリンクからダウンロード可能です。
※証明書およびプロビジョニングプロファイルを使用した、RanorexでのIPAファイルのインストルメント手順については、Ranorex ユーザーガイドをご確認ください。

資料ダウンロード

The post iOS 証明書・プロビジョニングプロファイルの作成手順 first appeared on テスト自動化ツール『Ranorex』.

Ranorex StudioでSwiftUIアプリをシームレスにテスト

Ranorex編集部 — Fri, 21 Feb 2025 02:11:52 +0000

モバイル開発が進化するにつれ、AppleのSwiftUIフレームワークは、直感的なクロスプラットフォームUIを構築できることから、開発者の間で人気が高まっています。しかし、SwiftUIの採用が広まるにつれて、これらのアプリケーションが高い品質基準を満たすことを保証するためには、強力で効率的なテストソリューションが必要になります。

そこで、Ranorex Studioの出番です。SwiftUIの完全なサポートにより、Ranorex Studioは開発チームにおけるiOSのテストワークフローを合理化し、包括的なカバレッジと信頼性の高いパフォーマンスを保証します。これにより、Ranorex StudioはすべてのiOSアプリケーションの機能テスト自動化のための最適なソリューションとなります。

? SwiftUIとは？

SwiftUIは、iOS、macOS、watchOS、tvOSなどのプラットフォーム間でユーザーインターフェイスを構築するためのAppleの宣言型UIフレームワークです。
直感的なデザインとXcodeとの統合により、開発者はより少ないコードでより速くアプリを作成できます。

SwiftUIの台頭は、UIテストがこの最新のフレームワークを効果的に扱えることを保証するという、特徴的な課題をQAチームにもたらします。
SwiftUIを活用するアプリケーションが増えるにつれて、SwiftUIのコンポーネントとシームレスに連携できるテスト自動化ツールが、品質と効率を維持するために不可欠になります。

Ranorex StudioにおけるSwiftUIサポートのメイン機能

Ranorex StudioのSwiftUIサポートは、SwiftUIアプリケーションのテストプロセスを簡素化するように設計された堅牢な機能を導入します。
これらの機能により、テスト担当者は時間と労力を最小限に抑えながら最大限のカバレッジを達成できるため、Ranorex Studioは強力な味方となります。

正確なオブジェクト認識：SwiftUIの要素を簡単に識別して操作できるため、信頼性が高く一貫性のあるテスト作成が可能になります。
包括的なカバレッジ：すべてのUI要素の機能を検証し、デバイス全体でE2Eの保証を提供します。
合理化されたテスト作成： Ranorex SpyやRecorderなどのRanorexツールを使用して、SwiftUIベースのアプリのテストをすばやく作成および管理します。
既存のワークフローとの統合：最小限の対応でSwiftUIテストを自動化戦略に組み込みます。

? SwiftUIサポートがワークフローにとって重要な理由

SwiftUIをサポートすることで、Ranorex Studioは、高品質なiOSアプリケーションを提供することに重きを置く開発チームにとって将来を見据えたソリューションとなります。

効率性の向上：インテリジェントなオブジェクト認識と再利用可能なテストモジュールにより、テストの作成と管理に必要な手作業の労力を削減します。
コラボレーションの改善：QAチームはSwiftUIテストを既存のプロジェクトにシームレスに統合できるため、開発者とテスト担当者間の連携が向上します。
スケーラブルなソリューション：SwiftUIがAppleプラットフォームの標準になるにつれて、Ranorex Studioは開発トレンドに合わせてテスト戦略を進化させます。

実際のアプリケーション: Ranorexを使用したSwiftUIアプリのテスト

次のシナリオを考えてみましょう。あなたの開発チームは、動的なUIを作成するために、SwiftUIを使用してiOSアプリを作成しています。
この合理化されたアプローチにより、時間が節約され、メンテナンスの手間が軽減され、サポートされているすべてのプラットフォームでアプリが問題なく動作することが保証されます。

Ranorex Studioでは、 Ranorex Spyを使用してSwiftUIコンポーネントをすばやく識別し、オブジェクトリポジトリに追加して再利用できます。Ranorex Recorderを活用することで、複雑なスクリプトを書くことなく自動テストを作成できます。何よりも、これらのテストを実際のiOSデバイスで実行して、包括的なカバレッジを確保し、潜在的な問題を早期に特定できます。

Ranorex StudioでiOSテストを効率化

Ranorexは、デスクトップ（Windows）アプリ、Webアプリをはじめ、モバイルアプリ（iOS、Android）にも対応したUIテスト自動化ツールです。
Ranorex バージョン 11.6.0でSwiftUIをサポートしました。

この記事は、開発元 Ranorex 社 Blog 「Seamlessly Test SwiftUI Apps with Ranorex Studio」2025年1月14日の翻訳記事です。）

The post Ranorex StudioでSwiftUIアプリをシームレスにテスト first appeared on テスト自動化ツール『Ranorex』.

Ranorex オートメーションヘルパーの新たな機能をリリース！

Ranorex編集部 — Fri, 31 Jan 2025 02:11:58 +0000

Ranorexでは、オートメーションヘルパー機能として、コードモジュールとユーザーコードメソッドのコレクションが実装されており、このコレクションを使用することで、通常はコーディングスキルが必要な機能をノーコードでテストに使用することができます。

この度、Ranorexユーザー様のお声を元に、弊社、テクマトリックスにて作成したコードモジュールおよびユーザーコードメソッドをTMX版のオートメーションヘルパーとしてリリースしました。今回のリリース（バージョン 1.0）では、以下のユーザーコードメソッドを提供します。

メソッド一覧

TmxCalculateLibrary：四則演算や数値処理に関するメソッド
- CalculateAddition：指定した2つの数値の加算します
- CalculateSubtraction：指定した2つの数値の減算します
TmxSystemLibrary：システムに関するメソッド
- GetDateTimeAsString_en：英語ロケールで、システム日付を取得します
TmxValidationLibrary：検証に関するメソッド
- CompareImageFiles：指定した2つの画像ファイルを比較します
- ValidateLocation：オブジェクト画面の中央の座標位置が、期待する座標位置かを検証します
- ValidateDiffText：指定した2つのテキストを比較します
- ValidateDiffTextFile：指定した2つのテキストファイルを比較します
- ValidateBiggerThan2：2つの数字の大小を比較し、期待する数値が大きいかを検証します
- ValidateSmallerThan2：2つの数字の大小を比較し、期待する数値が小さいかを検証します
TmxReportLibrary：レポートに関するメソッド
- ~~AttachImageToExcel：指定した画像ファイルをExcelに張り付けます~~（※変更履歴を参照）
- ReportPageScreenshot：取得したスクリーンショットを指定したファイル名と場所に保存します

TMX版のオートメーションヘルパーの利用方法

TMX版のオートメーションヘルパーを以下のリンクからダウンロードしてください。
ダウンロードしたzipファイルを解凍し、フォルダ－に入っているユーザーガイドに沿って、ご利用ください。

TMX版オートメーションヘルパーダウンロード

TMX版のオートメーションヘルパーは、今後も新しいコレクションをリリースしていく予定であり、Ranorexユーザー様からのリクエストもお待ちしています。
※欲しい機能やメソッドなどのリクエストがございましたら、弊社、担当営業までご相談ください。
リクエストの内容によっては、実装が難しい場合もございますので、あらかじめご了承ください。

変更履歴

2025年05月26日：AttachImageToExcelメソッドにて一部、不具合が見つかったため、一旦、リストから外しました。
2025年05月26日：ユーザガイドのCompareImageFilesメソッド名に誤りがあったため、修正しました。
2025年05月26日：ユーザガイドのセットアップにて、注意事項に「Visual Studio 2022および、Visual Studio Build Tools 2025をインストールされているマシンでの利用」を追加しました。

The post Ranorex オートメーションヘルパーの新たな機能をリリース！ first appeared on テスト自動化ツール『Ranorex』.

Ranorex：デバッグ実行

Ranorex編集部 — Fri, 02 Feb 2024 02:00:49 +0000

Ranorexで作成したテストが「うまく動かない」となったとき、通常は、レポートのエラーメッセージを確認してテストを修正したり、メンテナンスモードを使用してエラー箇所を特定します。しかし、エラーの原因が特定できなかったり、ユーザーコードを使用してテストを作成している場合は、RanorexのGUI上から、直接テストコードをデバッグすることもできます。

そこで、本記事では、Ranorexによるデバッグ実行についてご紹介します。

Ranorexによるデバッグ実行

デバッグ実行を行う際には、事前にデバッグ機能を有効化する必要があります。

1．デバッグの有効化

デバッグ機能を使用するためには、以下のいずれかの方法でデバッグを有効化します。

①Ranorex Studioにて、”デバッグ”メニューを開き、”デバッグの有効化”にチェックを入れます。

②Ranorex Studioのツールバーから、”デバッグの有効化”をクリックします。

有効化すると、デバッグの項目がツールバーに表示されます。

※注意：デバッグの有効化を行った上でテストを実行する場合、Ranorex Studioを管理者権限で起動する必要があります。

2．ブレークポイントの設定

特定の位置でテストを一時停止する場合は、ブレークポイントを設定します。

1.Ranorexにてソースコードを開きます。
　例）レコーディングモジュールの*.UserCode.csファイル

2.プログラムを一時停止したい箇所にブレークポイントを設定します。

3．デバッグ実行

RUNボタンをクリックし、デバッグ実行を行います。

ブレークポイントを設定している場合、テスト実行中に、変数の状態やコールスタック（関数の呼び出し経路）などを確認することができます。

また、デバッグ実行中は「ステップオーバー」「ステップイン」「ステップアウト」が利用できます。

※ツールバーのアイコンをクリック、または、”デバッグ”メニューから利用します。

・ステップオーバー：1行単位でステップ実行する中でメソッドがあった場合に、メソッドの中には入らず次の行に進みます。

・ステップイン：1行単位でステップ実行する中でメソッドがあった場合に、メソッドの中に入って実行します。

・ステップアウト：親のメソッドに戻るまで、今実行しているメソッドの処理を進めます。

まとめ

本記事では、Ranorexのデバッグ機能についてご紹介しました。
詳細については以下のページをご参照ください。

・Ranorex Studio IDE – デバッグ

The post Ranorex：デバッグ実行 first appeared on テスト自動化ツール『Ranorex』.

Ranorex：ライセンス管理

Ranorex編集部 — Fri, 13 Oct 2023 02:00:38 +0000

Ranorexバージョン10.7のライセンス管理サーバー（Ranorex License Manager）において、ライセンスキー（フローティングライセンス）を利用するクライアント（Ranorexを利用するマシン）を制限することができる機能が追加されました。開発プロジェクトやチーム別で使用するライセンスキーを振り分けたい場合、これまではライセンス管理サーバーをそれぞれ用意する必要がありましたが、この機能を使用することで１つのライセンス管理サーバーで対応することが可能となります。

対応方法として、ライセンスキーと利用したいクライアントマシンのIPアドレスを紐づけることで、ライセンスキーに紐づいたIPアドレスを持つクライアントのみ、そのライセンスキーを利用することができるようになります。

※国内リリース版のRanorexでは、バージョン10.7.2以上のRanorex License Manager（RanorexLicenseManager-10.7.2-ja.exe）で本機能を使用することができます。

(クライアントと紐づいたライセンスキーの管理イメージ）

設定方法

１．ライセンスキーとクライアントの紐づけ

① ライセンス管理サーバー（Ranorex License Manager）にて、ライセンス設定画面を管理者権限で起動します。
Windowsのアプリ一覧から”Ranorex License Manager” – “Ranorex License Manager X.x”を右クリックし、表示されるメニューにて「その他」‐「管理者として実行」を選択します。

② 「許可されたIPアドレス」タブを開きます。

③ ライセンスのリストからクライアントに紐づけしたいライセンスキーを選択します。

④ IPアドレスの入力フォームにクライアントのIPアドレスを入力し、「IPアドレスを追加」をクリックします。

以下のように、対象ライセンスキーに対して、追加したIPアドレスが登録されます。

※紐づけされたライセンスキーは、対象クライアント（IPアドレス）以外から利用することができなくなります。また、何も紐づけされていないライセンスキーは、どのクライアントからも利用することが可能です。

※紐づけされた情報は、”C:\Program Files (x86)\Ranorex\License Manager\Bin\LicensorInfo.json“ファイルに保存されます。

[
  {
    "HostsList": [
      {
        "IP": "192.168.11.1",
        "IsEnabled": false
      },
      {
        "IP": "192.168.11.2",
        "IsEnabled": false
      }
    ],
    "LicenseKeyName": "WAH6-HVX9-2DGH-####-####-6YAF-VQYL-4M7E-3M4K-2D4"
  },
  {
    "HostsList": [
      {
        "IP": "192.168.11.1",
        "IsEnabled": false
      },
      {
        "IP": "192.168.11.3",
        "IsEnabled": false
      }
    ],
    "LicenseKeyName": "PVSM-EMZW-E4VQ-####-####-Y994-FFXW-2ZFL-M9K2-LF2"
  }
]

2．ライセンスキーに紐づけされたクライアントの確認

ライセンスのリストからライセンスキーを選択することで、そのライセンスキーに紐づいたクライアント（IPアドレス）の情報を確認することができます。

3．ライセンスキーとクライアントの紐づけ解除

ライセンスのリストからライセンスキーを選択後、解除したいクライアントのチェックボックスを有効にし、「IPアドレスの削除」をクリックします。

The post Ranorex：ライセンス管理 first appeared on テスト自動化ツール『Ranorex』.

Safariブラウザのテスト

Ranorex編集部 — Thu, 28 Sep 2023 02:23:20 +0000

Ranorex 10.7より、iOS端末のSafariブラウザでのテストが可能となりました。そこで、本記事では、iOS端末のSafariブラウザでRanorexのテストを実施する方法をご紹介します。

※本記事では、Safariブラウザでのテストに必要な設定をご紹介していますので、Ranorexでモバイルテストを実施する際に必要なモバイルデバイスの登録、及び、RxServiceAppのインストールはこちらをご参照ください。
※本記事の手順では、iOSバージョン16を使用しています。iOSのバージョンによっては表示される画面が異なる場合があります。

Safari ブラウザのテストの注意事項

RanorexにおけるSafariブラウザのテストでは、以下の操作がおこなえません。

Safariブラウザを閉じる
複数のタブを開く(新規にURLを開いた場合、既存のタブは終了されます)

これらの操作の自動化が必要な場合、RxBrowserでのテスト、あるいはAppium連携でのテストをご検討ください。

iOS端末の設定

Safariブラウザでテストを実施する場合は、事前にiOS端末のセットアップが必要となります。
※RxServiceAppをインストールしてから実施します。

1.iOS端末にて、[設定]アプリを開きます。

2.[Safari]から、[拡張機能]をタッチします。

3.[Ranorex Safari Extension]をオンにします。

4.[すべてのWebサイト]をタッチし、[許可]を選択します。

ここまで設定をおこなったら、[設定]アプリは閉じます。

テストの作成

テストの作成は、RxBrowserやネイティブアプリと同じ方法で実施しますが、作成時のテスト対象アプリには[RxServiceApp]を選択します。

1.iOSデバイス上でRxServiceAppを起動します。

2.Ranorex Studioで[RECORD]ボタンをクリックし、[アプリの選択または追加]から、[RxServiceApp]を選択します。

3.WebサイトのURLを指定し、[作成]をクリックします。iOS端末にてSafariブラウザが起動されるので、オブジェクトを取得していきます。
※モバイル端末でのテストの作成方法はこちら

テストの実行

テストの実行は、RxBrowserやネイティブアプリと同じ方法で実施します。Ranorex Studioから[RUN]ボタンをクリックすることで、Safariブラウザ上でのテストが実行できます。

注意点

Safariブラウザでのテストは、iOS15以降が対象となります。

テストの作成/実行の際には、iOS端末にてRxServiceAppを開いた状態で開始してください。

RxBrowserで作成済みのRanorexソリューションをSafariブラウザでテスト実行することはできません。

iOS 18.5以降でSafariテストができない

The post Safariブラウザのテスト first appeared on テスト自動化ツール『Ranorex』.

ユーザーコードリファレンス：スクリーンショットの名前や出力場所の変更

Ranorex編集部 — Fri, 25 Aug 2023 06:59:59 +0000

テスト実行時のエビデンスとして取得するスクリーンショットを管理しやすくするために、スクリーンショットの名前や出力場所を変更したいといったご意見をユーザー様からよくいただきます。こちらについては、Ranorex のユーザーコード機能を使用して、コードを書くことで簡単に実現できます。今回は、スクリーンショットの名前や出力場所を変更するサンプルのユーザーコードをご紹介します。

ユーザーコードの作成

ユーザーコードコレクションによるコーディングをすることで、どのレコーディングモジュールからでも、User Code アクションでユーザーコードを呼び出すことができます。
ユーザーコードコレクションによるコーディング方法については、こちらをご参照ください。

今回、ご紹介するサンプルのユーザーコードは、以下のような処理になります。

対象オブジェクトのスクリーンショットの取得
スクリーンショットの取得が実行されたときのモジュール名と日時の取得 (スクリーンショット名に使用するため)
任意のスクリーンショット名でイメージファイルに出力
イメージファイル出力パス + 実行時のモジュール名と日時 + 末尾のスクリーンショット名 (画像形式の拡張子も含む)
スクリーンショットをレポートファイル(rxlog)に出力

サンプルコード

ここでご紹介するサンプルコードは、Ranorex 10.7で動作することを確認したものになります。

1. ユーザーコレクションにて、以下の2つの名前空間を定義します。

using Ranorex.Core.Repository;
using System.IO;

2. 新規メソッドを作成し、以下のコードを記載します。

public void Screenshot(RepoItemInfo repoInfo, String outputImgPath,String outputImgName)
{
//スクリーンショットの実行
Bitmap screenShot = repoInfo.FindAdapter().CaptureCompressedImage();

//モジュール名の取得
var curModule = TestModuleLeaf.Current;
string mdName= curModule.Name;

//テスト実行時の日時の取得
System.DateTime datetime = System.DateTime.Now;
string nowTime = datetime.ToString("yyyyMMdd_HHmm");

//スクリーンショットをイメージファイルに出力（ファイル出力パス+モジュール名+日時+スクリーンショット名）
screenShot.Save(outputImgPath + "/" + mdName + "_" + nowTime + "_" + outputImgName);

//スクリーンショットをレポートファイルに出力
Report.LogData(ReportLevel.Info, "スクリーンショット", screenShot);
}

解説

public void Screenshot(RepoItemInfo repoInfo, String outputImgPath,String outputImgName)

引数には、スクリーンショット対象のオブジェクト (RepoItemInfo repoInfo)、イメージファイルの出力パス (String outputImgPath)、末尾のスクリーンショット名 (outputImgName) を指定しています。

//スクリーンショットの実行
Bitmap screenShot = repoInfo.FindAdapter().CaptureCompressedImage();

Ranorex API の CaptureCompressedImage を使用して、対象のオブジェクトのスクリーンショットを取得する処理になります。
FindAdapter の種類をサンプルのようににすることで、アダプタのタイプ(Form、WebDocument、等)を特定せずに実装いただけます。

//モジュール名の取得
var curModule = TestModuleLeaf.Current;
string mdName= curModule.Name;

Ranorex API の TestModuleLeaf.Current と curModule.Name を使用して、スクリーンショット時の実行モジュールの名前を取得します。

//テスト実行時の日時の取得
System.DateTime datetime = System.DateTime.Now;
string nowTime = datetime.ToString("yyyyMMdd_HHmm");

.NET クラスライブラリを使用して、スクリーンショット時の年月日と時間(時間+分)を取得します。

//スクリーンショットをイメージファイルに出力（ファイル出力パス+モジュール名+日時+スクリーンショット名）
screenShot.Save(outputImgPath + "/" + mdName + "_" + nowTime + "_" + outputImgName);

引数で指定したイメージファイルの出力パス(outputImgPath)に、モジュール名+日時+スクリーンショット名(outputImgName)のイメージファイルが出力されます。
例：RecordingModule1_2023825_0930_FormScreenshot1.jpg

//スクリーンショットをレポートファイルに出力 
Report.LogData(ReportLevel.Info, "スクリーンショット", screenShot);

Ranorex API の Report.LogData を使用して、レポートにスクリーンショットを出力します。

ユーザーコードアクションの追加と引数の指定

1. 対象のアクションテーブルにて、スクリーンショットを取りたい場所で右クリック > 新しいアクションの追加 > ユーザーコード(User code) > ライブラリから追加 を選択します。

2. ライブラリ画面から、作成した対象のメソッドを選択し、選択項目を追加 ボタンをクリックします。

3. 追加されたユーザーコードアクションの引数 repoInfo(RepoItemInfo) に、スクリーンショット対象のオブジェクトを指定します。
リポジトリから対象のオブジェクトを repoInfo(RepoItemInfo) にドラッグ&ドロップします。

4. 引数 outputImgPath(String) に、スクリーンショットを出力したいフォルダパスを指定します。

5. 引数 outputImgName(String) に、末尾のスクリーンショット名(拡張子も含む)を指定します。
※JPG、PNG形式で出力できます。

こちらの設定で、テスト実行することで、手順4で指定したフォルダに、対象オブジェクトのスクリーンショットが任意の名前で出力されます。

まとめ

スクリーンショット名や出力フォルダを変更することで、スクリーンショットの管理がしやすくなりますので、ぜひこちらのコードを参考にして、ご活用ください。
また、Ranorex API の詳細につきましては、Ranorex Studio のメニューバーから ヘルプ > API ドキュメント をご参照ください。

The post ユーザーコードリファレンス：スクリーンショットの名前や出力場所の変更 first appeared on テスト自動化ツール『Ranorex』.

Ranorex機能 - テスト自動化ツール 『Ranorex』