Merge pull request #276630 from shellyhaverkamp/smh-worklist

Add worklist service

Author: v-dirichards

articles/healthcare-apis/dicom/dicomweb-standard-apis-with-dicom-services.md

@@ -1,32 +1,33 @@
 ---
-title:  Access DICOMweb APIs with the DICOM service in Azure Health Data Services
-description: Learn how to use the DICOMweb APIs to store, review, search, and delete DICOM objects with the DICOM service. The DICOM service also offers custom APIs for tracking changes and defining custom tags for DICOM data. 
+title:  Access DICOMweb APIs to manage DICOM data in Azure Health Data Services
+description: Learn how to use DICOMweb APIs to store, review, search, and delete DICOM objects. Learn how to use custom APIs to track changes and assign unique tags to DICOM data.
 author: mmitrik
 ms.service: healthcare-apis
 ms.subservice: dicom
 ms.topic: tutorial
-ms.date: 10/13/2022
+ms.date: 05/29/2024
 ms.author: mmitrik
 ---
 
-# Access DICOMweb APIs with the DICOM service
+# Access DICOMweb APIs to manage DICOM data
 
-The DICOM® service allows you to store, review, search, and delete DICOM objects by using a subset of DICOMweb APIs, which are web-based services that follow the DICOM standard. By using these APIs, you can access and manage your organization's DICOM data in the cloud without requiring complex protocols or formats.
+The DICOM® service allows you to store, review, search, and delete DICOM objects by using a subset of DICOMweb APIs. The DICOMweb APIs are web-based services that follow the DICOM standard. By using these APIs, you can access and manage your organization's DICOM data without requiring complex protocols or formats.
 
 The supported services are:
 
