-
Deprecated InterfacesInterfaceDescriptionThis interface is not used anymore as marker interface for operations that can be invoked via REST API with user supplied arguments. These AuthorOperations must be instead annotated with
WebappRestSafeannotation.This approach will continue to work but it is recommanded to use the ro.sync.exml.plugin.urlstreamhandler.URLChooserPluginExtension2 interface which also receives access to the Oxygen workspace.
-
Deprecated ClassesClassDescriptionThis API is deprecated because it's based on javax package that's no more supported starting with Servlet 5.0 specification and because this extension type isn't protected against CSRF attacks. Use
ServletPluginConfigExtensioninstead.This API is deprecated because it's based on javax package that's no more supported starting with Servlet 5.0 specification and because this extension type isn't protected against CSRF attacks. UseServletPluginExtensioninstead.
-
Deprecated Exceptions
-
Deprecated FieldsFieldDescriptionsince 17It is a shorthand now, use
Styles.KEY_TEXT_DECORATION_LINE,Styles.KEY_TEXT_DECORATION_COLOR,Styles.KEY_TEXT_DECORATION_STYLEinstead.This is a typo of theStyles.KEY_VISIBILITY.UseDITAAccess.ID_FIRST_TOPIC_IDinstead which has a clearer meaning.
Identifier used in references path, representing that the topic id can be excluded from the reference.Use the constant POSITION_INSIDE_FIRST instead.UseInplaceEditorArgumentKeys.PROPERTY_EDIT_QUALIFIEDinstead. In case of an attribute it will offer a clark name instead of the QName used in the CSS.Since Oxygen 12.2 the preferred way is to define view IDs at plugin.xml level.Datasource (relational or native XML) ViewThe DITA maps organizer. WARN: Adding a new View Frame also means changing the version in MainFrameLayoutManager.VIEWS_LAYOUT_VERSION.Resource dependencies or hierarchy view. WARN: Adding a new View Frame also means changing the version in MainFrameLayoutManager.VIEWS_LAYOUT_VERSION.Preview view. WARN: Adding a new View Frame also means changing the version in MainFrameLayoutManager.VIEWS_LAYOUT_VERSION.Database table (relational) ViewSince Oxygen 12.2 toolbar IDs are defined in the "plugin.xml".Since Oxygen 12.2 toolbar IDs are defined in the "plugin.xml".since Oxygen 12.2. Please define a view id for the extension in the "plugin.xml".Since Oxygen 23 you can no longer create Saxon 9 PE transformers using this constant. The created transformer will be a Saxon HE transformer instead.Since Oxygen 23 you can no longer create Saxon 9 PE transformers using this constant. The created transformer will be a Saxon HE transformer instead.
-
Deprecated MethodsMethodDescriptionThis was used to return only the text-decoration-line part from the text-decoration shorthand, as defined here https://drafts.csswg.org/css-text-decor-3/#text-decoration-property.This method does not do anything anynmore, the attribute annotations are gathered from the framework folder.Please use the equivalent method which also receives the URL of the requestor.Please use the equivalent method which also receives the URL of the requestor.This method is not used anymore from oXygen to insert topic reference elements and it will be removed in a future release. All topic reference elements are inserted using the same method:
DITAAccess.editProperties(URL, AuthorCCManager, AuthorDocumentControllerImpl, AuthorElement[], TopicRefInserter, Object, boolean)use getInheritanceType instead.Please use the equivalent method which also receives the URL of the requestor.Please use the equivalent method which also receives the URL of the requestor.Please use the equivalent method which also receives the URL of the requestor.Use the getLocationOnScreenAsPoint(int x, int y) method instead.use modelToViewRectangle(int offset) insteadUse the method from the AuthorXMLUtilAccess class.Use the method from the AuthorXMLUtilAccess class.Use the method from the AuthorXMLUtilAccess class.Use the method from the AuthorXMLUtilAccess class.UseWorkspace.open(URL)instead.UseUtilAccess.correctURL(String)instead.UseWSAuthorEditorPageBase.deleteSelection()instead.UseAuthorUtilAccess.escapeAttributeValue(String)instead.UseWSTextBasedEditorPage.getCaretOffset()UseAuthorAccess.getReviewController()UseWSEditorBase.getEditorLocation()instead.UseWorkspaceUtilities.getParentFrame()instead.UseWSAuthorEditorPageBase.getSelectedText()UseWSAuthorEditorPageBase.getSelectionEnd()UseWSAuthorEditorPageBase.getSelectionStart()UseAuthorTableAccess.getTableCellAbove(AuthorElement)instead.UseAuthorTableAccess.getTableCellBelow(AuthorElement)instead.UseAuthorTableAccess.getTableCellIndex(AuthorElement)instead.UseAuthorTableAccess.getTableRow(int, AuthorElement)instead.UseAuthorTableAccess.getTableRowCount(AuthorElement)instead.UseWSTextBasedEditorPage.getWordAtCaret()instead.UseWSAuthorEditorPageBase.hasSelection()instead.UseAuthorDocumentController.inInlineContext(int)instead.UseAuthorDocumentController.insertText(int, String)instead.UseWorkspace.isStandalone()instead.UseChangeTrackingController.isTrackingChanges()instead.UseUtilAccess.locateFile(URL)instead.UseUtilAccess.makeRelative(URL, URL)instead.UseAuthorUtilAccess.newNonValidatingXMLReader()instead.UseAuthorElement.removeAttribute(String)instead.UseWSAuthorEditorPageBase.select(int, int)instead.UseWSTextBasedEditorPage.selectWord()instead.UseWSTextBasedEditorPage.setCaretPosition(int)instead.UseAuthorElement.setAttribute(String, AttrValue)instead.UseWorkspaceUtilities.showErrorMessage(String)instead.UseChangeTrackingController.toggleTrackChanges()instead.UseWSAuthorEditorPageBase.viewToModel(int, int)instead.Please use the APIAuthorDocumentController.getContentCharSequence().Use the API based on theAuthorNodeto get the length of the displayed text only, without mark-up markers.This functionality is needed from the CSS style matcher, so it will eventually move there. Will be removed in 17.0 or later.Will be removed in a future versionReplaced by "ro.sync.ecss.extensions.api.ChangeTrackingController.acceptSelection(int, int)"Replaced by "ro.sync.ecss.extensions.api.ChangeTrackingController.rejectSelection(int, int)"Please use instead the method ((WSAuthorComponentEditorPage)getWSEditorAccess().getCurrentPage()).createExtensionActionsToolbars();Please use instead the method ((WSAuthorEditorPage)getWSEditorAccess().getCurrentPage()).getAuthorAccess().Please use instead the method ((WSAuthorEditorPage)getWSEditorAccess().getCurrentPage()).getActionsProvider().getAuthorCommonActions().Please use instead the method ((WSAuthorEditorPage)getWSEditorAccess().getCurrentPage()).getActionsProvider().getAuthorExtensionActions().Please use instead the method ((WSAuthorComponentEditorPage)getWSEditorAccess().getCurrentPage()).setBreadCrumbPopUpCustomizer();Please use instead the method ((WSAuthorEditorPage)getWSEditorAccess().getCurrentPage())addPopUpMenuCustomizer(AuthorPopupMenuCustomizer popUpCustomizer)Please use instead the method ((WSAuthorComponentEditorPage)getWSEditorAccess().getCurrentPage()).setOutlinerPopUpCustomizer();Please use instead the method ((WSAuthorComponentEditorPage)getWSEditorAccess().getCurrentPage()).showBreadCrumbPanel();Please use instead the method getDITAAccess().getActionsProvider().getActions().from Oxygen 24 because it modifies the system ID at consecutive Paste, setting the systemID as current editor location.UseDocumentContentChangedEvent.getType()to determine the type of edit.UseAuthorInplaceContext.getAttributeToEditQName()instead. This method returns the attribute name as it was specified in the CSS. If a QName was specified then this QName might not be valid in the context of the current element. PropertyInplaceEditorArgumentKeys.PROPERTY_EDIT_QUALIFIEDshould be used in these situations.UseAuthorElement.getElementsByLocalName(String)[0] instead.UseAuthorTableOperationsHandler.handleDeleteRows(AuthorTableDeleteRowsArguments)method instead.UseWSAuthorEditorPage.getReviewController()This method removes all pop-up menu customizers already registered, please use the "addPopUpMenuCustomizer" method instead.For performance reasons, consider implementing the {KeyDefinitionManager.getContextKeyDefinitionsMap(URL)method instead.For performance reasons, consider implementing the {KeyDefinitionManager.getContextKeyDefinitionsMap(URL)method instead.The value may not be a plain String, use the "getNewValueObject" insteadThe value may not be a plain String, use the "getOldValueObject" insteadWARNING: THE USE OF THIS METHOD IS DISCOURAGED AND DEPRECATED
All plugins initially share a common settings namespace. So that would mean that a plugin could read values set by other plugins or it could register to receive value changed events for certain option keys set by other plugins (which may sometimes be useful). But this also means that accidentally a plugin could also overwrite the value for a certain key if more than one plugin use the same key. So ideally your plugin's persisted keys would all be manually prefixed with some unique ID when they are defined. This would be the recommended way of doing things. If you still want to use the method:
Using this method when working with the singleton access to the workspace "PluginWorkspaceProvider.getPluginWorkspace().getOptionsStorage()" will set it for all plugins. So a plugin will globally influence the global prefixes for keys loaded and saved also by other plugins. Which is never a good thing.
But using this method on the WorkspaceAccessPluginExtension.applicationStarted will only set the prefix for your plugin. So as long as your plugin will keep using the "WSOptionsStorage" received on the applicationStarted callback you will not influence other plugins.
replaced with processAboutToStart in version 23.1.Kept for backwards compatibility, no longer necessary with java 9+since 19.1, please use the equivalentCompareUtilAccessutilities.This method returns false also when running inside the WebApp. UseApplicationInformationAccess.getPlatform()instead.Replaced byWorkspaceUtilities.getImageUtilities()
-
Deprecated ConstructorsConstructorDescriptionLeft only for backward compatibility.Use
TableInfo(Map, int)instead because the table operation can also convert lists to tables and we need to provide a minimum number of rows.useDITAConRefResolver(ContextKeyManagerProvider)instead.useDitaLinkTextResolver(ContextKeyManagerProvider)instead.useDITAMapRefResolver(ContextKeyManagerProvider)instead, otherwise key resolution will not work in Web Author.useDITAMapRefResolver(ContextKeyManagerProvider)instead.
-
Deprecated Enum ConstantsEnum ConstantDescriptionUse
CursorType.CURSOR_E_RESIZEinstead.You should use one of the two other constants, specifying the direction.You should use one of the two other constants, specifying the direction.
CustomAttributeValueEditorcan be used instead to edit only specific attributes using a custom editor.