Utilización de la transferencia FTP por lotes

Product
Video Cloud
Aplicable a roles
Editor, Desarrollador
Versión
Brightcove 5
Edición
Pro, Enterprise
Creado por Chris Howell.
FTP Batch Provisioning

Aprenda cómo utilizar la transferencia FTP por lotes para agregar o editar activos sin usar el módulo Multimedia en Video Cloud Studio. Este documento explica los fundamentos de XML y cómo preparar vídeos y activos para la carga, crear el archivo de manifiesto XML y transferir tanto sus archivos como el archivo de manifiesto XML al servidor FTP de Video Cloud.

La transferencia FTP por lotes únicamente está disponible para los clientes de Video Cloud Pro y Enterprise. Si desea ampliar su cuenta de Video Cloud, póngase en contacto con Brightcove para obtener más información.

Este documento incluye las secciones siguientes:

¿Por qué utilizar la transferencia FTP por lotes?

La transferencia FTP por lotes permite cargar, actualizar y eliminar varios vídeos y listas de reproducción a la vez mediante un archivo de manifiesto XML y el servidor FTP de Video Cloud. La mayoría de las acciones que pueden realizarse con los activos y listas de reproducción a través del módulo multimedia de Video Cloud Studio se pueden efectuar con la transferencia FTP por lotes, y viceversa. Puede utilizar la transferencia FTP por lotes para generar vídeos y listas de reproducción, que aparecerán en su biblioteca de medios en el módulo multimedia una vez que se haya completado el proceso de carga. También le permite cargar grandes cantidades de activos o realizar varias ediciones rápidamente sin acceder al módulo multimedia. Sin embargo, a la hora de ejecutar acciones sobre los activos mediante la función de transferencia FTP por lotes en lugar de utilizar el módulo multimedia, todas las operaciones de transferencia deben especificarse meticulosamente (en cuanto a sintaxis, etiquetas y atributos) en un documento XML (el archivo de manifiesto XML), ya que no se trabaja con una interfaz de usuario gráfica.

A menudo, los editores utilizan la transferencia FTP por lotes en lugar del módulo multimedia cuando necesitan cargar o eliminar un gran número de vídeos o de listas de reproducción, o modificar los ajustes de los mismos, según las necesidades del sistema de gestión de contenidos (CMS), o bien para realizar una ingestión inicial de una biblioteca de vídeos existente en la plataforma de Video Cloud.

Importante: Si en su cuenta ya existe un vídeo o una lista de reproducción con un Id. de referencia determinado, tanto si lo añadió utilizando el módulo Multimedia como la Media API o un archivo de manifiesto XML de una transferencia FTP por lotes anterior, se actualizará con la información contenida en el archivo de manifiesto XML actual.

Resumen del proceso de transferencia FTP por lotes

El diagrama de flujo siguiente explica el proceso de transferencia FTP por lotes.

Diagrama de flujo de la transferencia FTP por lotes

Comparación de la transferencia por lotes con el módulo multimedia

Puede utilizar el módulo multimedia para trabajar con los vídeos y listas de reproducción que ha añadido mediante la transferencia FTP por lotes. Sin embargo, debe tener en cuenta lo siguiente:

  • Si realiza algún cambio sobre un vídeo o una lista de reproducción mediante la transferencia FTP por lotes, sobrescribirá cualquier información que haya introducido antes mediante el módulo multimedia, incluso si no ha cambiado toda la información. Por ejemplo, suponga que ya cuenta con un vídeo en su cuenta con todos los atributos definidos. Si utiliza la transferencia por lotes para modificar la descripción corta del vídeo pero no suministra ningún otro tipo de información sobre el vídeo, el resto de atributos del vídeo quedarán en blanco y no se definirán. Por tanto, si utiliza la transferencia por lotes para modificar vídeos y listas de reproducción existentes, asegúrese de proporcionar toda la información sobre ellos, no sólo los atributos que desea cambiar. Alternativamente, también puede utilizar el atributo overlay-update, según se describe en el tema Modificación de vídeos existentes mediante transferencia FTP por lotes.
  • Si define la información de programación mediante la transferencia FTP por lotes, debe proporcionar las horas de inicio y final utilizando la zona horaria del Pacífico. Al visualizar la información de programación en el módulo multimedia, estas horas se traducen automáticamente a la zona horaria definida en su perfil de usuario.

Pasos principales para transferencia FTP por lotes

Para utilizar la función de transferencia FTP por lotes de Video Cloud, siga los pasos que se explican a continuación.

  1. Consulte Antes de empezar para conocer los fundamentos de XML y el software que necesitará utilizar.
  2. Prepare sus activos para la carga.
  3. Cree su manifiesto XML. El manifiesto XML proporciona a Video Cloud toda la información que el servicio requiere para gestionar los vídeos y las listas de reproducción que carga.
  4. Cargue sus activos al servidor FTP de Video Cloud.
  5. Cargue su manifiesto XML al servidor FTP de Video Cloud.

