Selecting an Endpoint Type

To create an Object Service, you can specify the endpoint details in the Object Service definition.

To create an object service, follow these steps:

  1. Create an app.
  2. Click the Objects tab.

  3. Click CONFIGURE NEW.
  4. Under the Name, type the name of the object, for example, EmployeeModelSchema.
  5. Under the Endpoint Type field, select the endpoint that you want to use, and enter the details for the selected endpoint type.

    For example, you can create objects services for the following three endpoint types:

    • Integration and Orchestration Services

    • Storage: Storage service helps you to develop apps by creating object data model and uploading data to the storage database which will then be available to app developers on the runtime instance.
      • When you select Storage endpoint, the Sample Data and Download Template buttons are displayed. You can store or import sample data by importing a .ZIP file.

        NOTE: You can associate the sample data at the design time of the service in Quantum Fabric, and you can import the sample data at the run time in the App Services Console as well.

        For more information on generating sample data for Storage Object services, refer to How to Create Storage Object Services with Sample Data using Quantum Fabric.

    • Business Adapters: SAP, RAML, Relational Database, Salesforce, and MongoDB are the endpoint types for which you can create object services.

      NOTE: If your database (RDBMS/MongoDB) is configured with a proxy server, you must select an environment and then click Test Connection to test the database connectivity. The environment should be => V8 SP3 or later. If the entered details are correct, the system displays the message: Valid Database connection detail.

  6. Identity Service for Backend Token: Select the Identity service associated with your app if this service needs backend token like access_token from that Identity service to access the backend server.

    NOTE: For more information on Externalizing Identity Services, refer to Replace the Identity Service references in a Fabric app.

  7. From Quantum Fabric V9 onwards, the Delete Strategy section is displayed. This section is displayed when you have selected the Endpoint Type as Storage. It helps you delete the selected record data from the database. You can choose Hard Delete or Soft Delete.

    • The Soft Delete option is selected by default. In this case, when a user performs the delete operation using the client app, the deleted record data is marked for the SoftDeleteFlag with value as 1 in the database. The soft deleted data is not available for the app user.

      IMPORTANT: Quantum recommends you to use the Soft Delete option along with the Offline enabled mode to ensure the data is in sync with the device and the server.

      When you select the Offline enabled check box, the Soft Delete option is selected automatically.

    • Select the Hard Delete option to delete the selected record data permanently from the database.

      IMPORTANT: When you select the Hard Delete option after selecting the Offline enabled check box, the following waring message appears: Warning! Hard Deleting Records in Offline mode is not Recommended. It will make local storage inconsistent with the backend.

      Click OK to continue enabling the Hard Delete option.

      NOTE: You can also use the Hard Delete option from the App Services Console. For example, an app is created with the Delete strategy settings set to the default Soft Delete option but you want to delete some records permanently. In this case, you use the Hard Delete option by passing the X-Kony-Soft-Delete header parameter set to false with the delete request call. The delete request body must contain the primary key of the records that you want to delete.

      For more information on how to use the Hard Delete option using the App Service Console, refer to App Services Console > Object Services > Hard Delete option using the X-Kony-Soft-Delete header parameter for Storage Services.

  8. Click SAVE & CONFIGURE.

You can now Configure a Data Model.