Merge pull request #286728 from KendalBond007/FHIReditsBatch14_Sep24

FHIReditsBatch14_Sep24

Author: prmerger-automator[bot]

articles/healthcare-apis/fhir/use-postman.md

@@ -47,8 +47,8 @@ To access the FHIR service, you need to create or update these variables:
 |--------------|-----------------|----------|
 | **tenantid** | Azure tenant where the FHIR service is deployed | Located on the Application registration overview |
 | **subid** | Azure subscription where the FHIR service is deployed | Located on the FHIR service overview |
-| **clientid** | Application client registration ID | - |
-| **clientsecret** | Application client registration secret | - |
+| **clientid** | Application client registration ID | |
+| **clientsecret** | Application client registration secret | |
 | **fhirurl** | The FHIR service full URL (for example, `https://xxx.azurehealthcareapis.com`) | Located on the FHIR service overview |
 | **bearerToken** | Stores the Microsoft Entra access token in the script | Leave blank |
 
@@ -59,7 +59,7 @@ To access the FHIR service, you need to create or update these variables:
 
 ## Get the capability statement
 
-Enter `{{fhirurl}}/metadata` in the `GET`request, and then choose `Send`. You should see the capability statement of the FHIR service.
+Enter `{{fhirurl}}/metadata` in the `GET` request, then choose `Send`. You should see the capability statement of the FHIR service.
 
 :::image type="content" source="media/postman/postman-capability-statement.png" alt-text="Screenshot showing capability request parameters." lightbox="media/postman/postman-create-new-request.png":::
 
@@ -69,7 +69,7 @@ Enter `{{fhirurl}}/metadata` in the `GET`request, and then choose `Send`. You sh
 
 ## Get a Microsoft Entra access token
 
-Get a Microsoft Entra access token by using a service principal or a Microsoft Entra user account. Choose one of the two methods.
+Get a Microsoft Entra access token by choosing either a service principal, or a Microsoft Entra user account.
 
 ### Use a service principal with a client credential grant type
 
@@ -89,9 +89,9 @@ Create a new `POST` request:
 > [!NOTE]
 > In scenarios where the FHIR service audience parameter isn't mapped to the FHIR service endpoint URL, the resource parameter value should be mapped to the audience value on the FHIR service **Authentication** pane.
 
