ObtenirAttributConteneur

Renvoie les métadonnées de fichier de la rubrique Conteneur spécifiée.

Format

ObtenirAttributConteneur ( Rubrique ; NomAttribut )

Paramètres

Rubrique : toute expression qui renvoie des données de conteneur.

NomAttribut : nom d'un attribut pris en charge (voir ci-dessous).

Résultat

Texte, nombre, date, heure, horodatage, conteneur

Provient de la version

13.0

Description

Certains attributs peuvent ne renvoyer aucun résultat. Par exemple, la latitude et la longitude d'une photo peuvent ne pas être disponibles, ou certaines métadonnées audio, telles que l'artiste d'un album, peuvent être stockées hors du fichier audio. Certains attributs individuels de l'attribut de groupe all peuvent ne pas être applicables dans certaines circonstances.

De plus, lorsque vous hébergez des bases de données sous Windows ou dans le cloud et que vous y accédez via des API REST, certains attributs de la fonction ObtenirAttributConteneur (par exemple, photo, created, modified et all) peuvent renvoyer des valeurs non valides.

Attributs

Attribut	Renvoie	Type de données renvoyées
General
`filename`	Le nom du fichier inséré dans la rubrique Conteneur.	Texte
`MD5`	Le résultat de l'application de la fonction hachage cryptographique MD5 sur un fichier inséré dans une rubrique Conteneur ou référencé par elle.	Texte
`storageType`	La méthode utilisée pour stocker les données dans la rubrique Conteneur : Embedded, External (Secure), External (Open), File Reference, Text.	Texte
`fileSize`	La taille du fichier (en octets) inséré dans la rubrique Conteneur.	Nombre
`internalSize`	La quantité d'espace (en octets) occupée par la rubrique Conteneur dans le fichier de base de données.	Nombre
`externalSize`	La quantité d'espace (en octets) stockée en externe par la rubrique Conteneur. Il s'agit soit de la taille du fichier référencé, soit de la taille totale de tous les fichiers de la rubrique Conteneur (définie pour un stockage ouvert ou sécurisé).	Nombre
`externalFiles`	Une liste de tous les fichiers externes associés à la rubrique Conteneur (soit les fichiers utilisant un stockage ouvert ou sécurisé, soit une référence de fichier).	Texte

Images
`width`	Un nombre indiquant la largeur de l'image, en pixels.	Nombre
`height`	Un nombre indiquant la hauteur de l'image, en pixels.	Nombre
`dpiWidth`	Un nombre indiquant la résolution horizontale de l'image.	Nombre
`dpiHeight`	Un nombre indiquant la résolution verticale de l'image.	Nombre
`transparency`	1 si l'image a un canal alpha, sinon renvoie 0.	Nombre

Photos
	Remarque Seuls les fichiers HEIC, JPEG et TIFF renvoient des résultats.
`orientation`	Un nombre indiquant l'orientation de la photo : 1 (Normal) 2 (Flipped horizontally) 3 (Rotated 180 degrees) 4 (Flipped vertically) 5 (Rotated 90 degrees counterclockwise and flipped vertically) 6 (Rotated 90 degrees counterclockwise) 7 (Rotated 90 degrees clockwise and flipped vertically) 8 (Rotated 90 degrees clockwise) Remarque Les photos qui ont été insérées avec une version antérieure des clients FileMaker ne sont pas automatiquement orientées. L'attribut not applied est alors ajouté au résultat. Par exemple, 3 (Rotated 180 degrees), not applied.	Texte
`created`	Le plus ancien horodatage disponible pour la photo.	Horodatage
`modified`	Le plus récent horodatage disponible pour la photo. Si la photo n'a jamais été modifiée, renvoie une chaîne vide.	Horodatage
`latitude`	La latitude de l'emplacement de la photo.	Texte
`longitude`	La longitude de l'emplacement de la photo.	Texte
`make`	Le fabricant de l'appareil utilisé pour prendre la photo.	Texte
`model`	Le modèle d'appareil utilisé pour prendre la photo.	Texte

Audio
	Remarque Seuls les fichiers MP3 et M4A renvoient des résultats.
