El negocio de Claro video Brasil requiere ingestar y enriquecer los archivos XMLs que actualmente proporciona el proveedor de los contenidos VOD con las bases de datos de AMCO y Gracenote, para disponibilidad de otras herramientas mediante el uso del MDM.
Operaciones
Brasil
Usuarios
No aplica
Dispositivos
No aplica
Situación actual
Actualmente Claro video Brasil recibe archivos XML de diferentes proveedores dependiendo del tipo de contenido.
Necesidad del negocio
Ingestar, procesar y enriquecer , los archivos XMLs que actualmente proporcionan los proveedores de contenido VOD, considerando lo siguiente:
Si el dato se encuentra marcado como requerido y no se encuentra en la base de datos del proveedor, se debe realizar un cruce con las bases de datos de AMCO y Gracenote. En caso de no contar con información en las bases anteriores se debe preparar la aplicación para que el usuario pueda realizar una actualización manual del atributo.
Se debe identificar mediante filtro aquellos contenidos que deben consultar en Gracenote.
Historias de usuario
ID
HU001 Especificación para proveedores VOD
ID
HU001 Especificación para proveedores VOD
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que los archivos de contenido VOD cumplan con los criterios que se indican en esta historia de usuario Para estandarizar la recepción de información por parte de los proveedores.
Criterios de aceptación
El formato en que se debe presentar el paquete de contenido VOD debe ser un archivo XML.
El archivo XML debe cumplir con lo descrito en el documento normativoNET_NOW_Content_Acquisition 30-08_2019.pdf.
El paquete ADI puede estar integrado por los siguientes archivos:
Si el contenido es película, el paquete ADI puede contener los siguientes archivos:
ADI-XML (metadados),
.ts (transport stream) película
.ts (transport stream) preview (este archivo es opcional y no todas las películas lo tienen).
Archivo de texto .srt para subtítulos (este archivo también es opcional y no todas las películas lo tienen).
.jpg (Poster).
Si el contenido es anuncio de publicidad, el paquete puede contener 2 archivos: ADI-XML (metadados) y .ts (transport stream).
EL paquete de contenido VOD puede incluir una película o un anuncio de publicidad.
Ambos contenidos deben cumplir con el estándar de ADI.
Si el contenido es una película, se debe respetar la estructura del XML que se define en la historia de usuario HU002.
Si el contenido es un anuncio de publicidad, se debe respetar la estructura del XML que se define en la historia de usuario HU003.
Cada uno de los archivos debe contar con la información necesaria de los metadatos.
Se debe enviar un paquete ADI por cada contenido VOD a ingestar en la plataforma.
Existen actualizaciones a los contenidos VOD (película o poster). Esto se identifica mediante la versión del archivo. En caso de que solo sea una actualización de metadatos solo se recibe el archivo XML.
Se adjunta archivo:
ID
HU002 Estructura XML - Película
ID
HU002 Estructura XML - Película
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que se valide la estructura de los archivos XML con contenido Película Para garantizar que se cumple con el estándar establecido para este tipo de contenido.
Para los atributos que se indican en este layout se debe validar:
Que los atributos marcados como requeridos se encuentren disponibles en el archivo XML.
ID
HU003 Estructura XML - Anuncio de publicidad
ID
HU003 Estructura XML - Anuncio de publicidad
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que se valide la estructura de los archivos XML con contenido Anuncio de video Para garantizar que se cumple con el estándar establecido para este tipo de contenido.
Todos los atributos que se indican en este layout son requeridos.
La estructura del XML está basada en un ejemplo proporcionado por el equipo de Brasil (No existe normatividad para este tipo de contenido).
Se adjunta ejemplo de referencia:
ID
HU004 Atributo marcado como requerido
ID
HU004 Atributo marcado como requerido
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para los atributos marcados como requeridos en el layout del XML se consideren las reglas que se describen en esta historia de usuario Para garantizar el enriquecimiento de las bases de datos.
Criterios de aceptación
Para los atributos marcados como Requeridos en el layout del XML se debe validar lo siguiente:
Si el atributo no se encuentra en el archivo del proveedor, se debe buscar en las siguientes bases de datos, en el orden que se indica:
AMCO
Gracenote
Se debe validar que el contenido se encuentre configurado para poder realizar esta acción. Ver historia de usuario HU005.
Si el atributo no se encuentra en las bases anteriores, se debe permitir al usuario realizar una actualización manual de este atributo.
No se puede ingestar información si no se cuenta con la totalidad de los atributos marcados como requeridos, en este caso se debe detener la ingesta y mandar una alerta.
Para el caso en que un atributo sea opcional y no tenga información, se debe permitir la ingesta pero se debe enviar una alerta.
ID
HU005 Contenidos que deben consultar en Gracenote
ID
HU005 Contenidos que deben consultar en Gracenote
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que se configuren aquellos contenidos VOD que deben consultar información en Gracenote Para poder administrar el enriquecimiento de los datos marcados como requeridos.
Criterios de aceptación
Se debe configurar mediante filtros los contenidos VOD que deben consultar información en Gracenote.
ID
HU006 Nombrado del archivo XML VOD
ID
HU006 Nombrado del archivo XML VOD
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que no se valide la estructura del nombre de los archivos XML de contenido VOD Para que no sea considerado dentro del alcance del proyecto.
Criterios de aceptación
No existe actualmente una nomenclatura que se deba validar en el nombrado de los archivos de contenido VOD.
La información relevante sobre filme, serie, etc, se encuentra dentro del archivo XML y así AMCO debe revisarlas.
ID
HU007 Ubicación del archivo XML VOD
ID
HU007 Ubicación del archivo XML VOD
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que el MDM de AMCO tome los archivos XML VOD de la estructura de directorio definida en esta historia de usuario Para que homologar la transferencia de archivos.
Criterios de aceptación
El MDM de AMCO debe tomar los archivos XML VOD de la estructura de directorio compartida por el equipo de Brasil.
Esta estructura de directorios debe ser similar a la que opera actualmente para los otros backends.
El acceso a la estructura de directorios debe realizarse vía SFTP. desde una dirección IP fija.
El acceso al SFTP del equipo de Brasil, debe realizarse mediante las VPN de los ambientes UAT para:
GLOBAL General 54.208.98.127 ANDINA Perú 3.226.212.12 ANDINA Chile 34.227.164.71
Los datos para conectarse a la estructura de directorios compartida por el equipo de Brasil deben ser los siguientes:
SFTP - sftp://201.6.6.35
user - amco
password - XXXXX
port - 3222
ID
HU008 Ingesta de archivos XML
ID
HU008 Ingesta de archivos XML
Historia de usuario
Yo como negocio de Claro video Quiero que se consideren las reglas descritas en esta historia de usuario Para la ingesta de contenido en la plataforma.
Criterios de aceptación
Un paquete ADI cuenta con Asset (como parte del paquete)
Para el caso de operación “normal”, el orden para procesar los archivos es el orden que se reciban.
La plataforma de AMCO debe tener la funcionalidad de priorización para un Asset especifico y así procesarlo antes de los demás.
Un Asset se puede volver a lanzar o modificar en un nuevo paquete ADI.
La plataforma no debe sustituir/quitar el paquete original, en caso que se vuelva a lanzar el mismo contenido, esto debe tener una versión incremental (ejemplo: v2).
ID
HU009 Atributo - Assets_Class
ID
HU009 Atributo - Assets_Class
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que se identifique mediante el atributo Assets_Class el tipo de assets que se esta recibiendo Para validar la estructura de los metadatos con base al tipo de paquete.
Criterios de aceptación
Se debe identificar mediante el atributo Assets_Class el tipo de assets que se esta recibiendo como parte del paquete.
Se debe validar que la estructura y contenido de cada metadatos correspondan al layout definido para cada tipo de clase.
Application meta-data.
Ver historia de usuario HU010.
Title assets meta-data
Ver historia de usuario HU011.
Movie assets meta-data
Ver historia de usuario HU012.
Poster assets meta-data
Ver historia de usuario HU013.
Preview assets meta-data
Ver historia de usuario HU014.
ID
HU010 Application meta-data
ID
HU010 Application meta-data
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el tipo de clase Application-meta-data se valide la estructura definida en el layout Para garantizar el cumplimiento de la norma ADI.
Que los atributos marcados como requeridos se encuentren disponibles en el XML.
ID
HU011 Title assets meta-data
ID
HU011 Title assets meta-data
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el tipo de clase Title assets meta-data se valide la estructura definida en el layout Para garantizar el cumplimiento de la norma ADI.
Criterios de aceptación
Se debe validar que se cumpla con el layout definido en la siguiente ruta:
Para cada atributo se debe validar:
Que los atributos marcados como requeridos se encuentren disponibles en el XML.
ID
HU012 Movie assets meta-data
ID
HU012 Movie assets meta-data
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el tipo de clase Movie assets meta-data se valide la estructura definida en el layout Para garantizar el cumplimiento de la norma ADI.
Criterios de aceptación
Se debe validar que se cumpla con el layout definido en la siguiente ruta:
Para cada atributo se debe validar:
Que los atributos marcados como requeridos se encuentren disponibles en el XML.
ID
HU013 Poster assets meta-data
ID
HU013 Poster assets meta-data
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el tipo de clase Poster assets meta-data se valide la estructura definida en el layout Para garantizar el cumplimiento de la norma ADI.
Criterios de aceptación
Se debe validar que se cumpla con el layout definido en la siguiente ruta:
Para cada atributo se debe validar:
Que los atributos marcados como requeridos se encuentren disponibles en el XML.
ID
HU014 Preview assets meta-data
ID
HU014 Preview assets meta-data
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el tipo de clase Preview assets meta-data se valide la estructura definida en el layout Para garantizar el cumplimiento de la norma ADI.
Criterios de aceptación
Se debe validar que se cumpla con el layout definido en la siguiente ruta:
Para cada atributo se debe validar:
Que los atributos marcados como requeridos se encuentren disponibles en el XML.
ID
HU015 Atributo - Assets_ID
ID
HU015 Atributo - Assets_ID
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el atributo Assets_ID se consideren las reglas descritas en esta historia de usuario Para su ingesta en la plataforma.
Criterios de aceptación
Se debe validar que el atributo Assets_ID cumpla con lo siguiente:
Debe estar integrado por 4 letras y 16 números
Este atributo debe ser un valor único. Es decir, no se puede repetir entre clases y entre archivos.
ID
HU16 Atributo - Actors
ID
HU16 Atributo - Actors
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el atributo Actors se consideren las reglas descritas en esta historia de usuario Para su ingesta en la plataforma.
Criterios de aceptación
Se deben almacenar todos los atributos Actors contenidos en el archivo XML.
Para cada atributo se debe validar que cumpla con la siguiente estructura: Last Name + First Name
Se deben separar los valores Last Name y First Name mediante el uso de comas.
Se deben respetar y almacenar los caracteres especiales que se incluyan en este atributo.
Debe existir un registro por cada atributo Actors.
ID
HU17 Atributo - Actors_Display
ID
HU17 Atributo - Actors_Display
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para los atributos Actors_Display se consideren las reglas descritas en esta historia de usuario Para su ingesta en la plataforma.
Criterios de aceptación
Se deben concatenar los atributos Actors que se encuentren en el archivo XML del proveedor.
El orden de concatenación debe corresponder al orden de aparición en la consulta.
Ejemplo: Actors1 + Actor2 + Actor3
La separación entre actores debe realizarse mediante una coma.
Para cada atributo concatenado se debe mantener la siguiente estructura: First Name + Last Name ya que este dato es el que se toma para presentarlo al usuario final en las búsquedas.
Se deben respetar y almacenar los caracteres especiales que se incluyan en este atributo.
Debe existir un único registro para este atributo.
ID
HU018 Atributo - Director
ID
HU018 Atributo - Director
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el atributo Director se consideren las reglas descritas en esta historia de usuario Para su ingesta en la plataforma.
Criterios de aceptación
Por cada contenido VOD enviado por el proveedor, puede existir mas de un valor para el atributo Director.
Se deben almacenar todos los atributos Director contenidos en el archivo XML.
Para cada atributo se debe validar que cumpla con la siguiente estructura: Last Name + First Name
Se deben separar los valores Last Name y First Name mediante el uso de comas.
Se deben respetar y almacenar los caracteres especiales que se incluyan en este atributo.
Debe existir un registro por cada atributo Director.
ID
HU019 Atributo - Director_Display
ID
HU019 Atributo - Director_Display
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el atributo Director_Display se consideren las reglas descritas en esta historia de usuario Para su ingesta en la plataforma.
Criterios de aceptación
Se deben concatenar los atributos Director que se encuentren en el archivo XML del proveedor.
El orden de concatenación debe corresponder al orden de aparición en la consulta.
Ejemplo: Director1 + Director2 + Director3.
La separación entre actores debe realizarse mediante una coma.
Para cada atributo concatenado se debe considerar la siguiente estructura: First Name + Last Name.
Se deben respetar y almacenar los caracteres especiales que se incluyan en este atributo.
Debe existir un único registro para este atributo.
ID
HU020 Atributo - Category
ID
HU020 Atributo - Category
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el atributo Category se consideren las reglas descritas en esta historia de usuario Para su ingesta en la plataforma.
Criterios de aceptación
Este atributo hace referencia a la dirección dónde se localizan los assets físicos dentro del catálogo de VOD de Claro.
Se debe almacenar este dato como viene en el XML y así se enviará a Sea Change.
ID
HU021 Atributo - ExtraData_1
ID
HU021 Atributo - ExtraData_1
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el atributo ExtraData1 se consideren las reglas descritas en esta historia de usuario Para su ingesta en la plataforma.
Criterios de aceptación
Este atributo es un campo customizado para Claro, cada número representa a un proveedor.
Se debe validar que el valor que se indica en el XML corresponda con la lista de valores proporcionadas, para garantizar que se guarde un valor válido.
Los valores de este campo se encuentran en una lista dinámica que genera el equipo de Brasil, cuando se tiene un nuevo proveedor es necesario generar un nuevo id.
Se comparte lista de proveedores con su id asociado:
ID
HU022 Atributo - Subtitle/Dubbed Language
ID
HU022 Atributo - Subtitle/Dubbed Language
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el atributo Subtitle/Dubbed Language se consideren las reglas descritas en esta historia de usuario Para su ingesta en la plataforma.
Criterios de aceptación
Si el contenido VOD es un contenido local los valores para estos atributos pueden NO venir en el archivo XML.
Si el contenido NO es local, se debe validar que en el archivo XML se considere por lo menos uno de los 2 valores.
No se debe ingestar esta información de no cumplirse este criterio.
Se debe notificar al operador cuando este escenario ocurra.
ID
HU023 Atributo - Content_FileSize
ID
HU023 Atributo - Content_FileSize
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el atributo Content_FileSize se consideren las reglas descritas en esta historia de usuario Para su ingesta en la plataforma.
Criterios de aceptación
Aplica únicamente para contenidos que deben ser ingestados dentro de la infraestructura de Claro.
Para un deeplink este atributo no es requerido.
ID
HU024 Atributo - Content_Remote
ID
HU024 Atributo - Content_Remote
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que para el atributo Content_Remote se consideren las reglas descritas en esta historia de usuario Para su ingesta en la plataforma.
Criterios de aceptación
Aplica únicamente para contenidos de deeplink.
ID
HU025 Volumen de Información
ID
HU025 Volumen de Información
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que el proceso de ingesta de contenido VOD considere los valores que se indica en esta historia de usuario Para garantizar el correcto funcionamiento de la herramienta.
Criterios de aceptación
Para el desarrollo de la herramienta MDM de AMCO se deben tomar en cuenta los siguientes valores:
El volumen de información actual para contenidos VOD es aproximadamente de 150.000 títulos.
El volumen de información que se recibe al día para los contenidos VOD es de aproximadamente 400 títulos al día entre archivos de inclusión y alta.
El volumen de cambio/actualización para los contenidos VOD es de aproximadamente de 600 títulos al día entre inclusión y bajas.
La recepción de estos archivos se presenta durante el transcurso del día.
No existe un horario definido para esta acción.
ID
HU026 Procesos en paralelo (Ingesta)
ID
HU026 Procesos en paralelo (Ingesta)
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que se permita la ingesta de contenidos como 2 procesos en paralelo Para contenido VOD y Lineal.
Criterios de aceptación
El CMS debe permitir ingestar contenido VOD y lineal de forma paralela.
ID
HU027 Validaciones
ID
HU027 Validaciones
Historia de usuario
Yo como negocio de Claro video Quiero que cuando ocurran los escenarios que se describan en esta historia de usuario se presente una alerta Para notificarle al proveedor de servicios.
Criterios de aceptación
Se debe generar un módulo que permita filtrar los contenidos a ingestar dentro del MDM de AMCO.
Este módulo será desarrollado en una segunda fase de este proyecto.
El equipo de Brasil debe definir las variables/validaciones que se deben considerar para poder generar el proceso de validación.
ID
HU028 Archivo final de datos
ID
HU028 Archivo final de datos
Historia de usuario
Yo como negocio de Claro video Brasil Quiero que después de realizar la ingesta de contenidos VOD, el MDM de AMCO genere un archivo final de datos Para poder comunicarnos con las herramientas de Brasil.
Criterios de aceptación
Como resultado de la ingesta de contenidos VOD en el MDM de AMCO, se debe generar un archivo final de datos que será proporcionado al equipo de Brasil.
El archivo final de datos debe considerar lo siguiente:
Si el archivo final de datos corresponde a un evento de tipo película o episodio de una serie, debe cumplir con la estructura que se describe en el siguiente link: PENDIENTE de validar con el equipo de Brasil.
Si el archivo final de datos corresponde a un anuncio de publicidad, debe cumplir con la estructura que se describe en el siguiente link: PENDIENTE de validar con el equipo de Brasil.
Para el archivo final de datos descrito en el punto 2.a se debe considerar lo siguiente:
Debe contener los atributos enriquecidos con la base de datos de AMCO y Gracenote (según aplique).
Debe contener el Identificador único actual de Brasil.
Assets_ID
Debe contener Identificador de AMCO
contentId
Para el archivo final de datos descrito en el punto 2.b se debe considerar lo siguiente:
Debe contener el Identificador único actual de Brasil.
Assets_ID
Debe contener el Identificador de AMCO
contentId
El contentId de AMCO se usará para el procesamiento de la lista de recomendación de contenidos.
El regreso a las APIs de Brasil será con base al identificador actual Assets_ID.
Esta solución será únicamente durante el proceso de transición, la idea es que al final del proyecto, el equipo de Brasil utilice el Id de AMCO (contentId), tal y como lo hace el resto de las operaciones.
El equipo de backend de AMCO debe agregar a las estructuras definidas para los archivos finales de datos descritos en el punto 2, los atributos de la base de datos de AMCO y Gracenote (según aplique) que consideren necesarios para completar el archivo final de datos.
ID
HU029 Priorizar desarrollo
ID
HU029 Priorizar desarrollo
Historia de usuario
Yo como negocio de Claro video Brasil Quiero se priorice el proceso de ingesta de contenido VOD Para iniciar el desarrollo del MDM de AMCO.
Criterios de aceptación
Se debe priorizar el proceso de ingesta de contenido VOD sobre el contenido Lineal.