--- updatedAt: 2025-12-04T14:00:24.000Z agentTools: projectIndex: https://developer.ironcladapp.com/llms.txt --- # Ironclad Repository to Entities Migration Guide ## **Overview** This guide provides a comprehensive overview of the steps required to effectively plan and implement the migration of your counterparty data from the Ironclad Repository to the new Entities framework. Historically, customers have managed counterparty data within the repository as a related record to workflows. With the introduction of the new Entities framework, Ironclad customers now have the flexibility to separate their counterparty data from the repository, enabling them to be mapped to workflows by the counterparty object. Although there isn’t currently an automated way to complete this migration, this sequence of steps will help Ironclad customers plan and execute an effective migration strategy. | # | Phase | Key Activities | | :- | :-------------------------- | :------------------------------- | | 1 | Planning & Preparation | Assess, scope, prepare | | 2 | Configure Entity Settings | Setup relationships, permissions | | 3 | Export & Transform Data | Export, clean, validate | | 4 | Create Entities | Import, verify | | 5 | Connect Entities to Records | Link using chosen method | | 6 | Update Workflows | Modify, test configurations | | 7 | Validation & Testing | Test, validate, UAT | | 8 | Go-Live & Post Migration | Deploy, monitor, optimize | ## ## **Phase 1: Planning & Preparation** ### **1.1 Assess Current State** * **Inventory existing counterparty records** in the repository * Document current workflow dependencies * Identify custom fields and metadata that need migration * Note any integrations that rely on counterparty data ### **1.2 Define Migration Scope** * Determine which counterparty records to migrate * Establish timeline and resource allocation * Identify stakeholders and communication plan * Create backup of existing data ### **1.3 Create Migration Checklist** * [ ] All counterparty records identified * [ ] Custom fields mapped to entity properties * [ ] Workflow dependencies documented * [ ] Testing environment prepared * [ ] Rollback plan established ## ## **Phase 2: Configure Entity Settings** This configuration step presents a valuable opportunity to not only map your existing entity properties to Ironclad's schema, but also to clean up and optimize your counterparty data during the migration process. Take advantage of this moment to standardize naming conventions, consolidate duplicate entries, validate data completeness, and establish consistent formatting rules that will improve data quality across both systems going forward ### **2.1 Set Up Entity Relationship Types** Before creating entities, configure the relationship framework that will define how entities interact with each other and with records. **Steps:** 1. Navigate to **Company Settings** → **Entities** 2. Click on **Relationship Types** 3. Define relationship types that match your business needs: * Vendor/Customer relationships * Partner relationships * Custom relationship types **Reference:** [Create & Manage Relationship Types and Entity Properties](https://support.ironcladapp.com/hc/en-us/articles/28005038398231-Create-Manage-Relationship-Types-and-Entity-Properties) ### **2.2 Configure Entity Permissions** Establish proper access controls to ensure data security and compliance. **Permission Levels to Configure:** * **View permissions**: Who can see entity data * **Edit permissions**: Who can modify entity information * **Create permissions**: Who can create new entities * **Delete permissions**: Who can remove entities **Steps:** 1. Go to **Company Settings** → **Groups** → **Configure Group** → **Repository and Entities** 2. Configure access controls **Reference:** [Entity Permissions Overview](https://support.ironcladapp.com/hc/en-us/articles/30930082077207-Entity-Permissions-Overview) ## ## **Phase 3: Export & Transform Data** ### **3.1 Export Counterparty Records** **Export Process:** 1. Navigate to the Repository 2. Apply filters to select counterparty records 3. Export records to spreadsheet format 4. Include all relevant metadata and custom fields ### **3.2 Data Transformation Checklist** Prepare your exported data for entity import: * [ ] Remove duplicate entries * [ ] Standardize naming conventions * [ ] Validate required fields are populated * [ ] Format dates consistently (MM/DD/YYYY or DD/MM/YYYY) * [ ] Clean up special characters * [ ] Add entity relationship columns if needed ## ## **Phase 4: Create Entities** ### **4.1 Import Transformed Data** **Import Steps:** 1. Navigate to **Entities** section 2. Click **Import Entities** 3. Upload your prepared spreadsheet 4. Map spreadsheet columns to entity fields 5. Review mapping and validate data 6. Execute import **Best Practices:** * Start with a small batch (10-20 records) for testing * Verify import results before proceeding with full dataset * Document any import errors for troubleshooting References: [Create Entities from Existing Data](https://support.ironcladapp.com/hc/en-us/articles/30930072721815-Create-Entities-from-Existing-Data)\ [Update Entity Data Using Metadata Export and Import](https://support.ironcladapp.com/hc/en-us/articles/31437736042775-Update-Entity-Data-Using-Metadata-Export-and-Import) ### **4.2 Verify Entity Creation** * Confirm all entities imported successfully * Check that custom properties populated correctly * Validate entity relationships are established * Review any import warnings or errors ## ## **Phase 5: Connect Entities and Records** ### **5.1 Choose Connection Method** | | AI Suggestions - RunAI | Metadata Import | Ironclad API | Manual Linking | | :-------- | :------------------------------------------------------------------ | :----------------------------------------------- | :------------------------------------------------------------------------------ | :------------- | | Best for: | Large volumes (batches of 2,500 documents) with pattern recognition | Large volume,structured data with clear mappings | Automated integrations & bulk operations | Small volumes | | Speed: | Fast | Very Fast | [Rate Limited](https://developer.ironcladapp.com/reference/clm-api-rate-limits) | Slow | | Accuracy: | High | Very High | Very High | Error prone | ### **5.2 Method 1: AI Suggestions (RunAI) - Recommended** **For batch processing of entity connections:** 1. Navigate to the Records section 2. Select records that need entity connections 3. Click **Run AI Suggestions** 4. Review AI-suggested entity matches 5. Approve or modify suggestions 6. Apply connections in batches **Benefits:** * Faster processing for large volumes * Pattern recognition for accurate matching * Batch approval capabilities **Reference:** [Use AI Suggestions to Tag Entities on Records](https://support.ironcladapp.com/hc/en-us/articles/33047366537367-Use-AI-Suggestions-to-Tag-Entities-on-Records) ### **5.3 Method 2: Metadata Import** **For structured bulk connections:** 1. Prepare a CSV with: * Record IDs * Entity IDs or names * Connection type 2. Navigate to **Import** → **Metadata Import** 3. Upload connection mapping file 4. Validate and execute import **Reference**: [Connect Entities and Records](https://support.ironcladapp.com/hc/en-us/articles/30929994192023-Connect-Entities-and-Records) ### **5.4 Method 3: Ironclad API - For Automated Integrations** **For programmatic bulk operations and system integrations:** The Ironclad API provides comprehensive endpoints for entity management and connection operations. This method is ideal for organizations with technical resources who need to automate the migration process or integrate with other systems. **Available API Endpoints:** | Operation | Method | Endpoint | Purpose | | :------------------------------------------------------------------------------------------------------ | :----- | :--------------------------------------- | :---------------------------------------------- | | [Get Relationship Types](https://developer.ironcladapp.com/reference/get-all-entity-relationship-types) | GET | `/public/v1/entities/relationship-types` | Retrieve all entity relationship configurations | | [List Entities](https://developer.ironcladapp.com/reference/list-all-entities) | GET | `/public/v1/entities` | Get all entities with filtering options | | [Create Entity](https://developer.ironcladapp.com/reference/create-an-entity) | POST | `/public/v1/entities` | Create new entities programmatically | | [Retrieve Entity](https://developer.ironcladapp.com/reference/retrieve-an-entity) | GET | `/public/v1/entities/{id}` | Get specific entity details | | [Update Entity](https://developer.ironcladapp.com/reference/update-an-entity) | PATCH | `/public/v1/entities/{id}` | Modify existing entity properties | | [Delete Entity](https://developer.ironcladapp.com/reference/delete-an-entity) | DELETE | `/public/v1/entities/{id}` | Remove entities from the system | **Implementation Steps:** 1. **Authentication Setup** * Generate API credentials in Ironclad settings * Configure authentication headers * Test connection with a simple GET request 2. **Bulk Entity Creation** ```py # Example: Create entities via API POST /public/v1/entities { "name": "Acme Corporation", "type": "vendor", "properties": { "industry": "Technology", "location": "San Francisco" } } ``` 3. **Establish Entity-Record Connections** * Query existing records via API * Map record IDs to entity IDs **Reference**: [Entity References in Workflows and Records](https://developer.ironcladapp.com/docs/entity-references-in-workflows-records) 4. **Validation** * Use GET endpoints to verify entity creation * Confirm relationship mappings **Requirements:** * Technical expertise (developers/IT team) * API access permissions * Programming knowledge (Python, JavaScript, etc.) * Error handling and retry logic implementation **Reference:** [Ironclad API Developer Documentation](https://developer.ironcladapp.com/reference/get-all-entity-relationship-types) **Reference:** [Connect Entities and Records - All Methods](https://support.ironcladapp.com/hc/en-us/articles/30929994192023-Connect-Entities-and-Records) ### **5.5 Method 4: Manual Linking** **For complex or one-off connections:** 1. Open individual record 2. Navigate to entity connection field 3. Search and select appropriate entity 4. Save connection ## **Phase 6: Update Workflow Configuration** ### **6.1 Workflow Migration Strategy** ### **6.2 Update Workflow Designer** **Steps for each affected workflow:** 1. Open **Workflow Designer** 2. Navigate to counterparty lookup fields 3. Change field type from "Related Record" to "Entity Lookup" 4. Configure entity lookup settings: * Select entity type * Set search parameters (note: search/filter parameters are more robust for entity object compared to related records) * Update any dependent logic ### **6.3 Update Workflow Components** **Components to review and update:** * **Forms**: Update counterparty selection fields * **Approvals**: Modify routing based on entity properties * **Integrations**: Update API calls to use entity IDs * **Reports**: Adjust to pull from entity data * **Notifications**: Update merge tags for entity fields **Reference:** [Configure Entities in Workflow Designer](https://support.ironcladapp.com/hc/en-us/articles/28376960249111-Configure-Entities-in-Workflow-Designer) ## ## **Phase 7: Validation & Testing** ### **7.1 Testing Checklist** **Data Validation:** * [ ] All counterparty records successfully migrated to entities * [ ] Entity relationships correctly established * [ ] Custom properties populated accurately * [ ] No data loss or corruption * [ ] Record → Entity mappings are correct **Workflow Testing:** * [ ] Entity lookups function correctly * [ ] Workflow routing works as expected * [ ] Integrations properly handle entity data * [ ] Reports display accurate information ### **7.2 User Acceptance Testing** 1. **Select test users** from different departments 2. **Provide test scenarios** covering common use cases 3. **Document feedback** and issues 4. **Address concerns** before full rollout ### **7.3 Performance Validation** * Monitor system performance post-migration * Check query response times * Verify bulk operations efficiency * Ensure no degradation in user experience ## ## **Phase 8: Go-Live & Post-Migration Activities** ### **8.1 Communication & Training** 1. **Announce completion** to all stakeholders 2. **Provide training** on new entity features 3. **Share documentation** and quick reference guides 4. **Establish support channels** for questions ### **8.2 Monitoring & Optimization** * Track entity usage patterns * Gather user feedback * Optimize entity search and filtering * Refine permissions as needed ### **8.3 Documentation** * Update internal process documentation * Record lessons learned * Create troubleshooting guide * Document custom configurations ## **Support Resources** * [Ironclad Support Center](https://support.ironcladapp.com) * Ironclad Professional Services for complex migrations * Ironclad Partner Ecosystem ## **Conclusion** Successfully migrating from repository-based counterparty management to the Entities framework requires careful planning, systematic execution, and thorough testing. By following this guide and leveraging the provided resources, you can ensure a smooth transition that enhances your contract management capabilities while maintaining data integrity and workflow continuity. Remember that this migration is not just a technical upgrade but an opportunity to optimize your counterparty data management, improve workflow efficiency, and enable more sophisticated reporting and analytics capabilities. [image1]: data:image/png;base64,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