-* [Store (STOW-RS)](dicom-services-conformance-statement-v2.md#store-stow-rs): Upload DICOM objects to the server.
-* [Retrieve (WADO-RS)](dicom-services-conformance-statement-v2.md#retrieve-wado-rs): Download DICOM objects from the server.
-* [Search (QIDO-RS)](dicom-services-conformance-statement-v2.md#search-qido-rs): Find DICOM objects on the server based on criteria.
-* [Delete](dicom-services-conformance-statement-v2.md#delete): Remove DICOM objects from the server.
+- [Store (STOW-RS)](dicom-services-conformance-statement-v2.md#store-stow-rs): Upload DICOM objects to the server.
+- [Retrieve (WADO-RS)](dicom-services-conformance-statement-v2.md#retrieve-wado-rs): Download DICOM objects from the server.
+- [Search (QIDO-RS)](dicom-services-conformance-statement-v2.md#search-qido-rs): Find DICOM objects on the server based on criteria.
+- [Delete](dicom-services-conformance-statement-v2.md#delete): Remove DICOM objects from the server.
+- [Worklist Service (UPS Push and Pull SOPs)](dicom-services-conformance-statement-v2.md#worklist-service-ups-rs): Manage and track medical imaging workflows.
 
-In addition to the subset of DICOMweb APIs, the DICOM service supports two custom APIs that are unique to Microsoft:
+In addition to the subset of DICOMweb APIs, the DICOM service supports these custom APIs that are unique to Microsoft:
 
-* [Change feed](change-feed-overview.md): Track changes to DICOM data over time.
-* [Extended query tags](dicom-extended-query-tags-overview.md): Define custom tags for querying DICOM data.
-* [Bulk update](update-files.md)
-* [Bulk import](import-files.md)
-* [Export](export-dicom-files.md)
+- [Change feed](change-feed-overview.md): Track changes to DICOM data over time.
+- [Extended query tags](dicom-extended-query-tags-overview.md): Define custom tags for querying DICOM data.
+- [Bulk update](update-files.md)
+- [Bulk import](import-files.md)
+- [Export](export-dicom-files.md)
 
 ## Prerequisites
 
@@ -36,23 +37,23 @@ In addition to the subset of DICOMweb APIs, the DICOM service supports two custo
 
 ## Use REST API methods to interact with the DICOM service
 
-The DICOM service provides a web-based interface that follows REST (representational state transfer) principles. The REST API allows different applications or systems to communicate with each other using standard methods like GET, POST, PUT, and DELETE. Use any programming language that supports HTTP requests and responses to interact with the DICOM service.
+The DICOM service provides a web-based interface that follows REST (representational state transfer) principles. The REST API allows different applications or systems to communicate with each other using standard methods like GET, POST, PUT, and DELETE. To interact with the DICOM service, use any programming language that supports HTTP requests and responses.
 
-For language-specific examples, refer to the examples. You can view Postman collection examples in several languages including:
+Refer to the language-specific examples. You can view Postman collection examples in several languages including:
 
-* Go 
-* Java 
-* JavaScript 
-* C# 
-* PHP 
-* C 
-* NodeJS
-* Objective-C
-* OCaml
-* PowerShell
-* Python
-* Ruby 
-* Swift
+- Go 
+- Java 
+- JavaScript 
+- C# 
+- PHP 
+- C 
+- NodeJS
+- Objective-C
+- OCaml
+- PowerShell
+- Python
+- Ruby 
+- Swift
 
 ### C#
 
@@ -62,28 +63,30 @@ Refer to [Use DICOMweb Standard APIs with C#](dicomweb-standard-apis-c-sharp.md)
 
 cURL is a common command-line tool for calling web endpoints and is available for most operating systems. To get started, [download cURL](https://curl.haxx.se/download.html).
 
-To learn how to use cURL with DICOM service, see [Using DICOMWeb™ Standard APIs with cURL](dicomweb-standard-apis-curl.md) tutorial.
+To learn how to use cURL with the DICOM service, see [Using DICOMWeb™ Standard APIs with cURL](dicomweb-standard-apis-curl.md).
 
 ### Python
 
-Refer to the [Using DICOMWeb™ Standard APIs with Python](dicomweb-standard-apis-python.md) tutorial to learn how to use Python with the DICOM service.
+For more information about how to use Python with the DICOM service, see [Using DICOMWeb™ Standard APIs with Python](dicomweb-standard-apis-python.md).
 
 ### Postman
 
-Postman is an excellent tool for designing, building, and testing REST APIs. [Download Postman](https://www.postman.com/downloads/) to get started. Learn how to use Postman at the [Postman learning site](https://learning.postman.com/).
+Postman is an excellent tool for designing, building, and testing REST APIs. [Download Postman](https://www.postman.com/downloads/) to get started. For more information, see [Postman learning site](https://learning.postman.com/).
 
-One important caveat with Postman and the DICOMweb Standard is that Postman only supports uploading DICOM files using the single part payload defined in the DICOM standard. This reason is because Postman can't support custom separators in a multipart/related POST request. For more information, see [Multipart POST not working for me # 576](https://github.com/postmanlabs/postman-app-support/issues/576). All examples in the Postman collection for uploading DICOM documents using a multipart request are prefixed with **[won't work - see description]**. The examples for uploading using a single-part request are included in the collection and are prefixed with **Store-Single-Instance**.
+One important caveat with Postman and the DICOMweb standard is that Postman only supports uploading DICOM files by using the single-part payload defined in the DICOM standard. This caveat is because Postman can't support custom separators in a multipart/related POST request. For more information, see [Multipart POST not working for me # 576](https://github.com/postmanlabs/postman-app-support/issues/576). All examples in the Postman collection for uploading DICOM documents by using a multipart request are prefixed with **[won't work - see description]**. The examples for uploading by using a single-part request are included in the collection and are prefixed with **Store-Single-Instance**.
 
-To use the Postman collection, you need to download the collection locally and import the collection through Postman. To access this collection, see [Postman Collection Examples](https://github.com/microsoft/dicom-server/blob/main/docs/resources/Conformance-as-Postman.postman_collection.json).
+To use the Postman collection, download it locally and then import the collection through Postman. To access the collection, see [Postman Collection Examples](https://github.com/microsoft/dicom-server/blob/main/docs/resources/Conformance-as-Postman.postman_collection.json).
 
 ### Next steps
-Check out these examples of how to use the APIs:
 
-- [Using DICOMweb™ Standard APIs with C#](dicomweb-standard-apis-c-sharp.md)
-- [Using DICOMWeb™ Standard APIs with cURL](dicomweb-standard-apis-curl.md)
-- [Using DICOMWeb™ Standard APIs with Python](dicomweb-standard-apis-python.md)
-- [Use DICOMWeb™ Standard APIs with the Postman Example Collection](https://github.com/microsoft/dicom-server/blob/main/docs/resources/Conformance-as-Postman.postman_collection.json)
+[Use DICOMweb Standard APIs with C#](dicomweb-standard-apis-c-sharp.md)
 
-Learn more about Microsoft support for DICOM Web Standard APIs in the [DICOM Conformance Statement](dicom-services-conformance-statement-v2.md).
+[Use DICOMweb Standard APIs with cURL](dicomweb-standard-apis-curl.md)
+
+[Use DICOMweb Standard APIs with Python](dicomweb-standard-apis-python.md)
+
+[Use DICOMWeb Standard APIs with the Postman Example Collection](https://github.com/microsoft/dicom-server/blob/main/docs/resources/Conformance-as-Postman.postman_collection.json)
+
+[DICOM Conformance Statement](dicom-services-conformance-statement-v2.md)
 
 [!INCLUDE [DICOM trademark statement](../includes/healthcare-apis-dicom-trademark.md)]

articles/healthcare-apis/dicom/toc.yml

@@ -24,8 +24,8 @@ items:
     - name: Register a client application
       href: dicom-register-application.md
 - name: Tutorials
-  expanded: true
-  items: 
+  expanded: false
+  items:
     - name: Use DICOM data in analytics workloads
       href: get-started-with-analytics-dicom.md
     - name: Use the DICOM service for digital pathology