Como exportar transcrições de vídeo com a API de Migração Importante do SharePoint

As transcrições de ficheiros de vídeo, como as das gravações de reuniões do Teams, são armazenadas num formato semelhante a um ficheiro zip. Se estiver a migrar vídeos de uma origem para outra, tem de utilizar um novo sinalizador para garantir que todo o ficheiro zip é migrado para o destino. Caso contrário, deixará inadvertidamente para trás o fluxo de conteúdo alternativo, a transcrição.

Passo 1: Verificar se o ficheiro contém fluxos de conteúdo alternativos

1. Verifique se o objeto SPFile tem a propriedade SPFile.HasAlternateContentStreams. Utilize a API REST ou CSOM para obter este valor de propriedade.
2. Se estiver definido como Verdadeiro, o ficheiro contém fluxos de conteúdo alternativos.

Exemplo:

GET https://{site_url}/_api/web/GetFileByServerRelativeUrl(‘/serverrelativeurl’)/HasAlternateContentStreams

Passo 2: transferir o ficheiro com fluxos de conteúdo alternativos

Um fluxo formatado com zip, incluindo fluxos primários e alternativos, pode ser transferido se o pedido de ficheiro incluir SPOpenBinaryOptions.GetAsZipWithAltStreamsIfAvailable.

1. Utilize a API REST ou CSOM para transferir o fluxo de conteúdo formatado zip.
2. Tem de incluir SPOpenBinaryOptions.GetAsZipWithAltStreamsIfAvailable. Se não for especificado, só é devolvido o fluxo de conteúdo do ficheiro principal.

Exemplo:

GET https://{site_url}/_api/web/GetFileByServerRelativeUrl(‘/serverrelativeurl’)/OpenBinaryStreamWithOptions(openOptions=1048576)

Observação

No exemplo acima, 1048576 corresponde ao valor inteiro da enumeração SPOpenBinaryOptions.GetAsZipWithAltStreamsIfAvailable.

Passo 3: importar o ficheiro com fluxos de conteúdo alternativos

Utilize a API de Migração para importar o fluxo formatado zip para um ficheiro com fluxos de conteúdo alternativos para o SPO. Os principais passos envolvidos são:

1. Carregue o fluxo formatado zip transferido com SPOpenBinaryOptions.GetAsZipWithAltStreamsIfAvailable como o ficheiro principal para a localização Azure.
2. Ao preparar o ficheiro de .xml manifesto de migração, adicione a propriedade vti_hasAlternateContentStreams ao objeto SPFile com o valor TRUE.
3. Chame a API de Migração como normal. Internamente, o SPO irá deszipar o fluxo de conteúdos fornecido e definir corretamente o fluxo de ficheiros principal e os fluxos de conteúdo alternativos associados.
4. Após a importação, verifique a propriedade SPFile.HasAlternateContentStreams para confirmar se está definida como Verdadeiro.

Exemplo:

<SPObject Url="Shared Documents/TestTMR.mp4" ObjectType="SPFile" Id="72b62f15-24be-4a8d-8023-ed7c4feae8c9"….>
<File Url="Shared Documents/TestTMR.mp4" ParentWebUrl="/" … Name="TestTMR.mp4">
<Properties>
<Property Name="vti_hasAlternateContentStreams" Value="TRUE" Access="ReadWrite" Type="Boolean"/>
</Properties>