bulkUpdateComponents
Update multiple Adobe Experience Manager components simultaneously with built-in validation and rollback capabilities to maintain system integrity during batch operations.
Instructions
Update multiple components in a single operation with validation and rollback support
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| updates | Yes | ||
| validateFirst | No | ||
| continueOnError | No |
Implementation Reference
- Primary handler implementation for the bulkUpdateComponents tool. Handles validation phase (optional), performs sequential updates via updateComponent method, supports continueOnError, and returns comprehensive results with per-component status.async bulkUpdateComponents(request: BulkUpdateComponentsRequest): Promise<BulkUpdateResponse> { return safeExecute<BulkUpdateResponse>(async () => { const { updates, validateFirst = true, continueOnError = false } = request; if (!Array.isArray(updates) || updates.length === 0) { throw createAEMError( AEM_ERROR_CODES.INVALID_PARAMETERS, 'Updates array is required and cannot be empty' ); } const results: Array<{ componentPath: string; success: boolean; result?: unknown; error?: string; phase: string; }> = []; // Validation phase if requested if (validateFirst) { for (const update of updates) { try { await this.httpClient.get(`${update.componentPath}.json`); } catch (error: any) { if (error.response?.status === 404) { results.push({ componentPath: update.componentPath, success: false, error: `Component not found: ${update.componentPath}`, phase: 'validation' }); if (!continueOnError) { return createSuccessResponse({ success: false, message: 'Bulk update failed during validation phase', results, totalUpdates: updates.length, successfulUpdates: 0 }, 'bulkUpdateComponents') as BulkUpdateResponse; } } } } } // Update phase let successCount = 0; for (const update of updates) { try { const result = await this.updateComponent({ componentPath: update.componentPath, properties: update.properties }); results.push({ componentPath: update.componentPath, success: true, result: result, phase: 'update' }); successCount++; } catch (error: any) { results.push({ componentPath: update.componentPath, success: false, error: error.message, phase: 'update' }); if (!continueOnError) { break; } } } return createSuccessResponse({ success: successCount === updates.length, message: `Bulk update completed: ${successCount}/${updates.length} successful`, results, totalUpdates: updates.length, successfulUpdates: successCount, failedUpdates: updates.length - successCount }, 'bulkUpdateComponents') as BulkUpdateResponse; }, 'bulkUpdateComponents'); }
- src/mcp-server.ts:415-437 (schema)JSON Schema definition and registration of the bulkUpdateComponents tool in the MCP server tools list, used for listTools request.{ name: 'bulkUpdateComponents', description: 'Update multiple components in a single operation with validation and rollback support', inputSchema: { type: 'object', properties: { updates: { type: 'array', items: { type: 'object', properties: { componentPath: { type: 'string' }, properties: { type: 'object' } }, required: ['componentPath', 'properties'] } }, validateFirst: { type: 'boolean' }, continueOnError: { type: 'boolean' } }, required: ['updates'], }, },
- src/mcp-server.ts:755-758 (registration)MCP server CallToolRequestSchema handler registration that invokes the bulkUpdateComponents method on the AEMConnector instance.case 'bulkUpdateComponents': { const result = await aemConnector.bulkUpdateComponents(args); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }; }
- src/aem-connector-new.ts:140-142 (handler)Delegation handler in AEMConnector class that forwards bulkUpdateComponents calls to the ComponentOperations module.async bulkUpdateComponents(request: any) { return this.componentOps.bulkUpdateComponents(request); }
- src/mcp-handler.ts:155-169 (helper)Tool metadata listing in MCPRequestHandler's getAvailableMethods, providing description and parameters for bulkUpdateComponents.{ name: 'bulkUpdateComponents', description: 'Update multiple components in a single operation with validation and rollback support', parameters: ['updates', 'validateFirst', 'continueOnError'] }, { name: 'startWorkflow', description: 'Start a new workflow instance', parameters: ['model', 'payloadPath', 'title', 'comment'] }, { name: 'listActiveWorkflows', description: 'List all currently running workflow instances', parameters: ['limit'] }, { name: 'completeWorkflowStep', description: 'Complete a workflow step', parameters: ['workflowId', 'stepName', 'comment'] }, { name: 'cancelWorkflow', description: 'Cancel a workflow instance', parameters: ['workflowId', 'reason'] }, { name: 'suspendWorkflow', description: 'Suspend a workflow instance', parameters: ['workflowId', 'reason'] }, { name: 'resumeWorkflow', description: 'Resume a suspended workflow instance', parameters: ['workflowId'] }, { name: 'getWorkflowModels', description: 'Get all available workflow models', parameters: [] }, { name: 'getVersionHistory', description: 'Get version history for a content path', parameters: ['path'] }, { name: 'createVersion', description: 'Create a new version of content', parameters: ['path', 'label', 'comment'] }, { name: 'restoreVersion', description: 'Restore content to a specific version', parameters: ['path', 'versionName'] }, { name: 'compareVersions', description: 'Compare two versions of content', parameters: ['path', 'version1', 'version2'] }, { name: 'deleteVersion', description: 'Delete a specific version', parameters: ['path', 'versionName'] }, ]; }