Liquid UI - WS Reference Library

versionnumber()


Purpose

The versionnumber() command is used principally to reduce web traffic when scripts are hosted in a SAP web repository, a FTP shared directory or a HTTP web share. In action, the versionnumber() command adds a version number to any scripts cached from SAPWR. If the versionnumber() is updated, then SAP will access SAPWR to re-cache scripts that are stored there. This version number can be assigned as per the user wish and operates by causing  both the logon script and the session script to load each time, from the designated script directory.


Syntax

versionnumber("string", {"option":value});

Note: For the versionnumber command to function correctly, you must have one of the following two files:

  • elogon.sjs
  • esession.sjs


Properties

  • string- name of the directory to cache scripts.


Available Option

You can use the following options with the versionnumber:

"systemid":".."

"systemid":"SAP_system_ID" - Add systemid in esession.sjs file.


Option Detail

systemid

  1. If multiple SAP systems with the same name are being employed, users can specify a different system ID. The system ID is then used to strengthen the cache directory name.

  2.  versionnumber("004",{"systemid":"TR1"});
  3. To change the system id, user has to navigate to esession file path by locating it under cornelius output window and then assign the desired system id.


Example

In the following example, we will demonstrate the versionnumber command in action.

  1. Add the following entry to the guixt.sjs file.

    directory1 = "SAPWR:Z.GUIXTSID";
  2. Set the RFC connection parameters in the guixt.sjs file

    rfcuser = "XXXX";
    rfcpassword = "XXXX";
  3. Add version number to either elogon or esession files. In this case we will use esession.sjs file and add the following entry:
    versionnumber("004");
  4. Now, when you logon to SAPGUI, WS will check the SAPWR directory and download the latest version of the script file into the specified folder.
  5. In this example, the script files are downloaded as shown in below format:
  6. If the user logon to SAPGUI with different system ID other than the specified one from esession.sjs file, then SAPWR will not cache any scripts into that folder by comparing the version number.

Change Version Number

To change the version number in SAPWR, perform the following steps:

Step 1: Open ESESSION.SJS file and add the version number.

versionnumber("005");

Step 2: Logon to SAPGUI and navigate to /nsmw0 transaction.

Step 3: Select Binary data for WebRFC applications option from Web object and hit Enter.

Step 4: Enter object name and hit execute.

For Example: Z.GUIXTSID1.*

Step 5: Click create object.Enter object name and description.

  • Object name would be package name followed by file name.
    Z.GUIXTSID1.ESESSION.SJS
  • Description would be file name.
    eSession

Step 6: Click Import to upload the new version number. Upload the file and add package name.

Step 7: Click Save, then you will see the changes in the below format: