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

Geral

 

 

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

 

 

 

Imagens

 

 

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 JPEG e TIFF retornam resultados.

 

orientation

Um número que representa a orientação da foto.
1 (Normal)
2 (Invertido horizontalmente)
3 (Girado180 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

 

 

 

Códigos de barras

 

 

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 Geral acima pertinentes ao campo de container.

texto

audio

Os atributos listados na categoria Áudio acima pertinentes ao campo de container.

texto

image

Os atributos listados na categoria Imagens acima pertinentes ao campo de container.

texto

photo

Os atributos listados na categoria Fotos acima pertinentes ao campo de container.

texto

barcode

Atributos listados na categoria Códigos de barras acima pertinentes ao campo de container.

texto

signature

Os atributos listados na categoria Assinaturas 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: Taxa de bits: 247 kbps (VBR).
    • year. As informações de data podem ser retornadas entre parênteses após o ano. Por exemplo: Ano: 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/01/2020 2:40:31 PM

Modified:

Latitude: 37,406167

Longitude: -121,983333

Make: Apple

Modelo: iPhone 11

Exemplo 2 

GetContainerAttribute(Produto;"barcode") retorna:

[Código de barras]

Texto do código de barras: 875720001107

Tipo de código de barras: UPC-A

Exemplo 3 

GetContainerAttribute(Pacote;"signature") retorna:

[Signature]

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