Académique Documents
Professionnel Documents
Culture Documents
Chapter 1. Introduction................................................................................................................ 4
1.1 Purpose.......................................................................................................................... 4
1.2 Environment................................................................................................................... 4
1.3 Configuration Parameter............................................................................................... 4
Chapter 2. tango g4 plugins....................................................................................................... 5
2.1 svc_tango_g4:init_tango_variables/3..........................................................................5
2.1.1 Overview.............................................................................................................. 5
2.1.2 Parameters............................................................................................................. 5
2.2 svc_tango_g4:init_specific_tango_variable/5.............................................................5
2.2.1 Overview.............................................................................................................. 5
2.2.2 Parameters............................................................................................................. 6
2.3 svc_tango_g4:include_dyn_menu/4............................................................................6
2.3.1 Overview.............................................................................................................. 6
2.3.2 Parameters.......................................................................................................... 7
2.4 svc_tango_g4:load_extra_tango_variables/4.............................................................7
2.4.1 Overview.............................................................................................................. 7
2.4.2 Parameters.......................................................................................................... 8
2.5 svc_tango_g4:check_string_prefix/5...........................................................................8
2.5.1 Overview.............................................................................................................. 8
2.5.2 Parameters.......................................................................................................... 8
2.6 svc_tango_g4:redirect_access/2.................................................................................9
2.6.1 Overview.............................................................................................................. 9
2.6.2 Parameters.......................................................................................................... 9
2.7 svc_tango_g4:set_biller_list/5.................................................................................... 10
2.7.1 Overview............................................................................................................ 10
2.7.2 Parameters........................................................................................................ 10
2.8 svc_tango_g4:language_menu/4..............................................................................10
2.8.1 Overview............................................................................................................ 10
2.8.2 Parameters........................................................................................................ 11
2.9 svc_tango_g4:transf_msisdn/5..................................................................................11
2.9.1 Overview............................................................................................................ 11
2.9.2 Parameters........................................................................................................ 11
2.10 svc_tango_g4:set_variable_by_tag/5.....................................................................12
2.10.1 Overview.......................................................................................................... 12
2.10.2 Parameters...................................................................................................... 12
2.11 svc_tango_g4:incl_multi_lang/2............................................................................... 13
2.11.1 Overview.......................................................................................................... 13
2.11.2 Parameters...................................................................................................... 13
2.12 svc_tango_g4:member_of_list/5.............................................................................. 13
2.12.1 Overview.......................................................................................................... 13
2.12.2 Parameters...................................................................................................... 13
2.13 svc_tango_g4:utf82uni/5.......................................................................................... 14
2.13.1 Overview.......................................................................................................... 14
2.13.2 Parameters...................................................................................................... 14
2.14 svc_tango_g4:check_number_range/5...................................................................14
2.14.1 Overview.......................................................................................................... 14
2.14.2 Parameters...................................................................................................... 15
2.15 svc_tango_g4:incl_options_menu/6........................................................................15
2.15.1 Overview.......................................................................................................... 15
2.15.2 Parameters...................................................................................................... 16
2.16 svc_tango_g4:format_check/7................................................................................. 16
2.16.1 Overview.......................................................................................................... 16
2.16.2 Parameters...................................................................................................... 16
2.17 svc_tango_g4:upper_case_convertor/5..................................................................17
2.17.1 Overview.......................................................................................................... 17
2.17.2 Parameters...................................................................................................... 17
2.18 svc_tango_g4:retrieve_tuple_element_by_key/7..................................................18
2.18.1 Overview.......................................................................................................... 18
2.18.2 Parameters...................................................................................................... 18
2.19 svc_tango_g4:incl_extra_menu/5............................................................................19
2.19.1 Overview.......................................................................................................... 19
2.19.2 Parameters...................................................................................................... 19
2.20 svc_tango_g4:incl_card_list/5.................................................................................. 20
2.20.1 Overview.......................................................................................................... 20
2.20.2 Parameters...................................................................................................... 20
2.21 svc_tango_g4:incl_offer_list/5.................................................................................. 20
2.21.1 Overview.......................................................................................................... 20
2.21.2 Parameters...................................................................................................... 21
2.22 svc_tango_g4:incl_menu/6......................................................................................21
2.22.1 Overview.......................................................................................................... 21
2.22.2 Parameters...................................................................................................... 22
2.23 svc_tango_g4:incl_lists/3.......................................................................................... 22
2.23.1 Overview.......................................................................................................... 22
2.23.2 Parameters...................................................................................................... 22
2.24 svc_tango_g4:init_variables/4.................................................................................. 23
2.24.1 Overview.......................................................................................................... 23
2.24.2 Parameters...................................................................................................... 23
2.25 svc_tango_g4:init_feature_variables/6...................................................................23
2.25.1 Overview.......................................................................................................... 23
2.25.2 Parameters...................................................................................................... 24
2.26 svc_tango_g4:get_currency_by_prefix/8................................................................24
2.26.1 Overview.......................................................................................................... 24
2.26.2 Parameters...................................................................................................... 25
2.27 svc_xml_generic_advanced_routing:request/8.....................................................25
2.27.1 Overview.......................................................................................................... 25
2.27.2 Parameters...................................................................................................... 26
2.28 svc_xml_generic_advanced_routing:rest_request/10...........................................27
2.28.1 Overview.......................................................................................................... 27
2.28.2 Parameters...................................................................................................... 27
Chapter 1. Introduction
1.1 Purpose
Tango g4 plugins provide executable functions and commands which can be invoked
from Cellcube XML documents.
1.2 Environment
The most tango g4 plugins are depending on the values from the configuration parameter
pservices_tango_g4::tango_init_variables, svc_tango_g4: init_tango_variables/3 will load
this parameter in session for other plugins.
The format of pservices_tango_g4::tango_init_variables:
{tango_init_variables,
[{default, [{{“service name”, ”variable name”}, value},
…...]},
{operator, [{{“service name”, “variable name”}, value},
……]}
]}
Chapter 2. tango g4 plugins
2.1 svc_tango_g4:init_tango_variables/3
2.1.1 Overview
This plugin command redirects to the next page when loading the variables is completed.
svc_tango_g4: init_tango_variables/3 is a plugin command: it will will read the
[app_name]::tango_init_variables, and load the variables in session for whole tango
services. The 'default' values will be initialized, then the operator-specific variables will be
loaded if exist.
2.1.2 Parameters
2.1.2.1 “app_name”
2.1.2.2 “next”
2.2 svc_tango_g4:init_specific_tango_variable/5
2.2.1 Overview
This plugin command redirects to the next page when loading the variables is completed.
svc_tango_g4: init_specific_tango_variable/5 is a plugin command: it will read the
[app_name]::tango_init_variables, and load the target variables in session for whole
tango services. The 'default' values will be initialized, then the operator-specific variables
will be loaded if exist. The variable names is the list of target variables to init.
2.2.2 Parameters
2.2.2.1 “app_name”
2.2.2.2 “service”
2.2.2.3 “variable_name”
2.3 svc_tango_g4:include_dyn_menu/4
2.3.1 Overview
This plugin function specifies to show the dynamic menu for Tango of the current session
into a page.
svc_tango_g4:include_dyn_menu/4 is a plugin function: it must be used as the target of a
<include> item in a page. The menu is defined in the pservices_xxx::tango_init_variables,
for example {“tango”,”menus”}. For each menu, it has a name and option list. In each
option, there should be {[name],[switch],[tag],[target]}:
[name] – the name of the option;
[switch] – enable/disable to decide if the link show
[tag] – the tag which related the multi lang content
[target] – the target which option link to
2.3.2 Parameters
2.3.2.1 "service_name"
This parameter specifies service name for storing the menu config which is configured in
tango_init_variables, the default value is “tango”.
Example for {“tango”,”menus”}:
tango
2.3.2.2 “variable_name”
This parameter specifies variable name for storing the menu config, which is initilized in
tango_init_variables, the default value is “menus”.
Example for {“tango”,”menus”}:
menus
2.3.2.3 “menu_name”
This parameter specifies the menu list name, consisted with name of menu in public
variables.
Example for {“tango”,”menus”}:
customer_menu
2.4 svc_tango_g4:load_extra_tango_variables/4
2.4.1 Overview
This plugin command redirects to the next page when loading the variables is completed.
svc_tango_g4: load_extra_tango_variables/4 is the plugin command: it will read the
app_name::extra_variables, and put the variables in session for whole tango services.
Only the 'key' related variables will be loaded.
The format of extra_variables:
{extra_variables,[
{"key”,[{{“service name”,”variable name”},value},
……]},
{“tb1”, [{{“service name”,”variable name”},value}]}
}]}
2.4.2 Parameters
2.4.2.1 “key”
2.4.2.2 “app_name”
2.4.2.3 “next”
This parameter specifies the next link when loading the variables of key is completed.
2.5 svc_tango_g4:check_string_prefix/5
2.5.1 Overview
This plugin command redirects to in or out page depending on the value includes or
excludes the one of prefix list.
svc_tango_g4:check_string_prefix/5 is the plugin command: it will check the prefix of
input string. If its prefix in the list, link to in; if not, link to out.
2.5.2 Parameters
2.5.2.1 “string_value”
2.5.2.2 “prefix_list”
This parameter specifies prefix list, separated by ',', which could be string/dynamic string.
Example:
220,221,222,223
2.5.2.3 “in”
This parameter specifies the next page when the string_value includes the one of the
prefix_list.
2.5.2.4 “out”
This parameter specifies the next page when the string_value does not contain any of the
prefix_list.
2.6 svc_tango_g4:redirect_access/2
2.6.1 Overview
2.6.2 Parameters
2.6.2.1 “match”
This parameter specifies how the patterns must match the value of the attribute in order
to trigger the redirection.
- "equal": the value is equal to the pattern
- "equal_num": the value is equal to the pattern (both interpreted as numbers)
- "prefix": the pattern is a prefix of the value.
- "contain": the pattern is nested in the value.
- "length": the length of the value is equal to the pattern (both interpreted as numbers)
2.7 svc_tango_g4:set_biller_list/5
2.7.1 Overview
svc_tango_g4: set_biller_list/5 is the plugin command: it will get the biller list in the
service_name.input_list_name, then set it in a variable and link to the next. The language
related list will be retrieved. Please confirm the session variable tango.default_lang is set
before using this plugin.
Example of tango.billers_list_A:
[{fr,[{"pb1","bp fr text 1","agent_bill_payment"}]},
{en,[{"pb1","bp en text 1","agent_bill_payment"}]}]
2.7.2 Parameters
2.7.2.1 “service_name”
2.7.2.2 “input_list_name”
2.7.2.3 “output_list_name”
This parameter specifies the variable name for saving the list
2.7.2.4 “next”
2.8 svc_tango_g4:language_menu/4
2.8.1 Overview
2.8.2 Parameters
2.8.2.1 “service”
This parameter specifies the variable name for saving the selected language
2.8.2.3 “next”
2.9 svc_tango_g4:transf_msisdn/5
2.9.1 Overview
2.9.2 Parameters
2.9.2.1 “svc”
2.9.2.2 “old_msisdn”
2.9.2.3 “new_msisdn_name”
This parameter specifies the variable name which will store the transformation result
2.8.2.4 “next”
2.10 svc_tango_g4:set_variable_by_tag/5
2.10.1 Overview
2.10.2 Parameters
2.10.2.1 “tag”
2.10.2.2 “service_name”
This parameter specifies the service name of saving the result from tag.
2.10.2.3 “val_name”
This parameter specifies the variable name of saving the result from tag.
2.10.2.4 “next”
2.11.1 Overview
svc_tango_g4: incl_multi_lang/2 is the plugin function: it will convert the tag to string in
corresponding language and operator in session. Please confirm the session variable
tango.default_lang is set before using this plugin.
2.11.2 Parameters
2.11.2.1 “tag”
2.12 svc_tango_g4:member_of_list/5
2.12.1 Overview
2.12.2 Parameters
2.12.2.1 “input_value”
2.12.2.2 “check_list”
2.12.2.4 “out”
2.13 svc_tango_g4:utf82uni/5
2.13.1 Overview
svc_tango_g4: utf82uni/5 is the plugin command: it will convert a utf8 string to unicode, the
result will be set into service.valname and link to next page.
2.13.2 Parameters
2.13.2.1 “string_utf8”
2.13.2.2 “service_name”
2.13.2.3 “val_name”
2.13.2.4 “next”
2.14.1 Overview
svc_tango_g4: utf82uni/5 is the plugin command: it will check if the input number in a
range. If min =< input_number =< max, link to in page; if not, link to out page; if input is
not number redirect to nok page. If the session value tango.decimal_switch is “on”
number with decimal is supported; otherwise only integer is supported. This plugin only
handle positive number
2.14.2 Parameters
2.14.2.1 “amount_value”
2.14.2.2 “max_value”
2.14.2.3 “min_value”
2.14.2.4 “in”
2.14.2.5 “out”
This parameter specifies to link to out page if the input number is not in a range
2.14.2.6 “not”
This parameter specifies to link to not page if the input number is not number
2.15 svc_tango_g4:incl_options_menu/6
2.15.1 Overview
2.15.2 Parameters
2.15.2.1 “list_var”
2.15.2.2 “first_item_id”
2.15.2.3 “service”
2.15.2.4 “output_val_name”
2.15.2.5 “next”
2.16.1 Overview
svc_tango_g4: format_check/7 is the plugin command: it will check the variable with
“format”, if match will link to match page, if not match will link to not_match page,
otherwise will link to error.
2.16.2 Parameters
2.16.2.1 “service_name”
2.16.2.2 “var_name”
2.16.2.3 “format”
2.16.2.4 “match”
This parameter specifies to link to the next if the variable matches the format
2.16.2.5 “not_match”
This parameter specifies to link to not_match page if the variable does not match the format
2.16.2.6 “error”
2.17.1 Overview
2.17.2 Parameters
2.17.2.1 “input”
2.17.2.2 “service”
2.17.2.3 “variable”
2.17.2.4 “next”
2.18 svc_tango_g4:retrieve_tuple_element_by_key/7
2.18.1 Overview
2.18.2 Parameters
2.18.2.1 “key”
2.18.2.2 “list_var”
2.18.2.3 “svc_name”
2.18.2.4 “var_name”
2.18.2.5 “ok”
2.18.2.6 “nok”
2.19 svc_tango_g4:incl_extra_menu/5
2.19.1 Overview
svc_tango_g4: incl_extra_menu/5 is the plugin function: it will display the menu according
to the configuration parameter app_name::extra_variables::extra_options, and save the
selected key in service.variable. The display is depending on the multi lang file, if do not
search the tag in multi lang file the description will be displayed directly.
The format of app_name::extra_variables::extra_options:
[{"description”,"tag","key"},……]
2.19.2 Parameters
2.19.2.1 “app_name”
2.19.2.2 “service”
2.19.2.3 “svc_name”
This parameter specifies the service name stores the selected key
2.19.2.4 “variable”
This parameter specifies the variable name stores the selected key
2.19.2.5 “next”
2.20 svc_tango_g4:incl_card_list/5
2.20.1 Overview
svc_tango_g4: incl_card_list/5 is the plugin function: it will generate a list menu based on
the "List" parameter. The chosen will be stored into "service. var".
2.20.2 Parameters
2.20.2.1 “list”
2.20.2.2 “service”
2.20.2.3 “var”
2.20.2.4 “next”
2.21 svc_tango_g4:incl_offer_list/5
2.21.1 Overview
svc_tango_g4: incl_offer_list/5 is the plugin function: it will generate an offer list menu
based on the offer list stored in the variable.
Each offer is like "{"offer_code", "offer_label", [{"option_code", "option_label"},...],
[{"duration_code", "duration_label",...}]}.
The chosen offer's offer_code will be stored into "service.offer_code".
The chosen offer's offer_label will be stored into "service.offer_label".
The chosen offer's option number will be stored into "service.option_num".
The chosen offer's option codes and labels will be stored into "service.option_list" with
format "[{option_code1, option_label1}, {option_code2, option_label2},...]".
The chosen offer's duration number will be stored into "service.duration_num".
The chosen offer's duration codes and labels will be stored into "service.duration_list"
with format "[{duration_code1, duration_label1}, {duration_code2, duration_label2},...]" if
duration number is larger than "1".
The chosen offer's duration code and label will be stored into "service.duration_list" with
format "duration_code;;duration_label" if duration number is "1"
2.21.2 Parameters
2.21.2.1 “offers_list”
2.21.2.2 “service”
2.21.2.3 “next”
2.22 svc_tango_g4:incl_menu/6
2.22.1 Overview
svc_tango_g4: incl_menu/6 is the plugin function: it will display a dynamic menu based on
the specified list stored in the session. The list should be in the format "[{ID1, Label1},
{ID2, Label2},....]". LabelX is used to display and selected ID and Label will be stored into
service.output_code and service.output_label, and then link to the next page.
2.22.2 Parameters
2.22.2.1 “list_var”
2.22.2.2 “service”
This parameter specifies the variable name stores the selected code
2.22.2.4 “output_label”
This parameter specifies the variable name stores the selected label
2.22.2.5 “next”
2.23 svc_tango_g4:incl_lists/3
2.23.1 Overview
svc_tango_g4: incl_lists/3 is the plugin function: it will display the elements of a list one by
one except an empty element. If the variable does not exist, an error page is sent
(pserver,bug_url)
2.23.2 Parameters
2.23.2.1 “service”
2.23.2.2 “name”
2.24.1 Overview
2.24.2 Parameters
2.24.2.1 “service_name”
2.24.2.3 “var_name_list”
This parameter specifies the variable name of name list which is separated by “,”
Example:
name1,name2,name3
2.25 svc_tango_g4:init_feature_variables/6
2.25.1 Overview
2.25.2 Parameters
2.25.2.1 “app_name”
2.25.2.2 “feature_name”
2.25.2.3 “init_var_name”
2.25.2.4 “next”
2.25.2.5 “error”
2.26 svc_tango_g4:get_currency_by_prefix/8
2.26.1 Overview
2.26.2.1 “msisdn”
2.26.2.2 “service”
This parameter specifies the service name of mapping and matched currency
2.26.2.3 “mapping”
This parameter specifies the variable name of the list including msisdn prefix and currency
2.26.2.4 “ok”
2.26.2.5 “nok”
2.26.2.6 “error”
2.27 svc_xml_generic_advanced_routing:request/8
2.27.1 Overview
2.27.2 Parameters
2.27.2.1 “request_name”
2.27.2.2 “svc_name”
2.27.2.3 “url”
2.27.2.4 “routing”
This parameter specifies the appropriate HTTP route which matches with the HTTP.
2.27.2.5 “timeout”
2.27.2.6 “pattern”
svc_xml_generic_advanced_routing:rest_request/10
2.28.1 Overview
2.28.2 Parameters
2.28.2.1“method”
2.28.2.2 “url”
2.28.2.3 “header”
2.28.2.4 “body”
This parameter specifies the appropriate HTTP route which matches with the HTTP.
2.28.2.6 “timeout”
2.28.2.7 “svc_name”
2.28.2.8 “mapping_name”
This parameter specifies mapping file used to decode the xml response
2.28.2.9 “pattern”