Utilisation du transfert FTP batch

Product
Video Cloud
S'applique aux utilisateurs
Éditeur, Développeur
Version
Brightcove 5
Édition
Pro, Entreprise
Créé par Jessica Nutting.
FTP Batch Provisioning

Découvrez comment utiliser le transfert FTP batch pour ajouter ou modifier des ressources sans utiliser le module Médias dans Video Cloud Studio. Ce document présente une introduction aux principes du XML et explique comment préparer vos ressources statiques au chargement, créer votre fichier de manifeste XML et charger vos fichiers et votre manifeste XML sur un serveur FTP Video Cloud.

Le transfert FTP Batch n’est accessible qu’aux clients Video Cloud Pro et Enterprise. Si vous désirez en savoir plus sur la mise à niveau de votre compte Video Cloud, contactez Brightcove.

Ce document contient les sections suivantes :

Pourquoi utiliser le transfert FTP Batch ?

Le transfert FTP Batch permet de charger, de mettre à jour ou de supprimer plusieurs vidéos et sélections à la fois par le biais d’un manifeste XML et du serveur FTP de Video Cloud. La plupart des actions relatives aux ressources et sélections possibles par le biais du module Médias de Video Cloud Studio sont également possibles avec le transfert FTP batch, et vice-versa. Vous pouvez utiliser le transfert FTP batch pour générer les vidéos et les sélections, qui apparaîtront dans la médiathèque du module Médias une fois le processus de chargement terminé. Cette fonctionnalité permet également de charger un grand nombre de ressources ou d'apporter un grand nombre de modifications rapidement, sans utiliser le module Médias. Toutefois, lorsque vous travaillez sur vos ressources avec le transfert FTP Batch au lieu du module Médias, vous devez spécifier votre chargement avec une syntaxe, des balises et des attributs précis dans un document XML (le manifeste XML) au lieu d'utiliser une interface graphique utilisateur.

Souvent, les éditeurs utilisent le transfert FTP Batch plutôt que le module Médias lorsqu'ils doivent charger, modifier ou supprimer un grand nombre de vidéos ou de sélections selon les besoins d'un système de gestion de contenus (CMS). Ils l'utilisent également pour l'intégration initiale de leur médiathèque sur la plate-forme Video Cloud.

Remarque importante : si une vidéo ou une sélection avec un ID de référence particulier existe déjà dans votre compte, elle sera mise à jour avec les informations du manifeste XML actuel et ce, quel que soit son mode de chargement (module Médias, API médias ou un manifeste XML de transfert FTP Batch antérieur).

Une présentation du processus de transfert FTP Batch

L'organigramme suivant explique le processus de transfert FTP Batch.
 
Organigramme du transfert FTP Batch

Comparaison du transfert FTP Batch et du module Médias

Vous pouvez utiliser le module Médias pour travailler avec les vidéos et les sélections ajoutées avec le transfert FTP Batch. Gardez toutefois à l’esprit les choses suivantes :

  • Si vous apportez des modifications à une vidéo ou une sélection avec le transfert FTP Batch, vous écraserez toute information saisie auparavant avec le module Médias, même si vous n’avez pas modifié toutes les informations. Supposons par exemple qu'une vidéo se trouve dans votre compte, avec tous ses attributs déjà définis. Si vous utilisez le transfert batch pour modifier la description courte de cette vidéo, mais que vous ne fournissez pas d'autre information, les attributs restés vides ne seront pas définis. Donc, si vous utilisez le transfert batch pour modifier des vidéos et sélections existantes, saisissez toutes leurs informations et pas seulement celles que vous désirez modifier. Vous pouvez également tenter d'utiliser l'attribut overlay-update, comme décrit dans la rubrique Modification de vidéos existantes avec le transfert FTP Batch.
  • Si vous définissez des informations de planification avec le transfert FTP Batch, vous devez fournir les dates de début et de fin au format Heure du Pacifique (GMT-7). Lorsque vous visionnez ces informations dans le module Médias, ces heures sont automatiquement converties à l'heure du fuseau horaire défini dans votre profil.

Principales étapes du transfert FTP Batch

Pour utiliser la fonctionnalité de transfert FTP Batch de Video Cloud, suivez les étapes décrites en détail ci-dessous.

  1. Consultez la rubrique Avant de commencer pour comprendre les principes XML et les logiciels que vous aurez à utiliser.
  2. Préparez vos ressources pour le chargement.
  3. Créez votre manifeste XML. Le manifeste XML offre à Video Cloud toutes les informations requises pour gérer les vidéos et sélections chargées.
  4. Chargez vos ressources sur le serveur FTP de Video Cloud.
  5. Chargez votre manifeste XML sur le serveur FTP de Video Cloud.

Une fois le chargement terminé, vous pouvez recevoir un avis par courrier électronique. Celui-ci vous confirme le chargement ou vous décrit les problèmes rencontrés, le cas échéant. Consultez la rubrique Dépannage pour identifier les problèmes rencontrés.

