The Export/Import and Staging features give users the power to plan page publication and manage content. The Export/Import feature lets users export content from the portal and import external content into the portal. Providing the export feature in your application gives users the flexibility of exporting content they’ve created in your application to other places, such as another portal instance, or to save the content for a later use. Import does the opposite: it brings the data from a LAR file into your portal.

For instance, suppose you’re managing an online education course. Because of the nature of an online course, the site’s data (grades, assignments, etc.) is purged every semester to make way for new incoming students. In a scenario like this, there is a need to frequently store a complete record of all data given during a course. The institution offering the course must keep records of the course’s data for a minimum number of years. To abide by these requirements, having a gradebook application with an export/import feature would let you clear the application’s data for a new semester, but save the previous class’s work. You could export the students’ grades as a LAR file and save it outside the course’s site. If the grades ever needed to be accessed again, you could import the LAR and view the student records.

The Export/Import feature adds another dimension to your application by letting you produce reusable content and import content from other places. To learn more about using the Export/Import feature, visit the Exporting/Importing App Data User Guide section.

Staging lets you change your Site behind the scenes without affecting the live Site, and then you can publish all the changes in one fell swoop. Keep in mind that Staging leverages the Export/Import framework. When publishing your staged content to the live Site, you’re essentially importing content from the staged Site and exporting it to the live Site. If you include staging support in your application, your users can stage its content until it’s ready.

For example, if you have an application that provides information intended only during a specific holiday, supporting the Staging environment lets users save your application’s assets specific for that holiday. They’ll reside in the Staging environment until they’re ready for publishing. To learn more about Staging, visit the Staging Content for Publication section.

Besides configuring these features for your application, you can also access APIs that let you write custom code, extending Liferay’s default functionality.

In this section of tutorials, you’ll learn how to implement Staging and the Export/Import framework. The main areas of Staging code to focus on are outlined below:

  1. StagedModel: The StagedModel is the cornerstone of Staging. All content that must be handled in Staging should implement this interface; it provides the behavior contract for the entities Staging uses during the Staging process.

  2. StagedModelDataHandler: These data handlers are responsible for handling one specific entity class. For example, the BookmarksEntryStagedModelDataHandler handles the BookmarksEntry during Staging: exporting data, serializing content, finding existing entries, etc.

  3. PortletDataHandler: These data handlers are responsible for handling aspects of the portlet’s configuration and publication during Staging.

  4. ExportActionableDynamicQuery: This framework is useful when developing Staging support. Its purpose is to query data from the database and process it during publication. It’s automatically generated if your entity contains the right fields so there’s no need to worry about configuring it.

  5. ExportImportContentProcessor and ExportImportPortletPreferencesProcessor: Advanced frameworks only needed in special cases. The ExportImportContentProcessor lets you process your content during a publication process. The ExportImportPortletPreferencesProcessor lets you process your portlet preferences (application’s configuration) during a publication process.

Decision to Implement Staging

Staging is an advanced publication tool that lets you create or modify your site before releasing it to the public. Most of Liferay Portal’s included applications (e.g., Web Content, Bookmarks,...

Llegeix més

Understanding Staged Models

To track an entity of an application with the Staging framework, you must implement the StagedModel interface in the app’s model classes. It provides the behavior contract for entities during the...

Llegeix més

Generating Staged Models Using Service Builder

A Staged model is an essential building block to implementing the Staging and Export/Import frameworks in your application. Instead of having to create staged models for your app manually, you can...

Llegeix més

Creating Staged Models Manually

There are times when using Service Builder to generate your staged models is not practical. In these cases, you should create your staged models manually. Make sure to read the Adapting Your...

Llegeix més

Understanding Data Handlers

A common requirement for many data driven applications is to import and export data. This could be accomplished by accessing your database directly and running SQL queries to export/import data;...

Llegeix més

Developing Portlet Data Handlers

There are two types of data handlers you can implement: Portlet Data Handlers and Staged Model Data Handlers. For more information on the fundamentals behind Liferay’s data handlers and how a LAR...

Llegeix més

Developing Staged Model Data Handlers

There are two types of data handlers you can implement: Portlet Data Handlers and Staged Model Data Handlers. For more information on the fundamentals behind Liferay’s data handlers and how a LAR...

Llegeix més

Providing Entity-Specific Local Services for Staging

When creating your data handlers, you must leverage your app’s local services to perform Staging-related tasks for its entities. When the Staging framework operates on entities (i.e., staged...

Llegeix més

Using the Export/Import Lifecycle Listener Framework

The ExportImportLifecycleListener framework lets developers write code that listens for certain staging or export/import events during the publication process. The staging and export/import...

Llegeix més

Initiating New Export/Import Processes

The Staging and Export/Import features are the building blocks for creating, managing, and publishing a site. These features can be accessed in the Publishing Tools menu. You can also, however,...

Llegeix més
0 (0 Vots)
Documents and Media API Anterior