Provides APIs to refactor XWiki entities

Description

This module provides APIs to perform various refactoring operations, such as move, copy, rename, delete, that target XWiki Entities. Since most of these operations can take a long time (e.g. renaming a space with lots of documents in it) they have been implemented as jobs that run in background threads for which we can monitor the process.

Script Service

• Copy a Space
  #set ($source = $services.model.resolveSpace('Path.To.Source'))
  #set ($destination = $services.model.resolveSpace('Path.To.New.Parent'))
  $services.refactoring.copy($source, $destination).join()
• Copy a Space As
  #set ($source = $services.model.resolveSpace('Path.To.Source'))
  #set ($destination = $services.model.resolveSpace('Path.To.New.Name'))
  $services.refactoring.copyAs($source, $destination).join()
• Move a Space
  #set ($source = $services.model.resolveSpace('Path.To.Source'))
  #set ($destination = $services.model.resolveSpace('Path.To.New.Parent'))
  $services.refactoring.move($source, $destination).join()
• Move a Document
  #set ($source = $services.model.resolveDocument('Path.To.Source.WebHome'))
  #set ($destination = $services.model.resolveSpace('Path.To.New.Parent'))
  $services.refactoring.move($source, $destination).join()
• Rename a Space
  #set ($source = $services.model.resolveSpace('Path.To.Source'))
  $services.refactoring.rename($source, 'NewName').join()
• Rename a Document
  #set ($source = $services.model.resolveDocument('Path.To.Source.WebHome'))
  $services.refactoring.rename($source, 'NewName').join()
• Delete a Document
  #set ($source = $services.model.resolveDocument('Path.To.Source.WebHome'))
  $services.refactoring.delete($source).join()
• Delete a Space
  #set ($source = $services.model.resolveSpace('Path.To.Source'))
  $services.refactoring.delete($source).join()
• Convert a Terminal Document to a Nested Document
  #set ($source = $services.model.resolveDocument('Path.To.Page'))
  $services.refactoring.convertToNestedDocument($source).join()
• Convert a Nested Document to a Terminal Document
  #set ($source = $services.model.resolveDocument('Path.To.Source.WebHome'))
  $services.refactoring.convertToTerminalDocument($source).join()