Importing the SAP Inventory Manager Project into the Eclipse Workspace

Prerequisites

Address the following items before performing this procedure:

  • Determine the source of the application project you are importing in this procedure and that you have access to that source.

  • Verify that the application project source was created with the same or earlier version of the SAP Mobile Platform. You cannot import projects, export files, or published applications created with a later version into an earlier version.

  • Ensure that Eclipse is installed. For information on installing Eclipse, see the following topics:

  • Verify the workspace in which you are importing the project is the currently opened workspace in Eclipse.

  • Determine a project name, or how the project is listed in the Eclipse workspace. The project name is required information entered in the import process.

  • Determine a value for the Name attribute of the application definition. The value is information required during the import process.

  • Though not required, it is strongly recommended that you install the SAP Inventory Manager development server. A development server is necessary when defining any of the synchronization logic within the project after it is created.

Context

This procedure describes the steps involved in importing an application project into the current Eclipse workspace. When this procedure is complete, a new Agentry application project is created in the current Eclipse workspace. This project contains the definitions and application components found in the import source.

Note that this process excludes any related projects for the source application that may reside in the workspace of the source project, such as Java development projects and related packages. Import these related projects and components according to the process that matches that project type, using tools found in Eclipse. Whether the Agentry application project is imported before or after other related projects is unimportant. However, import or configure all items before modifications are made.

This procedure accomplishes the following:

  • Checks out an Agentry application project from an Agentry share repository and creates a new local project based on the top revision within that repository.

  • Migrates an application project from one workspace to another.

  • Upgrades an application project or application export file created in a previous release of the SAP Mobile Platform.

  • Restores or recovers an application project from an archived project or export file.

  • Creates, restores, or recovers an application project from a mobile application published to the SAP Mobile Platform.

Procedure

  1. If not already open, open or create the Eclipse workspace in which to import the new project. Opening or creating a workspace in Eclipse begins by selecting the menu item Start of the navigation pathFiles Next navigation step Switch WorkspaceEnd of the navigation path and following the on-screen instructions.
  2. Right-click an empty area in the Project Explorer view and select the menu item Import. Alternately, select the menu item Start of the navigation pathFiles Next navigation step ImportEnd of the navigation path in the main menu of Eclipse.

    The Select Import Source screen displays.

  3. On this screen, there are the different import sources for Eclipse. Expand the Agentry Project folder and select the appropriate source by highlighting it. Click Next to continue.

    The Select Source screen displays. This screen is slightly different depending on the selected import source type. The following example is for a source type of production server export:

  4. In this screen the information entered is dependent on the source type selected in the previous step. Enter the information according to the following:
    1. The specific item selected for the source is different based on the type. Click Browse to select the source.
    2. The Source Application box is only displayed when the source type is an SAP Mobile Application server. The Source Application box lists the name of the application published to that server instance. If the selected server instance is a production server, each published version currently residing on that server is listed. You can import any one of those versions.
    3. The Application Name is the name given to the mobile application that is created by the import. The Application Name is the value of the name attribute within the application definition and can contain no white space. This field is read-only if the selected import source is an Agentry share repository.
    4. The Project Name is the name for the project within the Eclipse workspace. The Project Name must be a unique project name for the workspace and white space is allowed.
    5. The Development Server (optional) is the SAP Inventory Manager development server for the application project being created. Any script files contained in the source project are copied to this server. By default, this field is set to the server from which the project is imported, if that server instance is a development server. Leave the option set as-is if you are setting up a development server for a new project, or change to a different development server if necessary.
  5. Verify the information entered is accurate and complete. Click Finish to perform the project import.

    A new project is created by importing the definitions from the selected import source. The project is listed in the Project Explorer view and is automatically opened.

Results

After this process is complete, the new project is added to the Eclipse workspace. The project opens and displays in the Agentry perspective within Eclipse. The application name and project name match those values entered in the Import wizard. If the application project source was created using a previous version of the SAP Mobile Platform, the new project upgrades during the import to the version of the current Agentry.

If the selected import source was an Agentry share repository, the new project contains the definitions found in the top revision of that repository. The revision is checked out to the current user. Subsequent changes made to the application project are tagged with that user ID. The project is connected to the selected share repository and you can update from it. Commit changes made locally to this repository.