Release Notice for Customers Upgrading to EPC141006

Product

Visual LANSA Framework (VLF)

Build Number

141006

Pre-RequisiteDetails
  • Partitions must be multilingual and RDMLX enabled.
  • VLF-ONE requires either Chrome (latest), Firefox (latest), MS IE10 or MS IE11 for developers and end-users.
  • If you are using RAMP-TS then developers must have MS IE10 or MS IE11 installed.
  • For RAMP-TS applications aXes software must be at version 3.11 or later, and aXes 3.11 patches Axes_ANY_Patch_VLFONE_155198 and Axes_311000_Patch_RAMP_155820 must be applied.
  • Any Newlook software used with RAMP applications must be at version 8.0.5.14769 or later.
  • If you upgrade Newlook software, new license codes may be required. 

 

Valid Upgrade Paths
Current VLF Version / Build Number Can upgrade directly to EPC141006? Additional Actions you need to take

EPC868

Yes

Obtain copies of the EPC870.HTM, EPC130100.HTM and EPC132100.HTM upgrade notices. Add all Additional Actions they indicate to the Additional Actions for EPC141006 listed below.

EPC870

Yes

Obtain copies of the EPC130100.HTM and EPC132100.HTM upgrade notices. Add all Additional Actions they indicate to the Additional Actions for EPC141006 listed below.

EPC130100

Yes

Obtain a copy of the EPC132100.HTM upgrade notice. Add any Additional Actions it indicates to the Additional Actions for EPC141006 listed below.

EPC132100

Yes

Perform the Additional Actions listed below.

EPC140006

Yes

Perform the Additional Actions listed below.

If your VLF version is not listed contact your LANSA vendor for advice.

To find out your version start your Framework as a designer. Use the Help -> About menu options. Scroll to find VL Framework Build Number.

Full Distribution

This is a full distribution. It may be used to install a brand new VLF or to upgrade an existing one.

Additional Post Install/Upgrade Actions

1. You must upgrade all partitions within a LANSA system.

2. On IBM i servers, when the VLF-ONE demonstration system is required, you should use the Partition Initialize administration option to import the PERSYS (Personnel demonstration system) material - even if you have already imported PERSYS prior to applying EPC141006.

3. All XML files (Framework definitions) should be opened and resaved.

4. Any VLF-ONE custom entry points derived from UF_OEXEC must be recompiled. If you have a #VLF_ONE.uTerminate method call you may need to add parameter Browserisclosing(True) to it.

5. Any VLF-ONE server custom logon components must be recompiled.

6. If you have created VLF tools or extensions that use private (ie: undocumentented) VLF-WIN or VLF-ONE properties, methods or events you may need to modify and/or recompile them.

7. Custom VLF-WIN developer or designer entry points may no longer function.

  1. * Administrator and end-user entry points will still function.
  2. * A custom designer entry point would have originated from copying UF_DESGN, a developer entry point from copying UF_DEVEL.
  3. * Upgraded entry points have an invalid method named ProcessHelpRequest that need to be replaced with:

    

Mthroutine Name(ProcessHelpRequest) Options(*Redefine)