Después de que se complete su carga, puede recibir una notificación por correo electrónico que confirme que Video Cloud ha recibido sus archivos correctamente o que le informe de cualquier problema que haya surgido durante la transferencia. Consulte Identificación de problemas para obtener información que le ayude a identificar los problemas con los que se puede encontrar.

Antes de empezar

Antes de comenzar, es necesario saber o configurar algunas cosas, como disponer de unos conocimientos básicos de XML, obtener acceso al servidor FTP e instalar un editor/verificador de XML y un programa cliente de FTP.

Nociones de XML

Para utilizar el sistema de transferencia FTP por lotes de Video Cloud, debe contar con conocimientos básicos de XML y tener experiencia en la creación de documentos XML. Si necesita una guía sobre XML, puede utilizar los siguientes recursos básicos:

Obtener acceso FTP

Debe ponerse en contacto con el Centro de asistencia técnica de Brightcove y pedir al representante que le ayude con los permisos siguientes:

  • Configurar su cuenta para permitir la transferencia FTP por lotes 
  • Obtener acceso a los servidores FTP de Video Cloud

Alternativamente, los editores de Video Cloud Enterprise pueden conectarse a los servidores Aspera de Video Cloud para efectuar transferencias seguras a velocidades notablemente mayores, particularmente para las cargas originadas desde grandes distancias. Póngase en contacto con el Centro de asistencia técnica de Brightcove o con el gestor de su cuenta si necesita ayuda.

Instalar estas herramientas

Para utilizar el sistema de transferencia FTP por lotes de Video Cloud, necesitará unas cuantas herramientas básicas de software:

  • Un editor XML para crear el archivo de manifiesto XML que deberá cargar después de sus activos. XML Marker y XRay son dos editores XML gratuitos; Altova XMLSpy y Stylus Studio son otros dos editores XML conocidos. Puede utilizar un editor de textos sin formato, pero un editor de XML le ayudará a reducir el número de errores en su código XML.
  • Una utilidad para comprobar si su XML es válido y está bien formado. La mayoría de editores XML validan su XML. También podría utilizar una utilidad como el servicio de validación basado en web de W3C.
  • El software de cliente FTP para cargar sus archivos y el manifiesto XML al servidor de Video Cloud. Algunos programas cliente de FTP que puede utilizar son: WSFTP, AceFTP y CuteFTP. También existe un cliente FTP integrado en Windows Explorer.

Preparar sus activos

Siga estos pasos para preparar sus activos para la transferencia FTP al servidor de Video Cloud.

  1. Reúna los activos que desee cargar en una ubicación o sistema adecuado para trabajar con ellos y cargarlos.
  2. Asegúrese de que todos los activos son compatibles con los requisitos de Video Cloud para activos de este tipo.
  3. Asegure la compatibilidad con los sistemas automáticos que procesan activos cargados.
    • Asegúrese de que sus activos no contienen caracteres no permitidos que puedan interferir en el procesamiento de sus archivos.
    • Asegúrese de que los nombres de sus archivos sólo contengan caracteres alfanuméricos del alfabeto inglés (1-9, A-Z, a-z).
    • Elimine los siguientes caracteres no admisibles en los nombres de sus archivos:
      • Caracteres no ingleses y/o con código ASCII alto, como: é ñ å
      • Caracteres no imprimibles, como espacios y tabulaciones. Sustituya los espacios por guiones bajos.
      • Ciertos caracteres de puntuación como: @ ! * & #. Los guiones y guiones bajos están permitidos.
  4. Por cada archivo que cargue necesitará la información siguiente, que deberá incluir en el archivo de manifiesto XML:
    • El tipo de activo de Video Cloud.
    • Un Id. de referencia único para el archivo. Los IDs de referencia no son obligatorios para los vídeos que se carguen usando el módulo Multimedia o las Media APIs, pero sí para los vídeos que se carguen o modifique mediante el archivo de manifiesto XML de la transferencia FTP por lotes.
    • Opcionalmente, puede crear una suma de comprobación MD5 (también denominada "hash") por cada archivo de activo para facilitar la comprobación de errores. Para obtener más información, consulte Creación de sumas de comprobación para las transferencias FTP por lotes.
    • Opcionalmente, puede incluir el tamaño en bytes de cada archivo de activos para facilitar la comprobación de errores. Puede que deba convertir el tamaño de archivo de kilobytes o megabytes a bytes. Si utiliza Mac OS, para obtener el tamaño del archivo, seleccione el archivo y pulse "Apple + i", o haga clic con el botón derecho y seleccione Obtener información.

Creación del archivo de manifiesto XML

