IBookDefinitionManager (Oracle Fusion Middleware Java API for Oracle WebLogic Portal)

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.bea.netuix.application.manager
Interface IBookDefinitionManager

All Known Subinterfaces:: BookDefinitionManager

public interface IBookDefinitionManager

This is the primary interface for performing persistent store operations on BookDefinitions. In general this interface provides coarse grain getters and fine grain setters.

It is important to note that all methods on this interface are fully internationalized and entitled. All titles and descriptions on the objects returned by these methods are internationalized to the preferred locale. Also, all methods are entitled, meaning if the caller does not have the required credentials the method may return a subset of the actual list or be unable to perform the specified function.

"Definitions" can be thought of as objects in the library. Objects in the library are not associated to any one Desktop. In other words definitions can be placed on zero or more desktops and changes made in the library (to the definitions) are cascaded down to object on the desktops. If you are only interested in affecting a single desktop then use the PortalCustomizationManager and make changes to the "Instances".

This interface is intended to be implemented only by Oracle Weblogic Portal. Oracle Systems reserves the right to add abstract methods to this interface without notice. Implementations of this interface by other parties must not be expected to compile without change in future versions of Oracle Weblogic Portal.

Method Summary
`NavigableInstance`	`addNavigable(CustomizationContext customizationContext, BookDefinitionId bookDefinitionId, NavigableDefinitionId navigableDefinitionId, int position, int alignment, boolean isDefault)` Add a Navigable definition (child BookDefinition or PageDefinition) to an existing parent BookDefinition.
`BookDefinition`	`createBookDefinition(CustomizationContext customizationContext, BookDefinition bookDefinition)` Create a new book definition.
`BookDefinition`	`createBookDefinition(CustomizationContext customizationContext, BookView bookView)` Create a new book definition in the persistent store from a given BookView.
`void`	`deleteBookDefinition(CustomizationContext customizationContext, BookDefinitionId bookDefinitionId)` Method for deleting a `BookDefinition` object given a supplied book definition identifier.
`void`	`deleteBookDefinitionWithCascade(CustomizationContext customizationContext, BookDefinitionId bookDefinitionId)` Delete the `BookDefinition` of the supplied book definition identifier and all `BookInstance` objects associated with this book definition.
`void`	`deleteBookDefinitionWithReplacement(CustomizationContext customizationContext, BookDefinitionId deleteBookDefinitionId, BookDefinitionId replacementBookDefinitionId)` Delete an existing book definition and if it is in use, replace its use with the supplied book definition.
`BookDefinition`	`getBookDefinition(CustomizationContext customizationContext, BookDefinitionId bookDefinitionId)` Getter for returning a single `BookDefinition` object given a supplied book definition identifier.
`BookDefinition`	`getBookDefinition(CustomizationContext customizationContext, String definitionLabel, String webAppName)` Getter for returning a single `BookDefinition` object given a supplied book definition label.
`SortableFilterablePagedResult<BookDefinition>`	`getBookDefinitions(CustomizationContext customizationContext, BookSearchCriteria criteria, int pageSize)` Get all the book definitions for the webapp as a paged object.
`BookDefinition[]`	`getBookDefinitions(CustomizationContext customizationContext, String webapp)` Getter for returning a list of all `BookDefinitions` scoped to the supplied webapp.
`BookDefinition[]`	`getBookDefinitions(CustomizationContext customizationContext, String webapp, BookDefinitionId firstBookDefinitionId, int limit)` Returns `BookDefinition`s in `definitionId` order (create order), starting with the supplied definitionId and limiting the result set to size `limit`.
`BookView`	`getBookView(CustomizationContext customizationContext, BookDefinitionId bookDefinitionId)` Getter for returning an immutable deep `BookView`.
`SortableFilterablePagedResult<BookDefinition>`	`getPagedPublicBookDefinitions(CustomizationContext customizationContext, DesktopDefinitionId desktopDefinitionId, int pageSize)` Getter for returning a PagedResult of all `BookDefinitions` scoped to the supplied webapp and marked as public and not currently on the user's desktop.
`BookDefinition[]`	`getPublicBookDefinitions(CustomizationContext customizationContext, DesktopDefinitionId desktopDefinitionId)` Getter for returning a list of all `BookDefinitions` scoped to the supplied webapp and marked as public and not currently on the user's desktop.
`BookDefinition[]`	`getPublicBookDefinitions(CustomizationContext customizationContext, DesktopDefinitionId desktopDefinitionId, BookDefinitionId firstBookDefinitionId, int limit)` Returns `BookDefinition`s in `definitionId` order (create order) scoped to the supplied webapp and marked as public and not currently on the user's desktop, starting with the supplied definitionId and limiting the result set to size `limit`.
`BookDefinition[]`	`getPublicBookDefinitions(CustomizationContext customizationContext, String webapp)` Getter for returning a list of all `BookDefinitions` scoped to the supplied webapp and marked as public.
`BookDefinition[]`	`getPublicBookDefinitions(CustomizationContext customizationContext, String webapp, BookDefinitionId bookDefinitionId)` Getter for returning a list of all `BookDefinitions` scoped to the supplied webapp and marked as public and not currently in the supplied book (bookDefinitionId).
`BookDefinition[]`	`getPublicBookDefinitions(CustomizationContext customizationContext, String webapp, BookDefinitionId firstBookDefinitionId, int limit)` Returns `BookDefinition`s in `definitionId` order (create order) scoped to the supplied webapp and marked as public, starting with the supplied definitionId and limiting the result set to size `limit`.
`BookDefinition[]`	`getPublicBookDefinitions(CustomizationContext customizationContext, String webapp, PageDefinitionId pageDefinitionId)` Getter for returning a list of all `BookDefinitions` scoped to the supplied webapp and marked as public and not currently in the supplied page (pageDefinitionId).
`BookView`	`getShallowBookView(CustomizationContext customizationContext, BookDefinitionId bookDefinitionId)` Getter for returning an immutable `BookView`.
`SortableFilterablePagedResult<LocalizationResourceView>`	`getVisibleBookLocalizationResources(CustomizationContext customization, WebAppSearchCriteria criteria, int pageSize)` Retrieve the LocalizationResourceViews for all visible books for a given locale and webapp.
`NavigableDefinition`	`moveNavigable(CustomizationContext customizationContext, BookDefinitionId fromParentBookDefinitionId, BookDefinitionId toParentBookDefinitionId, NavigableDefinitionId navigableDefinitionId, int position, int alignment)` Relocate the navigable definition to a new location.
`NavigableDefinition`	`moveNavigable(CustomizationContext customizationContext, DesktopDefinitionId desktopDefinitionId, BookDefinitionId fromParentBookDefinitionId, BookDefinitionId toParentBookDefinitionId, NavigableDefinitionId navigableDefinitionId, int position, int alignment)` Deprecated Use moveNavigable(CustomizationContext, BookDefinitionId, BookDefinitionId, NavigableDefinitionId, int, int)
`void`	`removeNavigable(CustomizationContext customizationContext, BookGroupId bookGroupId)` Remove a NavigableDefinition (BookDefinition or PageDefinition) from the specified book.
`BookDefinition[]`	`searchPublicBookDefinitions(CustomizationContext customizationContext, String webapp, String partialBookTitle, int limit)` Search for public books given the supplied search string.
`void`	`setDefaultNavigable(CustomizationContext customizationContext, BookDefinitionId parentBookDefinitionId, NavigableDefinitionId navigableDefinitionId)` Set a navigable (book or page) on a parent page as the default page.
`void`	`updateBookDefinition(CustomizationContext customizationContext, BookDefinition bookDefinition)` Update the persistent store for the supplied `BookDefinition`.

