Developer

Creating Java Projects for Agentry Java API Development

If the application includes a Java Virtual Machine system connection, create a Java project in the Eclipse platform that includes the Agentry Java API. The Java package and Java project provide the information that define objects, transactions, synchronization steps, and properties.

Prerequisites

  • Install and configure a supported version of the Eclipse IDE and Agentry Editor plug-in.
  • Ensure that all Java resources are accessible from the Eclipse platform host system, including JAR files, Java code libraries, and so on.
  • If developing applications with the Agentry SAP Framework Foundation, use a supported version of the SAP Java Connector (SAP JCo).
  • Make sure you have the proper version of the JRE for the supported version of the Eclipse IDE.

Procedure

  1. In the Java perspective, select Start of the navigation path File Next navigation step New Next navigation step Java Project End of the navigation path to start the Java Project wizard.
  2. Define the project, then click Next.
    1. Name the project.
    2. (Optional) Unselect Use Default Location to specify a location outside the workspace in which to save the project.
    3. Specify the JRE version that matches the back-end system.
      This version does not have to match the version that Eclipse requires. This version of the JRE must be installed prior to making this selection.
    4. (Optional) Change the project folder structure.
      The default folders are src and bin.
    5. (Optional) Add the project to a working set.
  3. Configure the Java project build settings in each tab, then click Finish.
    1. (Optional) In the Source tab, create new source folders or link to existing source folders.
    2. (Optional) In the Projects tab, select additonal projects to be included on the build path for the current project.
      This project must reside in the same workspace as this project. Once added, options exist to select the files or sources within the project to use.
    3. In the Libraries tab, select Add External JARs, navigate to the Agentry Java API, Agentry-v5-doc.zip, then select Open.
      You can expand the node to edit the locations of the ZIP contents. You can also add additional libraries, if needed, as well as the SAP JCo JAR file.
    4. In the Order and Export tab, specify the build order for the libraries and external projects.
      Order guidelines:
      • Move the JRE System Library to the first position.
      • Place the Agentry Java API library before any libraries or projects that extend the Agentry classes or interfaces.
      • Place any resources from the back-end system before the mobile application-specific items, which may include application suite libraries.

Results

This project is accessible to the Agentry application project and includes.
  • The Agentry Java API jar file.
  • A source folder location for Java logic created for the mobile application.
  • Any other resources that you definted for the project.
When defining Java steps, or complex table or data table Java synchronization components, you can select items contained in the Agentry Java API, as well as those in the other libraries and projects for the Java project.

Next Steps

Configure the Eclipse file associations for the Agentry project.