Project data model

​

What is a project data model?

The Project Data Model (PDM) lets you define reusable data types at the project level. These data types propagate to the process data models, ensuring data consistency across yensuring data consistency across your FlowX.AI applications, including in Reusable Business Rules, Persistence Layer schemas, and other components. With PDM, you create a centralized data structure that serves as the foundation for all processes within your project. This ensures that core data types like Customer, Product, or Document maintain consistent definitions throughout your application.

​

Key concepts

​

Benefits of project data model

​

How to use the project data model

​

Access the project data model

​

Define a project data model

​

Manage data types

​

Add a data type

1. Click the ”+” button in the Data Types panel.
2. Enter the name and properties of the data type.
3. Add attributes as needed.
4. Save changes.

​

Edit a data type

​

Remove a data type

​

Working with referenced data types

When a data type from the Project Data Model is used in a Process Data Model:

1. The Process Data Model will display the referenced data type.
2. The referenced data type cannot be modified at the process level.
3. Changes to the data type in the Project Data Model will propagate to all referencing processes.

​

Common scenarios

​

Use the Project Data Model in processes

1. Navigate to a process within your project.
2. Open the Process Data Model.
3. Project data types are available for selection.
4. Select the desired project data type to use in your process.
5. The data type is added to your Process Data Model, maintaining reference to the Project Data Model.

​

Work with libraries

​

Integrate Library Data Models

1. Navigate to your project dependencies.
2. Add a library as a dependency. The library must have a build created.

3. Library data types become available in your Project Data Model.

4. You can now use the library data types in your data model.

​

Handle duplicate types from libraries

When multiple libraries contain data types with the same name:

1. Both types will be visible in the Project Data Model with visual indicators.
2. Namespacing functionality will prevent technical issues.

​

Configure reporting and sensitive data settings

1. Go to the Project Data Model.
2. Click the “3 dots menu” in the upper right corner of the side panel.
3. Choose “show details”.

4. Update the sensitive/reporting settings as needed.

​

Project Data Model after version commitment

After committing a project version:

1. The Project Data Model becomes read-only.
2. You can still view the diagram and monitor usage.

3. To make changes to the data model, you will require a new project version.

​

Search and filter

The Project Data Model interface provides tools to help you find and work with your data types:

1. Navigate to the Project Data Model.
2. By default, only project-level types are displayed.
3. Use filters to view library types as well.
4. Use the search function to find specific types by name.

​

Update library dependencies

When updating library dependencies:

1. Navigate to the dependencies section.
2. Select the new library version.
3. The system will inform you of any breaking changes to data types.
4. You can decide whether to proceed with the update.
5. If you proceed, changes will propagate to processes according to compatibility rules.

​

Real-world example: Insurance claims processing

Core data types in PDM

The insurance company created these data types in their Project Data Model:

1. Customer
   • customerId: string
   • firstName: string
   • lastName: string
   • dateOfBirth: date
   • contactInformation: ContactInfo (reference)
   • policyNumbers: array of string
   • customerSince: date
   • riskProfile: RiskProfile (reference)
   • Settings: Sensitive data = True, Used in reporting = True
2. ContactInfo
   • email: string
   • phone: string
   • address: Address (reference)
   • Settings: Sensitive data = True, Used in reporting = False
3. Claim
   • claimId: string
   • policyNumber: string (reference to Policy)
   • claimType: enum [“Auto”, “Property”, “Medical”, “Liability”]
   • incidentDate: date
   • reportedDate: date
   • status: enum [“New”, “Under Review”, “Pending Documents”, “Approved”, “Denied”, “Closed”]
   • estimatedAmount: number
   • approvedAmount: number
   • documents: array of Document (reference)
   • Settings: Sensitive data = False, Used in reporting = True
4. Document
   • documentId: string
   • documentType: string
   • fileName: string
   • fileUrl: string
   • uploadDate: date
   • Settings: Sensitive data = False, Used in reporting = False

Process-specific data models

The company created multiple processes using the PDM:

• Auto Claim Processing
• Policy Renewal Process

Root: ClaimProcess

Data Structure:

• ClaimProcess (Process-specific type)
  • claim: Claim (reference from PDM)
  • assignedAdjuster: string
  • vehicleInfo: AutoClaimDetails (reference)
  • processingStage: enum [“Initial Review”, “Damage Assessment”, “Liability Determination”, “Settlement Negotiation”, “Payment Processing”]
• AutoClaimDetails (Process-specific type)
  • vehicleMake: string
  • vehicleModel: string
  • vehicleYear: number
  • vin: string
  • accidentLocation: Address (reference from PDM)
  • damageDescription: string

Example use cases

• Add an attribute
• Remove a field
• Library integration

1. A configurator adds a new attribute loyaltyTier to the Customer data type in the PDM.
2. This attribute is an enum [“Bronze”, “Silver”, “Gold”, “Platinum”].
3. The new attribute automatically propagates to all processes using the Customer data type.
4. The Policy Renewal Process now has access to the customer’s loyalty tier without any process-level changes.

Benefits demonstrated

This example shows how the Project Data Model:

• Ensures data consistency: Core entities like Customer and Policy maintain consistent structures across all processes and resources.
• Promotes reusability: Common data types are defined once and reused in in multiple processes, business rules, and other resources.
• Simplifies changes: Updates to data types are propagated automatically to all processes.
• Enforces governance: Sensitive data is marked at the project level for consistent handling.
• Allows flexibility: Process-specific data can extend the PDM while maintaining core data integrity.

​

Best practices

​

Limitations

Show Current limitations of the Project Data Model

Data types from the Project Data Model cannot be modified at the process level.

Removing or changing data types in use may break processes.

Project Data Model becomes read-only after version commitment.

Library updates with breaking changes to data types require careful handling.

Project Data Model definitions are not currently used for resources (e.g., Workflows, Business Rules).

​

Troubleshooting

Cannot modify a referenced data type in process

1

Problem

You’re trying to edit a data type from the PDM within a process, but the fields are read-only.

2

Solution

Make changes at the project level instead:

1. Navigate to the Project Data Model
2. Locate and edit the data type
3. Save changes
4. The changes will propagate to all processes

Cannot delete a data type that is in use

1

Problem

You’re trying to delete a data type, but receive an error that it’s in use.

2

Solution

Either:

• Remove all references to the data type first
• Create a new version of your project to make the change

References broken after type change

1

Problem

After changing a data type (e.g., from string to number), references are broken in processes.

2

Solution

Review affected processes and update references manually:

1. Check the warning message that lists affected processes
2. Open each process
3. Update UI templates or other components that referenced the changed attribute

Library update warning about breaking changes

1

Problem

When updating a library dependency, you receive warnings about breaking changes to data types.

2

Solution

Carefully review the changes and their impact before proceeding:

1. Check which data types are affected
2. Review how these types are used in your processes
3. Decide whether to proceed with the update or maintain the current version