Setting Up the Development Environment for Agentry Toolkit

The Agentry Toolkit provides the components to create Agentry applications. These components are intended for developers, implementors, and administrators.

With the exception of the Agentry SAPĀ® Framework Foundation, all Agentry components are installed as part of the SAP Mobile Platform SDK. You can find the Agentry developer resources and installers in the Agentry installation folders.

Agentry Editor

The Agentry Editor provides a point-and-click development environment, within which the mobile application can be built or an existing mobile application can be modified for specific implementation needs.

File locations:
  • 32 bit build: SDK_HOME\AgentryToolkit\32-bitAgentryEditor\Agentry_7.0.x.x_EditorPlugin_x86.zip
  • 64 bit build: SDK_HOME\AgentryToolkit\64-bitAgentryEditor\Agentry_7.0.x.x_EditorPlugin_x86_64.zip

Agentry OpenUI SDK & Android and iOS Agentry Client Rebranding

File locations:
  • Agentry OpenUI SDK for Android: AgentryToolkit\AgentryOpenUISDK\SMPAgentryClientFramework-Android-7.0.x.x.zip
  • Agentry OpenUI SDK for iOS: AgentryToolkit\AgentryOpenUISDK\SMPAgentryClientFramework-iOS-7.0.x.x.tgz
  • Agentry OpenUI SDK for Windows - Sample Project Only: AgentryToolkit\AgentryOpenUISDK\Agentry_7.0.x.x_OpenUISampleDotNET.zip

The Agentry OpenUI SDK is introduced in the SAP Mobile Platform SDK 3.0 release. This SDK is available for Android, iOS, and Windows client platforms. It is provided to allow developers to create custom controls for the Agentry Client. These custom controls will then override the standard field edit types within the Agentry Client at runtime.

For both Android and iOS the client framework archives listed above provide the needed resources to develop custom controls using the OpenUI SDK. For the Agentry Client for Windows devices, this is not necessary. Rather, a project is created in Visual Studio targeting .NET 4.5 Framework, and which uses reflection to obtain information about the loaded assemblies for the OpenUI interface.

Additionally, the resources provided in these same SDK files also provide the necessary interface to support rebranding of the Agentry Client for Android and iOS. Windows clients are rebranded using the Agentry Device Client Branding SDK, as in previous versions of SAP Mobile Platform and/or Agentry Mobile Platform.

Agentry Test Environment

File location:
  • Installer: AgentryToolkit\AgentryTestEnvironment\Agentry_7.0.x.x_Test_Environment.exe

The Agentry Test Environment provides an Agentry Client which runs within a test and monitoring interface. This interface provides tools to inspect data stored on the client device, including objects, transactions, complex tables, and data tables. Actions and transactions can be debugged as they are executed or instantiated. Client devices hardware features including barcode scanners and GPS units can be mimicked within the Agentry Test Environment to support full functional testing of client-side behavior of the mobile application. The Agentry Test Environment can also mimic various client device types and form factors.

Agentry Java API

File location:
  • Agentry Java API: AgentryToolkit\AJAPI\Agentry-v5.jar
  • Agentry Java API Javadoc: AgentryToolkit\AJAPI\Agentry-v5-doc.zip

The Agentry Java API is provided for development of mobile applications with a Java system connection. This API provides the interface between the Agentry Server and the Java synchronization logic. This interface supports passing data between this logic and the Agentry Server, and also provides state, user, and other runtime information. Base classes for step definition logic, complex table and data table synchronization logic are included within the API and are extended by the logic written specific to the mobile application. The Agentry Java API is contained in a single Jar file, named Agentry-v5.jar. Also included is a ZIP archive containing the associated Javadoc content, which can be referenced as a resource within the Eclipse Java project. Details on creating a Java project in Eclipse, including how to add the associated documentation, are provided in a later procedure.

Agentry Branding SDK

File location:
  • Windows CE Client Branding SDK: AgentryToolKit\BrandingSDK\Agentry_ClientWinCE_Branding.exe
  • iOS and Android: This functionality is encompassed by the OpenUI and the associated Agentry client framework resources provided as a part of the OpenUI SDK. Creating the projects as instructed for each of these will also provide the necessary framework to rebrand these clients.
  • Windows WPF and Windows Desktop: The Branding SDK is provided from the standard client installers for each these, with special command line switches provided during execution. See the instructions provided for details.

Rebranding the Agentry Client for Windows devices begins with the installation of the needed rebranding resources. For the Windows desktop Agentry Client builds, this is provided by running the Agentry Client installer with specified command line arguments. This may either be the Agentry Client installer for Windows 7 desktop or earlier, or the .NET Windows Client installer for Windows 8 desktops and tablets.

Rebranding of the Agentry Client for Windows mobile devices begins with the installation of the Agentry Branding SDK, which provides the necessary resources to rebrand and then package the Agentry Client executable for you application.

Rebranding the Agentry Client for both Android and iOS devices is accomplished within the framework provided by the OpenUI SDK. Icon images and UI text can be overridden within the framework and the Agentry Client rebuilt to include these branded resources using the framework provided as a part of the OpenUI SDK for these two platforms.

Agentry SAP Framework Foundation and Related Resources

Note: This component is not provided in the SAP Mobile Platform SDK. It is an ABAP Add-On and is installed only to SAP systems and is available on the SAP Service Marketplace.

The Agentry SAP Framework Foundation is an ABAP Add-On that is installed to the SAP system with which the mobile application is to connect and synchronize. The Agentry SAP Framework Foundation is provided for cases in which a new mobile application for an existing SAP system is being developed from the ground up. This component is only used for SAP systems; other back end systems do not use this component. The Agentry SAP Framework Foundation provides the framework within which the needed synchronization support for the mobile application is implemented. This includes exchange data model components such as triggers, mobile data objects, rules, filters, and other similar pieces.

If you plan to deploy a packaged mobile application built on Agentry, do not install this component. Rather, install the Agentry SAP Framework ABAP Add-On provided with that application, which includes application-specific components.

Agentry ActiveX SDK

Install the Agentry ActiveX SDK for these two development scenarios: when developing ActiveX controls for use on Windows Mobile devices, or when developing interprocess communications between the Agentry Client and another process running on the mobile device.