Differente between AppendAddOp and AppendReplaceOp

Gökhan Kurt 106

Azure.DigitalTwins.Core.Serialization.UpdateOperationsUtility contains two methods

AppendAddOp and AppendReplaceOp.

As far as i see Add behaves exactly like Replace

Add method you would expect it to add the path as well as value but it will probably not do that if the path is not already defined in the metadata.
Then the question is what is the difference.
By the way I am expecting both to generate a Microsoft.DigitalTwins.Twin.Update event but seems like Replace is not

AshokPeddakotla-MSFT 34,701 Reputation points

2020-11-11T09:58:15.227+00:00

@Gökhan Kurt Thanks for reaching out to us!

I am enquiring at the moment and will update you with my findings as earliest. appreciate your time and patience.
QuantumCache 20,271 Reputation points

2020-11-12T03:02:19.477+00:00

Hello @Gökhan Kurt we are working on this, please stay tuned.
Kurt, Gökhan 1 Reputation point

2021-01-14T13:20:38.807+00:00

So we have a modal of a sensor as below (not complete). Then I am updating the values once using add and once using replace in JsonPatch but not seeing any difference between the two in the digital twin. Both working and replacing the values of properties. Then my question what is the difference of using add vs replace in this scenario? And why would you allow add operation at all if you have the schema already in place? Or allow add to have values if it is only about adding new properties to the schema?

1 answer

QuantumCache 20,271 Reputation points

2020-11-12T19:04:51.567+00:00

Hello @Gökhan Kurt

Below is the response from Microsoft Product Team on your query.

You might be using the preview SDK version.

It is the difference between adding a new property to a twin, and replacing the current property value on a twin.

For GA, the new helper class is JsonPatchDocument instead: Docs/.NET API Browser/Microsoft.AspNetCore.JsonPatch/JsonPatchDocument

Please let us know if you need further help in this matter.

Thank you,
Satish
Please sign in to rate this answer.
QuantumCache 20,271 Reputation points

2020-11-25T00:23:26.013+00:00

Hello @Gökhan Kurt , Just checking back, could you please let us know if you need further help in this matter.

Gökhan Kurt 106 Reputation points

2020-11-25T07:42:27.187+00:00

Wouldn't add cause the modal of the node to change? If you add value of a new property that does not exist in the schema.

QuantumCache 20,271 Reputation points

2020-11-25T19:53:18.91+00:00

Hello @Gökhan Kurt , I didn't really catch that question, could you please elaborate on your question a little bit more?

Kurt, Gökhan 1 Reputation point

2021-01-14T13:23:23.467+00:00

So we have a modal of a sensor as below (not complete). Then I am updating the values once using add and once using replace in JsonPatch but not seeing any difference between the two in the digital twin. Both working and replacing the values of properties. Then my question what is the difference of using add vs replace in this scenario? And why would you allow add operation at all if you have the schema already in place? Or allow add to have values if it is only about adding new properties to the schema?

Kurt, Gökhan 1 Reputation point

2021-01-14T13:23:44.467+00:00

Schema:
{
'@id': 'dtmi:Sensor;1',
'contents': [
{'@type ': 'Property','name': 'numericValue'},
{'@type ': 'Property','name': 'updateTimeStamp'}
]
}

Kurt, Gökhan 1 Reputation point

2021-01-14T13:23:58.613+00:00

patch for add
{[ {'op':'add','path':'/numericValue','value':62.8547},
{'op':'add','path':'/updateTimeStamp','value':'2021-01-13T13:10:31'}]
}
patch for replace
{[ {'op':'replace','path':'/numericValue','value':612.8134},
{'op':'replace','path':'/updateTimeStamp','value':'2021-01-13T13:11:32'}
]
}
Sign in to comment

Use comments to ask for clarification, additional information, or improvements to the question.

Share via

Differente between AppendAddOp and AppendReplaceOp

1 answer

Your answer