Migrando arquivos e pastas compartilhados
Implementação
Conforme documentado na API do Migration PRIME, aplique metadados de compartilhamento usando referências de item. O método mais antigo de usar a coluna Compartilhado com não deve ser usado mais adiante.
Para um item compartilhado com um usuário, adicione o bloco SharedWithEvents em seu bloco ListItem . O bloco SharedWithEvents representa uma ocorrência quando o item foi compartilhado, incluindo o usuário que fez o compartilhamento (SharingInitatiorId e SharedById), bem como o tempo de compartilhamento (SharedTime).
Adicione um bloco SharedWithMember para cada pessoa com a qual o item foi compartilhado durante essa ocorrência. Todas as IDs de usuário devem ser entradas válidas no UserGroup.xml.
<ListItem ParentWebId="79f949a2-f38b-40e3-91ef-ffdbe6214bef"
Id="a4bbc3c7-7ef1-47ef-8451-ea8e1a69cb88"
TimeLastModified="2018-11-06T22:43:49"
TimeCreated="2018-11-06T22:25:32">
<SharedWithEvents>
<SharedWithEvent SharedTime="2018-10-29T04:06:09.1385321Z"
SharingInitiatorId="2"
SharedById="2">
<SharedWithMembers>
<SharedWithMember SharedWithId="1"/>
<SharedWithMember SharedWithId="2"/>
</SharedWithMembers>
</SharedWithEvent>
</SharedWithEvents>
</ListItem>
Práticas Recomendadas
Noções básicas
Para cada arquivo ou pasta compartilhada com um usuário na origem, crie uma referência de item para esse item no OneDrive do destinatário. Todas as referências de item criadas serão exibidas na exibição Compartilhado com Eu do usuário no OneDrive. Lembre-se de dar ao usuário permissão para acessar o item também.
Herança
Certifique-se de usar a herança corretamente para compartilhamento. Ao criar uma referência de item para um arquivo ou pasta, verifique se sua pasta pai (ou superior) já tem uma referência de item criada para ele. Nesse caso, não crie outro para o item filho. Isso impedirá que os usuários vejam itens duplicados em sua exibição Compartilhado comigo e reduzam a migração e a carga de serviço também.
Exemplo: Quando uma pasta é compartilhada e o destinatário pode acessar todo o conteúdo da pasta, uma referência de item só deve ser criada para a pasta compartilhada -- não para seu conteúdo. O único item que deve aparecer nos destinatários Compartilhados comigo é a pasta compartilhada.
Essas mesmas diretrizes também devem ser usadas para ACLs (permissões). Aplique apenas permissões em um item filho em que as permissões necessárias são diferentes do item pai. Certifique-se de não exceder 5.000 ACLs exclusivas em um site. Pode ser útil verificar quantas ACLs você cria e avisar o usuário antes da migração. Há também um limite difícil de 50.000 ACL exclusivas que serão impostas. Se você estiver perto de atingir os limites de 5000, recomendamos que o modelo de permissão seja simplificado na origem antes da migração.
Compartilhamento com grupos
Para itens compartilhados com um grupo de indivíduos na origem, o conteúdo pode ser migrado para uma biblioteca compartilhada (por exemplo, um site de equipe) na qual todos esses indivíduos recebem acesso.
Links de compartilhamento anônimos
Não migre links anônimos de compartilhamento da origem; isso não é útil, pois não é possível saber quais usuários usaram esse link na origem. Os usuários devem avaliar se os links anônimos ainda são necessários e criar novos no destino, se sim.
Compartilhamento com usuários externos
Antes de iniciar a migração, você deve garantir que todos os usuários sejam provisionados no locatário do cliente. Para usuários externos ao locatário (ou seja, de uma organização diferente), provisione-os como usuários de colaboração B2B no Azure Active Directory. Isso é feito no portal do Azure seguintes etapas:
Depois que os usuários externos forem provisionados, compartilhe arquivos e pastas com eles durante a migração da mesma forma que os usuários internos.
Permissão e Compartilhamento
O modelo de compartilhamento por usuário no SharePoint depende de permissões e referências de dados "Compartilhado com" para que um objeto seja considerado compartilhado com um indivíduo. Se um usuário tiver acesso ao conteúdo, mas não tiver referências de "Compartilhado com", ele não verá o conteúdo aparecer em sua exibição Compartilhado comigo em seu site do OneDrive For Business.
No entanto, se eles forem indicados em referências de "Compartilhado com", mas não tiverem acesso ao conteúdo, eles nunca verão o conteúdo aparecer em sua exibição Compartilhado Comigo em seu site do OneDrive For Business ou quando tentarem usar um link a partir daí, será negado acesso. Para preservar as informações de compartilhamento, as permissões e as referências "Compartilhado com" precisarão ser definidas corretamente. As permissões podem ser definidas em níveis diferentes da hierarquia de conteúdo usando escopos (ACLs exclusivos), que se aplicam a esse objeto e a qualquer um de seus filhos, a menos que eles próprios tenham permissões exclusivas.
Usando o PRIME, o conteúdo pode ser migrado usando objetos SPFile/SPFolder com uma biblioteca de documentos seguida por objetos SPListItem que fazem referência aos objetos de Arquivo/Pasta importados. Durante a importação de ListItem, os dados de referência "Compartilhado com" podem ser importados e, em seguida, a segurança pode ser aplicada posteriormente no mesmo pacote de migração, configurando acLs (ACLs) e atribuições de função (ACEs) para a hierarquia de conteúdo conforme necessário.
A migração de permissões é executada usando o objeto DeploymentRoleAssignments com entradas RoleAssignment representando escopos específicos e entradas de atribuição que representam atribuições de funções específicas para entidades específicas. Como esse código acaba quebrando a herança do conteúdo e aplicando as atribuições de função especificadas, ele tem as mesmas limitações que usar outras abordagens de modelo de objeto para definir permissões no SharePoint.
Observação
A API de Migração não está disponível para os usuários do Office 365 operado pela 21Vianet na China.