# Mapeamento automático

O Auto Mapping é a funcionalidade do KONNEKT que mapeia automaticamente todos os sites do SharePoint Online e bibliotecas de documentos para o Explorador de Arquivos do Windows do utilizador (e outras caixas de diálogo de ficheiros). Apenas os sites e bibliotecas aos quais o utilizador tem acesso são mapeados.

Os administradores podem controlar esta funcionalidade em dois níveis:

1. Nível do site
2. Nível da biblioteca

O KONNEKT atualiza os mapeamentos a cada 60 minutos.

{% hint style="info" %}
O KONNEKT usa a 'Result Source' predefinida da Pesquisa do SharePoint Online. Modificar esta definição pode alterar as Coleções de Sites e as Bibliotecas de Documentos apresentadas.
{% endhint %}

## Âmbito do site

{% hint style="info" %}
Esta política é aplicável à versão 2.0 e superior
{% endhint %}

{% hint style="info" %}
Por defeito, o KONNEKT mapeará todos os sites de equipa e de comunicação e os subsites aos quais o utilizador tem acesso. Os canais privados do Teams não fazem parte do âmbito de site predefinido.

**Se isso lhe convém, não precisa de usar esta política.**
{% endhint %}

### **Política** Definição

* **Nome da política (ADMX):** `Consulta de Sites do Sharepoint`

Esta política permite definir a cadeia de consulta usada para encontrar sites do SharePoint.

A consulta do site precisa de ser expressa em KQL. Pode encontrar a documentação geral de KQL aqui: <https://docs.microsoft.com/en-us/sharepoint/dev/general-development/keyword-query-language-kql-syntax-reference>

Pode encontrar uma lista de propriedades de consulta para o SharePoint aqui: <https://docs.microsoft.com/en-us/sharepoint/technical-reference/crawled-and-managed-properties-overview>

Pode testar a sua consulta KQL de site neste URL do SharePoint Online:

```
https://<YourTenantName>.sharepoint.com/_layouts/15/osssearchresults.aspx
```

Nos parágrafos seguintes, pode encontrar alguns exemplos de cadeias de consulta KQL.

### Predefinição

Se não configurar esta política, o KONNEKT usará a seguinte consulta KQL predefinida:

```
(webtemplate:STS OR webtemplate:GROUP OR webtemplate:SITEPAGEPUBLISHING) AND (contentclass=STS_Site OR contentclass=STS_Web)
```

Isto mapeará todos os sites de equipa e de comunicação aos quais o utilizador tem acesso. Os canais privados do Teams não fazem parte do âmbito de site predefinido