Method Detail

getBookView

BookView getBookView(CustomizationContext customizationContext,
                     BookDefinitionId bookDefinitionId)
                     throws RemoteException

Getter for returning an immutable deep BookView. The BookView objects, unlike the BookDefinition or the BookInstance objects contains a full set of references to all child pages, books and so on. The BookView object, however is immutable.

Parameters: customizationContext - customization information such as preferred locales and http request.; bookDefinitionId - the unique bookDefinitionId.
Returns: an immutable deep BookView object if one exists, otherwise null.
Throws: RemoteException
See Also: IBookInstanceManager.getBookView(com.bea.netuix.application.manager.CustomizationContext, com.bea.netuix.application.identifier.DesktopDefinitionId, com.bea.netuix.application.identifier.BookInstanceId)

getShallowBookView

BookView getShallowBookView(CustomizationContext customizationContext,
                            BookDefinitionId bookDefinitionId)
                            throws RemoteException

Getter for returning an immutable BookView. The returned view object will be shallow in the sense that it will have no child book or page view arrays. However, you can lazily retrieve those by calling the paginated getNavigables method.

Parameters: customizationContext - customization information such as preferred locales and http request.; bookDefinitionId - the unique bookDefinitionId.
Returns: an immutable shallow BookView object if one exists, otherwise null.
Throws: RemoteException
See Also: IBookInstanceManager.getBookView(com.bea.netuix.application.manager.CustomizationContext, com.bea.netuix.application.identifier.DesktopDefinitionId, com.bea.netuix.application.identifier.BookInstanceId)

