バージョン：23.5

RDPを使用した非米国英語キーボードの使用

Eggplant FunctionalとVirtual Network Computing (VNC)またはRemote Desktop Protocol (RDP)接続タイプを使用して、テスト対象のシステム(SUTs)上で非米国英語キーボードを使用することができます。非米国英語キーボードをEggplant FunctionalでSUTs上で使用する方法についての情報を以下に提供します。

Eggplant Functionalと非英語キーボードを使用するための追加の情報と代替手段については、FAQ記事How do I use non-English keyboards with Eggplant Functional?を参照してください。

VNC SUT接続のための

Eggplant Functionalで非米国英語キーボードを使用するためのサポートは、VNCサーバーに組み込まれています。VNCで接続するSUTs上で非米国英語キーボードを使用するために特別な設定は必要ありません。

RDP SUT接続のための

RDP SUT接続で非米国英語キーボードを使用するためのEggplant Functionalのサポートは、言語により追加の設定が必要です：

フランス語、ドイツ語、および英国英語言語のために、私たちはキーボードレイアウトマッピングを提供します。以下のUsing the Provided Languagesに記述されているように、Eggplant FunctionalおよびSUTで希望する言語を選択して設定します。
他の言語のためには、以下のCreating a Keyboard Layout Mapping Fileに記述されているように、Eggplant Functional内で自分自身のキーボードレイアウトマッピングファイルを作成することができます。

これらの設定のいずれかで非US英語キーボードを実装する方法に関する詳細な情報は以下に記載されています。

使用されている言語の使用

RDPで接続するSUT上でフランス語、ドイツ語、または英国英語を使用したい場合、以下に記述されているように言語を設定する必要があります：

Eggplant Functionalツールバーから**Control > RDP Keyboard Layout >**そして French、German、または UK Englishを選択します。
それに接続する際、SUTでも同じ言語を選択します。

ノート

ライブモードでは、Eggplant Functionalは常にUS Englishキーボードを使用します。キーボード設定の変更は、スクリプト化されたキーボードアクション（すなわち、typeTextコマンド）にのみ影響します。

他の言語の使用

Eggplant Functionalは、自身のキーボードレイアウトマッピングファイルを作成するオプションを提供することで、提供された言語に加えて他の言語の使用をサポートしています。新しいレイアウトマッピングファイルを作成することを選択すると、ファイルが作成されます。あなたは希望する言語のキーコードでそれを変更する必要があります。

キーボードレイアウトマッピングファイルの作成

以下に、キーボードレイアウトマッピングファイルの作成について知っておくべきこと、そして作成されてはいるが編集されていないファイルの内容を提供します。以下のトピックがカバーされています：

ステップバイステップ：キーボードレイアウトマッピングファイルの作成
キーボードレイアウトマッピングファイルの内容
キーボードレイアウトマッピングファイルの要件
キーボードレイアウトマッピングフォーマットの例
ステップバイステップ：キーボードレイアウトの実装

ステップバイステップ：キーボードレイアウトマッピングファイルの作成

キーボードレイアウトマッピングファイルを作成するには、以下の手順を実行します：

Eggplant Functionalを起動します。
Control > RDP Keyboard Layout > Create new を選択します。新しいキーボードレイアウトウィンドウが開き、新しいファイルの名前を付けて KeyboardLayouts ディレクトリに保存するように指示します。これは、Eggplant Functionalのアプリケーションディレクトリ構造内にあります。Eggplant Functionalをデフォルトのインストールディレクトリにインストールした場合、KeyboardLayoutsディレクトリは以下の場所のいずれかにあるでしょう：

MacとLinux上で： ~/Library/Eggplant/KeyboardLayouts.
Windows上で： ~/Application Data/Eggplant/KeyboardLayouts.

マッピングファイルには、あなたにとって意味のある名前を付けます。例えば、私たちのフレンチキーボードレイアウトファイルは "French.txt." と名付けられています。
マッピングファイルをテキストファイルとして .txt 拡張子で保存します。これがデフォルトです。ファイルはテキストファイルとして 保存する必要があります 。
ファイルを保存した後、KeyboardLayoutsディレクトリでそれを見つけてテキストエディタで編集することができます。

注記

あなたが追加したい言語ごとにこのプロセスを繰り返す必要があります。

キーボードレイアウトマッピングファイルの内容

以下は、作成されたが編集されていないキーボードレイアウトマッピングファイルの内容です。それはキーを設定するための例示コードを含んでいます。

重要

このサンプルコードをあなたの言語のコードで 置き換える必要があります 。

{
  "~": {
    "altFlag": "DOWN",
    "scancode": 27,
    "controlFlag": "DOWN"
  },
  "`": {
    "shiftFlag": "DOWN",
    "scancode": 13,
    "altFlag": "UP",
    "controlFlag": "UP"
  },
  "?": {
    "shiftFlag": "DOWN",
    "scancode": 12,
    "altFlag": "UP",
    "controlFlag": "UP"
  },
  "/": {
    "shiftFlag": "DOWN",
    "scancode": 8,
    "altFlag": "UP",
    "controlFlag": "UP"
  },
  "1": {
    "scancode": 2
  }
}

