roAssetCollection
6 min
este objeto se utiliza para representar una colección de recursos creación de objetos el objeto roassetcollection se crea sin parámetros createobject("roassetcollection") puede llenar una colección de recursos con llamadas individuales a addasset() o addassets() también puede llenar una colección de recursos utilizando el método rosyncspec getassets() , como se muestra a continuación assetcollection = createobject("roassetcollection") localcurrentsync = createobject("rosyncspec") if localcurrentsync readfromfile("local sync xml") then 	assetcollection = localcurrentsync getassets("download") endif iffailurereason getfailurereason() as string devuelve información adicional si falla un método ifassetcollection addasset(asset info as dynamic) as boolean agrega un único recurso desde un arreglo asociativo o una cadena con formato json si el argumento es una cadena, debe coincidir con el formato utilizado para un único recurso en una especificación de sincronización json devuelve true para indicar éxito y false para indicar fallo si se devuelve false, hay información más detallada disponible llamando al método getfailurereason addassets(asset info array as dynamic) as boolean agrega múltiples recursos desde un objeto enumerable (un objeto rolist , roarray , o una cadena que contiene un arreglo con formato json) que contiene arreglos asociativos compatibles devuelve true para indicar éxito y false para indicar fallo si se devuelve false, hay información más detallada disponible llamando al método getfailurereason getassetlist() as rolist devuelve una instancia de rolist que contiene arreglos asociativos de metadatos de recursos este método no es eficiente y, por lo tanto, se recomienda solo para propósitos de depuración y diagnóstico cada arreglo asociativo contiene lo siguiente name string obligatorio el nombre del recurso para que un archivo se materialice, debe tener un nombre de archivo válido (es decir, sin barras diagonales) link string obligatorio la ubicación de descarga del recurso size integer/string opcional el tamaño del recurso use una cadena si desea especificar un número demasiado grande para caber en un entero (esto permite tamaños de archivo superiores a 2 gb) hash string opcional una cadena con el formato "hash algorithm\ hash" consulte la siguiente tabla para ver los algoritmos hash disponibles change hint string opcional cualquier cadena que cambie junto con el contenido del archivo esto no es necesario si se proporciona el enlace o el hash y siempre cambia auth inherit boolean opcional indicación de si este recurso usa o no información de autenticación de roassetfetcher el valor predeterminado es true auth user boolean opcional usuario que se utilizará para la autenticación al descargar solo este recurso esto deshabilita automáticamente "auth inherit" auth password boolean opcional contraseña que se utilizará al descargar solo este recurso esto deshabilita automáticamente "auth inherit" headers inherit boolean opcional el comando para pasar cualquier proveedor de encabezados a roassetfetcher al obtener este recurso el valor predeterminado es true cualquier campo "optional" que se especifique al rellenar el pool también debe especificarse al recuperar assets del pool (es decir, se convierten en "mandatory" una vez que se usan para un asset) por ejemplo, si el valor hash se especifica al obtener datos en el pool, entonces también debe especificarse al intentar hacer referencia a archivos en el pool algoritmos hash sha1 si hay un sha1 disponible, puede validar el hash mientras se descarga el archivo si dicho hash está disponible, debería utilizarse las propiedades link y change hint no tienen ningún efecto en el nombre de archivo del pool, por lo que el archivo se comparte incluso si se descarga desde diferentes ubicaciones besha1 este algoritmo aplica hash a parte del archivo junto con el tamaño del archivo para verificar el contenido también mueve las propiedades link y change hint al nombre de archivo del pool md5 utiliza el algoritmo hash md5 para validar archivos (ninguno) sin ningún hash, el archivo no puede verificarse mientras se descarga, y el sistema dependerá de las propiedades link y change hint para dar al pool un nombre de archivo único