Passing the workspace as a parameter

Parameter to choose workspace used

Previously in VDF 11.1 I have created and compiled programs on my development machine with local data on drive C:and a workspace called "Garments". When publishing the program for network use, I have passed a parameter to the application "Netgarments" and have had a separate "Netgarments.ws" file which stated that the data path was on drive F: - the network drive. Thus when using the App on the network, users saw data on drive F:

How can I do this with the new workspace system in VDF12.x and beyond?

Changes in the cApplication class

With VDF12 the workspace logic has changed a little. Previously in VDF8.x .. VDF11.x the configuration of your workspace was partly stored in the registry and partly in the .ws file. Now with VDF12.x (and later) the registry settings are gone. The settings are now stored in a .sws file along with one (or more) .ws files.

In order to select the correct .ws file, the cApplication class now has a property called

psAutoOpenWorkspace

and its default is

config.ws

which is the name of the default .ws file. If you want to use your old .ws file, just change the value of that particular property.

An Example of a program that uses a subclass of cApplication

the program:

 //AB-StoreStart
 Use dfAllEnt.pkg
 use DFAbout
 //
 #REPLACE CURRENT$WORKSPACE   "Training.Mapps121" //default - modified by calling param
 Register_Object oClientArea
 //
 // 1) use package for application workspace
 Use MyApplication.pkg //Workspc for multico workspace mapps121
 //
 // 2) Set date attributes as needed
 Set_Date_Attribute sysdate4_State to dftrue
 Set_Date_Attribute Date4_State    to dftrue
 Set_Date_Attribute epoch_value    to 60
 //
 // 3) Application Workspace - help type and name
 Object oApplication is a cMyApplication
 End_Object  // oApplication
 //etc

The cApplication subclass

  Class MyApplication is a cApplication
    Procedure OnCreate
        String sCompanyFolder stemp Programname
        
        cmdline sCompanyFolder // get a parameter from the command line!
        If (sCompanyFolder="") Move "TRAINING" to scompanyfolder //default to traing db if execeuted without param
        move (uppercase(sCompanyFolder)) to sCompanyFolder
        
        Send DoOpenWorkspace (sCompanyFolder -".mApps121") //CURRENT$WORKSPACE
        Get_Attribute DF_OPEN_PATH to sTemp        

        //we use a file, REFNUM2, to contain info specific to this company
        Open refnum2
        Move (trim(refnumA2("COMPFOLD"))) to sTemp //function to get a param from the company control file
        
        If (sTemp<>sCompanyFolder) Begin
            Send stop_box ("Company ID mismatch in refnum2 file"  * sCompanyFolder * sTemp) 
            Abort //showstopper
        End
        Set psCompanyFolder to sCompanyFolder
        
        //colour for visual clues
        Move (trim(refnumA2("COMPCOLR")))   to sTemp
        Set psCompanyColour to sTemp
        
        //Formal Company Name
        Move (trim(RefNumA2("COMPANY")))    to sTemp
        Set psCompany  to sTemp

        //and much much more, you get the picture
        //....

        Set peHelpType to htHtmlHelp
        //
        Set pbEnterKeyAsTabKey to True
        Set psProduct to "KirkNet"
        Set psProgram to (Module_Name(Self))
        Set psHelpFile to ((Module_name(self)) + ".htm")       
        Set pbPreserveEnvironment to False          
    End_Procedure
  End_Class