El manifiesto XML proporciona a Video Cloud toda la información necesaria para procesar su carga y ponerla a disposición en sus servidores de Video Cloud. Un archivo de manifiesto XML simple puede describir varios vídeos. Siga estos pasos para crear su archivo de manifiesto XML:

  1. Descargue el documento Manifiesto XML de ejemplo para la transferencia FTP por lotes, que puede utilizar como punto de partida para su propio manifiesto. Este archivo de manifiesto XML contiene el caso de uso más común para una transferencia FTP por lotes, que consiste en cargar vídeos usando el archivo de manifiesto XML.
  2. En su editor de XML, abra el archivo de manifiesto XML de ejemplo, o el que usted haya creado, y modifíquelo basándose en las acciones que necesite ejecutar. Consulte Transferencia FTP por lotes: Referencia para el archivo de manifiesto XML, que contiene las especificaciones y la sintaxis correspondientes a las etiquetas y a los atributos XML que deberá incluir en su archivo, así como especificaciones de las diversas acciones que podrá realizar con el archivo.
  3. Valide el archivo de manifiesto XML. En Transferencia FTP por lotes: Referencia para el archivo de manifiesto XML puede descargar una definición de tipo de documento (DTD) para validar su documento.

¿Cuántos vídeos pueden especificarse en un manifiesto?

Para obtener los mejores resultados, no transfiera demasiados vídeos o activos en un mismo manifiesto XML. Un lote de transferencia y su correspondiente manifiesto no deben incluir más de 5 GB de activos ni más de 100 activos, lo que se alcance primero. Si alguno de sus activos ocupa más de 5 GB, cárguelo en su propio manifiesto.

Comprobaciones finales

Cuando haya acabado de preparar su manifiesto XML, realice una comprobación final para asegurarse de que está preparado para empezar la carga de sus activos y del archivo de manifiesto XML. Utilice esta lista de comprobación como guía:

  • ¿Son correctos los nombres de mis activos, sin espacios o caracteres no permitidos?
  • ¿Está bien formado y es válido el código XML de mi archivo de manifiesto XML, y está libre de caracteres no permitidos? Compruebe su archivo de manifiesto con una utilidad de validación de XML.
  • ¿Están correctamente especificados en mi archivo de manifiesto XML los nombres de los archivos, y coinciden con los archivos que voy a cargar?
  • ¿Cuadran el número de activos del disco y el número de activos de mi archivo de manifiesto XML?
  • Importante: Si en su cuenta ya existe un vídeo o una lista de reproducción con un Id. de referencia determinado, tanto si lo añadió utilizando el módulo Multimedia como las Media APIs o un archivo de manifiesto XML de una transferencia FTP por lotes anterior, se actualizará con la información contenida en el archivo de manifiesto XML actual.

Carga de los activos y del manifiesto XML

Después de haber preparado sus activos, creado el manifiesto XML que describe los activos y comprobado todo, ya está todo listo para iniciar la carga de los activos y del archivo de manifiesto XML.

  1. Acceda al servidor FTP de Video Cloud, utilizando un cliente FTP y la dirección URL, nombre de usuario y contraseña que le proporcionó su representante de asistencia técnica de Brightcove.
  2. Cargue todos los activos listados en su archivo de manifiesto XML.
    • A medida que progresa su carga, se dará cuenta de que sus archivos desaparecen del directorio de carga de su servidor FTP poco después de cargarse en el servidor FTP. Esto ocurre porque los archivos normales se guardan de forma segura en un área de prueba hasta que se carga el manifiesto.
    • No cargue el archivo de manifiesto XML antes de que todos sus archivos se hayan transferido correctamente.
  3. Cargue el archivo de manifiesto XML.
    • Es importante cargar todos los archivos de activos antes de cargar el manifiesto XML; de lo contrario, el servidor de Video Cloud empezará a procesar el archivo de manifiesto XML. Esto generará errores cuando el servidor no pueda localizar archivos de activos especificados en el archivo de manifiesto XML, pero que aún no han sido cargados en el servidor FTP de Video Cloud.
    • Una vez completada la carga de los activos, tiene 48 horas para cargar el archivo de manifiesto XML.
  4. Cuando Video Cloud haya acabado de procesar su manifiesto, recibirá un correo electrónico confirmando que Video Cloud ha recibido correctamente los archivos detallados en el manifiesto o notificándole cualquier problema encontrado durante la transferencia. También puede recibir una devolución de llamada de notificación enviada a una URL que proporcionó en su archivo de manifiesto XML. Nota: Recibirá un correo electrónico de confirmación únicamente si definió el atributo report-success="true" en su archivo de manifiesto XML. Para obtener información sobre las posibles causas de los problemas o mensajes de error, consulte Transferencia por lotes: Identificación de problemas.
  5. Conéctese al módulo multimedia de Video Cloud Studio y edite los vídeos y las listas de reproducción que haya cargado mediante la transferencia FTP por lotes.
    Nota importante: Los activos pueden tardar hasta una hora en propagarse completamente por la red antes de estar disponibles para su previsualización. Espere una hora antes de intentar ver sus activos en el módulo multimedia de Video Cloud Studio.

Temas relacionados

Además de este documento, puede leer otros documentos que le ayudarán a comprender y utilizar la función de transferencia FTP por lotes de Video Cloud.

Lea los documentos siguientes para conocer los fundamentos de la transferencia FTP por lotes:

Los siguientes documentos explican las diferentes maneras de utilizar la transferencia FTP por lotes:

Etiquetas
lote, FTP, cargar