NextGen Consulting

Display Multi-Level Choice List

Q: Could you please show me how to display multi-level choice list in Amdocs smart client form (Eg: CASE_TYPE choice) .     

I’ve seen the guidance in AUIF_Programmers_Guide-M30113 document, but it’s not illustrated by image so I can not make it.     

Displaying Multi-Level Choice List

Flow Diagram

 

 

Using Multi-Level Choice List

To display Multi-level choice list, you need to use Multi-level choice list submit action (MLCLSA). This action is used if change of selection in a ComboBox or ListBox needs to fetch choice list data to fill next level ComboBox or ListBox.

To display a 3 level hierarchical user defined choice lists, use the following example.

We will use CASE_TYPE user defined popup list in this example.

Add to your Smart Client form the following entities:

• Add three ComboBox controls: cmbLevel1, cmbLevel2 and cmbLevel3.
    
  

   

• Add the following data models:
   
  

        

• Add  three Multi Level Choice List Submit Actions (MLCLSA): MLCLSA_Level1, MLCLSA_Level2 and MLCLSA_Level3
   
  
    
  
    
   
  
• Set the following controls properties:

cmbLevel1 properties:
 

 

 

cmbLevel2 properties:
 

  

 

cmbLevel3 properties:
 

 

• Set the following MLCL Submit Actions properties:

MLCLSA_Level1 properties:
 

 

MLCLSA_Level1 Request Map:
  
 

 

MLCLSA_Level1 Response Map:

 

  

MLCLSA_Level2 properties:
 

  

MLCLSA_Level2Request Map:
<none>
 

MLCLSA_Level2Response Map:
 

 

MLCLSA_Level3 properties:
 

  

MLCLSA_Level3 Request Map:
<none>

 

MLCLSA_Level3 Response Map:
 

 

 

• Set the form_load event to execute the first level MLCL Submit Action:
   
  
     
   
  

         

 

• Test your new choice list:
      
  

 

 

 

Explaining the Request Data Map parameters

The server returns associated data as a hierarchical TDM to the client, according to the value set for returnAll parameter.

 

Response Data Map Parameters

The following response data map properties should be set:

Source Path need to be set to “$Return”.

Target Data Model needs to be set to the TDM (defined on the form) to hold the choice list data.  

Each data model (row) in the TDM will have the following fields.

 

 

 

 

Retrieving Subsets of Hierarchical Lists

 

The returnAll value affects the behavior of the properties ChildChoiceAvailable and ChildChoice according to existence of child choice lists.

–       The ChildChoiceAvailable indicates whether or not the current selected data model has a child tabular data model.

–       The ChildChoice refers to the the child choice list TDM

The returnAll parameter can be set in to either 0, 1, or 2 as follows:

0:   return default choice

1:   return only choices

2:   return all

 

 

Option A: RetuenAll = 0 

If the returnAll parameter is set to 0 (return default):

–       The result may contain all the choices for the given metadata id and the child choice lists for the default choice.

If there are children:

–       ChildChoiceAvailable = true

–       ChildChoice = nested TDM containing the children, for the default item

–       ChildChoice = null, for the non-default items

If there are no children:

–       ChildChoiceAvailable = false

–       ChildChoice = null for all items

 

 

Option B: RetuenAll = 1

 

If the returnAll parameter is set to 1 (return_only_choices)

–       The result would include only the choices for the given metadata id.

–       ChildChoice=null for all items

 

If there are children

–       ChildChoiceAvailable = true   

If there are no children:

–       ChildChoiceAvailable = false.

 

 

Option C: RetuenAll =2

If the returnAll parameter is set to 2 (return all)

–       The result contain the choices and all child choice lists for the given metadata id.

 

If there are children

–       ChildChoiceAvailable = true

–       ChildChoice=nested TDM containing the children, for all items.

 

If there are no children

–       ChildChoiceAvailable = false

–       ChildChoice = null, for all items.