Avant de commencer

Avant de commencer, vous devez connaître ou définir certains paramètres. Vous devez, par exemple, disposer d'une connaissance de base du XML, d'un accès FTP, d'un logiciel éditeur/validateur XML et d'un client FTP.

Connaissances des bases du XML

Pour utiliser le système de transfert FTP Batch de Video Cloud, vous devez connaître les rudiments des principes du XML et de la création de documents XML. Pour vous aider, voici quelques ressources :

Obtention de l’accès FTP

Contactez le support Brightcove et demandez à ce que votre agent de support vous aide à obtenir les autorisations suivantes :

  • Paramétrez votre compte pour qu'il autorise le transfert FTP Batch
  • Obtenez l'accès aux serveurs FTP de Video Cloud

Autrement, les éditeurs Video Cloud Enterprise peuvent se connecter aux serveurs Aspera de Video Cloud. Ces serveurs leur permettent de charger des ressources à un meilleur débit et de façon plus sécurisée pour les chargements à longue distance. Contactez le support Brightcove ou votre administrateur des comptes pour vous aider à obtenir l'accès au FTP ou aux serveurs Aspera.

Installation des outils

Pour utiliser le système de transfert FTP Batch de Video Cloud, vous aurez besoin des outils logiciels suivants :

  • Un éditeur XML pour créer le fichier manifeste XML à charger après les ressources. XML Marker et XRay sont deux éditeurs XML gratuits. Altova XMLSpy et Stylus Studio sont également très répandus. Vous pouvez utiliser un éditeur de texte standard, mais un éditeur XML permettra de réduire le nombre d'erreurs potentielles dans votre manifeste XML.
  • Un utilitaire de vérification de la validité de votre code XML. La plupart des éditeurs s’en chargent eux-mêmes. Vous pouvez malgré tout utiliser un utilitaire tel que le service de validation en ligne du W3C.
  • Un logiciel de client FTP pour charger vos fichiers et le manifeste XML sur le serveur de Video Cloud. Voici quelques logiciels créés dans ce but : WSFTP, AceFTP et CuteFTP. Windows Explorer possède également un client FTP intégré.

Préparation des ressources

Suivez les étapes suivantes pour préparer vos ressources au chargement sur le serveur FTP de Video Cloud.

  1. Groupez les ressources à charger dans un système ou emplacement approprié au travail ou au chargement.
  2. Assurez-vous que chaque ressource est compatible avec les exigences de Video Cloud pour les ressources de ce type.
  3. Vérifiez la compatibilité avec les systèmes automatisés qui traitent les ressources chargées.
    • Vérifiez que vos ressources ne contiennent pas de caractères invalides qui pourraient perturber le traitement de vos fichiers.
    • Les noms de fichier ne doivent compter que des caractères alphanumériques anglais (1-9, A-Z, a-z).
    • Éliminez les caractères incorrects suivants de vos noms de fichier :
      • Les caractères non anglais et/ou ASCII étendu tels que : é ñ å
      • Les caractères non imprimables tels que les espaces et les tabulations. Remplacez les espaces par des tirets bas.
      • Certains signes de ponctuation comme : @ ! * & #. Tirets et caractères de soulignement sont autorisés.
  4. Pour chaque fichier chargé, rassemblez les informations suivantes et saisissez-les dans votre manifeste XML :
    • Le type de ressource Video Cloud.
    • Un identifiant de référence unique pour le fichier. Les ID de référence sont facultatifs pour les vidéos que vous chargez avec le module Médias ou les API médias. Elles sont au contraire obligatoires pour les vidéos chargées ou modifiées par l’intermédiaire du fichier du manifeste XML de transfert FTP batch.
    • Vous pouvez créer une somme de contrôle MD5 (hachage) pour chaque fichier de ressource afin d'améliorer le processus de vérification des erreurs. Pour plus d'informations, consultez la rubrique Création de sommes de contrôle pour le transfert FTP batch.
    • Vous pouvez inclure la taille du fichier en octets pour chaque fichier de ressource afin d'améliorer le processus de vérification des erreurs. Vous devrez peut-être convertir la taille de kilo-octets ou méga-octets à octets. Pour afficher la taille sous Mac OS, sélectionnez le fichier et appuyez sur Pomme + i, ou faites un clic droit et sélectionnez Lire les informations.

Création de votre fichier de manifeste XML

