Bulk-Upload von Dateien

Um mehrere Dateien wie z. B. Bilder oder Präsentationen in empower® auf einmal hochzuladen, verwenden Sie den folgenden Befehl:

backendCli.exe u -s "[QUELL-PFAD]" -t "[ZIEL-PFAD]"

Der zugrundeliegende Befehl besteht aus den folgenden Bestandteilen:

  • u – Zeigt an, dass ein Bulk-Upload von Dateien durchgeführt werden soll.

  • --source [QUELL-PFAD] (-s) – Definiert den Pfad, unter dem der zu importierende Inhalt gespeichert ist.

  • --target [ZIEL-PFAD] (-t) – Definiert den Ordner, in den die Inhalte importiert werden sollen.

    Der Ordner kann entweder in Form eines Pfades oder in Form seiner GUID aus empower® definiert werden. Die GUID ist in der empower® Datenbank zu finden.

    Für weitere Informationen siehe Gültige Zielordner und Dateitypen.

Optional können Sie den Befehl im stillen Modus ausführen, um ihn zeitlich zu planen.

Fügen Sie dazu -q (--quiet) am Ende des Befehls hinzu:

backendCli.exe u -s "[QUELL-PFAD]" -t "[ZIEL-PFAD]" -q

Wichtig

Der Quell-Pfad darf nicht mit einem \-Zeichen enden.

Der Ziel-Pfad darf nicht mit einem >-Zeichen enden.

Beispiel

Quell-Pfad

Richtig: -s "C:\Users\[BENUTZERNAME]\Desktop\Bilder"

Falsch: -s "C:\Users\[BENUTZERNAME]\Desktop\Bilder\"

Ziel-Pfad

Richtig: -t "%CorporateDesignTemplates%>%Slides%"

Falsch: -t "%CorporateDesignTemplates%>%Slides%>"

Gültige Zielordner und Dateitypen

Die Dateipfade zu den Ordnern auf dem Gerät und in der empower® Bibliothek können auf zwei verschiedenen Wege angegeben werden

Für Pfade, die zu Dateien auf dem Gerät führen, geben Sie den Pfad in einer Standard-Pfad-Struktur an, die mithilfe von Rückstrichen (\) getrennt wird.

Wenn Sie den Ordner in der empower® Bibliothek mithilfe eines Pfades statt mithilfe der GUID definieren, verwenden Sie das folgende Format:

%UserLibrary%>%MyContent%>[ORDNER-NAME]

Die folgende Tabelle bietet eine Übersicht über alle gültigen Ordnerpfade und die jeweiligen unterstützten Dateitypen, die mit dem Befehl -t verwendet werden können:

Ordnerpfad

Bereich in der Bibliothek

Unterstützte Dateitypen

%CompanyLibrary%

Unternehmensbibliothek

Alle unterstützten Dateitypen in dieser Tabelle.

%CorporateDesignTemplates%>%CorporatePresentations%

Corporate Presentations

.pptx, .pptm

%CorporateDesignTemplates%>%DocumentTemplates%

Dokumentvorlagen

.docx, .docm

%CorporateDesignTemplates%>%Icons%

Icons

.jpg, .jpeg, .png, .gif, .svg, .tif, .tiff

Außerdem wird .tiff nur unterstützt, wenn der Parameter -l auf false gesetzt ist.

%CorporateDesignTemplates%>%Images%

ODER

%CorporateDesignTemplates%>%Pictures%

Bilder

.jpg, .jpeg, .png, .gif, .svg, .tif, .tiff

Außerdem wird .tiff nur unterstützt, wenn der Parameter -l auf false gesetzt ist.

%CorporateDesignTemplates%>%MasterTemplates%

Master Templates

.pptx, .pptm

%CorporateDesignTemplates%>%Slides%

Slides

.pptx, .pptm

%UserLibrary%>%MyContent%

ODER

%UserLibrary%

Meine Inhalte

Alle unterstützten Dateitypen in dieser Tabelle.

Wichtig

Die Ordnernamen der zu importierenden Daten dürfen keine Punkte enthalten.

Erweiterte Befehle

Wenn Sie zum Bulk-Upload mehr Details mitgeben möchten, können Sie die folgenden Parameter zu Ihrem Befehl hinzufügen:

Befehl

Kurzform

Beschreibung

Standard

--includeSubfolders

-i

Definiert, ob Unterordner mit eingeschlossen werden.

Dieser Parameter kann auf true oder false gesetzt werden.

true

--ignoreUnsupportedFiles

-g

Definiert, ob nicht unterstützte Dateien übersprungen werden.

Dieser Parameter kann auf true oder false gesetzt werden.

Wenn dieser Parameter deaktiviert ist und es nicht unterstützte Dateien gibt, wird der Import abgebrochen und ein Hinweis erscheint.

false

--additionalInformationFile [PFAD]

-f

Definiert den Pfad zu einer zusätzlichen .csv-Datei mit Metadaten, die mit den Dateien hochgeladen werden sollen.

Für weitere Informationen siehe Metadaten zum Import hinzufügen.

-