Set Com(#Handled) Value(False)

If_Ref Com(#Requestor) Is_Not(*null)

If_Ref Com(#uFramework) Is_Not(*null)

Invoke Method(#uSystem.uShowTopic)

Endif

Set Com(#Handled) Value(True)

Endif

Endroutine

 

Specific Special Notes

You must perform this upgrade using a user profile that is QSECOFR, part of the QSECOFR group, or has *ALLOBJ and *SECADM special authorities.

New Features

See What's New in EPC141006.

Installation or Upgrade on Windows Systems  

1. If you have not already done so, upgrade LANSA to V14SP1 (EPC141000) level.

2. Then follow the installation steps On LANSA Developer PCs and Windows Servers for the rest of the steps required.

Installation or Upgrade on IBM i Servers

 

If you are using server-side components of the Visual LANSA Framework or are using RAMP, you need to update any IBM i servers you are using.

1. If you have not already done so, upgrade LANSA to V14SP1 (EPC141000) level.

2. If you use RAMP:

  1. * Do not upgrade until you are using aXes 3.11 (or later). See Checking which version of aXes is installed.
  2. * Apply or reapply aXes_ANY_Patch_VLFONE_155198.
  3. * Apply or reapply aXes 3.11 patch Axes_311000_Patch_RAMP_155820.

These patches can be requested from your local LANSA support team.

3. Then follow Installation On IBM i Servers for the rest of the steps required.

 

 

 

 

 

Visual LANSA Framework Guide
Introduction
What is the Visual LANSA Framework?
What Does It Look Like?
When to use the VLF?
When not to use the VLF?
Who Is It For?
What Are Its Benefits?
What's New
EPC142011 – Available September 2018
VLF-ONE 5250 Form Wrappers
Instance Lists Can Have Image Columns in VLF-ONE
Instance List Column Visibility Can Be Set at Run Time
VLF-ONE Application Can Now Use a Custom Theme
Second Level Ancestor Prompting
VLF-ONE Traces Now Include a Stopwatch Time
Hidden Command Changes in VLF-ONE
Zoom Slider Now Available in Material Design Desktop Mode
User Capability Control Options
Automatically Associate Menu Option Name and Number in RAMP
Screen Probe Options on VLF-ONE RAMP Developer Panel
RAMP Flow Layout Ranges
RAMP Hidden Screen Change in VLF-ONE
Extended RAMP Script Editor
Attachment/Document Storage in the Shipped Demo
VLF-ONE Filter Borders Can Be Customized
New Common Activity Options
Generate Code to Validate Windows Domain Users
Generate SQL Based Searches
Add a Website
Instance List Column Selection Improvements
Event Recording
EPC142005 – Available May 2018
Explanatory Source Code in VLF-ONE
UF_OEXEC and DF_OEXEC Web Pages Changed
Create a Contact Card Style Instance List Browser in Simple SCRUD
System Information Shown in the Workbench Title Bar
Badges
Prefixes/Suffixes for Instance List Numeric Column Data
New Unique Team Member Prefix for Framework Objects
Generate Code in Material Design Style in Common Activities
Sidebar Menus Are No Longer Enabled by Default
Material Design Mode Menus Show Open Items
#uSystemCommon Services Now Available In Server Modules
Suspended Session Time Limit Introduced
Web Page Icon and Caption Now Set at Start Up
Improved VLF-ONE Start Up Times
New System IIP Advanced RAMP Methods
New RAMP Button Sizing Options
RAMP Developer Panel in VLF-ONE Applications
Trace RAMP Context Only
Logon Layout Changes in Material Design Mode
New Themes for Material Design
EPC141081 – Available December 2017
Evolving VLF-ONE Support for Small, Medium and Large Screen Devices
Google Material Design Style
Emulating Screen Sizes
Launching Applications
Controlling Content Based on Device Size
Navigation in Google Material Design User Interface
Sometimes Things Just Won't Fit into a Smaller Screen
More Functionality in VLF-ONE Entry Point Web Pages
Printing Barcodes
New Option to Delete Scripts
Send to Ms-Excel Option Moved
The Menu Option to Move A Filter Has Been Moved
VLF-ONE Default Text Color Changed
ExecuteDefaultCmd Parameter Now Functional in VLF-ONE
Font Awesome Icons for VLF-ONE Application Icons
Ramp-Tools Screen Size Warning Revised
Show/Hide Instance List Columns Based on Screen Size
Test Your Application on Different Screen Sizes
Enable/Disable Column Selection
New Back and Forward Options
EPC141034 – Available August 2017
New Design and Role for the VLF Developer's Workbench
VLF-WIN Designer Menu Option Has Been Moved
Instant Prototyping Assistant Enhancements
New Common Activities Feature
Program Coding Assistant Only for VLF-WIN
New VLF-ONE Navigation Menu Options
Column Filtering
Changes to the Demonstration System
Snap-in Prompters
Instance List Send to MS-Excel Has Changed
Notes Handler Uses Quill Rich Text Editor
New Printing Option and Examples
Access to the List Control in an Instance List
Design Time Framework Locking
New RAD-PADs Tab
Enhanced Images Palette
Google Material Icons in VLF-ONE Applications
Clearer Indication of What Internal VLF-ONE Components You Can Use
Instance List Maintenance Has Been Redesigned
New Asynchronous Handling Methods in VLF-ONE
EPC141017 – Available February 2017
After installing EPC141017
Recompile Your IIP Components
Delete #VF_AX007 and VF_SI001
Modify and Recompile the VLF-ONE Custom Logon Form
Demonstration System with New Data
Recovering Old VF_SY001_System.XML and VF_SY001_tables.XML
Screen Size Emulation
New RAMP Demonstration System for VLF-ONE
aXes-TS2 Language Code
Upload/Download Examples
Allow Selection from Navigation Pane Property Available in VLF-ONE
VLF-ONE Toolbar Collapse/Expand Remembered
Page-at-a-Time Instance List
Signon Component Returns User Profile
Optionally Combine All VLF JavaScript Files into One
Replaceable VLF-ONE User Authority Model
RAD-PADs are HTML5 compliant
Default port set when executing the Framework as a VLF-ONE application
Silent Signon Example Available at the Visual LANSA Forum
WAM, WEBEVENT and Fast Part Demonstration and Examples No Longer Shipped
Intelligent Snap-in Prompter
Improved Code Assistants
Configurable CSV/MS-Excel Separator Character
EPC141006 – Available August 2016
New VLF-ONE Reusable Parts
Customized Header and Trailer Panels in Default Logon Screen
Framework Selection Optionally Displayed
Customized Main Panel Backgrounds
Customizable Logon Timeouts
Zoom And Shrink Filter, Instance List and Command Handler Panes
Open Slider Pane Programmatically
Option to Use aXes-TS2 in RAMP-Tools
Selectable Ramp Button Locations
User Authority Maintenance Available in VLF-ONE
Better Encryption for User Authority Options
Improved Instance List Tracing
Trace Filtering
Simplified Tracing
System Tracing Has a New Show Active Button
Major Object Leakages Checked in Developer Mode
Tab Styles Enforced for Selection of BO Form View
More Messaging Examples
Close Button in Message Display
Passing Logon Validator Information/Persisting Values on Server
VLF-ONE Main Tool Bar Changed
You Can Programmatically Enable or Disable Commands
Shipped Demonstration Objects Are Easier to Identify
New Property #Com_Owner.avTitleBarHelp
Quickly Clear Messages in Your Code
New Look Sign-in Dialog
EPC140006 – Available February 2016
Hide/Show Properties
Quick Search Field
Framework Menu Options Save, Save and Restart, and Save and Exit Options Have Changed
Getting Started
Computer System Requirements
Other Requirements
Should you create Windows Desktop or Web Browser Applications?
Core Users and Occasional Users
Using One UI Technology does not necessarily mean One UI Fits All
Understanding What the Zero Deployment Advantage Really Is
Installing Your VLF Environment
On LANSA Developer PCs and Windows Servers
On IBM i Servers
VLF-ONE – Tour the Shipped Demonstration
VLF-WIN – Tour the Shipped Demonstration
HTML Startup Page
Graphical Content
Grids
Web Content
Dynamic Report Generation
Integration of desktop and folders into a VL application
Integration with Excel
Mini-Filters
Generic Notes Command Handler
Generic Spooled Files Command Handler
IBM i Server Message Queues
General Purpose Document Manager
Programming Examples Application
Key Concepts
What Is an Application?
What Is a Business Object?
What Is a Filter?
What Is an Instance List?
What Is a Command?
What Is a Command Handler?
VLF-ONE applications are Single Page Applications (SPAs)
Shortcuts for Launching VLF-ONE Applications
VLF-WIN Navigation Pane Options
Tree view
List view
Drop-down button
Launching Applications from the Status Bar
OBJECT-ACTION User Interfaces
If you have used a PC then OBJECT-ACTION should be familiar
If you have used a 5250 then OBJECT-ACTION should be familiar
Mock Up Filters and Command Handlers
Images Palette
Tailoring the Window Layout
Standard Look
Command Handler on the Right
Command Handler on the Top
Application Choices on the Right
Application Choices Moved to Tool Bar
Application Selection on Top
Application Selection at the Bottom
Floating Filter
Floating Instance List
Administration Objects
Users
Servers
Quick Find Box on the tool bar
Help and Tutorials
Tutorials
Tutorials for VLF-ONE Web Applications
Assumed Knowledge
You Know How to Use the VL-IDE
You Know What a VL Reusable Part Is
A Very Quick Tour of the Shipped Demonstration Framework
Starting
Navigation Basics
Panels
Themes
People, Places, Things
People
Places
Things
Orders, Customers, Products and Reports
Shipped Examples (Are Your VLF Best Friend)
Work as a VLF Developer
Start the VLF Developer's Workbench
VLF Developer's Workbench Basics
Property Tab Sheets
Common Activities
Other VLF Tools
Create Your Own Visual LANSA Framework
Create a Repository List to Track the Things You Create in This Tutorial
Why?
How?
Tables Used in the Tutorials
Create Applications and Business Objects
Create an Application Manually
Create a Business Object Manually
Create an Auto-SCRUD Business Object
Add an Application and a Business Object to the Framework
Define the Instance List
Create the Parts for the Business Object
Execute the Business Object
Understand How the SCRUD's Parts Work Together
Prototype an Application
Use Instant Prototyping Assistant
Execute the Prototype
Use RAD-PADs to Enhance Communication and Specification
Filters
What is a Filter?
Automatically Generate and Snap in Filters
Command Handlers
What is a Command Handler?
Automatically Generate and Snap in Command Handlers
Manually Creating Filters and Command Handlers
Create Business Object Employees
Manually Code and Snap in a Filter
Create a Server Module for Table Access
Create a Reusable Part For the Filter
Snap in the Filter
Test the Filter
Examine the Filter Code
Manually Code and Snap in a Command Handler
Create a Server Module for Table Access
Create a Reusable Part for the Command Handler
Snap in the Command Handler
Test the Command Handler
Modify the Command Handler
The Different Ways to Display an Instance List (Optional)
Create Business Object and Filters
Change Instance List Style
Change Instance List Columns
Switching and Signalling
Create a Bottom Pane Slider
Change the Slider to Switch to (Invoke) a Business Object
Change the Slider to Signal to a Command Handler
Recommended Things to Understand Next
When to Use the VLF
When to NOT Use the VLF
Debug an Application (Client or Server)
Trace an Application
Create a Functional Business Object
Add a Trace Statement to Indicate Save Key Was Pressed
Start Tracing Programmatically
Use Multiple Open Business Object Instances
Create an Information Panel
Create a Settings Panel
Create a Settings Panel
Create a Background Panel
Create a Custom Framework Manager
Edit the Settings Panel
Edit the Background Panel
Test the Settings Panel
Asynchronous Processing
Create a Timer
Upload Your Framework to an IBM i Server
Server-Side System Managers
Client-Side Controllers
Multi-Developer Projects
Tutorials for VLF-WIN Applications
The Employee Table
VLF000 - Execute Framework Application
Step 1. Execute the Visual LANSA Framework
Step 2. Execute an Application
Step 3. Use Filters to Find an Employee
Step 4. Use Commands and Command Handlers
Step 5. Execute the HR Demo Application
Summary
VLF001 - Defining Your HR Application
Step 1. Create Your Framework
Step 2. Create a New Application
Step 3. View Commands Allowed
Step 4. Execute the About Command
Summary
VLF002 - Defining Your Business Objects
Step 1. Decide on the Business Objects
Step 2. Create the Business Objects
Step 3. Specify Business Object Commands
Step 4. Add the Business Objects to the Application
Step 5. Specify Business Object Icons
Step 6. View the Business Objects
Summary
VLF003 - Prototyping Your Filters
Step 1. Define By Name Filter for Employees
Step 2. Prototype the Instance List
Step 3. Prototype the Filter Designs for Employees
Step 4. Filters for Statistical Reporting Business Object
Step 5. View the Filters
Summary
VLF004 - Prototyping Your Commands
Step 1. View Command Definitions
Step 2. Set Command Display for New
Step 3. Prototype the New Command Handler
Step 4. Prototype the Other Command Handlers
Step 5. Define Commands for Statistical Reporting
Step 6. Specify Command Display
Step 7. Prototype Command Handlers for Statistical Reporting
Summary
VLF005 - Validating the Prototype
Step 1. Validate Your Prototype
Summary
VLF006WIN - Snapping in a Real Windows Filter
Step 1. Create Your Real By Name Filter
Step 2. Test the By Name Filter
Step 3. Filter Code
Step 4. Create a Real By Location Filter
Step 5. Snap in the By Location Filter
Summary
VLF007WIN - Snapping in a Real Windows Command Handler
Step 1. Create Your Real Command Handler
Step 2. Test Your Command Handler
Step 3. Make the Employee Identification Number Field Invisible
Summary
VLF009WIN - Adding Instance List Columns in Windows Applications
Step 1: Add Columns to the Instance List
Step 2: Change your filter
Step 3: Remove the Additional Columns
Summary
VLF010WIN - Creating a Mini Filter
Step 1. Create the Mini Filter Interface
Step 2. Write the Mini Filter Code
Step 3. Snap in the Mini filter and Test It
Step 4. Use the Virtual Clipboard to Save and Restore the Search Value
Summary
VLF011WIN - Creating a Parent Child Instance List
Step 1. Create a New Business Object
Step 2. Establish the Parent-Child Relationship
Step 3. Create a Hidden Filter for Departments
Step 4. Create a Relationship Handler to Load Employees
Step 5. Display Additional Columns in the Instance List
Step 6. Access the Properties of Hidden Child Objects
Summary
VLF012WIN - Controlling Navigation Using Switching and the Virtual Clipboard
Step 1. Remove the Parent-Child Relationship
Step 2. Create a Details Command Handler for Departments
Step 3. Add Logic to Switch from Departments to the Employees Business Object
Step 4. Record Switch History using the Virtual Clipboard
Step 5. Use the Switch History to Return to the Original Business Object
Summary
VLF013WIN - Signaling Events
Step 1. Change Employee Surname and Save the Changes
Step 2. Add the avSignalEvent to the Employee Details Command Handler
Step 3. Add a Routine to Listen for the EMPLOYEE_CHANGED Event
Step 4. Test Signaling
Summary
VLF014WIN - Debugging/Tracing
Step 1. Add a Trace Statement to Indicate Enter Key Was Pressed
Step 2. Add More Trace Statements
Step 3. Start Tracing Programmatically
Summary
Tutorials for Deployment
VLFDEPONE - Deploying the VLF-ONE Framework
Step 1. Prepare for Deployment
Step 2. Make Sure the Framework Definition File Has Been Created
Step 3. Package Your Framework Server Objects
Step 4. Add Framework Components
Step 5. Add the Save Files to the Export
Step 6. Add Files to the Export
Step 7. Move the Deployment Material to the Target System
Step 8. Import the Deployment Package
Step 9. Restore Your Framework Objects
Step 10. Restore the Framework Components
Step 11. Execute the Deployed Application
Summary
VLFDEPWIN - Deploying the VLF-WIN Framework
Step 1. Remove Other Applications from the Framework
Step 2. Create the Entry Point Form
Step 3. Make a Copy of Other UF* Objects Your Framework References
Step 4. Create the Package
Step 5. Specify the Entry Point Form and Database Type
Step 6. Disable all Prompting at Start Up
Step 7. Add Framework Components
Step 8. Add Table Data
Step 9. Add Other Framework Objects
Step 10. Add an Icon
Step 11. Check the Package
Step 12. Build the Package
Step 13. Ship the Package
Summary
Framework Programming
Filter and Command Handler Anatomy
Hidden Command Handler Anatomy
The VLF's Snap-In Architecture
VLF-ONE Snap-In Points Summary
VLF-WIN Snap-In Points Summary
The VLF Framework Manager
UpperCase Conversions
Numeric to Alphanumeric Conversions
Application Error Handling
How To Use It
Example
Properties Used
Framework Locking Service to Handle Unsaved Changes
Saving unsaved changes using uQueryCanDeactivate or uQueryCanClose
Reason Code
Comments/Warnings
The Virtual Clipboard
Remembering Information on the Clipboard
Listening for Changes to the Clipboard
Other Things Worth Knowing
Persistence, Resetting and Deploying in VLF-WIN Applications
Persistence and Resetting VLF-ONE Applications
Basic Tracing Service
Event Signaling Service
avSignalEvent
#Com_owner.avEvent
Object Switching Service
Introductory avSwitch Examples
Referencing Applications, Business Objects and Commands
Advanced avSwitch Examples
avSwitch Method
AvAddSwitchInstances Event
AvAddSwitchInstance Method
Troubleshooting Switch Examples
Custom Property Access Service
User Authority Access Service
Messaging Services
In VLF-ONE
In VLF-WIN
Temporarily Overriding Object Captions
Get Visual LANSA Framework Icon Reference
In VLF-ONE
In VLF-WIN
Change a visual style at run time
Get an Image from a File
AvGetImageReference Method
Change Command State Programmatically
Framework Windows Management
Programmatically Creating and Managing Windows
Finding a Window
Enumerating All Windows
The Current and Main Windows
Window Opening Information
Notifying other Windows of Significant Events
Keeping Windows Open
Switching in Windows
Windows and Imbedded Interface Points
In VLF-ONE
In VLF-WIN
Expanding, Shrinking and Focusing Panes
In VLF-ONE
avPaneMaximize Method
avPaneMinimize Method
avPaneRestore Method
In VLF-WIN
avPaneShrink Method
avPaneExpand Method
avPaneMaximize Method
avPaneRestore Method
avPaneFocus Method
avCmdPanelState Property
Windows Resource Usage
Usage Expectations
Resource Leakage
The Instance Lists and the Instance List Manager
Instance List Processing Essentials
Visual Identifiers
Programmatic Identifiers
Testing Your Assigned Identifiers
List Manager Methods
Handling Instance List Entries in VLF-ONE
Getting the Selected Instance List Items
Updating an Instance List Item
Updating and Deleting Instance List Entries in VLF-WIN
Command Handlers and the List Manager
Current and Selected Instances
Authority to Instances
Associated Instances
More about Instance Lists
Shipped VLF-ONE Instance Lists
Using VLF-ONE Instance List Browser VF_UM040O
Using VLF-ONE Instance List Browser VF_UM041O - Introduction
Using VLF-ONE Instance List Browser VF_UM041O - Advanced
Making your own VLF-ONE Instance List Browser
Adding Additional Columns to Instance Lists
IColumns
Changing the Color and Style of List Entries
In VLF-ONE
In VLF-WIN
Popup Panel Hints in the Instance List
Instance Lists with Different Types of Objects
VLF-ONE and VLF-WIN Differences in Child and Peer Business Object Handling
Physical Instance Lists
Planning parent-child relationship in VLF-WIN
You can add the entries to the instance list in any order
In VLF-ONE Adding Children is Simpler
You can dynamically add children to an instance list "on demand"
Dynamically adding children in VLF-ONE
Dynamically adding children in VLF-WIN
When a child is in the instance list it must have a parent
You can dynamically update individual entries in a parent-child instance list without collapsing the visual tree
You can dynamically delete individual entries in a parent-child instance list without collapsing the visual tree
You can dynamically add individual entries in a parent-child instance list without collapsing the visual tree
Instance List Tips and Techniques
Building Modern Filters and Instance Lists
Page-at-a-Time logic may indicate a conceptual problem with filters
Instance lists do not have to reflect the database that underpins them
End-users can choose instance list columns to be displayed
Create Your Own Snap-in Instance List
Instance List with more than 10 alphanumeric and/or 10 numeric additional columns
Sample Filter using 34 columns (16 alpha, 16 numeric + Visual IDs)
Matching Snap-In Instance List Browser
Source for Snap-in Instance List Example
Advanced Instance List Processing
Avoid duplicated instance list code by using a 'Controller'
Manipulate Instance Lists from RAMP Scripts
Delegate Common Tasks to your own Instance List Controller
Low Level Direct Access to the Visualization Trees
Low Level Direct Access To The Visualization List in VLF-ONE Instance Lists
Some Significant Usage Points
Some Examples
Sending Instance Lists to MS-Excel
Using a VLF-ONE Custom Framework Manager
Advanced Filter Styles
Instant Filters
Drill Down Filters
Power Filters
Hidden Filter
In VLF-ONE
In VLF-WIN
Mini Filters
In VLF-ONE
In VLF-WIN
Properties
Events
Code Examples
RDML for a Windows Mini Filter
RDMLX for a WAM Mini Filter
VLF-ONE Themes Concepts
Using a Snap-In Component to Customize Themes
Code Tables
Framework Code Tables
Code Table Data Flow
Setting up a Code Table
Step 1. Create a Table
Step 2. Define a Table
Step 3. Enter data into a code table
Using a Code Table in your application
As a part of a referential integrity check
As a decode or lookup operation in your programs
Advanced options when setting up a code table
Multilingual Data
Sequencing
Choosing the description field
Creating your own table data handler function
Read Only Tables
Inactive Table Entry indicator
Creating Your Own Table Data Handler Reusable Part
Frequently asked Questions about Code Tables
Using Assistants to handle more complex "codes"
Approach 1: Single Window – Multiple Assistants
Approach 2: Multiple Windows – Multiple Assistants
Approach 3: Multiple Windows – Multiple Assistants (some Complex)
How are Assistants started?
How do Assistants interact with other parts of the application?
Using Unicode Data with the Framework
In VLF-ONE
In VLF-WIN
Unicode Data in Code Tables
Unicode Data in Virtual Clipboard
Unicode Data in Tracing
End-user Help
Help Text for VLF-ONE Applications
Help Text for VLF-WIN Applications (F1)
Disabling or diverting the F1=Help key in VLF-WIN applications
Quick Find Override Feature
Setup
Programming Tips
Always Use Identifiers, Not Names
Advanced Topics
Using your Visual LANSA Framework in DirectX mode
Win32
DirectX
Mixed Mode
Snap-In Instance Lists
Snap-In command handlers and filters
Considerations for ISVs
Getting Ready for Deployment of a Framework Version
Getting ready for deployment in VLF-ONE
Getting ready for deployment in VLF-WIN
Naming Space Considerations for Managing Different Frameworks
Users, Groups and Security
Framework Security
Set up Framework Security
Activate Framework Security
Create a Framework Administrator
Copy the VLF-ONE Administration Application
Implement Framework Security: Users, Groups and Authorities
Set Up a Server or Servers
Using VLF-WIN
Using VLF-ONE
Maintain Users and Authorities
Using VLF-WIN
Using VLF-ONE
Maintain Groups
Five Things You Need to Know About Basic Framework Security
User and authority data is usually stored in tables VFPPF06 and VFPPF07 on the server
Data in VFPPF06/07 controls access to Framework objects for VLF-ONE and VLF-WIN
There are two sets of user profiles and passwords on the server
You can assign authorities to groups of users
In design mode security is not applied
Advanced Options
Add your own extra layers of security
You do not have to use Framework security
A user who signs on with one profile can be automatically changed to another
Two different Frameworks can share the same set of users
User and security data can be stored as an XML file instead of using tables VFPPF06/07
You can store other information relating to a user
Export or Import of Full or Partial User Data
How to Export User Data
How to Import User data from an XML file
Set up the Framework to Generate an XML file from an External Source of user data and import it
The Rules for Creating an XML File of User Data
Writing your own version of the User Authority report
Frequently Asked Questions (Users and Security)
I do my unit and suite testing in Design mode. Is this a good practice?
When I run the Framework security does not seem to work?
Why options I have disabled are displayed?
Why does a user with my user profile get automatically created?
What are the user timeout settings used for?
Can I control which user profile appears on the status bar?
How can I allow the user to change their own password?
When I start the Framework as an administrator (for example UF_ADMIN), the Framework appears briefly and then disappears?
Some Scenarios
Scenario: IBM i Web Server
Assumptions
Settings
Modifications to your version of UFU0001
Enroll Typical Users in the Framework
Scenario: IBM i Server, Users Connect with Super Server
Assumptions
Settings
Enroll Users and Groups
Scenario: Windows Server, Users Connect with Super Server
Assumptions
Settings
Enroll Users and Groups
More Information
More Details about Groups
Create Your Own Imbedded Interface Points (IIP)
In VLF-ONE
In VLF-WIN
More Details about being Signed on as a Different User
How to Share Users between Different Frameworks
User Profile Management Options
IBM i Servers Only: Check Password Expiry
Allow Remote Server Password Change
Changing the Remote Server Password in VLF-ONE
Changing the Remote Server Password in VLF-WIN
Server Profile Management and Issues
Deploying Server Definitions
Scenario: In House Development, Well Known Servers
Scenario: ISV, Single Unknown Server
Scenario: ISV, Multiple Unknown Servers
Server Connection Recovery
Server Connection Recovery Settings
Attempt Automatic session recovery
Time interval between checks of connection status
Check connection before executing commands
Check connection before selecting applications and business objects
Action to take when session cannot be recovered
Check Connection using function
Programmatic server connection checking
Examples
Public Signals
Examples
Multilingual Application Issues
Imbedded Interface Points (IIPs)
What Imbedded Interface Points are Provided?
In VLF-WIN
In VLF-ONE
Adding your own object security validation
avCheckAuth Method
Adding your own instance level security validation
avCheckInstanceAuth Method
avCheckInstanceAuth Example
Custom Properties
Frequently Asked Questions about Custom Properties
Things to be careful with when using Custom Properties
Writing queries over Visual LANSA Framework objects
Getting Started
Using the First Query Example
Using the Second Query Example
Using the Third Query Example
Creating Your Own Queries
Other things worth knowing about Query Programs
Examples
UF_TRVRS - Signal VLF Objects
UF_QRY01 - Simple Example of How to Listen For General Framework Objects And View Their Properties
UF_QRY02 - Listening for General Framework Objects And View Their Properties
UF_QRY03 - Listening for Ramp Objects And View Their Properties
Designer and Developer Practices
Usage Scenario: One Designer – Multiple Developers
Usage Scenario: Multiple Designers – Multiple Developers
Development Status Feature
How to Create a New Framework Version
Clone the Framework
Associated XML Definition Files
Optionally Change Associated XML Definition Files
Start a Framework Version
Notes for RAMP Users
How to Keep Automatic Backup Copies of Your Framework
How to Export Framework Definitions
How to Merge Items from one Framework to Another
The Merge Tool Window
Using the Merge Tool
Example of Combining Two RAMP Framework Definitions
Collecting the Definitions
Merging the Definitions
Key VLF Project Success Factors
Frequently Asked Questions
Why do my RAD-PADs display two strange characters?
Can I control the separator used in CSV files in VLF-ONE applications?
Are child and peer business objects handled the same way in VLF-ONE and VLF-WIN?
Can I run my VLF-ONE application on a phone?
Can I run my VLF-ONE application on a tablet?
How can I replace the IBM i library list used in VLF-ONE server modules?
How can I change the IBM i user profile used in VLF-ONE server modules?
Why does this message appear?
What should I do about this message?
What can I do to customize the look of my VLF-ONE application?
Can I customize the VLF-ONE application logon screen?
Can I customize the main panel background in a VLF-ONE application?
How should I structure server modules used in VLF-ONE applications?
How can I copy my VLF-ONE Framework's definition .DAT file to my IBM web server?
Why does my VLF-ONE Framework work okay on my PC but not when I execute it from my IBM i server?
What Are Menu Options in Brackets?
Why is my VLF-ONE Framework acting differently when I execute it locally and when I execute it from my IBM I server?
Changes I make to my VLF-ONE screen content do not appear, or appear later than I expected them to?
Can I use shortcut keys in a VLF-ONE application?
Can I use prototype images in VLF-ONE applications?
Can I use Visual LANSA Framework in DirectX mode?
Can I change the options that the user searches for in the Quick Find box?
Can I control what happens when the user clicks on an option that they have located by using the Quick Find box?
Can I change the business object instance caption that appears in the area above my command handlers?
How do I execute an initial Framework level command when starting up a Framework application?
Do I have to (re)define my user profiles into the Framework?
Do I have to (re)define my user passwords into the Framework?
Are there techniques to minimize user profile (re)definition?
Can I run web applications using secure sockets layer (SSL)?
When I start the Framework as an administrator (for example UF_ADMIN), the Framework appears briefly and then disappears?
I do my unit and suite testing in Design mode. Is this a good practice?
When I run the Framework security does not seem to work?
Why are unauthorized options displayed?
How can I translate text, for example the caption of the instance list Clear List button?
How do I enroll my own visual styles?
How do I change a visual style at run time?
I have created a new command but it does not appear in the menus or the toolbar?
Does VLF-ONE have a main form menu bar?
Do VLF-ONE and VLF-WIN handle the main form tool bar the same way?
Can I define the toolbar by application?
I change Instance Command Presentation but the changes do not take effect?
How do I run my application in SuperServer mode?
Are copies of my Framework design kept?
I have just deleted an object but it is still visible?
I have just deleted an object and want to get it back again?
How do I change Help About logos?
How do I change introduction logos?
How do I change the logo shown when the Framework starts executing?
I have just changed my Framework design but the change has not taken effect?
How do I enroll my own bitmaps and icons?
Why are some menus and menu options in brackets?
How are Framework settings remembered?
How are instance lists remembered?
Can more than one person design the same Framework at the same time?
Where does the Images Palette get the pictures from (when using the HTML formatted Images Palette)?
Can my VLF-ONE applications be used with IBM i multi-tier web server configurations?
Can my Web browser applications be used with Windows multi-tier web server configurations?
I want to restore the default window layout for the Framework
The URL to start my deployed VLF-ONE is too complex for users to reliably type in to their browsers
How do I pick up the servers that have been defined in the Framework using the Servers option of the Administration menu?
How can I change the list of Framework versions shown?
Troubleshooting
Troubleshooting Filters and Command Handlers
Framework fails as soon as you select your new Windows filter or command handler
When you recompile your Windows filter or command handler it fails with a "Permission Denied" error.
Debugging Browser Problems
Internet Explorer
Firefox and Chrome
Application Performance
Work as User
Best-Case Conditions
Worst-Case Conditions
A Risk Check List
Using Server Projected Desktop Technologies
Options for Very Large Frameworks
Definitions
Framework Window
Title Bar
Toolbar
Menu Bar
Popup Menu
Navigation Pane
Application Bar
Application and Business Object Tree
Business Object Bar
Application View
Filter Tab
Filter Folder
Instance List
Command Tab
Command Folder
Property Tab Sheets
Application Views
Authorities
Bitmaps and Icons
Create Links
Commands Allowed
Command Display
Common Activities
Slide in Panels
Assistance Panel
Settings Panel
Framework Custom Logon Page
Optional Things You Can Do with Your Launch Component
Background Panel
Select the Columns to Display and to Use for Identification
Choose to Display Lists in Contact Card Style
Choose to Display Lists in a Shipped Style
Simple Grid Style
Simple Expand/Collapse Style
Massive List
Parent-Child Style
Choose to Display Lists in a Custom Style
Make this a One Command, No Instance List Business Object
Custom Properties
Data
Definition
Export Design
Filters
Filter Snap-in Settings
Filter Settings
Framework Details
Help About
Identification
Instance List
Instance List Column Maintenance Panel
Column Maintenance Dialog
Instance List Relationships Summary
Other Options
RAD-PADs
Relationships
Server Details
Startup
SubTypes
Toolbar and Menus
Usage
User Administration Settings
User Details
Visual Styles
Visualization
VLF-ONE Images
Web/RAMP Details
Dialogs
Execute Framework as VLF-ONE Application
Choose Browser
Use Approximate Test Size
As Developer
Enable RAMP Demo
Turn Tracing On
Material Design Mode
In Language
URLs
URL
Create Desktop Icon
Upload Script
Instant Prototyping Assistant
Program Coding Assistant
Properties
Add Fields from this Physical File
Additional Columns for Building AColumn and NColumn Values
Address for Error Notification
Administrative User
Advise User With a Message
All Fields in the File
Alignment of Image on Form
Allow Generic Searching
Allow Float
Allow in VLF-ONE
Allow in VLF-WIN
Allow Instance List to be sent to MS-Excel
Allow Multiple Selection
Allow Multiple Selections
Allow on Small/Medium/Large Screen
Allow Panes to be Shrunk and Expanded
Allow Remote Server Password Change
Allow Search/Recently Used Limit
Allow Selection from Navigation Pane
Allow Side by Side Display
Allow this Object to be Opened in a New Window
Allow User to Clear Instance List
Allow User to Re-Order Columns
Allow User to Re-Order Command Handler Tabs
Allow Users to Switch Views
Also drop them here to define how each [business object name] list entry is uniquely identified
Alter Development Status
As the Default Command
Automatic Save Time in Minutes
Automatically Enable for New Applications
Automatically Enable for New Business Objects
Automatically Enable for New Business Object Instances
Automatically Increment when Saving
aXes-TS2 Language Code
Blank Lines Around Comments
Business Object Command
Business Object List
Bypass Locks
Caption
Caption (Singular)
Caption with Accelerator
Change Password IIP
Check Password Expiry
Check Still Connected Before Doing Database IO
Clear
Client Server Translation Table
Codebase
Code Table Data
Code Table Definition/ Reusable Part Data Handler (ID)
Code Table Definition/ Use a Reusable Part
Code Table Field Definitions
Column Caption
Column Decimals
Command Tab Location
Command Tab Show All
Command Tab Style
Commitment Control
Component Identifier
Contains Favorites
Contains SHARED Object
Copyright Notice to Be Used
Copyright Text
Create Component
Database Name
Database Password
Database Type
Database User
Date/Time Output Format
DBCS Capable
Default Command
Default Font when Printing a Report Using Windows
Default Properties for Fields on Filter Panels
Default Properties for Fields on Handler Panels
Defined In
Display VLF-ONE About Centered
Displayed Field
Development Status Captions
Divert Locks
Double Click for Default Command
Drag and Drop the Fields
Drag table columns from here
Drop them here to lay out how a list of [business object name] should be displayed to the users
Edit Code
Edit Panel
Email Address
Email Zip File To
Enable Child when Parent Selected
Enable Clear List Button
Enable Column Filtering
Enable Command
Enable Development Status Feature
Enable Framework for RAMP Applications
Enable Framework for VLF-ONE Applications
Enable Parent when Child Selected
Enable Peers when Selected
Enable Popup Panels
Enable the Position Menu Option
Encrypt XML Files
End-user can change theme
End-users Must Sign on to this Framework
Execution/RAMP Tools Engine
Execute as Hidden Command
Execution Priority
Execution Mode Load Path
Export Tables
Export Framework Design
Export Include All Versions
Export Images Palette
Export RAMP Definitions
Export RAD-PAD Notes
Export RAD-PAD Defaults
Export Servers
Export Users
Field Prefix to be Used
Fields That You Want to Appear in a List at The Bottom of Your Handler
Fields That You Want to Appear on the Top of Your Command Handler
Fields to be Shown on the Command Handler
File Prefix to be used for MS-Excel
Filter Tab Location
Filter Tab Style
First Time Only
Fixed / Default Values
Font Awesome Icons for VLF-ONE Application Icons
Framework Fatal Error
Function Handling Table Data storage
Generate VLF-ONE or VLF-Web Resources
Generation Prefix
Groups this user belongs to
Height
Help Text
Hide All Other Command Tabs
Hint
IBM i Host Server Mapper Name / IP address
IBM i Host Server Mapper Port
Icon
Icon and Bitmap Enroller
Identify Fields Using the Fields
IIP - Component to Validate VLF-ONE User Sign On
Import Users Imbedded Interface Point
Image Columns
Image File
Image / Web Page to Display on Form
Import Users from XML
Inactive Table Entry indicator
Inactivity Timeout Log off
Inactivity Timeout Log on
Include Default Save Button and Logic
Include Default Search Button
Include Layout Managed Button and Field Areas
Include uInitalize Routine in Command Handler
Include uInitialize Routine in Filter
Include uTerminate Routine in Command Handler
Include uTerminate Routine in Filter
Input Method
Instance Command
Instance Command Presentation
Instance List Relationship Summary
Instance List Tool Bar Location
Instance List Tool Bar Height or Width
Instance List Tool Bar Text Location
Internal Identifier
IP Address
IP Address and Port Number
Intro Caption
Intro URL
Keep newlook SID File Versions
Keep Versions in Subfolders
Keep XML File Versions
Keys of the View
Keys from the Instance List
Language Field
Languages
LANSA Language Code
Last Changed
Latest VLF-ONE Demo
Latest VLF-WIN Demo
Launch Button Caption
Launch from Status Bar
Launch URL (Windows)
List Panel
Load Path
Major Comment Separator
Marker for Code Requiring Manual Completion
Maximum Decimals
Maximum Entries in List
Maximum Instances Concurrently Open
Maximum Length
Maximum Signon Attempts Allowed
Minor Comment Separator
Mock Up RAD-PAD
MTXT String Loader
Multiline Tab Sheet Captions
Multiple Window Control Bar Location
Name
Name of User Set to be Used
New Password
Nodes XML File
Number of Additional Windows a User can have Open Concurrently
Object Command Presentation
Optional Arguments
Options
Overall Theme
Own Window Size
Partition
Partition is Enabled for RDMLX
Physical File from which the Child Data Comes From
Popup Panel Name
Port Number
Private Definition/aXes Project Folder
Programmatic Identifiers for Building AKey and NKey Values
Property Type
Prototype Only
Quick Search Field Caption
Quick Search Field Width
RAD-PAD File Name
RAMP Destinations
RAMP JavaScript Charset
RAMP Password
RAMP Tools Mode Load Path
RAMP User
Read Only
Remember Key Values between Filter Executions
Relationship Handler
Relationship Type
Replace Instance List Details
Report on Users - Imbedded Interface Point (Id)
Restricted Access
Routine to listen for signals to update the instance list
Save and Restore Instance Lists
Save as Deployment Server
Search Field Width
OR get data dictionary fields with prefix
Select the table that most closely represents [business object name]
Select the Keys of the Selected View to be used for Search Operations
Select the View to Be Used For Filtering and Searching Operations
Selection Block Size
Selection Limit
Sequence
Sequence Using
Server Client Translation Table
Server IIP function to validate sign on
Server Name
Server Overrides
Server Settings XML File
Server Type
Shortcut
Show Additional Columns
Show Current Business Object in Window Title
Show Information For
Show in Help About Text
Show in Menu
Show When Disabled
Show on Instance List Tool Bar
Show On Popup Menus
Show on Toolbar
Show the 'Windows' Menu in this Framework
Show on Connect Dialog
Show a Select Columns Menu
Show When Disabled
Specify the Underlying Physical File that Will Be Searched by this Filter
Stay Active
Stay Active Default for Command Handlers and Filters
Store Users in XML File and Store users in DBMS Tables VFPPF06/07
SubTypes
Synonyms
System Info
Table Definitions XML File
Technical Support
Temporary Directory on PC
The physical file that most closely resembles this business object is
Toolbar Button Caption
Toolbar Button Width
Toolbar Group
Tool Bar Height
Tool Bar Style
Trim Working Set
Unique Identifier
Update File
Uppercase
Upper and Lower Case Password
URL
Use a Grid for Displaying Any List
Use HTTPS
Use INI file
Use Framework Users and Authority
Use 'liteclient' license
Use a Reusable Part
Use Shared Instance List for Relationships
Use the field's Description/Label/Column Heading as column heading
Use Windows Credentials
User Authorities Report File
User Can Change Own Password
User Imbedded Interface Point
User Is Disabled
User Must Specify all Chosen Keys
Users May Work Offline if the Remote Server Is Not Available
User Object Name/Type
User Profile
Users Sign on Locally to Use the Framework
Users Sign on to a Remote Server to Use the Framework
UTC Conversion
Value(s) can be changed by Administrator
View as Drop Down on Toolbar
View as A Single Tree
View as Two Lists Side By Side
View as Two Lists Over and Under
View Used to Read the Child Data
Visual Identifiers for Building VisualID1 and VisualID2 Values
Visual Style Base Style
Visual Style Protected Fields and Areas
Visual Style Dark Background Small Font
Visual Style Dark Background Large Font
Visual Style Status Bar Fields
Visual Style URLs
VLF-ONE About Image URL Dark
VLF-ONE About Image URL Light
VLF-ONE Assistance Panel Reusable Part
VLF-ONE Background Panel Reusable Part
VLF-ONE Change Password IIP
VLF-ONE Command Handler or Filter
VLF-ONE Dark Background Color
VLF-ONE Instance List Initial Width
VLF-ONE Instance List Initial Height
VLF-ONE Instance List Row Height
VLF-ONE Light Background Color
VLF-ONE Popup Panel Name
VLF-ONE Settings Panel Reusable Part
VLF-ONE Slide In Panel Reusable Part
VLF-ONE Snap-In Instance List Browser
VLF-ONE Snap-In Instance Item Panel ID
VLF-ONE Startup Page
VLF-ONE User Imbedded Interface Point
VLF-WIN Administrator Launch Form
VLF-WIN Designer Launch Form
VLF-WIN End-User Launch Form
VLF-WIN Launch Render Type
VLF-WIN Snap-In Instance List Browser ID
Warn before (days)
Width
Windows Code Page
XML Encoding
Your Framework Version Number
Printable VLF-ONE Quick Reference
Release Notices
Release Notice for Customers Upgrading to EPC142011
Valid Upgrade Paths from versions earlier than EPC142005
Release Notice for Customers Upgrading to EPC142005
Release Notice for Customers Upgrading to EPC141081
Release Notice for Customers Upgrading to EPC141034
Release Notice for Customers Upgrading to EPC141017