SAP Function Modules

comments icon Comments

POWL_QUERY_REFRESH SAP Function module - POWL single query refresher (for async call)







POWL_QUERY_REFRESH is a standard SAP function module available within R/3 SAP systems depending on your version and release level. Below is the pattern details for this FM showing its interface including any import and export parameters, exceptions etc as well as any documentation contributions (Comments) specific to the object.

See here to view full function module documentation and code listing, simply by entering the name POWL_QUERY_REFRESH into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: POWL_FUGR
Released Date: Not Released
Processing type: Remote-Enabled
remote enabled module settings


Pattern for FM POWL_QUERY_REFRESH - POWL QUERY REFRESH 





CALL FUNCTION 'POWL_QUERY_REFRESH' "POWL single query refresher (for async call)
  EXPORTING
    i_query_data =              " powl_query_sty  Query data
*   i_feeder_name =             " powl_feeder_ty  Name of corresponding Feeder (for performance)
*   i_ignore_edit_lock = SPACE  " powl_xflag_ty  Flag: Ignore existing edit lock upon query
*   i_no_refresh_lock = SPACE   " powl_xflag_ty  Flag: set no own refresh lock (if caller has already set it)
*   i_langu = SY-LANGU          " langu         Language Key
*   i_reset_esttime = SPACE     " powl_xflag_ty  reset query refresh estimation time
*   i_additional_paras =        " powl_namevalue_tty  Name/Value set
*   i_visible_fields =          " powl_columnid_tty  table of column IDs
*   i_shadow_mode =             " boolean       Boolean Variable (X=True, -=False, Space=Unknown)
*   i_shadow_guids =            " powl_guid_tty  Table of Guids
*   i_shadow_session_id =       " guid_32       GUID in 'CHAR' Format in Uppercase
*   i_config_visible_cols = 0   " i             Configuration settings visible columns
*   i_config_visible_rows = 0   " i             Configuration settings visible rows
*   i_standard_type =           " powl_type_ty  Standard POWL Type ID
*   i_messages =                " powl_msg_tty  Message META description
*   i_worklist_type =           " powl_theme_ty  POWL workflow theme type
*   i_new_ui =                  " boolean       Boolean Variable (X=True, -=False, Space=Unknown)
  IMPORTING
    e_xml_result =              " string
    e_shadow_mode =             " boolean       Boolean Variable (X=True, -=False, Space=Unknown)
    e_shadow_session_id =       " guid_32       GUID in 'CHAR' Format in Uppercase
    .  "  POWL_QUERY_REFRESH

ABAP code example for Function Module POWL_QUERY_REFRESH





The ABAP code below is a full code listing to execute function module POWL_QUERY_REFRESH including all data declarations. The code uses the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the original method of declaring data variables up front. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8).

DATA:
ld_e_xml_result    TYPE STRING
,
ld_e_shadow_mode    TYPE BOOLEAN
,
ld_e_shadow_session_id    TYPE GUID_32
.




DATA(ld_i_query_data) = 'Check type of data required'.

DATA(ld_i_feeder_name) = 'Check type of data required'.

DATA(ld_i_ignore_edit_lock) = 'Check type of data required'.

DATA(ld_i_no_refresh_lock) = 'Check type of data required'.

DATA(ld_i_langu) = 'Check type of data required'.

DATA(ld_i_reset_esttime) = 'Check type of data required'.

DATA(ld_i_additional_paras) = 'Check type of data required'.

DATA(ld_i_visible_fields) = 'Check type of data required'.

DATA(ld_i_shadow_mode) = 'Check type of data required'.

DATA(ld_i_shadow_guids) = 'Check type of data required'.

DATA(ld_i_shadow_session_id) = 'Check type of data required'.

DATA(ld_i_config_visible_cols) = 'Check type of data required'.

DATA(ld_i_config_visible_rows) = 'Check type of data required'.

DATA(ld_i_standard_type) = 'Check type of data required'.

DATA(ld_i_messages) = 'Check type of data required'.

DATA(ld_i_worklist_type) = 'Check type of data required'.

DATA(ld_i_new_ui) = 'Check type of data required'.
.

CALL FUNCTION 'POWL_QUERY_REFRESH'
  EXPORTING
    i_query_data =               ld_i_query_data