getBookDefinitions

BookDefinition[] getBookDefinitions(CustomizationContext customizationContext,
                                    String webapp)
                                    throws RemoteException

Getter for returning a list of all BookDefinitions scoped to the supplied webapp.

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; webapp - the web application these book definitions are scoped to.
Returns: an array of BookDefinition objects if they exist, otherwise, an empty array.
Throws: RemoteException
See Also: BookDefinition

getBookDefinitions

BookDefinition[] getBookDefinitions(CustomizationContext customizationContext,
                                    String webapp,
                                    BookDefinitionId firstBookDefinitionId,
                                    int limit)
                                    throws RemoteException

Returns BookDefinitions in definitionId order (create order), starting with the supplied definitionId and limiting the result set to size limit. If fewer BookDefinitions exist than limit, then a smaller result set will be returned. If no definitions are found an empty array is returned. To start at the beginning of the list specify null as the bookDefinitionId. To retrieve from the end of the list and back specify null as the bookDefinitionId and a negative limit. To retrieve all the bookDefinitions in the database supply a limit of 0.
The implmentation has to ensure that repeated calls to this method return BookDefinitions in a consistent order.

Parameters: customizationContext - customization information such as preferred locales.; webapp - the web application these book definitions are scoped to.; firstBookDefinitionId - optional parameter to indicate where the list should start.; limit - the maximum result set size. Note the limit may be negative indicating a reverse sort order. To retrieve all the records specify a limit of zero. Note: some elements may be pruned because of entitlements.
Returns: array of BookDefinitions no greater than limit in size.
Throws: RemoteException

getPublicBookDefinitions

BookDefinition[] getPublicBookDefinitions(CustomizationContext customizationContext,
                                          String webapp,
                                          BookDefinitionId firstBookDefinitionId,
                                          int limit)
                                          throws RemoteException

Returns BookDefinitions in definitionId order (create order) scoped to the supplied webapp and marked as public, starting with the supplied definitionId and limiting the result set to size limit. If fewer BookDefinitions exist than limit, then a smaller result set will be returned. If no definitions are found an empty array is returned. To start at the beginning of the list specify null as the bookDefinitionId. To retrieve from the end of the list and back specify null as the bookDefinitionId and a negative limit. To retrieve all the bookDefinitions in the database supply a limit of 0.
The implmentation has to ensure that repeated calls to this method return BookDefinitions in a consistent order.