`title`	Le titre du morceau.	Texte
`artist`	Le nom de l'interprète du morceau.	Texte
`album`	Le nom de l'album contenant le morceau.	Texte
`year`	L'année de sortie du morceau.	Texte
`track`	Le numéro de piste du morceau et nombre total de pistes. Par exemple, 3/12, ou 3 si le nombre total de pistes n'est pas disponible.	Texte
`genre`	Le genre du morceau.	Texte
`composer`	Le compositeur du morceau.	Texte
`coverArt`	Une image de la pochette de l'album.	Conteneur
`duration`	La durée du morceau. Par exemple, 0:03:16.	Heure
`bitRate`	Le nombre de kilobits par seconde (kbps) utilisés dans le morceau.	Nombre

Barcodes
`barcodeText`	Le contenu du code-barres.	Texte
`barcodeType`	Le type de code-barres.	Texte

Signatures
`signed`	L'horodatage de l'insertion de la signature.	Horodatage

Groupes
`general`	Les attributs répertoriés dans la catégorie General ci-dessus relatifs à la rubrique Conteneur.	Texte
`audio`	Les attributs répertoriés dans la catégorie Audio ci-dessus relatifs à la rubrique Conteneur.	Texte
`image`	Les attributs répertoriés dans la catégorie Images ci-dessus relatifs à la rubrique Conteneur.	Texte
`photo`	Les attributs répertoriés dans la catégorie Photos ci-dessus relatifs à la rubrique Conteneur.	Texte
`barcode`	Les attributs répertoriés dans la catégorie Barcodes ci-dessus relatifs à la rubrique Conteneur.	Texte
`signature`	Les attributs répertoriés dans la catégorie Signatures ci-dessus relatifs à la rubrique Conteneur.	Texte
`all`	Les attributs répertoriés dans toutes les catégories ci-dessus relatifs à la rubrique Conteneur.	Texte

Remarques

Les codes-barres et signatures ne sont pas considérés comme des images.
La valeur internalSize peut être nettement inférieure à la valeur fileSize (par exemple, rubriques Conteneur définies pour un stockage ouvert ou sécurisé, références de fichiers, fichiers comprimés) ou nettement supérieure à la valeur fileSize (par exemple, rubriques Conteneur créées par des plug-ins).
L'attribut MD5 vous permet d'éviter d'insérer des fichiers en double dans une rubrique Conteneur, quel que soit le nom du fichier.
Les attributs de groupe general, audio, image, photo et all sont affichés au format Nom Attribut: valeurAttribut, avec un seul attribut par ligne. Certains attributs sont affichés différemment pour pouvoir tenir sur une ligne :
- externalFiles : affiche uniquement le nombre de fichiers externes.
- transparency : affiche 1 (Vrai) ou 0 (Faux).
- coverArt : affiche png ou jpg selon le type d'image.
- bitRate : affiche kbps après le nombre. Si un morceau utilise un débit variable, (VBR) est ajouté au résultat. Par exemple : Bit Rate: 247 kbps (VBR).
- year : la date peut être renvoyée entre parenthèses après l'année. Par exemple : Year: 2019 (10/11/2019)
Chaque valeur renvoyée, sauf la dernière, se termine par un retour chariot.
Pour réduire la fréquence à laquelle FileMaker Pro analyse les données de conteneur, utilisez ObtenirAttributConteneur dans le calcul de saisie automatique d'une rubrique et désélectionnez Ne pas remplacer val. exist. de la rubrique (s'il y a lieu). Dans ce cas, ObtenirAttributConteneur n'est mise à jour que lorsque le contenu de la rubrique Conteneur définie est modifié. Si ObtenirAttributConteneur est utilisé dans la définition d'une rubrique Calcul, le calcul peut être mis à jour chaque fois que l'enregistrement actif change, ce qui réduit les performances de votre app personnalisée.

Exemple 1

Notez que dans les exemples suivants, les attributs sont entre guillemets.

ObtenirAttributConteneur( Image ; "all" ) renvoie :

[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 14:40:31

Modified:

Latitude: 37.406167

Longitude: -121,983333

Make: Apple

Model: iPhone 11

Exemple 2

ObtenirAttributConteneur ( Produit ; "barcode" ) renvoie :

[Barcode]

Barcode Text: 875720001107

Barcode Type: UPC-A

Exemple 3

ObtenirAttributConteneur ( Archive ; "signature" ) renvoie :

[Signature]

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