キーボードレイアウトマッピングファイルの要件

以下は、Eggplant Functionalによるキーボードレイアウトマッピングファイルおよびマッピングの要件です：

ファイル形式の要件

あなたが追加したい各言語について、一つのマッピングファイルを作成する必要があります。
各マッピング ファイル は、文字 { で始まり、文字 } で終わる必要があります。

キーマッピング要件

ファイルには、USキーボードキーマッピングと異なる文字だけについてマッピングを含める必要があります。ファイルでマップされていない任意の文字については、USキーボードマッピングが使用されます。
各キーのマッピングには、マッピングする文字、スキャンコード、必要な修飾キーのフラグを含める必要があります。（修飾キーとは、Alt、Shift、または Control (CTRL) のことです。その文字に必要な修飾キーがない場合は、修飾キーのフラグを省略できます。たとえば、USキーボードの文字 # では、他の修飾キーの状態に関係なく、Shiftキーが押されている必要があります。したがって、他の修飾キー（つまり、CTRLとAlt）をExample 2で示されているマッピングに含める必要はありません。

各キーには一つのスキャンコードがありますが、各キーには複数のマッピングが可能です。なぜなら、それは異なる文字に使用することができるからです。例えば、USキーボードの数字4のキーは、Shiftキーが押されているときには # 文字にも使用されます。下の例1と例2を参照してください。

キーボードレイアウトマッピングフォーマットの例

以下は、非US英語のキーボードレイアウトマッピングファイルに対してEggplant Functionalが必要とする形式でのキーマッピングの例です。マッピングの説明が続きます。

例 1

最初の例は、MicrosoftのUnited States 101 Keyboard (Windows CE 5.0)からの数字4のマッピングを使用しています。このUnited States 101 Keyboardページの表を見て、以下の例と比較して、Eggplant Functional形式のキーマッピングがどのように見えるかを確認することができます。この例は数字4のマッピングを示しています：

"4": {
  "shiftFlag": "UP",
  "scancode": 04
}

マッピングの形式は次の通りです：

"4" マッピングの最初のアイテムはマッピングしているキャラクターです。
"shiftFlag" : "UP", このキャラクターはShiftキーが "UP" の位置にあることを必要とすることを示しています。
修飾キーのフラグに続くカンマは、上記のようにフラグを区切り、次のフラグまたはこの場合のスキャンコードから区別します。キー修飾子フラグとスキャンコードは、最後のものを除いてカンマで区切られていなければなりません。
"scancode" はキーのスキャンコード（04）です。

"shiftFlag" と "scancode," や他の修飾キーのフラグの順序は関係ありません。

例3

2つ目の例は、上記で参照した同じUnited States 101キーボードからのハッシュタグ（#）文字のマッピング形式を示しています。#文字は数字4と同じキーにあり、同じスキャンコードを持っています。Shiftキーの位置が文字を区別します：#文字の "shiftFlag" の位置は "DOWN," であり、数字4の場合は "UP" です。

"#": {
  "shiftFlag": "DOWN",
  "scancode": 04
}

例2

3 番目の例は、ドイツ語キーボードレイアウトの中括弧 ({) 文字マッピングを示しています。このマッピングは、Alt キー ("altFlag") と Control (CTRL) キー ("controlFlag") 修飾キーの修飾キーフラグの使用を示しています。

"{": {
  "shiftFlag": "UP",
  "scancode": 8,
  "altFlag": "DOWN",
  "controlFlag": "DOWN"
}

ステップバイステップ：キーボードレイアウトの実装

キーボードレイアウトマッピングファイルを作成したら、以下の手順に従って、Eggplant Functionalでお使いの言語のキーボードレイアウトを実装します。

編集したマッピングファイルを保存した後、それを実装するためにEggplant Functionalを再起動する必要があります。
Eggplant Functionalで新しい言語を設定します。Control Menu > RDP Keyboard Layout > your_new_language を選択します。これは現在キーボードレイアウトメニューのオプションです。
RDPを使用してSUTに接続し、SUTで同じ言語を設定します。 (前の二つの設定ステップは、上記のUsing Provided Languagesで説明されているものと同じです。)

これで、SUTを目的の言語でテストする準備が整いました。

VNC SUT接続のための​

RDP SUT接続のための​

使用されている言語の使用​

他の言語の使用​

キーボードレイアウトマッピングファイルの作成​

ステップバイステップ：キーボードレイアウトマッピングファイルの作成​

キーボードレイアウトマッピングファイルの内容​

キーボードレイアウトマッピングファイルの要件​

ファイル形式の要件​

キーマッピング要件​

キーボードレイアウトマッピングフォーマットの例​

例 1​

例3​

例2​

ステップバイステップ：キーボードレイアウトの実装​