You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/healthcare-apis/dicom/change-feed-overview.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,17 +1,17 @@
1
1
---
2
-
title: Overview of DICOM change feed - Azure Health Data Services
3
-
description: In this article, you learn the concepts of DICOM change feed.
2
+
title: Change feed overview for the DICOM service in Azure Health Data Services
3
+
description: Learn how to use the change feed in the DICOM service to access the logs of all the changes that occur in your organization's medical imaging data. The change feed allows you to query, process, and act upon the change events in a scalable and efficient way.
4
4
author: mmitrik
5
5
ms.service: healthcare-apis
6
6
ms.subservice: dicom
7
7
ms.topic: conceptual
8
-
ms.date: 10/9/2023
8
+
ms.date: 1/18/2024
9
9
ms.author: mmitrik
10
10
---
11
11
12
12
# Change feed overview
13
13
14
-
The change feed provides logs of all the changes that occur in the DICOM® service. The change feed provides ordered, guaranteed, immutable, and read-only logs of these changes. The change feed offers the ability to go through the history of DICOM service and acts upon the creates and deletes in the service.
14
+
The change feed provides logs of all the changes that occur in the DICOM® service. The change feed provides ordered, guaranteed, immutable, and read-only logs of these changes. The change feed offers the ability to go through the history of DICOM service and acts upon the creates, updates, and deletes in the service.
15
15
16
16
Client applications can read these logs at any time in batches of any size. The change feed enables you to build efficient and scalable solutions that process change events that occur in your DICOM service.
17
17
@@ -38,7 +38,7 @@ Sequence | long | The unique ID per change event
38
38
StudyInstanceUid | string | The study instance UID
39
39
SeriesInstanceUid | string | The series instance UID
40
40
SopInstanceUid | string | The sop instance UID
41
-
Action | string | The action that was performed - either `create` or `delete`
41
+
Action | string | The action that was performed - either `create`, `update`, or `delete`
42
42
Timestamp | datetime | The date and time the action was performed in UTC
43
43
State | string | [The current state of the metadata](#states)
44
44
Metadata | object | Optionally, the current DICOM metadata if the instance exists
@@ -48,12 +48,12 @@ Metadata | object | Optionally, the current DICOM metadata if the
48
48
State | Description
49
49
:------- | :---
50
50
current | This instance is the current version.
51
-
replaced | This instance has been replaced by a new version.
52
-
deleted | This instance has been deleted and is no longer available in the service.
51
+
replaced | This instance is replaced with a new version.
52
+
deleted | This instance is deleted and is no longer available in the service.
53
53
54
54
## Change feed
55
55
56
-
The change feed resource is a collection of events that have occurred within the DICOM server.
56
+
The change feed resource is a collection of events that occurred within the DICOM server.
57
57
58
58
### Version 2
59
59
@@ -152,7 +152,7 @@ limit | int | The maximum value of the sequence number relative t
152
152
includeMetadata | bool | Indicates whether or not to include the DICOM metadata | `true` | | |
153
153
154
154
## Latest change feed
155
-
The latest change feed resource represents the latest event that has occurred within the DICOM Server.
155
+
The latest change feed resource represents the latest event that occurred within the DICOM server.
@@ -208,15 +208,15 @@ includeMetadata | bool | Indicates whether or not to include the metadata | `tru
208
208
2. On some regular polling interval, the application performs the following actions:
209
209
* Fetches the latest sequence number from the `/changefeed/latest` endpoint
210
210
* Fetches the next set of changes for processing by querying the change feed with the current offset
211
-
* For example, if the application has currently processed up to sequence number 15 and it only wants to process at most 5 events at once, then it should use the URL `/changefeed?offset=15&limit=5`
211
+
* For example, if the application processed up to sequence number 15 and it only wants to process at most five events at once, then it should use the URL `/changefeed?offset=15&limit=5`
212
212
* Processes any entries return by the `/changefeed` resource
213
213
* Updates its current sequence number to either:
214
214
1. The maximum sequence number returned by the `/changefeed` resource
215
215
2. The `offset` + `limit` if no change events were returned from the `/changefeed` resource, but the latest sequence number returned by `/changefeed/latest` is greater than the current sequence number used for `offset`
216
216
217
217
### Other potential usage patterns
218
218
219
-
Change feed support is wellsuited for scenarios that process data based on objects that have changed. For example, it can be used to:
219
+
Change feed support is well-suited for scenarios that process data based on objects that are changed. For example, it can be used to:
220
220
221
221
* Build connected application pipelines like ML that react to change events or schedule executions based on created or deleted instance.
222
222
* Extract business analytics insights and metrics, based on changes that occur to your objects.
0 commit comments