-3. Select the **Test** tab and enter in the text section: `pm.environment.set("bearerToken", pm.response.json().access_token);` To make the value available to the collection, use the pm.collectionVariables.set method. For more information on the set method and its scope level, see [Using variables in scripts](https://learning.postman.com/docs/sending-requests/variables/#defining-variables-in-scripts).
+3. Select the **Test** tab and enter `pm.environment.set("bearerToken", pm.response.json().access_token);` in the text section. To make the value available to the collection, use the pm.collectionVariables.set method. For more information on the set method and its scope level, see [Using variables in scripts](https://learning.postman.com/docs/sending-requests/variables/#defining-variables-in-scripts).
 4. Select **Save** to save the settings.
-5. Select **Send**. You should see a response with the Microsoft Entra access token, which is saved to the variable `bearerToken` automatically. You can then use it in all FHIR service API requests.
+5. Select **Send**. You should see a response with the Microsoft Entra access token, which is automatically saved to the variable `bearerToken`. You can then use it in all FHIR service API requests.
 
 :::image type="content" source="media/postman/postman-send-button.png" alt-text="Screenshot showing the send button." lightbox="media/postman/postman-send-button.png":::
 
@@ -101,7 +101,7 @@ You can examine the access token using online tools such as [https://jwt.ms](htt
 
 ## Use a user account with the authorization code grant type
 
-You can get the Microsoft Entra access token by using your Entra account credentials and following the listed steps.
+You can get the Microsoft Entra access token by using your Microsoft Entra account credentials and following the listed steps.
 
 1. Verify that you're a member of Microsoft Entra tenant with the required access permissions.
 
@@ -115,7 +115,7 @@ You can get the Microsoft Entra access token by using your Entra account credent
 
    :::image type="content" source="media/postman/app-registration-permissions-2.png" alt-text="Screenshot showing application registration permissions screen." lightbox="media/postman/app-registration-permissions-2.png":::
 
-1. In the Postman, select the **Authorization** tab of either a collection or a specific REST Call, select **Type** as OAuth 2.0 and under **Configure New Token** section, set these values: 
+1. In Postman, select the **Authorization** tab of either a collection or a specific REST Call, select **Type** as OAuth 2.0 and under **Configure New Token** section, set these values: 
     - **Callback URL**: `https://oauth.pstmn.io/v1/callback`
 
     - **Auth URL**: `https://login.microsoftonline.com/{{tenantid}}/oauth2/v2.0/authorize`
@@ -134,9 +134,9 @@ You can get the Microsoft Entra access token by using your Entra account credent
 
 1. Choose **Get New Access Token** at the bottom of the page.
 
-1. You're asked for User credentials for sign-in.
+1. Provide User credentials for sign-in.
 
-1. You receive the token. Choose **Use Token.**
+1. Once you receive the token, choose **Use Token.**
 
 1. Ensure the token is in the **Authorization Header** of the REST call.
 
@@ -148,7 +148,7 @@ Open Postman, select the **workspace**, **collection**, and **environment** you
 
 :::image type="content" source="media/postman/postman-create-new-request.png" alt-text="Screenshot showing creation of new request." lightbox="media/postman/postman-create-new-request.png":::
 
-To perform health check on FHIR service, enter `{{fhirurl}}/health/check` in the GET request, and then choose **Send**. You should be able to see the `Status of FHIR service - HTTP Status` code response with 200 and OverallStatus as **Healthy** in response, which means your health check is successful.
+To perform a health check on the FHIR service, enter `{{fhirurl}}/health/check` in the GET request, and then choose **Send**. You should be able to see the `Status of FHIR service - HTTP Status` code response with 200 and OverallStatus as **Healthy** in response, which means your health check is successful.
 
 ## Get the FHIR resource
 
@@ -162,11 +162,11 @@ Select **Bearer Token** as authorization type. Enter `{{bearerToken}}` in the **
 
 After you obtain a Microsoft Entra access token, you can create or update the FHIR data. For example, you can create a new patient or update an existing patient.
 
-Create a new request, change the method to **Post**, and then enter the value in the request section.
+Create a new request, change the method to **Post**, and enter the value in the request section.
 
 `{{fhirurl}}/Patient`
 
-Select **Bearer Token** as the authorization type. Enter `{{bearerToken}}` in the **Token** section. Select the **Body** tab. Select the **raw** option and **JSON** as body text format. Copy and paste the text to the body section. 
+Select **Bearer Token** as the authorization type. Enter `{{bearerToken}}` in the **Token** section. Select the **Body** tab. Select the **raw** option and **JSON** as body text format. Copy and paste the following text to the body section. 
 
 
 ```
@@ -211,7 +211,7 @@ Select **Bearer Token** as authorization type. Enter `{{bearerToken}}` in the **
 
 - **Prefer**:  `respond-async`
 
-Select **Send**. You should notice a `202 Accepted` response. Select the **Headers** tab of the response and make a note of the value in the **Content-Location**. You can use the value to query the export job status.
+Select **Send**. You should notice a `202 Accepted` response. Select the **Headers** tab of the response and make a note of the value in the **Content-Location**. You can use this value to query the export job status.
 
 :::image type="content" source="media/postman/postman-202-accepted-response.png" alt-text="Screenshot showing selection 202 accepted response." lightbox="media/postman/postman-202-accepted-response.png":::
 

articles/healthcare-apis/fhir/using-curl.md

@@ -11,22 +11,22 @@ ms.author: kesheth
 
 # Access the Azure Health Data Services with cURL
 
-In this article, you'll learn how to access Azure Health Data Services with cURL.
+In this article, you learn how to access Azure Health Data Services with cURL.
 
 ## Prerequisites
 
 ### PowerShell
 
 * An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/free/).
-* If you want to run the code locally, install [PowerShell](/powershell/module/powershellget/) and [Azure Az PowerShell](/powershell/azure/install-azure-powershell).
+* If you want to run the code locally, install [PowerShell](/powershell/module/powershellget/) and [Azure Az PowerShell module PowerShell](/powershell/azure/install-azure-powershell).
 * Optionally, you can run the scripts in Visual Studio Code with the REST Client extension. For more information, see [Make a link to the REST Client doc](using-rest-client.md).
 * Download and install [cURL](https://curl.se/download.html).
 
 ### CLI
 
 * An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/free/).
 * If you want to run the code locally, install [Azure CLI](/cli/azure/install-azure-cli). 
-* Optionally, install a Bash shell, such as Git Bash, which it's included in [Git for Windows](https://gitforwindows.org/).
+* Optionally, install a Bash shell, such as Git Bash, which is included in [Git for Windows](https://gitforwindows.org/).
 * Optionally, run the scripts in Visual Studio Code with the REST Client extension. For more information, see [Make a link to the REST Client doc](using-rest-client.md).
 * Download and install [cURL](https://curl.se/download.html).
 
@@ -78,7 +78,7 @@ token=$(az account get-access-token --resource=$dicomtokenurl --query accessToke
 
 ---
 > [!NOTE] 
-> In the scenarios where the FHIR service audience parameter is not mapped to the FHIR service endpoint url. The resource parameter value should be mapped to Audience value under FHIR Service Authentication blade.
+> When the FHIR® service audience parameter is not mapped to the FHIR service endpoint url, the resource parameter value should be mapped to Audience value under the FHIR Service Authentication blade.
 
 ## Access data in the FHIR service
 
@@ -127,4 +127,4 @@ To learn about how to access Azure Health Data Services data using REST Client e
 >[!div class="nextstepaction"]
 >[Access Azure Health Data Services using REST Client](using-rest-client.md)
 
-FHIR® is a registered trademark of [HL7](https://hl7.org/fhir/) and is used with the permission of HL7.
+[!INCLUDE [FHIR trademark statement](../includes/healthcare-apis-fhir-trademark.md)]

articles/healthcare-apis/fhir/using-rest-client.md

@@ -11,28 +11,28 @@ ms.author: kesheth
 
 # Accessing Azure Health Data Services using the REST Client Extension in Visual Studio Code
 
-In this article, you'll learn how to access Azure Health Data Services using [REST Client extension in Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=humao.rest-client).
+In this article, you learn how to access Azure Health Data Services using [REST Client extension in Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=humao.rest-client).
 
 ## Install REST Client extension
 
 Select the Extensions icon on the left side panel of your Visual Studio Code, and search for "REST Client". Find the [REST Client extension](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) and install.
 
-[ ![REST Client VSCode extension](media/rest-install.png) ](media/rest-install.png#lightbox)
+[![REST Client VSCode extension](media/rest-install.png)](media/rest-install.png#lightbox)
 
 ## Create a `.http` file and define variables
 
 Create a new file in Visual Studio Code. Enter a `GET` request command line in the file, and save it as `test.http`. The file suffix `.http` automatically activates the REST Client environment. Select `Send Request` to get the metadata. 
 
-[ ![Send Request](media/rest-send-request.png) ](media/rest-send-request.png#lightbox)
+[![Send Request](media/rest-send-request.png)](media/rest-send-request.png#lightbox)
 
 ## Get client application values
 
 > [!Important]
-> Before calling the FHIR server REST API (other than getting the metadata), you must complete [application registration](../register-application.md). Make a note of your Azure **tenant ID**, **client ID**, **client secret** and the **service URL**.
+> Before calling the FHIR® server REST API (other than getting the metadata), you must complete [application registration](../register-application.md). Make a note of your Azure **tenant ID**, **client ID**, **client secret** and the **service URL**.
 
 While you can use values such as the client ID directly in calls to the REST API, it's a good practice that you define a few variables for these values and use the variables instead.
 
-In your `test.http` file, include the following information obtained from registering your application: 
+In your `test.http` file, include the following information obtained from registering your application. 
 
 ```
 ### REST Client
@@ -46,7 +46,7 @@ In your `test.http` file, include the following information obtained from regist
 
 ## Get Microsoft Entra access token
 
-After including the information below in your `test.http` file, hit `Send Request`. You'll see an HTTP response that contains your access token.
+After including the following information in your `test.http` file, hit `Send Request`. You'll see an HTTP response that contains your access token.
 
 The line starting with `@name` contains a variable that captures the HTTP response containing the access token. The variable, `@token`, is used to store the access token.
 
@@ -72,11 +72,11 @@ grant_type=client_credentials
 [ ![Get access token](media/rest-config.png) ](media/rest-config.png#lightbox)
 
 > [!NOTE] 
-> In the scenarios where the FHIR service audience parameter is not mapped to the FHIR service endpoint url. The resource parameter value should be mapped to Audience value under FHIR Service Authentication blade.
+> When the FHIR service audience parameter is not mapped to the FHIR service endpoint url, the resource parameter value should be mapped to the Audience value under the FHIR Service Authentication blade.
 
-## `GET` FHIR Patient data
+## Get FHIR Patient data
 
-You can now get a list of patients or a specific patient with the `GET` request. The line with `Authorization` is the header info for the `GET` request. You can also send `PUT` or `POST` requests to create/update FHIR resources.
+You can now get a list of patients or a specific patient with the `GET` request. The line with `Authorization` is the header info for the `GET` request. You can also send `PUT` or `POST` requests to create and update FHIR resources.
 
 ```
 ### GET Patient 
@@ -98,19 +98,20 @@ You can run PowerShell or CLI scripts within Visual Studio Code. Press `CTRL` an
 
 ## Troubleshooting
 
-If you're unable to get the metadata, which doesn't require access token based on the HL7 specification, check that your FHIR server is running properly.
+If you're unable to get the metadata (which doesn't require access token based on the HL7 specification) check that your FHIR server is running properly.
 
 If you're unable to get an access token, make sure that the client application is registered properly and you're using the correct values from the application registration step.
 
 If you're unable to get data from the FHIR server, make sure that the client application (or the service principal) has been granted access permissions such as "FHIR Data Contributor" to the FHIR server.
 
 ## Next steps
 
-In this article, you learned how to access Azure Health Data Services data using the using the REST Client extension in Visual Studio Code.
+In this article, you learned how to access Azure Health Data Services data using the REST Client extension in Visual Studio Code.
 
 To learn about how to validate FHIR resources against profiles in Azure Health Data Services, see 
 
 >[!div class="nextstepaction"]
 >[Validate FHIR resources against profiles in Azure Health Data Services](validation-against-profiles.md)
 
-FHIR® is a registered trademark of [HL7](https://hl7.org/fhir/) and is used with the permission of HL7.
+[!INCLUDE [FHIR trademark statement](../includes/healthcare-apis-fhir-trademark.md)]
+