Show TOC Anfang des Inhaltsbereichs

Vorgehensweisen Deprecating Usage Types  Dokument im Navigationsbaum lokalisieren

Use

You may need to change some interfaces or replace objects and interfaces. In order for other users to incorporate the change to new interfaces or objects there will be a transition period. In the transition period no new uses of the outdated interfaces or objects should occur. The provider of an interface can deprecate the use of individual objects through this interface. This does not mean disapproval of the use of objects through another interface or disapproval of the use of other objects in the interface.

Documentation of the date enables the owner to check whether a sufficient transition period was adhered to. In the deprecation for a use, there must be an alternative development object specified. Through the specification of an alternative, the changeover is easier for the client.

The disapproved use of an object or an interface leads to a warning during the check or activation through the client.

The following levels of deprecation is supported:

·        Standard: Both static and dynamic uses of a deprecated object give warnings.

·        Static use forbidden: Static use is forbidden already, dynamic use still only gives warnings.

Prerequisites

A usage can be marked as deprecated, only when the object is allowed to be exposed in an interface with this usage type. The rules for allowing a deprecated usage are the same as normal usage.

Procedure

...

       1.      Display the relevant package interface in the Package Builder/Interface Builder.

       2.      Select Change mode.

       3.      Choose the Deprecated Usages tab.

       4.      To add a usage, choose the Add Usage Type as Deprecated button in the Deprecated Objects List toolbar.

The system displays the Add an Object to Deprecated Objects List dialog box.

       5.      Save.

Result

This would result in deprecation of the said Usage Type / Object. It will also lead to deprecation of the usage types which are implied by this usage type.

Hinweis

Deprecation of Direct Use implies Deprecation for Propagated Use. So withdrawing the deprecation for Direct Use will result in withdrawal of the deprecation for Propagated Use. Also, only propagated use may be deprecated, if needed.


Ende des Inhaltsbereichs