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 NumberCan 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

EPC142067 – Available November 2019

VLF-ONE Supports Browser Back/Forward Keys

Log into Your VLF-ONE Applications Via Kerberos (Single Sign-On)

VLF-ONE Navigation Menu May Be Imbedded Into Slider Panes

EPC142057 – Available July 2019

Customizable VLF-ONE Instance List Toolbar

Common Activity to Create a Custom Instance List Toolbar

Snap in Deployment Checker

Replaceable VLF-ONE User Authority Model Extended

Instance List Column Caption Can Be Set Programmatically

Common Activity Option for Assistance Panels Has Been Upgraded

The VLF Workbench Can Now Use Google Translate

#Com_Owner.avCloseForm Has New Optional Delay() Parameter

New Common Activity to Create a ‘Contact Us’ Toolbar Option

Log on to VLF-ONE Applications via Microsoft, Google or Facebook

RAMP-TS2 Variable GLOBAL_LastFunctionKeyUsed

Enhanced VLF-ONE RAMP Field Prompter

avSwitch KeepMaximize Option

Instance List Column Multilingual Defaults

New avAllowExpandContract Option for Filters

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

Before You Start

Take A Very Quick Tour of the Shipped Demo

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 Framework Developer

Start the VLF Developer's Workbench

VLF Developer's Workbench Basics

Property Tab Sheets

Common Activities

Other VLF Tools

Create Your Own Framework

Create a Repository List to Track the Things You Create

Have a Look at the Tables Used in the Tutorials

Create Applications and Business Objects

Create an Application Manually

Create a Business Object Manually

Create a Fully Functional Business Object

Define the Instance List

Add an Application and a Business Object to the Framework

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

Create Filters

Automatically Generate and Snap in Filters

Create Command Handlers

Automatically Generate and Snap in Command Handlers

Create Filters and Command Handlers Manually

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

Change the Way an Instance List is Displayed

Create Business Object and Filters

Change Instance List Style

Change Instance List Columns

Understand 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

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

WIN-VLFDEPONE - Deploy the VLF-ONE Framework on Windows Servers

Step 1. Prerequisites

Step 2. Get Your Framework Ready for Deployment

Create Framework Launch Page

Create a Copy of UF_OMULTI

Create a Copy of UF_OSYSTM

Create a Copy of UF_OLOGON

Step 3. Configure the Database to Be Deployed

Step 4. Package Your Framework

Start the Deployment Tool

Define Default Cross Reference Settings

Define LANSA Listener

Include Your Objects in the Package

Set Package Settings

Note the Server Name

Define Database Settings

Save and Build the Package

Step 5. Prerequisite Actions on the Target Machine

Step 6. Configure the Database on the Target System

Step 7. Install the Deployment Package

Step 8. Execute the Deployed Application

Summary

IBM-VLFDEPONE - Deploy the VLF-ONE Framework on IBM i Servers

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 Frameworks

Use Multilingual Prompts

Type over the Captions

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

Set up a Framework Custom Logon Page

Optional Things You Can Do with Your Launch Component

Specify the Framework Identifier

Set Suspended Time Limit and Session Timeout

Add a Logon Header or a Trailer Panel

Show a Restart Button

Specify Snap-In Components

Control Framework Settings

Enable logging on to Your VLF-ONE Applications via Microsoft, Google or Facebook Services

Enable Logging on to Your VLF-ONE Applications via Kerberos (Single Sign-On)

Turn off Zoom in Small and Medium Sized Devices (Phones and Tablets)

Hide VLF-ONE RAMP Developer Panel

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/Web 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

Snap in Deployment Checker

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 Instance List Toolbar Part Id

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 Support Browser Back/Forward Keys

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 EPC142067

Valid Upgrade Paths from Versions earlier than EPC142057

Release Notice for Customers Upgrading to EPC142057

Valid Upgrade Paths from Versions earlier than EPC142011

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