Skip to content

Commit 9a9b805

Browse files
committed
fix removed file
1 parent 0a37a9d commit 9a9b805

18 files changed

+116
-117
lines changed

articles/cognitive-services/QnAMaker/Concepts/best-practices.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ The [knowledge base development lifecycle](../Concepts/development-lifecycle-kno
1919

2020
## Extraction
2121

22-
The QnA Maker service is continually improving the algorithms that extract QnAs from content and expanding the list of supported file and HTML formats. Follow the [guidelines](../Concepts/data-sources-supported.md) for data extraction based on your document type.
22+
The QnA Maker service is continually improving the algorithms that extract QnAs from content and expanding the list of supported file and HTML formats. Follow the [guidelines](../Concepts/content-types.md) for data extraction based on your document type.
2323

2424
In general, FAQ pages should be stand-alone and not combined with other information. Product manuals should have clear headings and preferably an index page.
2525

articles/cognitive-services/QnAMaker/Concepts/confidence-score.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,5 +85,5 @@ When no good match is found by the ranker, the confidence score of 0.0 or "None"
8585

8686
## Next steps
8787
> [!div class="nextstepaction"]
88-
> [Data sources supported](./data-sources-supported.md)
88+
> [Best practices](./best-practices.md)
8989

articles/cognitive-services/QnAMaker/How-To/add-sharepoint-datasources.md

Lines changed: 32 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -14,34 +14,34 @@ ms.author: diberry
1414

1515
# Add a secured SharePoint data source to your knowledge base
1616

17-
Add secured SharePoint data sources to your knowledge base to enrich the knowledge base with questions and answers that may be secured with Active Directory.
17+
Add secured SharePoint data sources to your knowledge base to enrich the knowledge base with questions and answers that may be secured with Active Directory.
1818

19-
When you add a secured SharePoint document to your knowledge base, as the QnA Maker manager, you must request Active Directory permission for QnA Maker. Once this permission is given from the Active Directory manager to QnA Maker for access to SharePoint, it doesn't have to be given again. Each subsequent document addition to the knowledge base will not need authorization if it is in the same SharePoint resource.
19+
When you add a secured SharePoint document to your knowledge base, as the QnA Maker manager, you must request Active Directory permission for QnA Maker. Once this permission is given from the Active Directory manager to QnA Maker for access to SharePoint, it doesn't have to be given again. Each subsequent document addition to the knowledge base will not need authorization if it is in the same SharePoint resource.
2020

2121
If the QnA Maker knowledge base manager is not the Active Directory manager, you will need to communicate with the Active Directory manager to finish this process.
2222

2323
## Add supported file types to knowledge base
2424

25-
You can add all QnA Maker-supported [file types](../Concepts/data-sources-supported.md) from a SharePoint site to your knowledge base. You may have to grant [permissions](#permissions) if the file resource is secured.
25+
You can add all QnA Maker-supported [file types](../Concepts/content-types.md) from a SharePoint site to your knowledge base. You may have to grant [permissions](#permissions) if the file resource is secured.
2626

2727
1. From the library with the SharePoint site, select the file's ellipsis menu, `...`.
2828
1. Copy the file's URL.
2929

3030
![Get the SharePoint file URL by selecting the file's ellipsis menu then copying the URL.](../media/add-sharepoint-datasources/get-sharepoint-file-url.png)
3131

32-
1. In the QnA Maker portal, on the **Settings** page, [add the URL](edit-knowledge-base.md#add-datasource) to the knowledge base.
32+
1. In the QnA Maker portal, on the **Settings** page, [add the URL](edit-knowledge-base.md#add-datasource) to the knowledge base.
3333

3434
### Images with SharePoint files
3535

3636
If files include images, those are not extracted. You can add the image, from the QnA Maker portal, after the file is extracted into QnA pairs.
3737

38-
Add the image with the following markdown syntax:
38+
Add the image with the following markdown syntax:
3939

4040
```markdown
4141
![Explanation or description of image](URL of public image)
4242
```
4343

44-
The text in the square brackets, `[]`, explains the image. The URL in the parentheses, `()`, is the direct link to the image.
44+
The text in the square brackets, `[]`, explains the image. The URL in the parentheses, `()`, is the direct link to the image.
4545

4646
When you test the QnA pair in the interactive test panel, in the QnA Maker portal, the image is displayed, instead of the markdown text. This validates the image can be publicly retrieved from your client-application.
4747

@@ -52,39 +52,39 @@ Granting permissions happens when a secured file from a SharePoint server is add
5252
* no additional steps - the person adding the file has all the permissions needed.
5353
* steps by both [knowledge base manager](#knowledge-base-manager-add-sharepoint-data-source-in-qna-maker-portal) and [Active Directory manager](#active-directory-manager-grant-file-read-access-to-qna-maker).
5454

55-
See the steps listed below.
55+
See the steps listed below.
5656

5757
### Knowledge base manager: add SharePoint data source in QnA Maker portal
5858

5959
When the **QnA Maker manager** adds a secured SharePoint document to a knowledge base, the knowledge base manager initiates a request for permission that the Active Directory manager needs to complete.
6060

61-
The request begins with a pop-up to authenticate to an Active Directory account.
61+
The request begins with a pop-up to authenticate to an Active Directory account.
6262

6363
![Authenticate User Account](../media/add-sharepoint-datasources/authenticate-user-account.png)
6464

65-
Once the QnA Maker manager selects the account, the Azure Active Directory administrator will receive a notice that they need to allow the QnA Maker app (not the QnA Maker manager) access to the SharePoint resource. The Azure Active Directory manager will need to do this for every SharePoint resource, but not every document in that resource.
65+
Once the QnA Maker manager selects the account, the Azure Active Directory administrator will receive a notice that they need to allow the QnA Maker app (not the QnA Maker manager) access to the SharePoint resource. The Azure Active Directory manager will need to do this for every SharePoint resource, but not every document in that resource.
6666

6767
### Active directory manager: grant file read access to QnA Maker
6868

69-
The Active Directory manager (not the QnA Maker manager) needs to grant access to QnA Maker to access the SharePoint resource by selecting [this link](https://login.microsoftonline.com/common/oauth2/v2.0/authorize?response_type=id_token&scope=Files.Read%20Files.Read.All%20Sites.Read.All%20User.Read%20User.ReadBasic.All%20profile%20openid%20email&client_id=c2c11949-e9bb-4035-bda8-59542eb907a6&redirect_uri=https%3A%2F%2Fwww.qnamaker.ai%3A%2FCreate&state=68) to authorize the QnA Maker Portal SharePoint enterprise app to have file read permissions.
69+
The Active Directory manager (not the QnA Maker manager) needs to grant access to QnA Maker to access the SharePoint resource by selecting [this link](https://login.microsoftonline.com/common/oauth2/v2.0/authorize?response_type=id_token&scope=Files.Read%20Files.Read.All%20Sites.Read.All%20User.Read%20User.ReadBasic.All%20profile%20openid%20email&client_id=c2c11949-e9bb-4035-bda8-59542eb907a6&redirect_uri=https%3A%2F%2Fwww.qnamaker.ai%3A%2FCreate&state=68) to authorize the QnA Maker Portal SharePoint enterprise app to have file read permissions.
7070

7171
![Azure Active Directory manager grants permission interactively](../media/add-sharepoint-datasources/aad-manager-grants-permission-interactively.png)
7272

7373
<!--
74-
The Active Directory manager must grant QnA Maker access either by application name, `QnAMakerPortalSharePoint`, or by application ID, `c2c11949-e9bb-4035-bda8-59542eb907a6`.
74+
The Active Directory manager must grant QnA Maker access either by application name, `QnAMakerPortalSharePoint`, or by application ID, `c2c11949-e9bb-4035-bda8-59542eb907a6`.
7575
-->
7676
<!--
77-
### Grant access from the interactive pop-up window
77+
### Grant access from the interactive pop-up window
7878
79-
The Active Directory manager will get a pop-up window requesting permissions to the `QnAMakerPortalSharePoint` app. The pop-up window includes the QnA Maker Manager email address that initiated the request, an `App Info` link to learn more about **QnAMakerPortalSharePoint**, and a list of permissions requested. Select **Accept** to provide those permissions.
79+
The Active Directory manager will get a pop-up window requesting permissions to the `QnAMakerPortalSharePoint` app. The pop-up window includes the QnA Maker Manager email address that initiated the request, an `App Info` link to learn more about **QnAMakerPortalSharePoint**, and a list of permissions requested. Select **Accept** to provide those permissions.
8080
8181
![Azure Active Directory manager grants permission interactively](../media/add-sharepoint-datasources/aad-manager-grants-permission-interactively.png)
8282
-->
8383
<!--
8484
8585
### Grant access from the App Registrations list
8686
87-
1. The Active Directory manager signs in to the Azure portal and opens **[App registrations list](https://ms.portal.azure.com/#blade/Microsoft_AAD_IAM/ApplicationsListBlade)**.
87+
1. The Active Directory manager signs in to the Azure portal and opens **[App registrations list](https://ms.portal.azure.com/#blade/Microsoft_AAD_IAM/ApplicationsListBlade)**.
8888
8989
1. Search for and select the **QnAMakerPortalSharePoint** app. Change the second filter box from **My apps** to **All apps**. The app information will open on the right side.
9090
@@ -94,52 +94,52 @@ The Active Directory manager will get a pop-up window requesting permissions to
9494
9595
[![Select Settings in the right-side blade](../media/add-sharepoint-datasources/select-settings-for-qna-maker-app-registration.png)](../media/add-sharepoint-datasources/select-settings-for-qna-maker-app-registration.png#lightbox)
9696
97-
1. Under **API access**, select **Required permissions**.
97+
1. Under **API access**, select **Required permissions**.
9898
9999
![Select 'Settings', then under 'API access', select 'Required permission'](../media/add-sharepoint-datasources/select-required-permissions-in-settings-blade.png)
100100
101-
1. Do not change any settings in the **Enable Access** window. Select **Grant Permission**.
101+
1. Do not change any settings in the **Enable Access** window. Select **Grant Permission**.
102102
103103
[![Under 'Grant Permission', select 'Yes'](../media/add-sharepoint-datasources/grant-app-required-permissions.png)](../media/add-sharepoint-datasources/grant-app-required-permissions.png#lightbox)
104104
105-
1. Select **YES** in the pop-up confirmation windows.
105+
1. Select **YES** in the pop-up confirmation windows.
106106
107107
![Grant required permissions](../media/add-sharepoint-datasources/grant-required-permissions.png)
108108
-->
109109
### Grant access from the Azure Active Directory admin center
110110

111-
1. The Active Directory manager signs in to the Azure portal and opens **[Enterprise applications](https://aad.portal.azure.com/#blade/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/AllApps)**.
111+
1. The Active Directory manager signs in to the Azure portal and opens **[Enterprise applications](https://aad.portal.azure.com/#blade/Microsoft_AAD_IAM/StartboardApplicationsMenuBlade/AllApps)**.
112112

113-
1. Search for `QnAMakerPortalSharePoint` the select the QnA Maker app.
113+
1. Search for `QnAMakerPortalSharePoint` the select the QnA Maker app.
114114

115115
[![Search for QnAMakerPortalSharePoint in Enterprise apps list](../media/add-sharepoint-datasources/search-enterprise-apps-for-qna-maker.png)](../media/add-sharepoint-datasources/search-enterprise-apps-for-qna-maker.png#lightbox)
116116

117-
1. Under **Security**, go to **Permissions**. Select **Grant admin consent for Organization**.
117+
1. Under **Security**, go to **Permissions**. Select **Grant admin consent for Organization**.
118118

119119
[![Select authenticated user for Active Directory Admin](../media/add-sharepoint-datasources/grant-aad-permissions-to-enterprise-app.png)](../media/add-sharepoint-datasources/grant-aad-permissions-to-enterprise-app.png#lightbox)
120120

121-
1. Select a Sign-On account with permissions to grant permissions for the Active Directory.
121+
1. Select a Sign-On account with permissions to grant permissions for the Active Directory.
122+
122123

123124

124-
125125
<!--
126126
127127
## Add SharePoint data source with APIs
128128
129-
You need to get the SharePoint file's URI before adding it to QnA Maker.
129+
You need to get the SharePoint file's URI before adding it to QnA Maker.
130130
131131
## Get SharePoint File URI
132132
133133
Use the following steps to transform the SharePoint URL into a sharing token.
134134
135-
1. Encode the URL using [base64](https://en.wikipedia.org/wiki/Base64).
135+
1. Encode the URL using [base64](https://en.wikipedia.org/wiki/Base64).
136136
137-
1. Convert the base64-encoded result to an unpadded base64url format with the following character changes.
137+
1. Convert the base64-encoded result to an unpadded base64url format with the following character changes.
138138
139-
* Remove the equal character, `=` from the end of the value.
140-
* Replace `/` with `_`.
141-
* Replace `+` with `-`.
142-
* Append `u!` to be beginning of the string.
139+
* Remove the equal character, `=` from the end of the value.
140+
* Replace `/` with `_`.
141+
* Replace `+` with `-`.
142+
* Append `u!` to be beginning of the string.
143143
144144
1. Sign in to Graph explorer and run the following query, where `sharedURL` is ...:
145145
@@ -174,9 +174,9 @@ Use the **@microsoft.graph.downloadUrl** from the previous section as the `fileu
174174
175175
## Remove QnA Maker app from SharePoint authorization
176176
177-
1. Use the steps in the previous section to find the Qna Maker app in the Active Directory admin center.
178-
1. When you select the **QnAMakerPortalSharePoint**, select **Overview**.
179-
1. Select **Delete** to remove permissions.
177+
1. Use the steps in the previous section to find the Qna Maker app in the Active Directory admin center.
178+
1. When you select the **QnAMakerPortalSharePoint**, select **Overview**.
179+
1. Select **Delete** to remove permissions.
180180
181181
-->
182182

0 commit comments

Comments
 (0)