Show TOC

 IF_WD_REPOSITORY_HANDLELocate this document in the navigation structure

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.

Note

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.