Parameters: customizationContext - customization information such as preferred locales.; webapp - the web application these book definitions are scoped to.; firstBookDefinitionId - optional parameter to indicate where the list should start.; limit - the maximum result set size. Note the limit may be negative indicating a reverse sort order. To retrieve all the records specify a limit of zero. Note: some elements may be pruned because of entitlements.
Returns: array of BookDefinitions no greater than limit in size.
Throws: RemoteException

getPublicBookDefinitions

BookDefinition[] getPublicBookDefinitions(CustomizationContext customizationContext,
                                          String webapp)
                                          throws RemoteException

Getter for returning a list of all BookDefinitions scoped to the supplied webapp and marked as public.

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; webapp - the web application these book definitions are scoped to.
Returns: an array of fully populated and internationalized BookDefinition objects if they exist, otherwise, an empty array.
Throws: RemoteException
See Also: BookDefinition

getPublicBookDefinitions

BookDefinition[] getPublicBookDefinitions(CustomizationContext customizationContext,
                                          DesktopDefinitionId desktopDefinitionId,
                                          BookDefinitionId firstBookDefinitionId,
                                          int limit)
                                          throws RemoteException

Returns BookDefinitions in definitionId order (create order) scoped to the supplied webapp and marked as public and not currently on the user's desktop, starting with the supplied definitionId and limiting the result set to size limit. If fewer BookDefinitions exist than limit, then a smaller result set will be returned. If no definitions are found an empty array is returned. To start at the beginning of the list specify null as the bookDefinitionId. To retrieve from the end of the list and back specify null as the bookDefinitionId and a negative limit. To retrieve all the bookDefinitions in the database supply a limit of 0.
The implmentation has to ensure that repeated calls to this method return BookDefinitions in a consistent order.

Parameters: customizationContext - customization information such as preferred locales; desktopDefinitionId - you wish to add any of these book definitions to.; firstBookDefinitionId - optional parameter to indicate where the list should start.; limit - the maximum result set size. Note the limit may be negative indicating a reverse sort order. To retrieve all the records specify a limit of zero.
Returns: an array of fully populated and internationalized BookDefinition objects if they exist, otherwise, an empty array.
Throws: RemoteException
See Also: BookDefinition

getPublicBookDefinitions

BookDefinition[] getPublicBookDefinitions(CustomizationContext customizationContext,
                                          DesktopDefinitionId desktopDefinitionId)
                                          throws RemoteException

Getter for returning a list of all BookDefinitions scoped to the supplied webapp and marked as public and not currently on the user's desktop.

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; desktopDefinitionId - you wish to add any of these book definitions to.
Returns: an array of fully populated and internationalized BookDefinition objects if they exist, otherwise, an empty array.
Throws: RemoteException
See Also: BookDefinition

getPagedPublicBookDefinitions

SortableFilterablePagedResult<BookDefinition> getPagedPublicBookDefinitions(CustomizationContext customizationContext,
                                                                            DesktopDefinitionId desktopDefinitionId,
                                                                            int pageSize)
                                                                            throws RemoteException

Getter for returning a PagedResult of all BookDefinitions scoped to the supplied webapp and marked as public and not currently on the user's desktop.

Parameters

customizationContext - customization information such as preferred locales and desktopInstanceId

desktopDefinitionId - you wish to add any of these book definitions to.

Returns

an array of fully populated and internationalized BookDefinition objects if they exist, otherwise, an empty array. The returned PagedResult is sortable and filterable on the fields "TITLE" and "DESCRIPTION", and supports these filter methods:

FilterMethod.UNFILTERED
FilterMethod.BEGINS_WITH
FilterMethod.ENDS_WITH
FilterMethod.CONTAINS
FilterMethod.EQUALS

However, the reSort and reFilter methods on the returned PagedResult ignore their locale arguments. If you want to requery with a different locale, you should call this method again after setting the desired locale in the CustomizationContext.

