Skip to main content

FieldLogs

Adding Data to an Object

The Object Model defines the structure of a database table as a collection of properties.

Properties are the columns defined for the table.

An Object is a database table containing rows of data.

The example below highlights Demo Object Model and Demo Object.

The Demo Object Model is the definition of the Demo table having two properties - Id and name.

The Demo Object contains several rows of data as seen.

2023-07-21_20-29-21.png
2023-07-21_20-29-21.png

To add a new Object:

  1. On the main menu, go to Enterprise >Data >Data.

    main_menu.png

    The Objects page is displayed.

    result_main_menu.png
  2. Select an Object to add rows.

    selecting_an_object.png
  3. Click Add new Object to add new row to the table.

    Add___new_object.png
  4. The user is prompted for values. Select properties from the dropdown as shown to enter the corresponding values.

    dropdown_for_properties.png

    In this example, values for Id and Name are entered.

    values_for_id_and_name.png

    Note

    The value for the key must be unique and should not be null.

    Primary_key.png

    Click maximise_button.png to maximize the panel. You can edit the data.

    maximised_screen.png

    You can also use the Generate button to generate a unique key for the Id.

    GenerateButton.png
  5. Repeat steps 3 and 4 to add more rows.

    Again_add_new_object.png
  6. Click Save.

    Save.png

    Rows of data are added to the Object.

    Result_save.png

    Note

    Errors may appear until the property values are filled in.

    These errors disappear once the required values are filled in a property.

    To see the errors, click See Issues.

    See_issues.png

    The error dialog box opens in case of incomplete Objects.

    Errors.png

    Revert

    To undo the changes, click Revert.

    revert_data.png

    Deleting Rows

    Click Icon.png to delete a row.

    remove_data.png

    Click Delete.

    Delete.png

    The row is deleted.

    result.png

    Search

    You can search the table using the Search bar as shown below.

    Filter.png

    The specific row is displayed.

    result_filter.png

    Delete Table

    To clear the Objects from the Table, click Clear Table.

    Clear_table.png

    A confirmation message is displayed.

    Click Clear Table.

    confirmation_message.png

    All the rows are cleared from the table.

    result_clear_table.png

To Export and Import a Data to an Object:

  1. On the main menu, go to Enterprise > Data > Data.

    main_menu.png
  2. Click Export.

    Export_data.png
  3. Select the File type and click Export.

    file_type.png

    The CSV file gets downloaded.

    csv_file.png
  4. Click Import.

    Import_data.png
  5. Click browse.

    Browse_button.png
  6. Select the CSV file from the download files.

    downloaded_csv_file.png
  7. Click Import.

    Import_data.png

    The Data is Imported.

    Result_Import_data.png

We use queries to filter Data. Such views of the Objects are called as Data Sets.

To create a Data Set:

  1. On the main menu, go to Enterprise > Data > Data Sets.

    main_menu.png

    The Data Sets page is displayed.

    result_of_data_sets.png
  2. Click New.

    New.png

    The Data Set info page is displayed.

    result_new_data_set_page.png
  3. Enter Data Set name.

    Data_set_name.png
  4. [Optional] Enter Data Set description.

    Data_set_description.png
  5. Click Save.

    Save_data_set_name.png

    The Data Set is saved.

    Saved_data_set.png
  6. Click Add New Query.

    Add_new_query.png

    The list of all Object types is displayed.

    result_add_query.png
  7. Select an option from the list as shown below.

    In this example, the Object Demo is selected.

    Select_an_option.png
  8. Click Confirm.

    Confirm_button.png
  9. [Optional] Enter Query name.

    Query_Name.png
  10. [Optional] Enter Query description.

    query_description.png
  11. Select the required fields in the Property References as shown below.

    Property_references.png
  12. To set the Constraints, select one of the options from the dropdown list.

    dropdown_option_constraint.png
  13. Build the required constraint with the conditional operators as shown below.

    string__conditional_operator.png
    Id_.png

    Below is an example of a Constraint with a query.

    constraints.png
  14. Click Save.

    Save_button.png
  15. Click Execute Query.

    Execute_query.png

    The Query is executed as shown below.

    result_constarints.png
  16. To add multiple queries to the Data Sets, repeat the procedure from step 6.

    multiple_query.png

    Note

    To change the Object linked to the query, click change Object type.

    Change_object_type.png

    The list of Object type is displayed.

    result_add_query.png

    Deleting a Data Set

    To delete the Data Set, click Delete.

    delete_data_set.png

    A confirmation message displays.

    confirm_delete.png

    The Data Set is deleted.

    delete_data_set_result.png

    Revert

    To undo the changes, click Revert.

    revert_button.png

    Deleting a Query

    To delete a Query, click Delete Query.

    delete_query.png

    A confirmation message displays.

    Click Delete.

    confirm_delete.png

    The Query is deleted.

    Result_delete.png

    View by Object

    When you toggle View by Object, the list of Data Sets are grouped based on Objects as shown below.

    view_by_object.png

    Search

    You can search the Data Set and Query name by using the search bar as shown below.

    filter.png

To Export a Data Set:

  1. On the main menu, go to Enterprise > Data > Data Sets.

    main_menu.png
  2. Select one of the queries from the Data Sets, and click Execute Query.

    Execute_query.png

    The Query is executed.

    Executed_query.png
  3. Click Export to Excel.

    Export_Excel.png

    The Excel file is downloaded.

    Result_export_excel.png

    Generating a Data Set Report

    To generate a Data Set Report, click Report.

    report.png

    The Reporting dialog box appears. Select the required Report Model to generate the Report as shown below.

    datasetreport_model.png

You can use an Export Model to define how the data is displayed in the export file.

To create an Export Model

  1. Open a new Excel sheet.

  2. Enter the property names in the first row.

    Note

    The name of the property is preceded by a dot.

    Export_Model1.png

    If you want to display a property contained in a sub-object, write the name of the property preceded by a dot, followed by a dot and the name of the sub-property.

    Export_Model2.png

    You need not enter all the properties of the main object. You can change their display order.

    Make sure to write the name of the property carefully in the export model. Any discrepancy may result in the failure of the export.

  3. Save the file.

    The export model can be uploaded and used in FieldLogs.