Le manifeste XML fournit à Video Cloud toutes les informations nécessaires pour traiter votre chargement et le publier sur les serveurs Video Cloud. Un seul manifeste XML peut décrire plusieurs vidéos à la fois. Pour créer votre manifeste XML, suivez les étapes suivantes :

  1. Téléchargez l'échantillon de manifeste XML pour le transfert FTP batch et inspirez-vous en pour créer votre propre manifeste XML. Ce manifeste XML a été conçu pour correspondre à l'utilisation la plus fréquente du transfert FTP Batch, à savoir le chargement de vidéos.
  2. Dans votre éditeur XML, ouvrez le manifeste XML d'exemple ou celui que vous avez créé et modifiez-le selon les actions à entreprendre. Consultez la rubrique Transfert FTP Batch : référence pour le manifeste XML, qui contient les spécifications et la syntaxe requises pour les balises et attributs XML à inclure dans votre fichier, ainsi que les spécifications pour les diverses actions que vous pouvez effectuer avec ce fichier.
  3. Validez votre fichier de manifeste XML. Dans la rubrique Transfert FTP Batch : référence pour le manifeste XML, vous pouvez télécharger une définition de type de document (DTD) pour valider votre document.

Combien de vidéos doit comporter mon manifeste ?

Pour un résultat optimal, ne chargez pas trop de vidéos ou de ressources dans un même manifeste XML. Un chargement par lots et son manifeste correspondant ne devraient pas dépasser une limite de 5 Go de ressources ou de 100 ressources, laquelle des deux est atteinte la première. Si vous possédez des ressources supérieures à 5 Go, consacrez un manifeste à chacune.

Dernières vérifications

Une fois votre manifeste XML terminé, faites une dernière vérification avant le chargement des ressources et du manifeste. Servez-vous de cette liste comme guide :

  • Mes ressources sont-elles nommées correctement, sans espaces ou caractères non valides ?
  • Mon manifeste est-il formulé dans un XML correct, sans aucun caractère non valide ? Faites analyser votre manifeste par un utilitaire de validation XML.
  • Les noms de fichier de mes ressources sont-ils correctement spécifiés dans mon manifeste XML, et correspondent-ils aux ressources que je suis sur le point de charger ?
  • Le nombre de ressources sur mon disque correspond-il au nombre de ressources dans mon manifeste XML ?
  • Remarque importante : si une vidéo ou une sélection avec un ID de référence particulier existe déjà dans votre compte, elle sera mise à jour avec les informations du manifeste XML actuel et ce, quel que soit son mode de chargement (module Médias, API médias ou un manifeste XML de transfert FTP batch antérieur).

Chargement de vos ressources et de votre manifeste XML

Une fois que vous avez préparé vos ressources, créé le manifeste XML qui décrit les ressources et tout revérifié, vous êtes prêt à démarrer le chargement de vos ressources et du manifeste.

  1. Connectez-vous au serveur FTP de Video Cloud en saisissant l’URL, le nom d’utilisateur et le mot de passe fourni par votre agent de support Brightcove dans votre client FTP.
  2. Chargez toutes les ressources énumérées dans votre manifeste XML.
    • Vous remarquerez que les fichiers disparaissent du répertoire de chargement sur serveur FTP à mesure qu’ils sont chargés sur le serveur FTP. Cela fait partie du processus : les fichiers sont sécurisés dans une zone intermédiaire jusqu'à ce que le manifeste soit chargé.
    • Ne chargez pas votre manifeste XML tant que tous les fichiers n'ont pas été transférés.
  3. Chargez votre manifeste XML.
    • Vous devez avoir chargé tous les fichiers de ressources avant de charger le manifeste XML. Sans cela, le serveur Video Cloud commencera à interpréter automatiquement votre manifeste. Cela provoquera des erreurs, car le serveur ne pourra pas localiser les fichiers de ressources spécifiées dans le manifeste, étant donné qu'ils n'ont pas encore été chargés sur le serveur FTP Video Cloud.
    • Une fois le chargement des ressources terminé, vous disposez de 48 heures pour charger le manifeste XML.
  4. Lorsque Video Cloud a terminé l’interprétation de votre manifeste, vous recevrez un courrier électronique qui confirmera que tous les fichiers détaillés dans le manifeste ont été reçus par Video Cloud, ou qui vous avertira de tout problème rencontré pendant le transfert, le cas échéant. Vous pouvez également recevoir un rappel d’avis publié à une URL spécifiée dans votre manifeste XML. Remarque : vous ne recevrez un courrier électronique de confirmation que si vous avez défini l’attribut report-success="true" dans votre manifeste XML. Pour plus d’informations sur les causes possibles de problèmes ou de messages d’erreur, consultez la rubrique Transfert FTP Batch : dépannage.
  5. Connectez-vous au module Médias de Video Cloud Studio et éditez les vidéos et sélections chargées par le biais du transfert FTP Batch.
    Remarque importante : la propagation des ressources sur tout le réseau peut prendre jusqu'à une heure. Elles ne peuvent pas être visualisées qu'une fois la propagation terminée. Attendez une heure avant d'essayer de visualiser vos ressources dans le module Médias de Video Cloud Studio.

Rubriques connexes

Pour mieux comprendre le fonctionnement du transfert FTP Batch de Video Cloud, vous pouvez lire les rubriques suivantes :

Lisez les documents suivants pour apprendre les connaissances de base sur le transfert FTP Batch :

Les documents suivants expliquent les diverses méthodes d'utilisation du transfert FTP Batch :

Balises
lot, FTP, télécharger