SplatDev.Umbraco.Plugins.CopyValue
2.2.1
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package SplatDev.Umbraco.Plugins.CopyValue --version 2.2.1
NuGet\Install-Package SplatDev.Umbraco.Plugins.CopyValue -Version 2.2.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SplatDev.Umbraco.Plugins.CopyValue" Version="2.2.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SplatDev.Umbraco.Plugins.CopyValue" Version="2.2.1" />
<PackageReference Include="SplatDev.Umbraco.Plugins.CopyValue" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SplatDev.Umbraco.Plugins.CopyValue --version 2.2.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: SplatDev.Umbraco.Plugins.CopyValue, 2.2.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SplatDev.Umbraco.Plugins.CopyValue@2.2.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SplatDev.Umbraco.Plugins.CopyValue&version=2.2.1
#tool nuget:?package=SplatDev.Umbraco.Plugins.CopyValue&version=2.2.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
UmbracoCms.Plugins.CopyValue
Copy property values between Umbraco content nodes — bulk copy, property mapping between different document types, with reusable mapping templates.
Supports
- Umbraco 13 (net8.0)
- Umbraco 17 (net10.0)
Features
- Define reusable mapping templates (stored in EF Core
copyvalueschema) - Map properties between same or different document types
- Execute single-pair or bulk copy operations via the backoffice or REST API
- Optional publish-after-copy support
- Lit 3 dashboard for Umbraco 17, AngularJS dashboard for Umbraco 13
CopyValueViewComponentfor rendering mapping templates in Razor views
Installation
Add the NuGet package. The CopyValueComposer registers CopyValueDbContext and ICopyValueService.
Run EF Core migrations:
dotnet ef migrations add InitialCopyValue --context CopyValueDbContext
dotnet ef database update --context CopyValueDbContext
Usage in Code
// Direct property copy with explicit mappings
var mappings = new[]
{
new PropertyMapping { Source = "pageTitle", Target = "headline" },
new PropertyMapping { Source = "bodyText", Target = "content" },
};
await _copyValueService.CopyPropertiesAsync(sourceId, targetId, mappings, publish: true);
// Bulk copy using a saved template
var pairs = new[] { (sourceId1, targetId1), (sourceId2, targetId2) };
int count = await _copyValueService.BulkCopyAsync(mappingId, pairs, publish: false);
REST API
| Method | Endpoint | Description |
|---|---|---|
| GET | /umbraco/api/copyvalue/GetMappings |
List all mapping templates |
| GET | /umbraco/api/copyvalue/GetMapping?id=1 |
Get a single mapping |
| POST | /umbraco/api/copyvalue/SaveMapping |
Create or update a mapping |
| DELETE | /umbraco/api/copyvalue/DeleteMapping?id=1 |
Delete a mapping |
| POST | /umbraco/api/copyvalue/CopyProperties |
Execute a single copy operation |
| POST | /umbraco/api/copyvalue/BulkCopy |
Execute a bulk copy using a template |
CopyProperties request body
{
"sourceContentId": 1234,
"targetContentId": 5678,
"mappings": [
{ "source": "pageTitle", "target": "headline" }
],
"publish": false
}
BulkCopy request body
{
"mappingId": 1,
"pairs": [
{ "sourceId": 1234, "targetId": 5678 },
{ "sourceId": 1235, "targetId": 5679 }
],
"publish": false
}
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- Microsoft.EntityFrameworkCore.Design (>= 10.0.7)
- Microsoft.EntityFrameworkCore.SqlServer (>= 10.0.7)
- Microsoft.Extensions.FileProviders.Embedded (>= 10.0.6)
- Umbraco.Cms.Core (>= 17.3.4)
- Umbraco.Cms.Web.Common (>= 17.3.4)
-
net8.0
- Microsoft.EntityFrameworkCore.Design (>= 8.0.20)
- Microsoft.EntityFrameworkCore.SqlServer (>= 8.0.20)
- Umbraco.Cms.Core (>= 13.12.0)
- Umbraco.Cms.Web.Common (>= 13.12.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.