Overview
This node integrates with the FractalForge API to perform operations on entities called "Commands" or "Queries." Specifically, for the Command - Create operation, it allows users to create a new object within a specified entity by sending a JSON payload. This is useful in scenarios where you want to programmatically add new data objects to your FractalForge system, such as creating new commands or events tied to an entity.
Practical examples include:
- Automating the creation of command objects based on external triggers.
- Integrating FractalForge with other systems to dynamically add new commands.
- Using JSON input to define complex object structures when creating new entries.
Properties
| Name | Meaning |
|---|---|
| Entity Name or ID | Select the target entity for the command. You can choose from a loaded list of entities or specify an ID via expression. |
| Object ID | The ID of the object to create under the selected entity. Optional; if provided, the new object will be created under this ID path. |
| JSON | The JSON body representing the object data to create. This should be a valid JSON string defining the object's properties and values. |
Output
The node outputs a JSON array containing the response from the FractalForge API after creating the object. Each item corresponds to one execution input and includes the newly created object's data as returned by the API.
If the API returns binary data (not indicated here), it would be included accordingly, but this node primarily deals with JSON responses representing created objects.
Dependencies
- Requires an API key credential for authenticating with the FractalForge API.
- Needs the API endpoint URL configured in the credentials.
- Uses HTTP requests to communicate with the FractalForge REST API.
Troubleshooting
- Invalid JSON Body: If the JSON property is malformed or invalid, the API request will fail. Ensure the JSON input is correctly formatted.
- Missing or Incorrect Entity: Selecting an entity that does not exist or providing an incorrect ID will cause errors. Use the provided load options or verify the entity ID.
- Authentication Errors: If the API key or endpoint is misconfigured, authentication will fail. Verify credentials are correct and have necessary permissions.
- API Errors: Any error returned by the FractalForge API (e.g., validation errors) will be surfaced. Review the error message for details.
- Empty Object ID: For creation, the Object ID is optional; however, if provided, it must be valid. An invalid ID format may cause failures.
Links and References
- FractalForge Documentation
- n8n Expressions Documentation (for using expressions in properties)