GetContainerAttribute

Devuelve los metadatos de archivos del campo contenedor especificado.

Formato

GetContainerAttribute ( campo ; nombreAtributo )

Parámetros

campo: cualquier expresión que devuelve datos del contenedor.

nombreAtributo: el nombre de un atributo admitido (ver más abajo).

Tipo de datos devuelto

texto, número, fecha, hora, fecha y hora, contenedor

Se origina en

13.0

Descripción

Algunos atributos pueden no devolver un resultado. Por ejemplo, los valores de latitud y longitud de una fotografía pueden no estar disponibles o algunos metadatos de audio como la carátula de un álbum pueden no estar disponibles debido a que los metadatos se encuentren almacenados fuera del archivo de audio. Algunos atributos individuales del atributo del grupo all pueden no ser aplicables en algunas circunstancias.

Además, cuando las bases de datos se alojan en Windows o en la nube y se accede a ellas a través de API REST, es posible que algunos atributos de la función GetContainerAttribute (por ejemplo, photo, created, modified y all) devuelvan valores no válidos.

Atributos

Atributo	Devuelve	Tipo de datos devuelto
General
`filename`	El nombre del archivo insertado en el campo contenedor.	texto
`MD5`	El resultado de aplicar la función hash criptográfica MD5 a un archivo insertado en el campo contenedor o a un archivo al que haga referencia un campo contenedor.	texto
`storageType`	El método usado para almacenar los datos en el campo contenedor: Incrustado, External (Secure), External (Open), Referencia de archivo, Texto.	texto
`fileSize`	El tamaño (en bytes) del archivo insertado en el campo contenedor.	número
`internalSize`	La cantidad (en bytes) de espacio dentro del archivo de la base de datos que ocupa el campo contenedor.	número
`externalSize`	La cantidad (en bytes) de espacio que almacena externamente el campo contenedor. Esto es el tamaño del archivo al que se hace referencia o el tamaño total de todos los archivos en el campo contenedor (configuración para almacenamiento seguro o abierto).	número
`externalFiles`	Una lista de los archivos externos asociados al campo contenedor (archivos que usan almacenamiento seguro o abierto, o una referencia de archivo)	texto

Images
`width`	Un número que representa la anchura de la imagen en píxeles.	número
`height`	Un número que representa la altura de la imagen en píxeles.	número
`dpiWidth`	Un número que representa los ppp horizontales de la imagen.	número
`dpiHeight`	Un número que representa los ppp verticales de la imagen.	número
`transparency`	1 si la imagen cuenta con un canal alfa. De lo contrario, devuelve 0.	número

Photos
	Nota Solo los archivos HEIC, JPEG y TIFF devuelven resultados.
`orientation`	Un número que representa la orientación de la fotografía: 1 (Normal) 2 (Volteado horizontalmente) 3 (Girado 180 grados) 4 (Volteado verticalmente) 5 (Girado 90 grados a la izquierda y volteado verticalmente) 6 (Girado 90 grados a la izquierda) 7 (Girado 90 grados a la derecha y volteado verticalmente) 8 (Girado 90 grados a la derecha) Nota Las fotografías que se insertaron con versiones anteriores de clientes FileMaker no se orientan automáticamente; en esas fotografías, se añade no aplicado al resultado. Por ejemplo, 3 (Girado 180 grados), no aplicado.	texto
`created`	La primera fecha y hora disponible para la fotografía.	fecha y hora
`modified`	La fecha y hora disponible más reciente para la fotografía. Si la foto no se ha modificado nunca, se devuelve una cadena vacía.	fecha y hora
`latitude`	La latitud de la ubicación de la fotografía.	texto
`longitude`	La longitud de la ubicación de la fotografía.	texto
`make`	El fabricante de la cámara utilizada para hacer la fotografía.	texto
`model`	El modelo de la cámara utilizado para hacer la fotografía.	texto

Audio
	Nota Solo los archivos MP3 y M4A devuelven resultados.