Throws

RemoteException

See Also

BookDefinition

getPublicBookDefinitions

BookDefinition[] getPublicBookDefinitions(CustomizationContext customizationContext,
                                          String webapp,
                                          BookDefinitionId bookDefinitionId)
                                          throws RemoteException

Getter for returning a list of all BookDefinitions scoped to the supplied webapp and marked as public and not currently in the supplied book (bookDefinitionId).

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; webapp - the web application these book definitions are scoped to.; bookDefinitionId - you wish to add any of these book definitions to.
Returns: an array of fully populated and internationalized BookDefinition objects if they exist, otherwise, an empty array.
Throws: RemoteException
See Also: BookDefinition

getPublicBookDefinitions

BookDefinition[] getPublicBookDefinitions(CustomizationContext customizationContext,
                                          String webapp,
                                          PageDefinitionId pageDefinitionId)
                                          throws RemoteException

Getter for returning a list of all BookDefinitions scoped to the supplied webapp and marked as public and not currently in the supplied page (pageDefinitionId).

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; webapp - the web application these book definitions are scoped to.; pageDefinitionId - you wish to add any of these book definitions to.
Returns: an array of fully populated and internationalized BookDefinition objects if they exist, otherwise, an empty array.
Throws: RemoteException
See Also: BookDefinition

searchPublicBookDefinitions

BookDefinition[] searchPublicBookDefinitions(CustomizationContext customizationContext,
                                             String webapp,
                                             String partialBookTitle,
                                             int limit)
                                             throws RemoteException

Search for public books given the supplied search string. Books with titles matching the supplied pattern will be returned. No more than limit results will be returned; however a smaller number may be returned. The implmentation has to ensure that repeated calls to this method return BookDefinitions in a consistent order.

Parameters: customizationContext - customization information such as preferred locales.; webapp - the web application these book definitions are scoped to.; partialBookTitle - the search string for book title match. Note: this string may contain special '*' and '?' characters, where '*' matches any number of characters and '?' matches any single character.; limit - the maximum result set size. Note the limit may be negative indicating a reverse sort order. To retrieve all the records specify a limit of zero. Note: some elements may be pruned because of entitlements.
Returns: array of BookDefinitions no greater than limit in size.
Throws: RemoteException

getBookDefinition

BookDefinition getBookDefinition(CustomizationContext customizationContext,
                                 BookDefinitionId bookDefinitionId)
                                 throws RemoteException

Getter for returning a single BookDefinition object given a supplied book definition identifier.

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; bookDefinitionId - the unique book definition identifier.
Returns: a BookDefinition object fully populated and internationalized, otherwise, null>/code> if the object does not exist.
Throws: RemoteException
See Also: BookDefinition

getBookDefinition

BookDefinition getBookDefinition(CustomizationContext customizationContext,
                                 String definitionLabel,
                                 String webAppName)
                                 throws RemoteException

Getter for returning a single BookDefinition object given a supplied book definition label.

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; definitionLabel - the unique book definition identifier.; webAppName - the webapp this book is scoped to.
Returns: a BookDefinition object fully populated and internationalized, otherwise, null>/code> if the object does not exist.
Throws: RemoteException
See Also: BookDefinition

deleteBookDefinition

void deleteBookDefinition(CustomizationContext customizationContext,
                          BookDefinitionId bookDefinitionId)
                          throws RemoteException,
                                 ObjectNotFoundException,
                                 ObjectInUseException,
                                 NotEntitledException

Method for deleting a BookDefinition object given a supplied book definition identifier. If the BookDefinition is in use by clients then a ObjectInUseFound exception is thrown.

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; bookDefinitionId - the unique book definition identifier.
Throws: ObjectNotFoundException - if the bookDefinitionId is bogus.; ObjectInUseException - if the book definition is in use by end users.; NotEntitledException - no entitlements for this operation.; RemoteException
See Also: BookDefinition

