Migrando arquivos e pastas compartilhados

Implementação

Conforme documentado na API PRIME de migração, aplique metadados de compartilhamento usando referências de item. O método mais antigo de usar a coluna Compartilhado com não deve mais ser usado.

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 horário do compartilhamento (SharedTime).

Adicione um bloco SharedWithMember para cada pessoa com quem 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 aparecerão no modo de exibição Compartilhado Comigo 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 compartilhar. Ao criar uma referência de item para um arquivo ou pasta, Marque se sua pasta pai (ou superior) já tem uma referência de item criada para ela. Nesse caso, não crie outro para o item filho. Isso impedirá que os usuários vejam itens duplicados no modo de exibição Compartilhado Comigo e reduzirá a migração e a carga de serviço.

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 no Compartilhado Comigo do destinatário é a pasta compartilhada.

Essas mesmas diretrizes também devem ser usadas para permissões (listas de controle de acesso, também conhecidas como ACLs). Aplique permissões apenas em um item filho quando as permissões necessárias forem diferentes de seu item pai. Certifique-se de não exceder 5.000 ACLs exclusivas em um site. Pode ser útil para marcar quantas ACLs você cria e avisar o usuário antes da migração. Também há um limite rígido de 50.000 ACLs exclusivas que serão aplicadas. Se você estiver próximo 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 têm acesso.

Não migre links de compartilhamento anônimos da fonte; 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.

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 seguindo estas 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 nenhuma referência "Compartilhado com", ele não verá o conteúdo aparecer no modo de exibição Compartilhado Comigo no site do OneDrive For Business.

No entanto, se eles forem indicados nas referências "Compartilhado com", mas não tiverem acesso ao conteúdo, eles nunca verão o conteúdo aparecer no modo de exibição Compartilhado Comigo no site do OneDrive for Business ou, quando tentarem usar um link de lá, o acesso será negado. 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 diferentes níveis da hierarquia de conteúdo usando escopos (ACLs exclusivas) 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 seguidos por objetos SPListItem que fazem referência aos objetos Arquivo/Pasta importados. Durante a importação do 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 escopos (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 representando atribuições de funções específicas para entidades de segurança específicas. Como esse código acaba interrompendo a herança do conteúdo e aplicando as atribuições de função especificadas, ele tem as mesmas limitações que o uso de 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.

Cota

Não migre mais de 1.000 eventos Compartilhe Comigo para qualquer receptor dentro de 24 horas. Se um receptor já tiver 1.000 eventos Compartilhar Comigo sendo importados dentro de 24 horas, ele NÃO receberá nenhum evento Compartilhar Comigo adicional durante a janela de tempo. E a API de Importação enviará mensagens de aviso indicando que alguns eventos de Compartilhar Comigo foram limitados.

  • Last updated on