Exportieren von Videotranskripts mithilfe der Wichtigen SharePoint-Migrations-API

Transkripte von Videodateien, wie die in Teams-Besprechungsaufzeichnungen, werden in einem Format gespeichert, das einer ZIP-Datei ähnelt. Wenn Sie Videos von einer Quelle zu einer anderen migrieren, müssen Sie ein neues Flag verwenden, um sicherzustellen, dass die gesamte ZIP-Datei zum Ziel migriert wird. Andernfalls lassen Sie versehentlich den alternativen Inhaltsstream, das Transkript, zurück.

Schritt 1: Überprüfen, ob die Datei alternative Inhaltsstreams enthält

1. Überprüfen Sie, ob das SPFile-Objekt über die Eigenschaft SPFile.HasAlternateContentStreams verfügt. Verwenden Sie die REST- oder CSOM-API , um diesen Eigenschaftswert abzurufen.
2. Bei Festlegung auf True enthält die Datei alternative Inhaltsstreams.

Beispiel:

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

Schritt 2: Herunterladen der Datei mit alternativen Inhaltsstreams

Ein ZIP-formatierter Stream, einschließlich primärer und alternativer Streams, kann heruntergeladen werden, wenn die Dateianforderung SPOpenBinaryOptions.GetAsZipWithAltStreamsIfAvailable enthält.

1. Verwenden Sie die REST- oder CSOM-API , um den ZIP-formatierten Inhaltsstream herunterzuladen.
2. Sie müssen SPOpenBinaryOptions.GetAsZipWithAltStreamsIfAvailable einschließen. Wenn dies nicht angegeben ist, wird nur der primäre Dateiinhaltsdatenstrom zurückgegeben.

Beispiel:

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

Hinweis: Im obigen Beispiel entspricht "1048576" dem ganzzahligen Wert der Enumeration SPOpenBinaryOptions.GetAsZipWithAltStreamsIfAvailable.

Schritt 3: Importieren der Datei mit alternativen Inhaltsstreams

Verwenden Sie die Migrations-API, um den ZIP-formatierten Stream für eine Datei mit alternativen Inhaltsstreams in SPO zu importieren. Die Standard Schritte sind:

1. Laden Sie den mit SPOpenBinaryOptions.GetAsZipWithAltStreamsIfAvailable heruntergeladenen ZIP-formatierten Stream als primäre Datei an den Azure-Speicherort hoch.
2. Fügen Sie beim Vorbereiten der Migrationsmanifestdatei .xml die Eigenschaft vti_hasAlternateContentStreams dem SPFile-Objekt mit dem Wert TRUE hinzu.
3. Rufen Sie die Migrations-API wie gewohnt auf. Intern entpackt SPO den bereitgestellten Inhaltsdatenstrom und legt den primären Dateistream und die zugehörigen alternativen Inhaltsstreams ordnungsgemäß fest.
4. Überprüfen Sie nach dem Import die Eigenschaft SPFile.HasAlternateContentStreams , um zu bestätigen, ob sie auf True festgelegt ist.

Beispiel:

<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>