--archiveSourceFolder [PFAD]

-r

Definiert den Pfad, unter dem der Import-Ordner nach erfolgreichem Upload archiviert werden soll.

Der Ordner wird dann zum Archivordner verschoben und nach dem Zeitstempel benannt.

false

--updateNotification [MODUS]

-n

Definiert das Update-Benachrichtigungsverhalten.

Dieser Parameter kann auf force, update oder disable gesetzt werden.

Dieser Parameter hat keinen Einfluss auf Word-Dateien.

Update-Benachrichtigungen werden nur für einzelne Folien, auf Benutzergeräten gespeicherte Präsentationen, Bilder in Word und Bilder in PowerPoint, die über den Parameter -l hochgeladen wurden, unterstützt.

update

--setTranslationsOutdated

-x

Definiert, ob Übersetzungen bei der Überschreibung von Dateien innerhalb des Übersetzungsverbundes als veraltet markiert werden sollen.

Dieser Parameter kann auf true oder false gesetzt werden.

Dieser Parameter ist abhängig vom Parameter -n.

false

--overwriteExistingFiles

-o

Definiert, ob bestehende Dateien in der empower® Bibliothek überschrieben werden sollen. Damit die Aktualisierung funktioniert, müssen die importierte und die existierende Datei denselben Namen haben.

Dieser Parameter kann auf true oder false gesetzt werden.

Wenn dieser Parameter deaktiviert ist, werden bestehende Dateien übersprungen.

true

--useIncrementalUpload

-m

Definiert, ob nur Dateien, die seit dem letzten Import geändert wurden, aktualisiert werden sollen.

Dieser Parameter kann auf true oder false gesetzt werden.

true

--useLegacySlidesImageFormat

-l

Definiert, ob das ältere Bildformat für empower® für PowerPoint verwendet werden soll.

Dieser Parameter kann auf true oder false gesetzt werden.

Wenn dieser Parameter aktiviert ist, werden Bilddateien nur in empower® für PowerPoint importiert.

Wenn dieser Parameter deaktiviert ist, werden die Bilddateien in einem globalen Format hochgeladen, das mit empower® für PowerPoint, Word, Excel und Outlook kompatibel ist.

false

Wichtig

Wenn Bilder im globalen Dateiformat hochgeladen werden, das für Bibliotheksinhalte in allen Office-Anwendungen funktioniert, funktionieren Updates für Inhalte in empower® für PowerPoint nicht. Außerdem gibt es für diese Dateien keinen Versionsverlauf.

Die Dateien werden dementsprechend hochgeladen, aber die Benutzer erhalten keine Update-Benachrichtigungen.

Für Bilder in Word, die im globalen Dateiformat hochgeladen wurden, erhalten Benutzer jedoch Update-Benachrichtigungen.

Metadaten zum Import hinzufügen

Wenn Sie Metadaten wie z. B. Tags zu Ihrem Import hinzufügen möchten, können Sie eine separate .csv-Datei erstellen, die diese Informationen enthält.

Während des Imports muss der relative Pfad zu dieser Datei im Befehl angegeben werden.

Platzieren Sie die Datei im Import-Quellordner oder in einem seiner Unterordner.

Geben Sie dann den relativen Pfad basierend auf dem Quellordner an.

Die Datei sollte die folgenden Inhalte in derselben Reihenfolge enthalten:

  • Relativer Dateipfad, inklusive Dateierweiterung

  • Name (ohne Dateierweiterung)

    • Definiert einen neuen Dateinamen, der in der empower® Bibliothek gespeichert wird

    • Wenn der Name nicht angegeben wird, wird der ursprüngliche Dateiname aus dem Import-Ordner verwendet.

  • Tags, die in der empower® Bibliothek angezeigt werden

    • getrennt durch Semikolons

    • in doppelten Anführungszeichen ein ("")

  • Indikator, dass nur einzelne Folien hochgeladen werden sollen

    • Verwenden Sie x, um zu definieren, dass nur die erste Folie aus einer Präsentation importiert werden soll.

    • Wenn diese Stelle leer bleibt, wird die gesamte Präsentation importiert

Der folgende Auszug bietet ein Beispiel für die Struktur einer .csv-Datei:

 
Picture File 1.png;New Picture Name;"tag1;tag2;tag3";
Images\Picture File 2.png;;"tag4;tag5;tag6";
Slides\PowerPoint File 1.pptx;New Slide Name;"tag7;tag8";x
Presentations\PowerPoint File 2.pptx;;"tag9";

Anmerkung

Wenn eine der Angaben leer bleibt, z. B. wenn Sie keinen neuen Namen für die Datei angeben möchten, lassen Sie dieses Feld leer.

In diesem Fall befinden sich zwei Semikolons direkt nebeneinander (siehe Zeile 2 und 4 in der Beispielstruktur).

Anmerkung

Es müssen nicht alle Dateien aus dem Import-Ordner in der .csv-Datei enthalten sein.

War dieser Beitrag hilfreich?

/

Kommentare

0 Kommentare

Zu diesem Beitrag können keine Kommentare hinterlassen werden.