IF_WD_REPOSITORY_HANDLE 

Meaning

Interface IF_WD_REPOSITORY_HANDLE allows access to metadata dynamically created with methods IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION and IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION. Every time these methods are called, an object of type IF_WD_REPOSITORY_HANDLE is generated.

Use

Interface IF_WD_REPOSITORY_HANDLE provides methods that can be used to reset or delete previously created metadata.

Every time method IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION or IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION is called, an object of type IF_WD_REPOSITORY_HANDLE is generated.

Methods

DELETE_ALL_DYNAMIC_METADATA

Method DELETE_ALL_DYNAMIC_METADATA deletes all metadata created under this handle. This is all metadata that was created by calling method IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION or IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION.

However, if a component usage has been created, this will not be deleted. This can be deleted using method DELETE_COMPONENT_USAGE.

DELETE_COMPONENT_USAGE

This method deletes the component usage created under this handle.

Prerequisites

Component usage created dynamically using methods

●      IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION

●      IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION

●      IF_WD_COMPONENT_USAGE~CREATE_COMP_USAGE_OF_SAME_TYPE

or

●      IF_WD_COMPONENT~CREATE_CMP_USAGE_GROUP

The reference to the component usage is stored in interface attribute COMPONENT_USAGE.

Exceptions

Exception CX_WDR_RR_EXCEPTION is triggered if

...

       1.      the component usage was created statically rather than dynamically.

       2.      no component usage was created (class attribute COMPONENT_USAGE is then initial).

DELETE_NAVIGATION_LINK

This method deletes a dynamically created navigation link. A return value specifies whether the deletion was successful.

Prerequisites

The creation of dynamic metadata using method IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION or IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION.

Result

Name	Description
SUBRC (Typ I)	The value 0 means that the deletion was successful.

 

Parameter

Name	Description
NAVIGATION_LINK (type WDRR_NAVIGATION_LINK):	Navigation link to be deleted

Exceptions

Attempting to delete a non-dynamically created navigation target with this method triggers exception CX_WDR_RR_EXCEPTION.

DELETE_NAVIGATION_TARGET

This method deletes a dynamically created navigation target. A return value specifies whether the deletion was successful.

Prerequisites

The creation of dynamic metadata using method IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION or IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION.

Result

Name	Description
SUBRC (Typ I)	The value 0 means that the deletion was successful.

 

Parameter

Name	Description
NAVIGATION_TARGET (type WDRR_NAVIGATION_TARGET)	Navigation target to be deleted

Exceptions

Attempting to delete a non-dynamically created navigation target with this method triggers exception CX_WDR_RR_EXCEPTION.

DELETE_VIEW_CNT_ASSIGNMENT

This method deletes a dynamically created view container assignment. A return value specifies whether the deletion was successful.

Prerequisites

The creation of dynamic metadata using method IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION or IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION.

Result

Name	Description
SUBRC (Typ I)	The value 0 means that the deletion was successful.

 

Parameter

Name	Description
VIEW_CNT_ASSIGNMENT (ref to IF_WD_RR_VIEW_CNT_ASSIGNMENT)	Reference to the view container assignment to be deleted.

Exceptions

Attempting to delete a non-dynamically created view container assignment with this method triggers exception CX_WDR_RR_EXCEPTION.

DELETE_VIEW_USAGE

This method deletes a dynamically created view usage. A return value specifies whether the deletion was successful.

Prerequisites

The creation of dynamic metadata using method IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION or IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION.

Result

Name	Description
SUBRC (Typ I)	The value 0 means that the deletion was successful.

 

Parameter

Name	Description
VIEW_USAGE (reference to IF_WD_RR_VIEW_USAGE)	Reference to the view usage to be deleted

Exceptions

Attempting to delete a non-dynamically created view usage with this method triggers exception CX_WDR_RR_EXCEPTION.

GET_NAVIGATION_LINKS

This method returns all navigation links created under this handle.

Prerequisites

The creation of dynamic metadata using method IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION or IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION.

Result

Name	Description
RESULT (type WDRR_NAVIGATION_LINKS)	Table containing all navigation links created under this handle

 

GET_NAVIGATION_TARGETS

This method returns all navigation targets created under this handle.

Prerequisites

The creation of dynamic metadata using method IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION or IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION.

Result

Name	Description
RESULT (type WDRR_NAVIGATION_TARGETS)	Table containing all navigation links created under this handle

 

GET_VIEW_CNT_ASSIGNMENTS

This method returns all view container assignments created under this handle.

Prerequisites

The creation of dynamic metadata using method IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION or IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION.

Result

Name	Description
RESULT (type WDRR_VCA_OBJECTS)	Table containing all view container assignments created under this handle

 

GET_VIEW_USAGES

This method returns all view usages created under this handle.

Prerequisites

The creation of dynamic metadata using method IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION or IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION.

Result

Name	Description
RESULT (type WDRR_VIEW_USAGE_OBJECTS)	Table containing all view usages created under this handle

 

REMOVE

This method deletes all metadata created under this handle, together with a dynamically created component usage, if applicable. The handle is also invalidated. Once this method has been called, the Web Dynpro framework no longer has a reference to the handle. If a handle that has been invalidated with this method is accessed, exception CX_WDR_RR_EXCEPTION is triggered.

Prerequisites

The creation of dynamic metadata using method IF_WD_NAVIGATION_SERVICES_NEW~PREPARE_DYNAMIC_NAVIGATION or IF_WD_NAVIGATION_SERVICES_NEW~DO_DYNAMIC_NAVIGATION.