Process Mapping Logo

Process Mapping - Forums

Sharing 19 years of knowledge and experience

 
Metastorm BPM forums
Sign up Latest Topics
 
 
 


Reply
  Author   Comment  
Jerome

Avatar / Picture

Guru
Registered:
Posts: 5,507
Reply with quote  #1 

Behavior of %User.Form and %Form.Name in Versions of Metastorm BPM

                                Created: 25 Aug 2005
Last edited: 13 Nov 2007


        The information in this article applies to:

Product: Metastorm BPM (e-Work)
        Version: 6.x 7.x

Discussion

  •                                 The following is adapted from the Metastorm BPM documentation.

    Metastorm BPM version 7.5 SR1 (7.5.1) corrects the behavior of %User.Form. Once this update is applied, %User.Form returns the form name in an action form (i.e. when the user has started an action and the action form is displayed). However, the function returns an empty value in a folder. This is the same behavior of %User.Form that existed with versions 6.x. In versions 7.0 - 7.5, %User.Form incorrectly returned the form name in both an action form and a folder.

                                    For users who have built procedures that rely on the incorrect behavior, a new function (%Form.Name) has been introduced.                                 If process designers wish to have access to the form name in a folder, %Form.Name should be used.                                 This returns the form name in both an action form and a folder.                                

                                   
  •                                 The following is adapted from the Designer User Manual.                                

                                   
    %User.Form
            The function %User.Form returns the form name (string, read-only name of the current form)
            when viewed in an action, refill, or submit request. For example, the form name is returned
            where a user has started an action and the action form is displayed.
           


            This variable should be used only in the following properties:
            Form - When user loads form.
            Form - When user saves form.
            Field - Calculation formula.
            Field - List options.
            Field - When button pressed, When field changed, and When user selects row.
            Roles - When a role is used in the 'Restrict Viewing to roles' property of a form.
           


            This function returns an empty value in a folder. The function %Form.Name also returns the form
            name; however, unlike %User.Form, it does so in all situations, including in a folder.

    %Form.Name
            The function %Form.Name returns the form name (string, read-only name of the current form)
            when viewed in an action, refill or submit request. For example, the form name is returned
            where a user has started an action and the action form is displayed.
           


            This function also returns a value in a folder.
           


            This variable should be used only in the following properties:
            Form - When user loads form.
            Form - When user saves form.
            Field - Calculation formula.
            Field - List options.
            Field - When button pressed, When field changed, and When user selects row.
            Roles - When a role is used in the 'Restrict Viewing to roles' property of a form.
           


            The function %User.Form contains similar functionality except it returns an empty value in a folder.
                                           
                                   

Keywords: kb622


__________________
Post an example, and we will have a much better idea what the problem is. In about 90% of posts, the problem is one of communication. Examples bridge that gap.
0
Jerome

Avatar / Picture

Guru
Registered:
Posts: 5,507
Reply with quote  #2 
I am pretty certain (although I have not tested both of these in all versions) that the variable is filled after a refresh on a form, as we have pointed out before.

__________________
Post an example, and we will have a much better idea what the problem is. In about 90% of posts, the problem is one of communication. Examples bridge that gap.
0
Previous Topic | Next Topic
Print
Reply

Quick Navigation:


Create your own forum with Website Toolbox!