From Clomosy Docs
Items
It is a data field that you can use in your projects. It can add, delete and update items. On the mobile screen, you can show your data in the area you want in the section.
If you want to use this template in your project, the code you need to write in the main code field on the web:
{
Clomosy.OpenForm(ftItems,fdtSingle,froAddNew,ffoNoFilter);
}
The following images show you how to do this:
Adding Objects and Excel Processing
Edit And Delete Screen
Adding and Sorting fields in a section
Adding a field to a partition
Sort my fields
Types
It is an area where you can select the Thread screen. For example, Customer, New Customer, Potential Customer, Working, Stopped, Defective etc.
It can add, delete and update items. On the mobile screen, you can show your data in the area you want in the section. If you want to use this template in your project, the code you need to write in the main code field on the web:
{
Clomosy.OpenForm(ftTypes,fdtSingle,froAddNew,ffoNoFilter);
}
The following images show you how to do this:
Adding Objects and Excel Operations
Editing and Deleting Operations
Type Show Section Screen
Adding a field to a partition
Sort my fields
Tasks
It is a data field where we can define a task. Of course, you don't necessarily have to use it for the product here. It can be used for the desired purpose for the project.
If you want to use this template in your project, the code you need to write in the main code field on the web:
{
Clomosy.OpenForm(ftTasks,fdtSingle,froAddNew,ffoNoFilter);
}
Products
It is a data field where you can define products. Of course, you don't necessarily have to use it for the product here. It can be used for the desired purpose for the project.
It can add, delete and update items. On the mobile screen, you can show your data in the area you want in the section. If you want to use this template in your project, the code you need to write in the main code field on the web:
{
Clomosy.OpenForm(ftProducts,fdtSingle,froAddNew,ffoNoFilter);
}
The following images show you how to do this:
Adding Objects and Excel Operations
Editing and Deleting Operations
Product Show Section Screen
Adding a field to a partition
Sort my fields
Employees
It is a data field where we can define personnel. Of course, you don't necessarily have to use it for the product here. It can be used for the desired purpose for the project.
It can add, delete and update items. On the mobile screen, you can show your data in the area you want in the section. If you want to use this template in your project, the code you need to write in the main code field on the web:
{
Clomosy.OpenForm(ftEmployees,fdtSingle,froAddNew,ffoNoFilter);
}
The following images show you how to do this:
Adding Objects and Excel Operations
Editing and Deleting Operations
Employees Show Section Screen
Adding a field to a partition
Sort my fields
Customers
It is a data field where you can define customers. Of course, you don't necessarily have to use it for the product here. It can be used for the desired purpose for the project. If you want to use this template in your project, the code you need to write in the main code field on the web:
{
Clomosy.OpenForm(ftCustomers,fdtSingle,froAddNew,ffoNoFilter);
}
Codes
In this section, you can do the commands you want to write when you click on the templates, and call a procedure when the project is entered. You can perform operations for each field. Example, you can also do the coding that sends the data in the Cloud to local Sql here. So let's see how to define what here. Let's go to Management>Codes.
As seen below, you must select the form on which you want to operate from the Forms field.
Then, the action should be selected according to what will be done on the form for the selected form.
Finally, you choose what happens when it is clicked, and now it is ready to write code. After that, don't forget to write your code and click the save button.
Check out the Procedure Operations page to see how to create and call a procedure.
Params
It allows us to make project-based parameters. You can find the general settings of the applications here. For example, using the location within the project. To access Params, when you click Management>Params on the website, the following page will appear.
As seen above, we can make some definitions on our page. The variable name is given to the "Param Name" field. We can access the fields of the variable such as Value Str, Value Integer, Value Float, Value Date by pulling the name of the variable (Param Name) we give in active coding.
Parameter Creation
Let's create a new parameter and call it into our project. Let's go to the Management>Params page. Here, let's write the parameter name that we will define in the Param name field. Let's write values for the defined variable in fields such as Value Str, Value Integer. An example parameter definition is given below.
Now we can call the fields of the parameter we defined here with the "GetProjectUserDefParam" parameter. You can use this accessed data wherever you want.
Code:
ShowMessage(Clomosy.GetProjectUserDefParam('nameStr').FieldByName('Value_Str').AsString);
ShowMessage(Clomosy.GetProjectUserDefParam('nameStr').FieldByName('Value_Integer').AsString);
ShowMessage(Clomosy.GetProjectUserDefParam('nameStr').FieldByName('Value_Text').AsString);
Ready Parameters
Parameters actively used on Clomosy;
You can change the background color of the poll app and Clomosy main theme.
- In order to see the change you have made, you need to create a survey and add the survey to your project. If you don't know how to create a poll, see the Surexam page.
- For Clomosy main theme color change, you only need to make the desired definitions on "Params". When you create the project, it will open with the color you specified.
- Theme Color Change for Survey App
For this;
- You should write Survey_Theme in the "Param Name" field.
- Clomosy Main Theme Color Change
For this;
- You should write Clomosy_Theme in the "Param Name" field.
Now we can make more than one definition for other fields. 5 different color definitions can be made.
Definitions should be made according to the colors as follows. You can use which color you want to use by defining it.
For green color identification;
- Value Text :
- For Survey_Theme = https://clomosy.com/theme/SurveyStyle5.png
- For Clomosy_Theme = https://images.clomosy.com/media/ThemeStyle5.png
- Value Str : 3cb187
- Value Integer : 5
For purple color identification;
- Value Text :
- For Survey_Theme = https://clomosy.com/theme/SurveyStyle1.png
- For Clomosy_Theme = https://images.clomosy.com/media/ThemeStyle1.png
- Value Str : b264e3
- Value Integer : 1
For orange color identification;
- Value Text :
- For Survey_Theme = https://clomosy.com/theme/SurveyStyle2.png
- For Clomosy_Theme = https://images.clomosy.com/media/ThemeStyle2.png
- Value Str : ff7676
- Value Integer : 2
For blue color identification;
- Value Text :
- For Survey_Theme = https://clomosy.com/theme/SurveyStyle3.png
- For Clomosy_Theme = https://images.clomosy.com/media/ThemeStyle3.png
- Value Str : 422da4
- Value Integer : 3
For pink color identification;
- Value Text :
- For Survey_Theme = https://clomosy.com/theme/SurveyStyle4.png
- For Clomosy_Theme = https://images.clomosy.com/media/ThemeStyle4.png
- Value Str : ff4272
- Value Integer : 4
An example is shown below.
Barcode scanning feature on Template Detail page
When we wanted to add the template code on the Template Detail screen, we were entering manually. Instead, adding the template code can be done by reading the barcode according to the project usage feature.
So what do we need to do to use it?
At first, the desired template should be defined for our project. Example; When the project is opened, the Product page should come up and it should be called by saying "froAddNewDetail" so that we can see the detail page on this page.
{
Clomosy.OpenForm(ftProducts,fdtSingle,froAddNewDetail,ffoNoFilter);
}
After making our definitions, to activate the barcode reading feature, come to the "Params" page and here;
- Param Name : AddCodeByBarcode
- Value Integer : 1 must be written.
After doing these steps, it is now ready to use. You can also try on other templates besides Product.
Activating the Delete Button on the template "Page Detailed Editing" screen
It is used to activate the delete button when the clicked data is requested to be deleted when this screen is reached.
Before activating, let's look at which fields we should define in our project.
At first, the desired template should be defined for our project. Example; When the project is opened, the Product page should come up and it should be called by saying "froAddNewDetail" so that we can see the detail page on this page.
{
Clomosy.OpenForm(ftProducts,fdtSingle,froAddNewDetail,ffoNoFilter);
}
Let's go to the template (Example; Management>Products) page that we will open later.
Here, let's open our edit button by typing 1 to the "Value Integer" value of the "Show edit button" field in the Settings section.
After making our definitions, to activate the delete button feature, come to the "Params" page and here;
- Param Name : CanDelete
- Value Integer : 1
must be written.
After doing these steps, it is now ready to use. You can also try on other templates besides Product.
Activity
It is a field that can be used in event definitions within the project. If we give an example of this, customer visits, potential sales, etc. in the CRM project. If you want to use this template in your project, the code you need to write in the main code field on the web:
{
Clomosy.OpenForm(ftActivities,fdtSingle,froAddNew,ffoNoFilter);
}
Group
In the data entry area, it is an area where you can select data. Options that can be used when choosing the visit type of the Salesperson on the data entry screen in a CRM project: Potential Customer, Visit, Sales Call, etc. If you want to use this template in your project, the code you need to write in the main code field on the web:
{
Clomosy.OpenForm(ftGroups,fdtSingle,froAddNew,ffoNoFilter);
}
Thread
You can design the data entry screen that you will use in the project here. If you want to use this template in your project, the code you need to write in the main code field on the web:
{
Clomosy.OpenForm(ftThreads,fdtSingle,froAddNew,ffoNoFilter);
}
Here are the fields you can use:
You can use the fields below in your own project in line with your needs. You can only use each field once. The order of the fields is your order of inserting the fields. You can name the fields as you wish.
In the "Show Delete Button" statement, if you want to use the delete button on the Thread page, you must write the value 1 in the "Value Integer" field and save it. In this way, when you open the project on mobile, the trash button will appear in the upper right application bar.
We need to enter the values we want to appear on our page in the "Visible List" field. These values are defined below with explanation. Example; [Thread_Product_GUID].
The "Field Captions" field is a field that we can use if we want to change the titles of the values we defined in the "Visible List" field. Example usage; "[Thread_GUID]":"Records".
If we write one of the values that we defined in the "Visible List" field in the "Disable Inputs" field on the page, when we open the mobile application, writing cannot be done on this field, only the field appears. Example; [Thread_Date].
TType GUID
You can make a selection here by placing the data you defined in Types in the screen you will use.
Item GUID
If you select this field, you can select the data you defined in the Item here.
Group_GUID
If you select this field, you can select the data you defined in the Group here.
Product_GUID
Bu alanı seçerseniz Product tanımladığınız ürünlerden birini seçebilirsiniz.
Task_GUID
If you select this field, you can choose one of the fields you defined in Task.
Customer_GUID
If you select this field, you can choose one of the fields you defined in Customer.
Employee_GUID
If you select this field, you can choose one of the values that you define Employee.
Date
It is a field where you can select only the date field. With this field, you can select the date field on the data entry screen.
Quantity
It is a field where you can enter the amount information.
Piece
It is a field where you can enter numeric values.
Price
It is a field where you can enter numeric values.
Discount
It is a field where you can enter numeric values.
Amount
It is a field where you can enter numeric values.
Value Str
It is a field where you can enter a single line of text.
Value Text
It is a field where you can enter long texts. Example; such as description, address information.
Value Float
It is a field where you can enter decimal numbers.
Value Integer
It is a field where you can enter numeric values.
Value Date
It is a field where you can select the date fields.
Value Start Date
It is a field where you can select the date fields.
Value End Date
It is a field where you can select the date fields.
Rec Location
If you want to save the location where the data is saved in the data entry screen, you must add it to the data entry screen.
Img GUID
You can add the feature of taking a picture to your data entry screen or uploading a picture from the gallery using this area.
Code
You can use this field when you want to assign a document number to your data entry screen.
GUID
You can add this field to view or review and make changes to your saved data.
New Questionnaires
It is a template that you can use when you want to conduct a survey in your project.
Where can you find when you open your project?
When you click on Management > New Questionnaires, a blank page will appear. Here you can create a new survey by clicking the "Add Survey Exam" button.
When you click the button, there is a field where you can enter the survey's id number, survey name and finally a description (not mandatory). After entering these fields, you can create a survey by clicking the add button. Now that you have created a survey, you can add questions to the survey. To do this, click on the survey you created.
There are multiple exam types (only Survey is supported at the moment), question types and selection types on the Clomosy application. With these, you can create questions with multiple different options and use more than one option of these questions. Now let's see what they are and how to use them.
| Value | Type |
|---|---|
| 0 | Survey |
| 1 | Exam |
| 2 | Quality Control |
| Value | Type | Explanationn |
|---|---|---|
| 0 | Single Choice Question | Only one option is ticked. |
| 1 | Multi Choice Question | You can tick more than one option. |
| 2 | Paragraph Question | Description is a type of response that can be entered. |
| 3 | Single Choice Matrix Question | It is used when it is desired to give the same answers to more than one question. (Single selection) |
| 4 | Multi Choice Matrix Question | It is used when it is desired to give the same answers to more than one question. (Multiple selection) |
| Value | Type | Explanationn |
|---|---|---|
| 0 | None Description | No explanation for the answer |
| 1 | Text Description | Long text explanation for the answer |
| 2 | Str Description | Short text explanation for the answer |
| 3 | Integer Description | Number value explanation is entered for the answer |
| 4 | Float Description | Float value explanation is entered for the answer |
| 5 | Date Description | Date value explanation is entered for the answer |
When we start creating the questions, we encounter a screen like the one below. We should start by typing the question and choosing the question option type. Then we can write the answers.
If you want a mandatory answer to the question, you should tick the "Must Filled" option on the left. As soon as this is marked, it will not move on to another question without answering this question.
If you have created a question, you can now proceed to the next question by pressing the + (plus) button.
Now that we have defined our questions and choices, we can now change the types of our choices. For this, when you click on the button next to the options as seen below, the options appear.
For example, if we consider that we have marked String, there is a field where we can write a string under the answer as seen on the mobile screen below. You can use this feature wherever you want. You can try and see other options.
In the matrix structures, the right of single or multiple choice was given according to whichever one chose in the single or multiple choice questions.
For example, there is a single choice question as seen below. Here, we can customize the question if we want, change it to multiple selection or keep it the same.
Another feature in matrix structures is the obligatory answering of the desired question. In the screenshot below, when the button is clicked, we can make this question a mandatory choice by saying "Must Filled" or leave it as it is by saying "Standard". In this way, you can create your questions and experiment.
So how can we see the survey we created now in our mobile application?
For this, we come to the "Main Code" section. Write and save the code below.
{
Clomosy.OpenForm(ftSurexams,fdtSingle,froAddNew,ffoNoFilter);
}
Then we come to the Management> Codes section. Here, we write the following code by marking "SUREXAMS.SCRIPT" in the Forms field, "Form" in the User/Normal field, and "ListView.OnBeforeClick" in the Events field.
Clomosy.OpenForm(ftThreadsView,fdtSingle,froAddNew,ffoDoFilter); Clomosy.ResumeLocalEvent = False;
Now we can open our application and make the survey we prepared. In order to see the survey reports after the survey is done, you can see the reports as follows by clicking the "Report Page" button in the upper right corner of the "Project Management" page of the website.
Show Mobile Feature
Sort List
When the templates used in Clomosy (Product, Items, Employees, Customers, etc.) are entered, we can access the "Show Mobile Feature" button at the bottom of the page and click on the "Sort List" mobile screen on the right. Below is the Sort List screen of a sample table.
You use this screen when you want to sort by all the data of the sample table. Example; If we are going to sort by "Product_Name", click "Product_Name" as shown below, then enter a namespace as you want it to appear on the screen. As soon as you save, you will now be able to sort.
To delete the registered field, you can delete it by clicking the minus button on the "Sort List" mobile screen, or if you want to change the name field, click on it and change it.
Now that we have done the sorting process, let's enter the project through our mobile application and have a look. On the screen below, you can see the view on mobile. The data came in as we recorded here. As soon as we click it, it will now sort by name.
Template Settings Section
After entering the project, the settings section appears as soon as you enter the Items, Type, Tasks, Product, Employee, Customer, Activity, Group templates in Management. Here you can edit/enable the features on the screen of your items.
Now let's see what the parameters in the settings section do:
Input Fields
In mobile when you activate edit button. Users need to enable the button. For this, they need to set the "Value Integer" part of the "Show edit button" field to 1. This Input Fields param comes to use when user clicked edit button app will show a new form and in this form which fields should be visible to user. That’s input fields param.
For adding input field you should use “Value Text” edit. In “Value Text” param should be like “item_code,item_name”.
Other columns like "Value Str", "Value Integer", "Value Float" and "Value Date" are for Clomosy Engineer. Which we simply give users param can acces by adding it.
Output:
Disable Inputs
In mobile when you activate edit button. Users can edit record by clicking edit button. This “Disable Inputs” param comes to use when user clicked edit button app will show a new form and in this form which fields should be visible to user will be shown. “Disable Inputs” make which field should be disable(can’t accessible by user but can see it)
For adding "Disable Inputs" you should use "Value Text" edit. In "Value Text" param should be like “item_code,item_name”
Other columns like "Value Str", "Value Integer", "Value Float" and "Value Date" are for Clomosy Engineer. Which we simply give users param can acces by adding it.
Output:
Field Caption
In mobile when you activate edit button. Users can edit record by clicking edit button. This “Field Captions” param comes to use when user clicked edit button app will show a new form and in this form which fields should be visible to user will be shown. "Field Captions" make which field’s Label should be what.
For adding "Field Captions" you should use "Value Text" edit. In "Value Text" param should be like "Item_Name": "Ztac Name", "Item_Code": "Ztac Code"
Other columns like "Value Str", "Value Integer", "Value Float" and "Value Date" are for Clomosy Engineer. Which we simply give users param can acces by adding it.
Output:
Field Defaults
In mobile when you activate edit button. Users can edit record by clicking edit button. This “Field Defaults” param comes to use when user clicked edit button app will show a new form and in this form which fields should be visible to user will be shown. "Field Defaults" make which field’s default value.
For adding "Field Defaults" you should use "Value Text" edit. In "Value Text" param should be like "Item_Name": "Ztac Name", "Item_Code": "Ztac Code".
Other columns like "Value Str", "Value Integer", "Value Float" and "Value Date" are for Clomosy Engineer. Which we simply give users param can acces by adding it.
Enable Fields For Top User
In mobile when you activate edit button. Users can edit record by clicking edit button. This "Enable Fields For Top User" param comes to use when user clicked edit button app will show a new form and in this form which fields should be visible to user will be shown. "Enable Fields For Top User" lets top member edit inputs even if its disable.
For adding "Enable Fields For Top User" you should use "Value Text" edit. In "Value Text" param should be like "item_code,item_name".
Other columns like "Value Str", "Value Integer", "Value Float" and "Value Date" are for Clomosy Engineer. Which we simply give users param can acces by adding it.
Hierarchy Flag
With this flag you are basically saying 0 numbered hierarchy template going to be active in this page.
For adding “Hierarchy Flag” you should use “Value Integer” edit. In “Value Integer” param should be like “0”.
Other columns like “Value Str”, “Value Text”, “Value Float” and “Value Date” are for Clomosy Engineer. Which we simply give users param can acces by adding it.
Can Upload Image While Adding Record
With this param you can active/deactive feature that lets user add image while adding record.
For adding “Can Upload Image While Adding Record” you should use “Value Integer” edit. In “Value Integer” param should be like “0”.
Other columns like “Value Str”, “Value Text”, “Value Float” and “Value Date” are for Clomosy Engineer. Which we simply give users param can acces by adding it.
Output:
While Listing Show Images
With this param you can specify how images should be shown in mobile.
0:deactivate, 1:Activating record screen’s record’s images, 2:Activating thread screen’s images.
For adding “While Listing Show Images” you should use “Value Integer” edit. In “Value Integer” param should be like “0”.
Other columns like “Value Str”, “Value Text”, “Value Float” and “Value Date” are for Clomosy Engineer. Which we simply give users param can acces by adding it.
Output:
Screen output when "Value Integer" is set to 2:
Listed Image Size
With this param you can specify your image’s size.
For adding “Listed Image Size” you should use “Value Str” edit. In “Value Str” param should be like “L”.
Other columns like “Value Integer”, “Value Text”, “Value Float” and “Value Date” are for Clomosy Engineer. Which we simply give users param can acces by adding it.
Show edit buttons
With this param you let user to edit record.
For adding “Show Edit Button” you should use “Value Integer” edit. In “Value Integer” param should be like “0”.
Other columns like “Value Str”, “Value Text”, “Value Float” and “Value Date” are for Clomosy Engineer. Which we simply give users param can acces by adding it.
When you enter the application on mobile, if you slide one of the listed data to the left, the "edit" button will appear.
Output:
Show Delete Button
With this param you let user to delete record.
For adding “Show Delete Button” you should use “Value Integer” edit. In “Value Integer” param should be like “0”.
Other columns like “Value Str”, “Value Text”, “Value Float” and “Value Date” are for Clomosy Engineer. Which we simply give users param can acces by adding it.
Barcode
When you enable it, the barcode icon appears on the call data entry screen. When you click on it, the camera opens and you can read the barcode. It searches the data with the read values. (The read barcode value can be found if the existing data is the id value.)
Output:
Can Add Image in Detail
With this param you let user to add image in detail screen. In order to see the detail page, the "Edit" button must be open and when it is clicked, we can enter the detail page. Here the picture will appear.
For adding “Can Add Image In Detail” you should use “Value Integer” edit. In “Value Integer” param should be like “0”.
Other columns like “Value Str”, “Value Text”, “Value Float” and “Value Date” are for Clomosy Engineer. Which we simply give users param can acces by adding it.
Restrict Records
With this param you are changing screen’s hierarchy settings.
0:All, 1:Only Owner, 2:Hierarchical, 3:HierarchicalWithWaitForTopMember.
For example, if we give a value of 1 to the "Value Integer" field, the data recorded by the user will be displayed. Data recorded by other users is not displayed on our screen. Each user can see their own data. You can try and see other options.
For adding “Restrict Records” you should use “Value Integer” edit. In “Value Integer” param should be like “0”.
Other columns like “Value Str”, “Value Text”, “Value Float” and “Value Date” are for Clomosy Engineer. Which we simply give users param can acces by adding it.
Status - Sub Status - Category ID - Sub Category ID - Priorty
With this param when you enter edit of record you will see fields in that screen if you add item_status to input fields you will see item_status combobox so you have to fill it with data in this param you can fill it up.
For adding “Item Status,SubStatus,Category,SubCategory and Priorty” you should use “Value Str” and “Value Text” edit.
Other columns like “Value Float” and “Value Date” are for Clomosy Engineer. Which we simply give users param can acces by adding it.