developing uniface applications by using standard deployment

Deployment new style

Online SeminarMichel van den Berg, Software Architect7 January, 2015

Agenda

• How to Move to Standard Deployment

• ASN settings

• Development vs Deployment

• Uniface Resource Manager

• Compatibility

Classical Style

Classical Style

idf.exe

Classic Style

• Update Dol for ever new global object

• Dol is shared possibly by apps

• Urr is shared possibly by apps

• Deployment is difficult• Locked files causes issues

• Undoing your updates is difficult

• No partitioning across app sub-systems

Standard deployment - Concepts

Uniface Resource Directory

idf.exe

Standard DeploymentApp packaging

uTree.uarCommon.uar

Person.uar

Department.uar

Uniface ResourceDirectory

Using Standard Deployment - Assignment Settings

Which ASN settings are needed for:

Development

Runtime

Settings for Development

Person.uar

idf.asn

[SETTINGS]

$RESOURCES_OUTPUT = {Path\}Directory

Main.uar

CompileUniface ResourcesDirectory

Deployment

department.uar

URMidf.exe

$RESOURCES_OUTPUT =

(build scripting)

idf.asn

[SETTINGS]

{Path\}utree.uar

utree.uarCompile

idf.exe

Settings for Development

DEMO 1

The compiler output

Uniface Runtime Application

UnifaceUsys.uar

Usysicon.uardepartment.uar

Person.uar

Uniface Runtime UARs can be found in .../common/usys

utree.uarcommon.uar

Settings for Runtime

UnifaceUsys.uar

Usysicon.uar department.uar

Person.uar

[SETTINGS] $SEARCH_RESOURCES = Resources_Only

usys.asn

[RESOURCES] Usys.uar Usysicon.uar

common.uar

Settings for Runtime

UnifaceUsys.uar

Usysicon.uar

utree.asn

[RESOURCES] Common.uar Person.uar Department.uar

department.uar

Person.uar

common.uar

DEMO 2

Running the uTree sample

in standard deployment style

idf.exe

Maintaining/Updating your application

Uniface

Development

Runtime

Usys.uar

Usysicon.uar

common2.uar

department.uar

Person.uar

common.uar

[RESOURCES] Common2.uar Common.uar Person.uar Department.uar

utree.asn

DEMO 3

Maintaining the uTree sample

IDF to standard deployment[SETTINGS]

$search_descriptor DBMS_FIRST

$enhanced_edit all

$putmess_logfile D:\build\uniface9\w2k\log\idf.log

$search_resources Resources_only

$resources_output Uniface_Resource_Directory

[FILES]

usys:*.xml usysuniface:misc\*.xml

usys:idf.aps usysuniface:components\idf.aps

usys:uu*.frm usysuniface:components\uu*.frm

usys:uu*.svc usysuniface:components\uu*.svc

common:uu*.frm usys:..\components\uu*.frm

common:uu*.svc usys:..\components\uu*.svc

common:ur*.svc usys:..\components\ur*.svca

[PATHS]

[ENTITIES]

[USER_3GL]

[RESOURCES]

Uniface_Resource_Directory

usys:uidf.uar

usys:usys.uar

usys:usysicon.uar

DEMO 4

IDF setup

Adding your own files in UARs

In ProcScript:

• $RSO

• $RES

Redirection via asn file:

[FILES]

*.xml $RES:FIL/*.xml

Local & Remote UAR’s

myApp.asn:

[RESOURCES]

myLocal.uar

F:\shares\MyRemote.uar

Settings for Runtime

[SETTINGS]

$SEARCH_RESOURCES = Resources_Only

Resources_Excluded (default)

Resources_First

Resources_Last

$Search_Resources = …

UnifaceUsys.uar

Usysicon.uar department.uar

Main.uarPerson.uar

FRM

USP

SVC

DOLURR

APS

Resources_OnlyResources_Excluded

Resources_First |Resources_Last

Uniface Resource Manager

Person.uar

Main.uar

Resources Deployment

department.uar

URM is a command line deployment utility

Uniface Resource Manager

Urm.exe {/GeneralSwitch(es)} Operation Source {Destination} {-Options}

List

Copy

Delete

Merge

Move

…

Samples

urm copy

Uniface_Resource_Directory/*/a*

mytest.uar:/*/a*

urm copy

Uniface_Resource_Directory/*/*

mytest.uar:/*/* -after=20131127

DEMO 5

Uniface Resource Manager

urm.exe

The Benefits

• Easy to deploy: Copy & Paste

• UAR Based on Standard Zip technology

• Easy to do/undo changes

• Run Straight from UARs

• Application Partitioning

Compatibility• Uniface is still installed in classical style

• Usys Directory contains both styles

• IDF flags /dis /ins /dol /urr still work

• $search_descriptor & $search_object are ignored in “resources_only” mode

• Urr’s & Dol’s are new the format from Uniface 9.3

• No migration issues: just recompile your complete app (Uniface 9.3 upwards)

Remember

who is your best friend

30

/?

Uniface 10

31

This will be the only approach in Uniface 10

Thank you!