Create New Record
This node is used to create a new record of a given class. You specify the class of record to be created in the Property Panel. Sending a signal to Do will perform the action.
You can also provide values for the properties of the record either via connections or by typing the values in the property panel.
Inputs
Data | Description |
---|---|
Class | Choose a class for the record that you want to create. |
Source Object Id | This input can be used to provide an object whose properties will be used as the initial values of the newly created record. |
Property Inputs | When the class of the record to be created is choosen, all properties of that class will be available as inputs. When the Do signal is received a new record will be created with the values of the properties either specified in the property panel or via connections. <##input:prop-*##>The value of these inputs will become the properties of the newly created record. |
Signal | Description |
---|---|
Do | Send a signal on this input to create a new record. |
Access Control Rules
When creating and updating records you can also specify access control rules. By default all records created can be read and written by everyone, they are completely public. This is convenient in the beginning when you are working on your applications but as you want to make it publicly available you need to think about access control. You do this by adding access control rules when creating or updating records.
You can have as many rules as you want. Each rule has a Target which can be one of User, Everyone or Role:
- User implies that this rule will target a specific user, you can either specify the User Id (that is the record Id for the user record) for the user or if omitted the current logged in user will be used.
- Everyone means, well, this rule applies to everyone. You can use to to create read only objects, that can be publicly read but not written.
- Role means that this object can be accessed as you specify by anyone belonging to a certain role. Please look at the access control guide for more information.
All rules have the inputs Read and Write when you specify if the users targeted by the role have read / write access.
Each rule can, depending on the selected Target type have the following inputs (it's a good idea to change the label of your rule as in the image above to easier find the inputs when connecting):
Data | Description |
---|---|
User Id | The User Id of the user that the rule should apply to. If none is provided via a connection the currently logged in user will be used. This input is only available if the User target type is selected. |
Role | The Role Name of the role that the rule should apply to. This input is only available if the Role target type is selected. |
Write | Set to true for this rule to have write access. |
Read | Set to true for this rule to have read access. |
Outputs
Data | Description |
---|---|
Id | The Id of the new record that was created if the action was successful. |
Error | The specific error message in case something went wrong when creating the record. |
Signal | Description |
---|---|
Success | A signal is sent here when the new record have been created successfully. |
Failure | A signal is sent on this output if something went wrong when creating the record. You can find the specific error in the Error output. |