GetContainerAttribute

Retorna os metadados do arquivo do campo de container especificado.

Formato

GetContainerAttribute ( campo ; nomeDeAtributo )

Parâmetros

campo - qualquer expressão que retorna dados de container.

nomeDeAtributo - o nome de um atributo suportado (veja abaixo).

Tipo de dados retornado

texto, número, data, hora, carimbo de data/hora, container

Originada na versão

13.0

Descrição

Alguns atributos podem não retornar um resultado. Por exemplo, os valores de latitude e longitude de uma foto podem não estar disponíveis ou alguns metadados de áudio, como arte de álbum, podem não estar disponíveis porque os metadados estão armazenados fora do arquivo de áudio. Alguns atributos individuais no atributo de grupo all podem não ser aplicáveis em algumas circunstâncias

Além disso, quando os bancos de dados são hospedados no Windows ou na nuvem e acessados via APIs REST, alguns atributos da função GetContainerAttribute (como, photo, created, modified e all) podem retornar valores inválidos.

Atributos

Atributo	Retorna	Tipo de dados retornado
General
`filename`	O nome do arquivo inserido no campo de container.	texto
`MD5`	O resultado da aplicação do MD5 da função de hash criptográfico em um arquivo inserido no campo de container ou um arquivo mencionado por um campo de container.	texto
`storageType`	O método usado para armazenar os dados no campo de container: Incorporado, Externo (seguro), Externo (aberto), Referência de arquivo, Texto.	texto
`fileSize`	O tamanho (em bytes) do arquivo inserido no campo de container.	número
`internalSize`	A quantidade (em bytes) do espaço dentro do arquivo de banco de dados ocupado pelo campo de container.	número
`externalSize`	A quantidade (em bytes) do espaço armazenado externamente pelo campo de container. Esse é o tamanho do arquivo mencionado ou o tamanho total de todos os arquivos no campo de container (configuração para armazenamento aberto ou seguro).	número
`externalFiles`	Uma lista dos arquivos externos associados ao campo de container (arquivos que usam armazenamento aberto ou seguro ou uma referência de arquivo.	texto

Images
`width`	Um número que representa a largura da imagem em pixels.	número
`height`	Um número que representa a altura da imagem em pixels.	número
`dpiWidth`	Um número que representa o DPI horizontal da imagem.	número
`dpiHeight`	Um número que representa o DPI vertical da imagem.	número
`transparency`	1 se a imagem tiver um canal alfa, caso contrário, retornará 0.	número

Photos
	Nota Somente arquivos HEIC, JPEG e TIFF retornam resultados.
`orientation`	Um número que representa a orientação da foto. 1 (Normal) 2 (Invertido horizontalmente) 3 (Girado 180 graus) 4 (Invertido verticalmente) 5 (Girado 90 graus no sentido anti-horário e invertido verticalmente) 6 (Girado 90 graus no sentido anti-horário) 7 (Girado 90 graus no sentido horário e invertido verticalmente) 8 (Girado 90 graus no sentido horário) Nota As fotos inseridas usando versões anteriores de clientes FileMaker não são orientadas automaticamente; para essas fotos, não aplicado é acrescentado ao resultado. Por exemplo, 3 (Girado 180 graus), não aplicado.	texto
`created`	O carimbo de data/hora disponível mais antigo para a foto.	carimbo de data/hora
`modified`	O carimbo de data/hora disponível mais recente para a foto. Se a foto não tiver sido modificada nunca, uma cadeia vazia será retornada.	carimbo de data/hora
`latitude`	A latitude do local da foto.	texto
`longitude`	A longitude do local da foto.	texto
`make`	O fabricante da câmera usada para a foto.	texto
`model`	O modelo da câmera usado para a foto.	texto

Audio
	Nota Somente arquivos MP3 e M4A retornam resultados.
`title`	O título do áudio	texto
`artist`	O nome do artista do áudio.	texto
`album`	O nome do álbum que contém o áudio.	texto
`year`	O ano em que o áudio foi lançado	texto
`track`	O número da faixa e a contagem do áudio. Por exemplo, 3/12 ou 3 se a contagem de faixas não estiver disponível.	texto
`genre`	O gênero do áudio	texto
`composer`	O compositor do áudio	texto
`coverArt`	Uma imagem da capa.	container
`duration`	A duração do áudio. Por exemplo, 0:03:16.	hora
`bitRate`	O número de quilobits por segundo (kbps) usados no áudio.	número

Barcodes
`barcodeText`	Conteúdo do código de barras.	texto
`barcodeType`	Tipo do código de barras.	texto

Signatures
`signed`	O carimbo de data/hora quando a assinatura foi inserida.	carimbo de data/hora

Groups
`general`	Os atributos listados na categoria General acima pertinentes ao campo de container.	texto
`audio`	Os atributos listados na categoria Audio acima pertinentes ao campo de container.	texto
`image`	Os atributos listados na categoria Images acima pertinentes ao campo de container.	texto
`photo`	Os atributos listados na categoria Photos acima pertinentes ao campo de container.	texto
`barcode`	Atributos listados na categoria Barcodes acima pertinentes ao campo de container.	texto
`signature`	Os atributos listados na categoria Signatures acima pertinentes ao campo de container.	texto
`all`	Os atributos presentes em todas as categorias listadas acima pertinentes ao campo de container.	texto

Notas

Códigos de barras e assinaturas não são considerados imagens.
O internalSize pode ser muito menor do que o fileSize (por exemplo, campos de container configurados para armazenamento aberto ou seguro, referências de arquivo fileSize (por exemplo, campos de container criados por plug-ins).
Usar o atributo MD5 permite impedir a inserção de arquivos duplicados em um campo de container, independentemente do nome do arquivo.
Para os atributos de grupo general, audio, image, photo e all, os atributos são exibidos no formato nomeDeAtributo: valorDeAtributo com um atributo por linha. Alguns atributos são exibidos de maneira diferente para colocar o atributo em uma linha:
- externalFiles. Exibe apenas o número de arquivos externos.
- transparency. Exibe 1 (True) ou 0 (False).
- coverArt. Exibe png ou jpg dependendo do tipo de imagem.
- bitRate. Exibe kbps após o número. Se um áudio usar uma taxa de bits variável, (VBR) será acrescentado ao resultado. Por exemplo: Bit Rate: 247 kbps (VBR).
- year. As informações de data podem ser retornadas entre parênteses após o ano. Por exemplo: Year: 2019 (10/11/2019)
Cada valor retornado, exceto o último, termina com um retorno de carro.
Para reduzir a frequência com a qual o FileMaker Pro analisa os dados de container, use GetContainerAttribute no cálculo com entrada automática de um campo e desmarque Não substituir o valor existente do campo (se houver). Nesse caso, GetContainerAttribute atualizará somente quando o conteúdo do campo de container especificado mudar. Se GetContainerAttribute for usado da definição de um campo de cálculo, o cálculo poderá ser atualizado sempre que o registro atual mudar, reduzindo o desempenho do seu app personalizado.

Exemplo 1

Observe que os atributos nos seguintes exemplos estão entre aspas.

GetContainerAttribute(Imagem;"all") retorna:

[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

Exemplo 2

GetContainerAttribute(Produto;"barcode") retorna:

[Barcode]

Barcode Text: 875720001107

Barcode Type: UPC-A

Exemplo 3

GetContainerAttribute(Pacote;"signature") retorna:

[Signature]

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