deleteBookDefinitionWithReplacement

void deleteBookDefinitionWithReplacement(CustomizationContext customizationContext,
                                         BookDefinitionId deleteBookDefinitionId,
                                         BookDefinitionId replacementBookDefinitionId)
                                         throws RemoteException,
                                                ObjectNotFoundException,
                                                NotEntitledException

Delete an existing book definition and if it is in use, replace its use with the supplied book definition.

Note all customization of the deleted book will be lost.

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; deleteBookDefinitionId - the definition id of the book to delete; replacementBookDefinitionId - the definition id of the book to replace the deleted book.
Throws: ObjectNotFoundException - if the bookDefinitionId is bogus.; NotEntitledException - no entitlements for this operation.; RemoteException
See Also: BookDefinition

deleteBookDefinitionWithCascade

void deleteBookDefinitionWithCascade(CustomizationContext customizationContext,
                                     BookDefinitionId bookDefinitionId)
                                     throws RemoteException,
                                            ObjectNotFoundException,
                                            NotEntitledException,
                                            ObjectInUseException

Delete the BookDefinition of the supplied book definition identifier and all BookInstance objects associated with this book definition. While this method will cascade delete all the user's and admin's customizations it will complain (ObjectInUseException) if the definition is the primary book of a desktop. In that case you may want to try deleteBookDefinitionWithReplacement().

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; bookDefinitionId - the unique book definition identifier of the book to delete.
Throws: ObjectNotFoundException - if there is no BookDefinition associated with bookDefinitionId.; ObjectInUseException - if the book definition is the main book on a desktop.; NotEntitledException - if the caller does not have the required permissions to delete this object.; RemoteException

updateBookDefinition

void updateBookDefinition(CustomizationContext customizationContext,
                          BookDefinition bookDefinition)
                          throws RemoteException,
                                 ObjectNotFoundException,
                                 NotEntitledException

Update the persistent store for the supplied BookDefinition. All attributes of the BookDefinition are updated in the persistent store.

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; bookDefinition - the object containing the new data for the book definition.
Throws: ObjectNotFoundException - the BookDefinitionIdNotEntitledException - if the caller does not have the required permissions to delete this object.; RemoteException

addNavigable

NavigableInstance addNavigable(CustomizationContext customizationContext,
                               BookDefinitionId bookDefinitionId,
                               NavigableDefinitionId navigableDefinitionId,
                               int position,
                               int alignment,
                               boolean isDefault)
                               throws RemoteException,
                                      ObjectNotFoundException,
                                      NotEntitledException,
                                      IllegalDependencyException,
                                      DuplicateObjectException

Add a Navigable definition (child BookDefinition or PageDefinition) to an existing parent BookDefinition.

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; bookDefinitionId - the book definition to add the navigable to.; navigableDefinitionId - the definition id of the navigable definition from which to add.; position - the position in the book (or menu) to insert this navigable (starts with 0). If position is set to -1, the Navigable will be appended in the last position within the Book.; alignment - position the page from the left (top) or right (bottom)
Returns: the Navigable instance which was created.
Throws: ObjectNotFoundException - BookDefinitionId or the NavigableDefinitionId are bogus.; NotEntitledException - if the caller does not have the required permissions to delete this object.; IllegalDependencyException - adding the Navigable to the BookDefinition would cause a recursive dependancy; DuplicateObjectException - if this navigable is already added to this book; RemoteException
See Also: NavigableView.ALIGNMENT_LEFT, NavigableView.ALIGNMENT_RIGHT

moveNavigable

@Deprecated
NavigableDefinition moveNavigable(CustomizationContext customizationContext,
                                             DesktopDefinitionId desktopDefinitionId,
                                             BookDefinitionId fromParentBookDefinitionId,
                                             BookDefinitionId toParentBookDefinitionId,
                                             NavigableDefinitionId navigableDefinitionId,
                                             int position,
                                             int alignment)
                                  throws RemoteException,
                                         ObjectNotFoundException,
                                         NotEntitledException