![](https://1241930089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8zLVuKYctMIUr68_fs%2Fuploads%2F87HL5sVuHXRgZXFF8DXC%2Fsharepoint%20site%20query%20policy.png?alt=media\&token=171fb103-fc4f-4dd5-8c11-c5f4b74009dd)

### Exemplos

#### Lista de permissões de sites

<details>

<summary>Filtrar por nome/título do site</summary>

`Title="<MySiteName>"`

**Cadeia de consulta** para mapear apenas os sites "Give" e "Leadership"

```
(webtemplate:STS OR webtemplate:GROUP OR webtemplate:SITEPAGEPUBLISHING) AND (contentclass=STS_Site OR contentclass=STS_Web) AND (title="Give" OR title="Leadership")
```

**Nota:** é necessário reiniciar o KONNEKT para aplicar a política

</details>

![](https://1241930089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8zLVuKYctMIUr68_fs%2Fuploads%2F8eyPohzXscLFaMW94wd2%2FKONNEKTQueryPolicy.png?alt=media\&token=0c61557a-b104-4f0d-8d43-6f43a851561f)

{% hint style="info" %}
**Nota:** Para mostrar todos os sites com \<Leadership> no nome, use o operador **(:)** em vez de **(=)** por título
{% endhint %}

#### Lista de permissões de sites usando o operador \*

<details>

<summary>Filtrar por nome/título do site usando o operador (*)</summary>

Mostrar todos os sites que têm uma palavra que começa por Con `title:<"Con*">`

**Cadeia de consulta**

```
(webtemplate:STS OR webtemplate:GROUP OR webtemplate:SITEPAGEPUBLISHING) AND (contentclass=STS_Site OR contentclass=STS_Web) AND (title:"Con*")
```

</details>

{% hint style="info" %}
**Nota**: Não recomendamos combinar o **(=)** operador juntamente com asterisco **(\*)** quando pretende correspondência exata. Em vez disso, use o **(:)** operador com **(\*)**
{% endhint %}

#### Lista de exclusão de sites

<details>

<summary>Excluir sites por nome/título do site</summary>

Mapear todos os sites e bibliotecas, exceto sites específicos (e as respetivas bibliotecas)

**Cadeia de consulta** a excluir `<Site01>` e `<Site02>`

```
(webtemplate:STS OR webtemplate:GROUP OR webtemplate:SITEPAGEPUBLISHING) AND (NOT (sitetitle:"Site01" OR sitetitle:"Site02"))
```

**Nota:** é necessário reiniciar o KONNEKT para aplicar a política

</details>

#### Canais privados e partilhados do Teams

<details>

<summary>Adicionar canais privados e partilhados do Microsoft Teams</summary>

Mapear todos os SP sites, canais privados do Teams e canais partilhados do Teams&#x20;

Ao adicionar `webtemplate:TEAMCHANNEL` à consulta

**Cadeia de consulta**

```
(webtemplate:STS OR webtemplate:GROUP OR webtemplate:SITEPAGEPUBLISHING OR webtemplate:TEAMCHANNEL) AND (contentclass=STS_Site OR contentclass=STS_Web)
```

**Nota:** é necessário reiniciar o KONNEKT para aplicar a política

Como os canais privados e partilhados são sites dedicados no SharePoint, aparecem como volumes dedicados no KONNEKT.

</details>

#### Todos os subsites para múltiplos sites do SharePoint

<details>

<summary>Mostrar todos os subsites de um ou mais sites do SharePoint</summary>

Para mapear todos os subsites (e bibliotecas) de um ou mais sites do SharePoint, pode usar a seguinte consulta

**Cadeia de consulta**

```
(webtemplate:STS OR webtemplate:GROUP OR webtemplate:SITEPAGEPUBLISHING) AND (contentclass=STS_Site OR contentclass=STS_Web) AND (path:https://<YourTenantName>.sharepoint.com/sites/MySite1 OR path:https://<YourTenantName>.sharepoint.com/sites/MySite2)
```

**Nota:** altere MySite1 e MySite2 para os nomes dos seus sites do SharePoint.&#x20;

Pode mapear subsites e bibliotecas apenas de um site do SharePoint ou até adicionar vários URLs, se necessário

</details>

### **Existem várias formas de aplicar a política:**

* manualmente, adicionando a chave no registo sob as definições de registo da máquina ou do utilizador
* via GPO, [verificar as definições via GPO](https://docs.konnekt.io/pt/configuration/management-options/settings-via-gpo)
* enviando políticas através do Intune, consulte [definições para Dispositivos Geridos pelo Intune](https://docs.konnekt.io/pt/management-options/setting-for-intune-managed-devices-1/intune-mappings#sharepoint-site-query)

#### **Definição manual no registo**

{% hint style="info" %}
Não precisa disto se usar gestão por GPO ou Intune.
{% endhint %}

* **Nome do valor do Registo:** `SharepointSiteQuery`
* **Tipo do valor do Registo:** `REG_SZ`
* **Dados do valor do Registo:** cadeia KQL
* **Localização de armazenamento do valor do Registo**:
  * `HKEY_CURRENT_USER\SOFTWARE\Policies\GlueckKanja\Konnekt`\
    ou
  * `HKEY_LOCAL_MACHINE\SOFTWARE\Policies\GlueckKanja\Konnekt`

## Âmbito da biblioteca

### Mapear bibliotecas de documentos predefinidas

Se estiver ativado, a definição "Enable Sharepoint Sites" apresentará todas as bibliotecas predefinidas de todas as Coleções de Sites às quais um utilizador tem acesso.

Um utilizador pode definir esta configuração através do menu de preferências:

![](https://1241930089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8zLVuKYctMIUr68_fs%2Fuploads%2FX7YN84KblPNQSM4VHJYm%2F2022-08-02%2016_26_17-Window.png?alt=media\&token=ebf07224-f23a-43d4-a02e-129907602487)

Também pode ser configurado através de registo/GPO/MDM:

**Nome da política (ADMX):** Descoberta automática de Sites do Sharepoint

![](https://1241930089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8zLVuKYctMIUr68_fs%2Fuploads%2FyTfGHgChaP2bEG9Tmuyh%2F2022-08-16%2015_15_20-LabServer%20%E2%80%8E-%20Remotedesktop.png?alt=media\&token=e15267e4-61de-4220-bfeb-3b729daba659)

#### Registo

Nome da chave: **O365SharepointUsage**\
Tipo de chave: REG\_DWORD

Ativar ou desativar o acesso a sites do SharePoint Online.

|   Função  |             Valor             | Comportamento                                                                                                                                                |
| :-------: | :---------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Desativar |               0               | O KONNEKT mapeia apenas a biblioteca do OneDrive for Business.                                                                                               |
|   Ativar  | <p>1</p><p>(predefinição)</p> | O KONNEKT mapeia o OneDrive for Business e todas as bibliotecas de documentos predefinidas dos sites do SharePoint Online aos quais o utilizador tem acesso. |

O valor predefinido é 1 (ativado).

Recomendamos usar a nossa [modelo ADMX](https://docs.konnekt.io/pt/management-options/settings-via-gpo#admx-file) para configurar esta definição.

### Mapear todas as bibliotecas de documentos

Pode encontrar esta definição no menu de preferências:

![](https://1241930089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8zLVuKYctMIUr68_fs%2Fuploads%2FUMH3ejq8y8ZdGIsx6UEI%2F2022-08-02%2016_26_54-Window.png?alt=media\&token=33ab3a77-1da2-421f-a92e-4da1e0cdf65c)

{% hint style="info" %}
Certifique-se de reiniciar **KONNEKT** após alterar esta definição.
{% endhint %}

Também pode configurar esta definição através de registo/GPO/MDM:

**Nome da política (ADMX):** Adicionar todas as bibliotecas do Sharepoint

![](https://1241930089-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8zLVuKYctMIUr68_fs%2Fuploads%2F3OmlRnygk6ReRf3KWmyJ%2F2022-08-16%2015_22_33-LabServer%20%E2%80%8E-%20Remotedesktop.png?alt=media\&token=4cc7e8a8-8164-4a76-8b57-e1f362add006)

#### Registo

Nome da chave: **AddAllSharepointLibraries**\
Tipo: REG\_DWORD

|   Função  |             Valor             | Comportamento                                                                                                                                                                                                  |
| :-------: | :---------------------------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Desativar | <p>0</p><p>(predefinição)</p> | <p>O KONNEKT mapeará apenas a biblioteca de documentos predefinida dos sites do SharePoint Online.</p><p>O formato do endereço UNC é: <br><code>\OneDrive-\<tenant-name>\&#x3C;site-name>...</code></p>        |
|   Ativar  |               1               | <p>O KONNEKT mapeará todas as bibliotecas de documentos do site do SharePoint Online.</p><p>O formato do endereço UNC é: <br><code>\OneDrive-\<tenant-name>\&#x3C;site-name>\&#x3C;library-name>...</code></p> |

O valor predefinido é 0 (desativado)

{% hint style="danger" %}
Se os utilizadores da sua empresa estiverem a usar valores diferentes desta definição, os respetivos caminhos UNC não serão compatíveis entre si (por exemplo, quando trocarem ligações UNC).

Para evitar isto, certifique-se de que esta definição está corretamente configurada para todos os utilizadores.
{% endhint %}

Recomendamos usar a nossa [modelo ADMX](https://docs.konnekt.io/pt/management-options/settings-via-gpo#admx-file) para configurar esta definição.

## **Existem várias formas de aplicar a política:**

* manualmente, adicionando a chave no registo sob as definições de registo da máquina ou do utilizador
* via GPO, consulte [definições via GPO](https://docs.konnekt.io/pt/configuration/management-options/settings-via-gpo)
* enviando políticas através do Intune, consulte [definições para Dispositivos Geridos pelo Intune](https://docs.konnekt.io/pt/management-options/setting-for-intune-managed-devices-1/intune-mappings#add-sharepoint-libraries)