*   i_feeder_name =              ld_i_feeder_name
*   i_ignore_edit_lock =         ld_i_ignore_edit_lock
*   i_no_refresh_lock =          ld_i_no_refresh_lock
*   i_langu =                    ld_i_langu
*   i_reset_esttime =            ld_i_reset_esttime
*   i_additional_paras =         ld_i_additional_paras
*   i_visible_fields =           ld_i_visible_fields
*   i_shadow_mode =              ld_i_shadow_mode
*   i_shadow_guids =             ld_i_shadow_guids
*   i_shadow_session_id =        ld_i_shadow_session_id
*   i_config_visible_cols =      ld_i_config_visible_cols
*   i_config_visible_rows =      ld_i_config_visible_rows
*   i_standard_type =            ld_i_standard_type
*   i_messages =                 ld_i_messages
*   i_worklist_type =            ld_i_worklist_type
*   i_new_ui =                   ld_i_new_ui
  IMPORTING
    e_xml_result =               ld_e_xml_result
    e_shadow_mode =              ld_e_shadow_mode
    e_shadow_session_id =        ld_e_shadow_session_id
    .  "  POWL_QUERY_REFRESH

IF SY-SUBRC EQ 0.
  "All OK
ENDIF.







ABAP code to compare 7.40 inline data declaration with original syntax

The below ABAP code uses the older none in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. It may also be useful if you are using an older version of SAP as some of the newer syntax above, such as the @DATA is not available until 4.70 EHP 8.

DATA:


ld_e_xml_result  TYPE STRING ,
ld_i_query_data  TYPE POWL_QUERY_STY ,
ld_e_shadow_mode  TYPE BOOLEAN ,
ld_i_feeder_name  TYPE POWL_FEEDER_TY ,
ld_e_shadow_session_id  TYPE GUID_32 ,
ld_i_ignore_edit_lock  TYPE POWL_XFLAG_TY ,
ld_i_no_refresh_lock  TYPE POWL_XFLAG_TY ,
ld_i_langu  TYPE LANGU ,
ld_i_reset_esttime  TYPE POWL_XFLAG_TY ,
ld_i_additional_paras  TYPE POWL_NAMEVALUE_TTY ,
ld_i_visible_fields  TYPE POWL_COLUMNID_TTY ,
ld_i_shadow_mode  TYPE BOOLEAN ,
ld_i_shadow_guids  TYPE POWL_GUID_TTY ,
ld_i_shadow_session_id  TYPE GUID_32 ,
ld_i_config_visible_cols  TYPE I ,
ld_i_config_visible_rows  TYPE I ,
ld_i_standard_type  TYPE POWL_TYPE_TY ,
ld_i_messages  TYPE POWL_MSG_TTY ,
ld_i_worklist_type  TYPE POWL_THEME_TY ,
ld_i_new_ui  TYPE BOOLEAN .




ld_i_query_data = 'Check type of data required'.
ld_i_feeder_name = 'Check type of data required'.
ld_i_ignore_edit_lock = 'Check type of data required'.
ld_i_no_refresh_lock = 'Check type of data required'.
ld_i_langu = 'Check type of data required'.
ld_i_reset_esttime = 'Check type of data required'.
ld_i_additional_paras = 'Check type of data required'.
ld_i_visible_fields = 'Check type of data required'.
ld_i_shadow_mode = 'Check type of data required'.
ld_i_shadow_guids = 'Check type of data required'.
ld_i_shadow_session_id = 'Check type of data required'.
ld_i_config_visible_cols = 'Check type of data required'.
ld_i_config_visible_rows = 'Check type of data required'.
ld_i_standard_type = 'Check type of data required'.
ld_i_messages = 'Check type of data required'.
ld_i_worklist_type = 'Check type of data required'.
ld_i_new_ui = 'Check type of data required'.

Contribute (Add Comments)

Please help keep this info upto date and use the comments section below to add useful hints, tips and information specific to this SAP function. This will then be available for you and other users to easily find by simply searching on the object name POWL_QUERY_REFRESH or its description.


   
 

POWL_QUERY_REFRESH - POWL single query refresher (for async call)
POWL_PACK_SELCRIT_FOR_EHP - FM to pack the bc set contents into cluster table
POWL_EXT_STATUS - set external status for gen. selection screen
POWL_ENCODE_SELPARA - converts table of rsparams into a string
POWL_ENCODE_DYNPARA - converts dyn. selection parameters to a string
POWL_DECODE_SELPARA - converts a string of selection parameters into a RSPARAMS_TT table