Deprecated Use moveNavigable(CustomizationContext, BookDefinitionId, BookDefinitionId, NavigableDefinitionId, int, int)

Relocate the navigable definition to a new location.

Parameters: desktopDefinitionId - the desktop context to which this update applies.; fromParentBookDefinitionId - the parent book definition id we are moving this navigable from.; toParentBookDefinitionId - the parent book definition to move the navigable definition to.; navigableDefinitionId - the identifier identifying the definition to move.; position - the position in the book (or menu) to insert this navigable (starts with zero). The moved navigable will use this position and previously existing navigables at and beyond this position will have their position incremented by one. After the position incrementing the positions will be normalized to shift the lowest position to a zero value and then shift any positions necessary to make them contiguous.; alignment - position the page from the left (top) or right (bottom)
Returns: a reference to the newly positioned navigableDefinition
Throws: ObjectNotFoundException - BookDefinitionId or the NavigableDefinitionId are bogus.; NotEntitledException - if the caller does not have the required permissions to delete this object.; RemoteException

moveNavigable

NavigableDefinition moveNavigable(CustomizationContext customizationContext,
                                  BookDefinitionId fromParentBookDefinitionId,
                                  BookDefinitionId toParentBookDefinitionId,
                                  NavigableDefinitionId navigableDefinitionId,
                                  int position,
                                  int alignment)
                                  throws RemoteException,
                                         ObjectNotFoundException,
                                         NotEntitledException

Relocate the navigable definition to a new location.

Parameters: fromParentBookDefinitionId - the parent book definition id we are moving this navigable from.; toParentBookDefinitionId - the parent book definition to move the navigable definition to.; navigableDefinitionId - the identifier identifying the definition to move.; position - the position in the book (or menu) to insert this navigable (starts with zero). After the moved navigable is given this position the entire position array must be normalized to ensure it is still zero-based and that it is contiguous with no missing positions. Therefore, the moved navigable will use this position and previously existing navigables at and beyond this position will have their position incremented by one. After the position incrementing, the positions will be normalized to shift the lowest position to a zero value and then shift any positions necessary to make them contiguous.; alignment - position the page from the left (top) or right (bottom)
Returns: a reference to the newly positioned navigableDefinition
Throws: ObjectNotFoundException - BookDefinitionId or the NavigableDefinitionId are bogus.; NotEntitledException - if the caller does not have the required permissions to delete this object.; RemoteException

removeNavigable

void removeNavigable(CustomizationContext customizationContext,
                     BookGroupId bookGroupId)
                     throws RemoteException,
                            ObjectNotFoundException,
                            NotEntitledException

Remove a NavigableDefinition (BookDefinition or PageDefinition) from the specified book. This method does not delete the NavigableDefinition it just removes it from the book.

Parameters: bookGroupId - the book group id of the navigable to be removed.
Throws: ObjectNotFoundException - if the navigable or book definition could not be found in the persistent store.; NotEntitledException - if the caller does not have the required permissions to delete this object.; RemoteException

setDefaultNavigable

void setDefaultNavigable(CustomizationContext customizationContext,
                         BookDefinitionId parentBookDefinitionId,
                         NavigableDefinitionId navigableDefinitionId)
                         throws RemoteException,
                                ObjectNotFoundException,
                                NotEntitledException

Set a navigable (book or page) on a parent page as the default page.

Parameters: parentBookDefinitionId - the book definition id of the parent book; navigableDefinitionId - the child book or page definition id to become the new defualt page
Throws: ObjectNotFoundException - if the navigable or book definition could not be found in the persistent store.; NotEntitledException - if the caller does not have the required permissions to delete this object.; RemoteException

createBookDefinition

BookDefinition createBookDefinition(CustomizationContext customizationContext,
                                    BookDefinition bookDefinition)
                                    throws RemoteException,
                                           MissingDataException,
                                           NotEntitledException

