Move or update data between entities

Prev Next
Post
/v1/LogicalEntityData/e2e/movedata

Performs a data move/update operation based on the provided mapping, optional filters, and transformation expressions.

Use this endpoint to:

  • Copy fields from a source entity to a target entity.
  • Apply transformations, for example, arithmetic or supported SQL functions.
  • Limit which records are affected by using OData-style filters.
Security
API Key: Authorization
Header parameter nameAuthorization

Add an Authorization header to authenticate requests originating outside of Zilliant's internal network. Set the header to Authorization: OAuth <tokenResponseBase64>.

<tokenResponseBase64> is the Base64-encoded entire JSON response body returned by the Salesforce OAuth token endpoint. Encode the full JSON payload, not only the access_token field.

For details, read Request an access token.

Header parameters
X-Forwarded-Host
string

OAuth host for your environment. Use it for all requests that originate outside Zilliant’s internal network. For details, read X-Forwarded-Host header in Introduction.

Body parameters
Increase ListPrice for National brand

Increase ListPrice by 10% for National brand products.

{
  "name": "User Update in Price List Maintenance - Brand Adjustments",
  "mode": "update",
  "sourceEntity": "Product",
  "targetEntity": "Product",
  "filters": [
    {
      "filterName": "filter",
      "filterExpression": "Brand eq 'National'"
    }
  ],
  "fields": [
    {
      "sourceEntityField": "ProductId",
      "targetEntityField": "ProductId"
    },
    {
      "sourceDefinition": "{ListPrice} * 1.1",
      "targetEntityField": "ListPrice"
    }
  ]
}
Increase ListPrice and Cost for National brand

Increase ListPrice by 10% and StandardCost by 5% for National brand products.

{
  "name": "User Update in Price List Maintenance - Brand Adjustments",
  "mode": "update",
  "sourceEntity": "Product",
  "targetEntity": "Product",
  "filters": [
    {
      "filterName": "filter",
      "filterExpression": "Brand eq 'National'"
    }
  ],
  "fields": [
    {
      "sourceEntityField": "ProductId",
      "targetEntityField": "ProductId"
    },
    {
      "sourceDefinition": "{ListPrice} * 1.1",
      "targetEntityField": "ListPrice"
    },
    {
      "sourceDefinition": "{StandardCost} * 1.05",
      "targetEntityField": "StandardCost"
    }
  ]
}
Increase StandardCost for National brand

Increase StandardCost by 5% for National brand products.

{
  "name": "User Update in Price List Maintenance - Brand Adjustments",
  "mode": "update",
  "sourceEntity": "Product",
  "targetEntity": "Product",
  "filters": [
    {
      "filterName": "filter",
      "filterExpression": "Brand eq 'National'"
    }
  ],
  "fields": [
    {
      "sourceEntityField": "ProductId",
      "targetEntityField": "ProductId"
    },
    {
      "sourceDefinition": "{StandardCost} * 1.05",
      "targetEntityField": "StandardCost"
    }
  ]
}
object

Describes how to copy and/or update data from a source entity to a target entity, optionally constrained by filters and with optional transformations.

name
string Required

User-friendly name for this move or update operation.

ExampleUser Update in Price List Maintenance - Brand Adjustments
mode
string Required

Mode of copying or updating data.

Valid values[ "insert", "update", "upsert", "delete", "refresh" ]
Exampleupdate
sourceEntity
string Required

System name of the source entity where values are read from.

ExampleProduct
targetEntity
string Required

System name of the target entity where values are written.

ExampleProduct
filters
Array of object

Array containing a single object that defines a filter.

Min items0
Max items1
object
filterName
string Required

Must always be filter.

Valid values[ "filter" ]
Examplefilter
filterExpression
string Required

OData filter expression in the format fieldSystemName operator fieldValue.

Supported operators:

  • eq—Equal
  • ne—Not equal
  • lt—Less than
  • le—Less than or equal
  • gt—Greater than
  • ge—Greater than or equal
  • and—Logical AND
  • or—Logical OR
* wildcard is allowed with eq and ne. Literal null is allowed with eq and ne.
ExampleBrand eq 'National'
fields
Array Required

Field-mapping objects that specify which source fields are copied to which target fields, with optional value transformations. Each object must be one of:

  • To copy a field as-is, use the sourceEntityField and targetEntityField parameters
  • To copy a field with transformations, use the sourceDefinition and targetEntityField parameters
Min items1
OneOf
Copy as is
object (Copy as is)
sourceEntityField
string Required

System name of the source field to copy.

ExampleProductId
targetEntityField
string Required

System name of the target field to receive the copied value.

ExampleProductId
Transform and copy
object (Transform and copy)
sourceDefinition
string Required

Transformation expression. Use the parameter to reference source fields and apply arithmetic (+, -, *, /, parentheses) and supported SQL constructs: CASE, and functions AVG, CAST, CEILING, COALESCE, CONVERT, COUNT, COUNT(DISTINCT ...), DATEDIFF, DATEADD, FORMAT, GETDATE, ISNULL, MAX, NULLIF, ROUND, SUM.

Example{ListPrice} * 1.10
targetEntityField
string Required

System name of the target field to receive the transformed value.

ExampleListPrice
Responses
200

Data movement completed successfully. Returns a JSON log of results.

400

Not suitable parameters received.

500

Service failed to process request.