Der DS besitzt eine öffentlich zugängliche API, die Sie für Ihren Anwendungscode verwenden können. Diese API wird meist zum Abrufen von Informationen aus einem gefüllten Schema verwendet, kann aber auch zum Vorabfüllen eines Schemas verwendet werden. Beispiel: Ein Kunde schickt nach dem Beenden einer Anwendung seine Informationen ab. Nun kann die API dazu verwendet werden, die Daten aus dem Schema zu extrahieren und Tabellen in der relationalen Datenbank zu füllen.
Ein Beispiel zum Vorabfüllen ist der Fall, dass Informationen zum Kunden bereits bekannt sind, bevor er die Anwendung startet. Wenn einige der Informationen erforderlich sind, um durch die Anwendung zu navigieren, kann der DS auch vorab mit diesen Informationen gefüllt werden.
Um Daten aus einem Schema lesen zu können, muss die entsprechende Ausführung des Scripts bekannt sein. Das heißt, Sie rufen die korrekten Anwendungsinformationen für einen Kunden auf. Aus diesem Grund sind die "executionID" und der Schemaname unbedingt notwendig, um Zugriff auf die Daten zu erhalten.
Das folgende Beispielcodefragment zeigt, wie man eine Stammentität anfordert:
final IEGRuntime runtimeAPI = new IEGRuntime();
final IEGRootEntityID rootEntityID =
runtimeAPI.getScriptExecutionRootEntityID(executionID);
Datastore ds = DatastoreFactory.newInstance()
.openDatastore(kSchemaName);
final Entity rootEntity =
ds.readEntity(rootEntityID.entityID));
Ab hier kann die Stammentität dafür verwendet werden, andere Entitäten unter dieser Stammentität abzurufen.