Create a new book definition. Creates a new book definition in the persistent store. This definition may be used to create book instance later on.

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; bookDefinition - the book definition object containing all the required data.
Returns: the fully populated BookDefinition object (with id's).
Throws: MissingDataException - if some vital information is missing from the BookDefinition.; NotEntitledException - if the caller does not have the required permissions to delete this object.; RemoteException

createBookDefinition

BookDefinition createBookDefinition(CustomizationContext customizationContext,
                                    BookView bookView)
                                    throws RemoteException,
                                           NotEntitledException,
                                           DuplicateObjectException,
                                           DuplicateDefinitionException,
                                           ViewDisassemblerException

Create a new book definition in the persistent store from a given BookView. Generally called after disassembling a .book file. This definition may be used to create book instance later on.

Parameters: customizationContext - customization information such as preferred locales and desktopInstanceId; bookView - the book view object containing all the required data.
Returns: the fully populated BookDefinition object (with id's).
Throws: NotEntitledException - if the caller does not have the required permissions to delete this object.; ViewDisassemblerException - If unable to disassemble the given page view pageView. typically caused by some bad markup names in the view.; DuplicateDefinitionException - if a book or page with the same definition label already exist in the database.; RemoteException; DuplicateObjectException
See Also: CustomizationContext.setDisassemblerTemplateAction(int), XmlDisassembler

getVisibleBookLocalizationResources

SortableFilterablePagedResult<LocalizationResourceView> getVisibleBookLocalizationResources(CustomizationContext customization,
                                                                                            WebAppSearchCriteria criteria,
                                                                                            int pageSize)
                                                                                            throws RemoteException

Retrieve the LocalizationResourceViews for all visible books for a given locale and webapp. The returned PagedResult is sortable and filterable on the field "TITLE", and supports these filter methods:

FilterMethod.UNFILTERED
FilterMethod.BEGINS_WITH
FilterMethod.ENDS_WITH
FilterMethod.CONTAINS
FilterMethod.EQUALS

Parameters: customization - - a customization context with a request and locale defined. Only the first locale is used.; criteria - - specifies the web application where the requested resources live; pageSize - - number of results to retrieve per page
Returns: SortableFilterablePagedResult of visible Book LocalizationResources
Throws: RemoteException

getBookDefinitions

SortableFilterablePagedResult<BookDefinition> getBookDefinitions(CustomizationContext customizationContext,
                                                                 BookSearchCriteria criteria,
                                                                 int pageSize)
                                                                 throws RemoteException

Get all the book definitions for the webapp as a paged object. The returned PagedResult is sortable and filterable on the field "TITLE", and supports these filter methods:

FilterMethod.UNFILTERED
FilterMethod.BEGINS_WITH
FilterMethod.ENDS_WITH
FilterMethod.CONTAINS
FilterMethod.EQUALS

Parameters: customizationContext - customization information such as preferred locales and http request.; criteria - used to specify the webapp; pageSize - the number of item per page in the result.
Throws: RemoteException

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.bea.netuix.application.manager Interface IBookDefinitionManager

getBookView

getShallowBookView

getBookDefinitions

getBookDefinitions

getPublicBookDefinitions

getPublicBookDefinitions

getPublicBookDefinitions

getPublicBookDefinitions

getPagedPublicBookDefinitions

getPublicBookDefinitions

getPublicBookDefinitions

searchPublicBookDefinitions

getBookDefinition

getBookDefinition

deleteBookDefinition

deleteBookDefinitionWithReplacement

deleteBookDefinitionWithCascade

updateBookDefinition

addNavigable

moveNavigable

moveNavigable

removeNavigable

setDefaultNavigable

createBookDefinition

createBookDefinition

getVisibleBookLocalizationResources

getBookDefinitions

com.bea.netuix.application.manager
Interface IBookDefinitionManager