ASNA WingsRPG™ Reference Manual

Import Display Files Dialog

The following are entries that need to be completed to import Display Files.

Legacy source location Description

Use login credentials

Select this option if you do not have a "database name" associated with the IBM i where the Display Files are located.

   Server

The IP resource name associated with the IBM i where the Display Files are located.

   User

The IBM i login user name.

   Password

The IBM i login password.

   Port

The TCP/IP port used by DataGate 400 service. If you don't know the port number, use "5047".

Use Database Name

Select this option if you have a "database name" associated with the IBM i where the Display Files are located.

   Database

The DataGate "database name" that defines the IBM i connection credentials.

Library

The IBM i library where the source member is located.

File

The IBM i file name where the source member is located.

Use Regular expressions checkbox

Check this option if you want to enter a regular expression pattern instead of the member name to process batch import.

Member

The group of members to convert, either typed in manually, selected using the wildcards described below, or, if the "Use Regular expressions" option is checked, the regular expression to be used to process in batch.

Browse member button (...)

Press the button labeled "..." to request a dialog box where you can select the member out of the available members in the database, library and file location indicated above. See Browse Member Button (...)

Import options

File field-reference library list
(use a space between entries)

The library-list to be used while resolving field-references. If no field-references are used in the DDS description, you can leave this entry blank, otherwise enter a space-separated list of IBM i libraries.

Language

Select from the list the .NET programming language used when the Wings website was created. Valid languages are: Visual RPG, C# and Visual Basic.

Web page name

The ASPX filename to be used for the imported display file. If you want the same name as the member name, you can leave this entry blank.

Same as source member checkbox

Check this option if you want to to keep the member name as the name of the ASPX file to be created. The new file will always have the extension "aspx".

Namespace

The .NET to be used when writing code-besides.

Advanced (...)

Press the button labeled "Advanced ..." to configure more options.

Advanced options

Grid Settings:

Horizontal Spacing

Enter the numbers of pixels for the character cell's width. The absolute horizontal position for any field would be this measurement multiplied by the column position on the DDS record.
On a Web Page, character's width is determined by the font used, which is normally proportionally spaced (meaning that an "i" is narrower than an "M" character), therefore a label most likely will not end in the same position as when it was rendered on the green-screen. When using multi-column field dispositions, adjusting the "Horizontal Grid Spacing" may produce different column spacing.

Vertical Spacing

Enter the numbers of pixels for the character cell's height.
On a Web Page, character's width is determined by the font used. Adjusting the "Vertical Grid Spacing" will produce more spacing between lines on the Page.

Misc:

Write Code Behind Errors

Unsupported DDS Keywords (critcal or not) are always reported on the Visual Studio Output window. This listing is cleared when Visual Studio closes (or when the user requests it be cleared).

However, you can control when and how errors are reported in the ASPX code behind. For each level of error severity, you can specify:

Ignore – Do not report in code behind.

Issue as Comment – The error message will appear only as a comment.

Issue as Error – The Error message will appear in the compiler output as an error and the build will fail.

Hint – You can review and change the message file used by Wing Design Aid: DDS.MIGRATION.MSGFILE. By default, it is located at "C:\Program Files (x86)\Microsoft Visual Studio\2019\[Visual Studio Version]\ Common7\IDE\Extensions\ASNA\Monarch Wings Design Aid\10.0" The severity and/or text of the message can be modified. Be aware that the file may be automatically replaced whenever a Wings Design Aid upgrade is installed.

Monarch:

Default Template Folder

When ASNA Wings (or ASNA Monarch Cocoon) is installed, a folder is created with templates to be used as patterns for the generation of the ASPX or Code-behind files. If you want to modify the templates, it is best to copy the files you wish to change to a different folder, and configure this folder as the "User Template Folder" as explained below.
Enter the location of the installed folder template.

Display Size

This specifies which display size condition to evaluate during the DDS conversion. Supported values are *DS3 and *DS4. For more details see the Display Size topic.

Labels to Discard

You may enter a space-delimited list of rows that should be ignored during the import process.
This may be useful to eliminate function key labels – usually on row 24, which may look redundant once imported as a Web Page.

User Template Folder

Overrides template files used during the import process. Any template required by the import process will be searched in this folder first, and, if not found, will continue looking in the "Default Template Folder" (see description above).

The Import DDS dialog supports two distinct wildcards as well as regular expressions, allowing users much greater flexibility in searching for and selecting the desired files. The wildcards and some examples of how they work are described in the tables below, to learn more about regular expressions (a more advanced syntax for text searching) visit Regular-Expressions.info or the regular expressions guide at Zytrax.com.

Character Meaning Regular Expression Equivalent

* (asterisk symbol)

Zero or more characters in that position

(.*)

? (question mark symbol)

Any character in that position. (A single character.)

(.)
Expression Description Matches

Mac*

Names beginning with "Mac" Mac
MacIntosh
Mackenzie
J*n Names starting with "J" and ending with "n" Jon
Johnson
Jason
Juan
*son Names ending with "son" Johnson
Jason
Son
Anderson
*sam* Names with "sam" anywhere in the string Sam
Samson
Grossam
Mac? Names exactly four character long, the first three being "Mac" Mack
Macks
?dam Names exactly four character long, the last three being "dam" Adam
Odam
*s?n Names containing "s" and "n" at the end of the value with any one character between them and any number of characters before the "s". Anderson
Andersen
Jackson
san
sun

For more information describing the Import process see Importing Display File Process.