User Guide Interface definitions Class mapping

 $ Class Maps entity

$ Class Maps entity

For every new interface created in TestArchitect, a default $ Class Maps entity is assigned. This entity is user-editable and allows for user-defined mappings to be created between native control classes and TA classes.In addition, it allows for native control classes to be mapped to user-defined TA classes.

• Windows Presentation Foundation (WPF)
• Win32
• iOS
• Android
• Silverlight
• Windows Forms (WinForms)
• SAP

In the $Class Maps entity, you can manually add new mappings, and edit or remove existing ones. It is suggested, however, that you create your mappings through the Interface Viewer (or Element Definition window), from which you may launch dialog boxes, such as Map to Known Class, or Map to New Class to accomplish these tasks.

A $Class Maps entity consists of three arguments:

1. ta class: The TA class (built-in or user-defined) to which a control is mapped.

   Notes: 
   A user-defined TA class is one that TestArchitect does not inherently know anything about. Of TestArchitect’s large library of user-interface built-in actions, only the most generic ones, such as click, check control exists, and get control property, can operate on controls mapped to such a class. You may, however, effectively extend TestArchitect’s library of actions by creating user-scripted actions that are specifically designed to apply to your new user-defined TA class.

2. native class:

   • native class property (WPF, Silverlight)
   • win class property (Win32)
   • class name property (iOS)
   • raw class property (Android)
   • SAP property

3. role:

   • role property (WPF)
   • win type property (Win32)
   • class name property (Silverlight)
   Restriction: 
   role argument is unavailable with iOS and Android applications.

For example, the mapping entry below can be interpreted as “every control whose native class property is System.Windows.Controls.Button, and whose role is button, is mapped to TA class button ”:

Related tasks

Mapping unknown controls to a new class

Remapping known controls to a new TA class