Introduction

Projects are created via the Dashboard.

A Project is a administrative unit to hold Environments and Applications.

From the Dashboard you can access the details of a Project by clicking the Projectname.

The Project details screen allows you to manage the current Project, create and view Environments and upload Applications.

The menu on the left side has three sections:

  • Actions
  • Navigation
  • Settings



Actions


New Environment

Within a project you must create an Envrionment before you install and run an Application.

An Environment contains the Database connection details that will be used by the application. 


(info)
 The application that will be installed in this envrionment will always use this database as the Target.


Click on the menu item "New environment" to create one.

It will show a dialog to provide the database connection details


Name

Provide a name for this environment. It must be unique within the project. 

You are allowed to change names afterwards.


Database Type

DATPROF Runtime supports two database types.

You can use the dropdown to select your Database type:

  • Oracle
  • Microsoft SQL Server

(info)
 Once choosen a Database type cannot be changed.

Based on the Database type you have different details to enter.


Oracle

  • Host: Hostname or IP-address of the database server.
  • Port number:  TCP port on which the database server is listening.
  • Username: The Oracle Schema user to use in this Target database.
  • Password: The password for the Oracle Schema user.
  • Instance: Unique database identification.

The Connection string shows the full connection details.

Click Test to validate and click Create environment to save



Microsoft SQL Server

Environment Connection details for Microsoft SQL Server

  • Host: Hostname or IP-address of the database server.
  • Instance Name:  (Optional) The Microsoft SQL Server Instance name If used Port number is not rquired.
  • Port:  (Optional) Port Number.  If used Instance name is not required.
  • Database: The name of the database to use.
  • Windows Authentication: Check this box If you use windows authentication. It is the user Runtime agent user.
  • Username: The Microsoft SQL Server user to use in this Target database.
  • Password: The Password for the Microsoft SQL Server user.

The Connection string shows the full connection details.

Click Test to validate and click Create environment to save.


PostgreSQL

  • Host: Hostname or IP-address of the database server.
  • Port:  Port Number.  
  • Database: The name of the database to use.
  • Username: PostgreSQL login
  • Password: The Password for the PostgreSQL login

The Connection string shows the full connection details.

Click Test to validate and click Create environment to save.

DB2 for Linux/Unix/Windows

  • Host: Hostname or IP-address of the database server.
  • Port:  Port Number.  
  • Database: The name of the database to use.
  • Username: DB2 database login
  • Password: The Password for the DB2 database login

The Connection string shows the full connection details.

Click Test to validate and click Create environment to save.

DB2 iSeries

  • Host: Hostname or IP-address of the database server.
  • Port:  Port Number.  
  • Database: The name of the database to use.
  • Username: DB2 database login
  • Password: The Password for the DB2 database login

The Connection string shows the full connection details.

Click Test to validate and click Create environment to save.

Upload Application

Applications generated by DATPROF Integrate, Subset or privacy must be uploaded into the project to be able to install it into a Environment.

To upload an Application you click the “Upload application” link in the Menu.


A dialog will show up  to select a zipped DATPROF application from your file system. 


Once a file is selected the dialog will extend and show the Name of the application, the Version and the Generation time.

You can upload  an application in a project only once. Runtime checks for the uniqueness of name and version. 

(info)
 If you know that the application differs from the existing one you are allowed to change the name and/or version at upload time. After uploading this is not possible,

The Generation time is the time of application generation by DATPROF Integrate, Subset or Privacy. It cannot be altered. 

To upload the packges click the blue Upload Application button.

Whenever successful a green Message box is shown and the application is added to the list of uploaded applications in this project.

Navigation

Environments

This is the default entry when accessing the Project details screen.

Environments in the Project details screen

This entry wil show the (running) status of an Application. The project details does not allow you to start or abort a run.


Applications 

Every Project has a list of one or more uploaded DATPROF applications. they are listed alphabetically. 

Only uploaded applications are available for installation. To run the applications the shoudl be installed into an environment.


From this screen you can remove applications.

(info)
 Only applications that are not installed in an environment are available for removal. Installed applications are greyed out.

Uploaded applications within this Project

Settings

Rename project

You can easy rename an existing project. This menu item brings a simple dialog to rename the current project.

(info)
 renaming a project implies new URL's for the API!


Delete project

(warning)
 Use this option with care.

Existing projects can be removed by using this menu item.

It will remove:

  • All uploaded Applications
  • All Environments (with the Run history)
  • The current Project.


(info)
 Only Projects without installed applications  can be removed!


A dialog will show up to verify if you really want to remove this project.

At confirmation the current project, all its environments as well as the  uploaded applications are deleted.