`title`	El título del archivo de audio.	texto
`artist`	El nombre del intérprete del archivo de audio.	texto
`album`	El nombre del álbum del archivo de audio.	texto
`year`	El año de lanzamiento del archivo de audio.	texto
`track`	El recuento de pistas y número de pista del archivo de audio. Por ejemplo, 3/12 o 3 si el recuento de pistas no está disponible.	texto
`genre`	El género musical del archivo de audio.	texto
`composer`	El compositor del archivo de audio.	texto
`coverArt`	Una imagen de la portada del álbum.	contenedor
`duration`	La duración del archivo de audio. Por ejemplo, 0:03:16.	Hora
`bitRate`	El número de kilobits por segundo (kbps) utilizado en el archivo de audio.	número

Barcodes
`barcodeText`	El contenido del código de barras.	texto
`barcodeType`	El tipo de código de barras.	texto

Signatures
`signed`	La hora y fecha del momento en el que se insertó la firma.	fecha y hora

Groups
`general`	Atributos enumerados en la categoría General anterior que pertenecen al campo contenedor.	texto
`audio`	Atributos enumerados en la categoría Audio anterior que pertenecen al campo contenedor.	texto
`image`	Atributos enumerados en la categoría Images anterior que pertenecen al campo contenedor.	texto
`photo`	Atributos enumerados en la categoría Photos anterior que pertenecen al campo contenedor.	texto
`barcode`	Atributos enumerados en la categoría Barcodes anterior que pertenecen al campo contenedor.	texto
`signature`	Atributos enumerados en la categoría Signatures anterior que pertenecen al campo contenedor.	texto
`all`	Atributos enumerados en todas las categorías anteriores que pertenecen al campo contenedor.	texto

Notas

Los códigos de barras y las firmas no se consideran imágenes.
internalSize puede ser mucho más pequeño que fileSize (por ejemplo, los campos contenedor establecidos para almacenamiento abierto o seguro, referencias de archivos o archivos comprimidos) o mucho más grandes que fileSize (por ejemplo, campos contenedor creados mediante plug-ins).
El atributo MD5 le permite evitar la inserción de archivos duplicados en un campo contenedor independientemente del nombre de archivo.
Los atributos de grupo general, audio, image, photo y all se muestran con el formato nombreAtributo: valorAtributo con un atributo por línea. Algunos atributos se muestran de forma distinta para ajustarse al atributo de una línea:
- externalFiles. Muestra solo el número de archivos externos.
- transparency. Muestra 1 (True) o 0 (False).
- coverArt. Muestra png o jpg según el tipo de imagen.
- bitRate. Muestra kbps después del número. Si un archivo de audio usa una velocidad de bits variable, se añadirá (VBR) al resultado. Por ejemplo: Bit Rate: 247 kbps (VBR).
- year. La información de la fecha puede devolverse entre paréntesis después del año. Por ejemplo: Year: 2019 (10/11/2019)
Cada valor devuelto, excepto el último, finaliza con un retorno de carro.
Para minimizar la frecuencia con la que FileMaker Pro analiza datos del contenedor, utilice GetContainerAttribute en un cálculo de entrada automática de un campo y desactive la opción No reemplazar el valor existente del campo (de haber alguno). En este caso, GetContainerAttribute solo se actualizará cuando cambie el contenido del campo contenedor especificado. Si GetContainerAttribute se utiliza en una definición de campo de cálculo, es posible que se actualice el cálculo cada vez que cambie el registro actual, lo que reducirá el rendimiento de la app personalizada.

Ejemplo 1

Tenga en cuenta que los atributos de los siguientes ejemplos se encuentran entre comillas.

GetContainerAttribute(Imagen;"all") devuelve:

[General]

Filename: IMG_003.JPG

Storage Type: Embedded

MD5: C35A3F668A1FB3F370969399A1FF04FE

File Size: 1964978

Internal Size: 1965064

External Size: 0

External Files: 0

[Image]

Width: 1936

Height: 2592

DPI Width: 72

DPI Height: 72

Transparency: 0 (False)

[Photo]

Orientation: 6 (Rotated 90 degrees counterclockwise)

Created: 14/1/2020 14:40:31

Modified:

Latitude: 37.406167

Longitude: -121,983333

Make: Apple

Modelo: iPhone 11

Ejemplo 2

GetContainerAttribute ( Producto;"barcode" ) devuelve:

[Barcode]

Barcode Text: 875720001107

Barcode Type: UPC-A

Ejemplo 3

GetContainerAttribute ( Paquete;"signature" ) devuelve:

[Signature]

Signed: 10/11/2019 11:41:22