Configure a hierarquia de segmentação de sua equipe
A configuração de uma hierarquia de direcionamento de equipe permite que sua organização publique conteúdo em um grande conjunto de equipes. A hierarquia de direcionamento de equipe define como todas as equipes em sua hierarquia estão relacionadas entre si, quais usuários podem publicar tarefas e quais usuários do teams têm permissões para publicar. Os recursos de publicação são desabilitados para todos os usuários, a menos que uma hierarquia de direcionamento de equipe seja configurada para sua organização. Para configurar uma hierarquia de direcionamento de equipe, você precisa criar um arquivo que defina a hierarquia e, em seguida, carregá-la no Teams para aplicá-la à sua organização. Depois que o esquema for carregado, os aplicativos no Teams poderão usá-lo.
Importante
Para a versão inicial, apenas o aplicativo Planner dá suporte a equipes hierárquicas. A aplicação de uma hierarquia de direcionamento de equipe à sua organização habilitará a publicação de tarefas no aplicativo Planner. Você não verá uma hierarquia de equipes em outras áreas do Microsoft Teams.
Aqui está um exemplo de como a hierarquia é representada no aplicativo Planner no Teams. Depois que uma lista de tarefas for criada, os membros da equipe de publicação poderão selecionar as equipes de destinatário para enviar (publicar) a lista de tarefas. Ao selecionar equipes, a equipe de publicação pode filtrar por hierarquia, por atributos ou uma combinação de ambos.
A experiência de publicação de tarefas está disponível no aplicativo Planner no Teams, mas é alimentada por Microsoft Planner. Como resultado, a publicação de tarefas exige que os usuários sejam atribuídos licenças que incluam Microsoft Planner.
Terminologia
Os termos a seguir são importantes à medida que você navega por hierarquias. As equipes são chamadas de nós.
- Os nós raiz são os nós mais altos na hierarquia. Na captura de tela de exemplo, Comunicações de Varejo é um nó raiz.
- Nós pai e nós filho são termos que representam uma relação entre dois nós conectados. Na captura de tela de exemplo, a França é um nó filho da Europa.
- Vários níveis de crianças são conhecidos como descendentes. França, Loja 17, Loja 18, Alemanha, Loja 19, Loja 20 e Reino Unido são todos descendentes da Europa.
- Um nó sem filhos é chamado de nó folha. Eles estão na parte inferior de uma hierarquia.
- As equipes de destinatários são equipes que foram selecionadas para receber um conjunto específico de conteúdo a ser publicado. Eles devem ser nós de folha.
Planejar sua hierarquia
Antes de criar o esquema que define sua hierarquia, você precisa fazer algum planejamento e decidir como deseja moldar sua organização. Uma das primeiras prioridades é decidir quais grupos organizacionais precisam publicar tarefas para outros grupos. Cada nó na hierarquia representa um grupo de trabalho ou um grupo de grupos.
Permissões para publicar
A permissão para publicar depende se um usuário é membro de qualquer equipe na hierarquia mais a relação dessa equipe ou conjunto de equipes com outras equipes na hierarquia.
Nota
O proprietário de uma equipe também recebe permissões de publicação.
- Se um usuário for membro de pelo menos uma equipe que tenha descendentes na hierarquia, esse usuário poderá publicar para esses descendentes sem ser membro de todas as equipes para as quais deseja publicar.
- Se um usuário for membro de pelo menos uma equipe na hierarquia, mas não for membro de nenhuma equipe com descendentes na hierarquia, esse usuário poderá ver e receber conteúdo publicado de sua organização.
- Se um usuário não for membro de nenhuma equipe na hierarquia, esse usuário não verá nenhuma funcionalidade relacionada à publicação.
Diretrizes
- Só pode haver um arquivo de hierarquia aplicado por organização. No entanto, você pode incluir diferentes partes da sua organização juntas como hierarquias distintas de nós em um arquivo. Por exemplo, a Contoso Pharmaceuticals tem um nó raiz da Farmácia e um nó raiz do Varejo. Ambos os nós raiz têm várias linhas de descendentes e não há sobreposição entre eles.
- Somente nós de folha podem ser destinatários de uma publicação. Outros nós na hierarquia são úteis para selecionar destinatários de uma publicação.
- Uma equipe só pode ser representada uma vez em uma hierarquia.
- Uma hierarquia pode conter até 15.000 nós. Planejamos trabalhar com clientes para aumentar esse limite para organizações maiores.
Hierarquia de exemplo
Por exemplo, na hierarquia a seguir, Recall, Comunicações e RH podem publicar tarefas em cada nó inferior (equipe) na hierarquia, mas a Zona Nordeste só pode publicar tarefas nas equipes da New York Store e da Boston Store. A hierarquia de exemplo permite que os grupos Recall, Comunicações e RH publiquem tarefas que se aplicam a toda a empresa, como informações de benefícios ou mensagens do CEO. A Zona Nordeste pode publicar tarefas como agendamento de pessoal, informações meteorológicas e assim por diante, apenas para as equipes da New York Store e da Boston Store.
Create sua hierarquia
Nota
O restante deste artigo discute a configuração de uma hierarquia de equipe no contexto da publicação de tarefas para equipes de destinatários. Consulte Gerenciar o aplicativo Planner para sua organização no Teams para obter uma visão geral do aplicativo Planner, em que a publicação de tarefas aparece quando habilitada.
O esquema que define sua hierarquia baseia-se em um arquivo CSV (valores separados por vírgulas). O arquivo deve estar no formato UTF-8. Cada linha no arquivo CSV corresponde a um nó dentro da hierarquia das equipes. Cada linha contém informações que nomeia o nó dentro da hierarquia, opcionalmente o vincula a uma equipe e inclui atributos que podem ser usados para filtrar equipes em aplicativos com suporte.
Você também pode definir buckets, que são categorias que a equipe de publicação pode usar para organizar o conteúdo enviado às equipes de destinatários para facilitar a exibição, classificação e foco em conteúdo relevante.
Adicionar colunas necessárias
O arquivo CSV deve conter as três colunas a seguir, na ordem a seguir, começando na primeira coluna. Um nó deve ser vinculado a uma equipe para que ele receba tarefas.
| Nome da coluna | Obrigatório | Descrição |
|---|---|---|
| DisplayName | Sim | Esse campo é o nome do nó. O nome pode ter até 100 caracteres e conter apenas os caracteres A-Z, a z e 0-9. Os nomes de nó devem ser exclusivos. |
| ParentName | Sim | Este é o nome do nó pai. O valor especificado aqui deve corresponder exatamente ao valor no campo DisplayName do nó pai. Se você quiser adicionar mais de um nó pai, separe cada nome do nó pai com um ponto e vírgula (;). Você pode adicionar até 25 nós pai e cada nome de nó pai pode ter até 2.500 caracteres de comprimento. Um nó só pode ter vários nós pai se os nós pai forem nós raiz. IMPORTANTE Tenha cuidado para não criar um loop em que um pai mais alto na hierarquia referencia um nó filho mais baixo na hierarquia. Não há suporte para isso. |
| TeamId | Sim, se a equipe publicar tarefas ou receber tarefas de um nó pai. | Isso contém a ID da equipe à qual você deseja vincular um nó. Cada nó deve se referir a uma equipe exclusiva, para que cada valor TeamId possa aparecer apenas uma vez no arquivo de hierarquia. Para obter a ID de uma equipe à qual você deseja vincular um nó, execute o seguinte comando do PowerShell: Get-Team | Export-Csv TeamList.csv. Este comando lista as equipes em sua organização e inclui o nome e a ID de cada equipe. Localize o nome da equipe à qual você deseja vincular e copie a ID para este campo. |
Nota
Se um nó não for um nó raiz ou um nó de folha e você não precisar da associação da equipe para conceder as permissões correspondentes para publicação e relatório, você poderá deixar o TeamId em branco. Esse método pode ser usado para adicionar mais granularidade ao escolher equipes de destinatário ou para exibir relatórios de conclusão sem ter uma equipe correspondente.
Adicionar colunas de atributo
Depois de adicionar as três colunas necessárias, você pode adicionar colunas de atributo opcionais. Esses atributos podem ser usados para filtrar nós para que você possa selecionar com mais facilidade os que deseja publicar tarefas. Há duas maneiras de definir seus atributos, dependendo se os valores desse atributo são mutuamente exclusivos.
| Maneiras de adicionar atributos | Descrição | Exemplo |
|---|---|---|
| Se os valores de um atributo forem mutuamente exclusivos, o nome da coluna especificado se tornará o nome do atributo. | Cada linha pode conter um valor para esse atributo e cada coluna de atributo pode ter até 50 valores exclusivos. Cada valor pode ter até 100 caracteres. O conjunto de valores de atributo especificados na coluna de atributo será exibido como valores de filtro para esse atributo ao selecionar equipes de destinatário usando a hierarquia de destino da equipe. | Você deseja que os usuários possam filtrar os armazenamentos por layout. Os valores desse atributo são mutuamente exclusivos porque um repositório pode ter apenas um layout. Para adicionar um atributo aos armazenamentos de filtro por layout, adicione uma coluna chamada Layout da Loja. Neste exemplo, os valores do atributo layout da Loja são Compact, Standard e Large. |
| Se você precisar indicar vários valores para um atributo e os valores não forem mutuamente exclusivos, use o formato AttributeName:UniqueValue para os nomes de coluna. IMPORTANTE Certifique-se de usar o cólon somente em inglês (:) como unicode não tem suporte como delimitador de coluna de atributo. |
A cadeia de texto antes do cólon (:) se torna o nome do atributo. Todas as colunas que contêm a mesma cadeia de caracteres de texto antes dos pontos (:) são agrupadas em uma seção no menu de filtragem. Cada uma das cadeias de caracteres após o cólon se torna os valores dessa seção. Cada linha pode ter um valor de 0 (zero) ou 1 para esse atributo. Um valor de 0 (zero) significa que o atributo não se aplica ao nó e um valor de 1 significa que o atributo se aplica a esse nó. |
Você deseja que os usuários possam filtrar armazenamentos por departamento. Uma loja pode ter vários departamentos e, portanto, os valores desse atributo não são mutuamente exclusivos. Neste exemplo, adicionamos Departments:Clothing, Departments:Electronics, Departments:Foods, Departments:Home and Garden, Departments:Sporting goods como colunas de atributo. Os departamentos se tornam o nome do atributo e os usuários podem filtrar pelos departamentos de Vestuário, Eletrônicos, Alimentos, Casa e Jardim e Artigos Esportivos. |
Ao adicionar uma coluna de atributo, tenha o seguinte em mente:
- O nome da coluna que você especifica ou o nome da coluna que você especifica antes do cólon (:) se torna o nome do atributo. Esse valor será exibido nos aplicativos do Teams que usam a hierarquia.
- Você pode ter até 100 colunas de atributo na hierarquia.
- O nome da coluna pode ter até 100 caracteres e conter apenas os caracteres A-Z, a z e 0-9 e espaços. Os nomes de coluna devem ser exclusivos.
Adicionar colunas bucket
Você pode adicionar colunas de bucket para criar buckets, que são agrupamentos nos quais as tarefas podem ser organizadas. Cada bucket obtém sua própria coluna no arquivo CSV. Os buckets que você cria são disponibilizados para a equipe de publicação. Em seguida, a equipe de publicação pode usar esses buckets para categorizar tarefas para as equipes de destinatário. Se um bucket ainda não existir em uma equipe, os buckets serão criados sob demanda quando as tarefas são publicadas.
Ao categorizar os itens de trabalho uma vez centralmente, a equipe de publicação pode preorganizar a lista de tarefas para todas as dezenas, centenas ou milhares de equipes de destinatários que recebem a lista de tarefas. Em seguida, as equipes de destinatário podem classificar e filtrar suas tarefas por bucket para se concentrar na área mais relevante para seu trabalho.
Ao adicionar uma coluna bucket, observe o seguinte:
- O nome da coluna se torna o nome do bucket. Cada bucket especificado aparecerá na lista Buckets nos aplicativos do Teams que usam a hierarquia.
- Recomendamos que você não inclua informações confidenciais em nomes de bucket. Neste momento, as equipes de publicação não podem remover um bucket por meio da publicação depois que ele é criado.
- O nome da coluna deve ser precedido por uma hashtag (#). Ele pode ter até 100 caracteres e conter apenas os caracteres A-Z, a z e 0-9. Por exemplo, #Operations e #Frozen Goods.
- Uma hierarquia pode conter até 100 colunas de bucket. Planejamos trabalhar com clientes para aumentar esse limite para organizações maiores.
Exemplo
Aqui está um exemplo de um arquivo CSV de esquema que seria criado para dar suporte à hierarquia mostrada na imagem anterior. Este esquema contém o seguinte:
- Três colunas necessárias chamadas
TargetName,ParentNameeTeamId - Três colunas de atributo chamadas
Store layout,Departments:ClothingeDepartments:Foods - Três colunas de bucket chamadas
Fresh Foods,Frozen FoodseWomen's Wear
O Store layout atributo tem valores que incluem Compact, Standarde Large. As Departments colunas de atributo podem ser definidas como um valor de 0 (zero) ou 1. O Store layout e Departments os atributos não são mostrados na imagem. Eles são adicionados aqui para ajudar a mostrar como os atributos podem ser adicionados às entradas de nó. O mesmo vale para as três colunas de bucket.
TargetName,ParentName,TeamId,Store layout,Departments:Clothing,Departments:Foods,#Fresh Foods,#Frozen Foods,#Women's Wear
Recall,,db23e6ba-04a6-412a-95e8-49e5b01943ba,,,,,,
Communications,,145399ce-a761-4843-a110-3077249037fc,,,,,,
HR,,125399ce-a761-4983-a125-3abc249037fc,,,,,,
East Regional Office,HR;Communications;Recall,,,,,,,
West Regional Office,HR;Communications;Recall,,,,,,,
Northeast Zone,East Regional Office,,,,,,,
Southeast Zone,East Regional Office,,,,,,,
New York Store,Northeast Zone,e2ba65f6-25e7-488b-b8f0-b8562d5de60a,Large,1,1,,,
Boston Store,Northeast Zone,0454f08a-0507-437c-969a-682eb2fae7fc,Standard,1,1,,,
Miami Store,Southeast Zone,619d6e4e-5f68-4b36-8e1f-16c98d7396c1,Compact,0,1,,,
New Orleans Store,Southeast Zone,6be960b8-72af-4561-a343-9ac4711874eb,Compact,0,1,,,
Seattle Store,West Regional Zone,487c0d20-4e55-4dc2-8187-a24c826e0fee,Standard,1,1,,,
Los Angeles Store,West Regional Zone,204a1287-2efb-4a8a-88e0-56fbaf5a2389,Large,1,1,,,
Aplicar sua hierarquia
Nota
Para executar esta etapa, você deve usar cmdlets do Microsoft Teams PowerShell. Você deve usar a versão 4.6.0 ou posterior dos cmdlets do Microsoft Teams. Esse requisito também se aplica aos clientes do GCC (Government Community Cloud).
Depois de definir sua hierarquia no arquivo CSV do esquema, você estará pronto para carregá-la no Teams. Para fazer isso, execute o comando a seguir. Você deve ser um administrador global ou administrador de serviço do Teams para fazer essa etapa.
Set-TeamTargetingHierarchy -FilePath "C:\ContosoTeamSchema.csv"
Atualizar sua hierarquia
Você pode carregar uma nova hierarquia para substituir a antiga usando o mesmo comando do PowerShell descrito anteriormente. Sempre que você carrega uma nova hierarquia, ela substitui a hierarquia anterior.
Verifique o status de sua hierarquia
Você pode executar o comando a seguir para marcar a status do upload da hierarquia.
Get-TeamTargetingHierarchyStatus
O comando retorna os seguintes campos:
| Campo | Descrição |
|---|---|
| Id | A ID exclusiva para o upload. |
| Status | Carregar status. Os valores incluem Inicialização, Validação, Êxito e Falha |
| ErrorDetails | Detalhes se houver um erro de carregamento. Para obter mais informações sobre os detalhes do erro, consulte a seção Solução de problemas. Se não houver erro, esse campo ficará em branco. |
| LastUpdatedAt | Carimbo de data/hora de quando o arquivo foi atualizado pela última vez. |
| LastModifiedBy | A ID do último usuário que modificou o arquivo. |
| FileName | O nome do arquivo do CSV. |
Remover sua hierarquia
Se você quiser desabilitar imediatamente a guia Listas publicadas para todos os usuários da sua organização, poderá remover sua hierarquia. Os usuários não terão acesso à guia Listas publicadas ou a nenhuma das funcionalidades na guia. Isso inclui a capacidade de criar novas listas de tarefas para publicar, acessar listas de rascunho, publicar, publicar, publicar e duplicar listas e exibir relatórios. A remoção da hierarquia não impublica tarefas que foram publicadas anteriormente. Essas tarefas permanecerão disponíveis para que as equipes de destinatário sejam concluídas.
Para remover sua hierarquia, execute o comando a seguir. Você deve ser um administrador para executar esta etapa.
Remove-TeamTargetingHierarchy
Ao confirmar a exclusão, a mensagem status ainda exibirá o esquema anterior está presente, embora a tentativa de excluir novamente retorne um erro de que o objeto é nulo.
Create uma hierarquia de exemplo
Instalar o módulo do Teams PowerShell
Importante
Para executar esta etapa, você deve instalar e usar o módulo do Teams PowerShell do Galeria do PowerShell. Para obter etapas sobre como instalar o módulo, consulte Instalar o módulo do Microsoft Teams PowerShell.
Script de exemplo
O script a seguir pode ser usado para criar as equipes e carregar um arquivo .csv para o locatário do Microsoft Teams. Se você tiver uma hierarquia existente, esse script o substituirá.
Create equipes para uma hierarquia simples
$tm1 = New-Team -DisplayName "HQ"
$tm2 = New-Team -DisplayName "North"
$tm3 = New-Team -DisplayName "Store 1"
$tm4 = New-Team -DisplayName "Store 2"
$tm5 = New-Team -DisplayName "South"
$tm6 = New-Team -DisplayName "Store 3"
$tm7 = New-Team -DisplayName "Store 4"
Usar dados de equipe para criar saída separada por vírgulas (DisplayName, ParentName, TeamId)
$csvOutput = "DisplayName" + "," + "ParentName" + "," + "TeamId" + "`n"
$csvOutput = $csvOutput + $tm1.DisplayName + "," + "," + $tm1.GroupID + "`n"
$csvOutput = $csvOutput + $tm2.DisplayName + "," + $tm1.DisplayName + "," + $tm2.GroupID + "`n"
$csvOutput = $csvOutput + $tm3.DisplayName + "," + $tm2.DisplayName + "," + $tm3.GroupID + "`n"
$csvOutput = $csvOutput + $tm4.DisplayName + "," + $tm2.DisplayName + "," + $tm4.GroupID + "`n"
$csvOutput = $csvOutput + $tm5.DisplayName + "," + $tm1.DisplayName + "," + $tm5.GroupID + "`n"
$csvOutput = $csvOutput + $tm6.DisplayName + "," + $tm5.DisplayName + "," + $tm6.GroupID + "`n"
$csvOutput = $csvOutput + $tm7.DisplayName + "," + $tm5.DisplayName + "," + $tm7.GroupID
Salvar saída em um arquivo .csv na pasta Downloads
$csvOutputPath = $env:USERPROFILE + "\downloads\testhierarchy-" + (Get-Date -Format "yyyy-MM-dd-hhmmss") + ".csv"
$csvOutput | Out-File $csvOutputPath
Carregar a hierarquia
Set-TeamTargetingHierarchy -FilePath $csvOutputPath
Get-TeamTargetingHierarchyStatus
Solução de problemas
Como exibir detalhes do erro
Você pode executar o comando a seguir para entender o que está causando um erro e retornar os detalhes do erro.
(Get-TeamTargetingHierarchyStatus).ErrorDetails.ErrorMessage
Você recebe uma mensagem de erro ao carregar o arquivo CSV do esquema
Anote a mensagem de erro, pois ela deve incluir informações de solução de problemas para indicar por que o esquema não pôde ser carregado. Examine e edite o arquivo CSV do esquema com base nas informações na mensagem de erro e tente novamente.
Você recebe uma mensagem de erro "Erro: InvalidTeamId" ao carregar o arquivo CSV do esquema
Ao tentar carregar o arquivo CSV do esquema, você obtém a seguinte mensagem de erro:
Error: InvalidTeamId
Description: TeamID in row # doesn't match a valid Group ID. Please view our documentation to learn how to get the proper GroupID for each team.
Verifique se você está usando o TeamId correto para a equipe no arquivo CSV do esquema. O TeamId deve ser o mesmo que a ID de Grupo do grupo Microsoft 365 que apoia a equipe. Você pode pesquisar a ID de grupo da equipe no centro de administração do Microsoft Teams.
- Na navegação à esquerda do centro de administração do Microsoft Teams, acesse Equipes>gerenciar equipes.
- Se a coluna ID do grupo não for exibida na tabela, selecione Editar colunas no canto superior direito da tabela e ative a ID do grupo.
- Localize a equipe na lista e localize a ID do grupo.
Verifique se o TeamId no arquivo CSV do esquema corresponde à ID do Grupo exibida no centro de administração do Teams.
Artigos relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de