{"id":5219,"date":"2021-06-30T16:54:44","date_gmt":"2021-06-30T15:54:44","guid":{"rendered":"https:\/\/iptc.org\/?page_id=5219"},"modified":"2022-06-06T10:31:36","modified_gmt":"2022-06-06T09:31:36","slug":"interoperability-tests","status":"publish","type":"page","link":"https:\/\/iptc.org\/standards\/photo-metadata\/interoperability-tests\/","title":{"rendered":"IPTC Photo Metadata Interoperability Tests"},"content":{"rendered":"\r\n
The IPTC Photo Metadata Standard is made for describing what an image shows and providing administrative information and copyright data of an image. A key use case of this standard is to keep metadata embedded into an image file persistent and alive when the image is exchanged between many parties in a supply chain.
\r\nSoftware managing and processing image files in this exchange has an essential role: it must not remove or modify existing metadata on its own and should not hide it, metadata intentionally added or changed must be saved, embedded correctly into the image file.<\/p>\r\n\r\n\r\n
IPTC is watching this behaviour of software and calls it a software’s photo metadata interoperability<\/span><\/em>.<\/p>\r\n\r\n\r\n To enable anybody in testing a software’s interoperability IPTC defines three tests and what IPTC expects as results – find all below.<\/p>\r\n\r\n\r\n Executing the tests and comparing the results with IPTC’s expectations helps to evaluate the metadata reliability of a software in a supply chain.<\/p>\r\n\r\n\r\n Metadata field <\/strong>or metadata property<\/strong>: an element of metadata made for a specific purpose, e.g. to hold the date and time of creating the image, name of who created the image, describing what the image shows or who owns the copyright of the image. Field <\/em>is the term used primarily by users of the software, property <\/em>is the term primarily used by metadata standards and makers of the software, in fact they are synonyms. For filling in the value of a metadata field a user should know for what kind of information this field is made. For IPTC fields this is defined by the IPTC Photo Metadata Standard<\/a>. The first – and in many cases the only – helper on a metadata user interface is the field label. It is shown close to where you can see or fill in the value and tells with a single or a few words what should be filled into the field or what the field shows. The IPTC has created a reference image file with all metadata fields defined by the IPTC standard and almost each field has its IPTC name as value (only very short or numeric values are different). This name is also used in the IPTC standard document. You should load this file in the to-be-tested software and check with your eyes on the software’s metadata panel(s): does the shown field value – the IPTC field name – tell (almost) the same as the label of this field on the panel.<\/p>\r\n\r\n\r\n <\/p>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n Each IPTC Photo Metadata field has a definition of its semantics and a corresponding recommended label in English. Therefore IPTC expects that any label of an IPTC property is either identical to the the field’s name or label in English as defined by IPTC or only a slight modification of it<\/strong>. For a label in a different language the translation should reflect what IPTC defined as kind of information of the field.<\/p>\r\n\r\n\r\n Each software supporting photo metadata implements a small metadata workflow: the embedded metadata is read from the image file, the read field values are assigned to corresponding fields on the metadata panel. If the field values can be edited each one has to be assigned to the corresponding IPTC field(s) and finally all fields should be embedded into the image file correctly. IPTC has a reference image file with all metadata fields defined by the IPTC standard and each field has a specific value. You should load this file in the to-be-tested software, edit (= change) the values of some fields and save all metadata to the image file. This file should be uploaded to the IPTC Interoperability Test site and “Test #2” should be executed there. The generated test result shows: Test #2 on this site compares the values of the IPTC reference image with the values in the uploaded test image file which is initially a copy of the IPTC reference image. If: Without changing a metadata field value in the test image the value must stay as the one in the IPTC reference image. If “… value is MISSING – NOT the … value!” is shown<\/span>: this indicates that for this IPTC field the XMP and the IIM format is specified, but only the value of one format is missing, the correct value in the other format still exists – field value(s) of one format have been stripped.<\/strong><\/p>\r\n\r\n\r\n The IPTC Photo Metadata Standard defines a set of about 57 metadata fields, some of them have a structured value with a set of sub-fields. Unfortunately not all the software claiming to support IPTC fields supports all of them. For metadata interoperability it is quite essential that a specific IPTC field edited with software A can also be shown and edited with software B. IPTC provides an image file without<\/em> any embedded metadata – IPTC, Exif or any other. You should load this file in the to-be-tested software and fill in values for all fields available on the metadata panel(s). Test #3 on this site checks for each IPTC field if a value in XMP format, and if the IIM format is also specified a value in IIM exists. It is not bad if these fields are shown as MISSING<\/span>:<\/strong> … you may want to contact the maker of the tested software to discuss unexpected or bad results. We suggest to contact the support of the software maker.<\/p>\r\n\r\n\r\n … you may want to discuss the results with other photo metadata people. IPTC runs a public email list at https:\/\/groups.io\/g\/iptc-photometadata\/<\/a>, join it and raise your questions or share your comments. You are highly welcome.<\/p>\r\n\r\n\r\n All the best for running our interoperability tests, \r\nHow the IPTC Interoperability Tests can be used<\/h3>\r\n\r\n\r\n
\r\n\t
\r\n\t
Terminology used show\/hide more details of this section<\/a><\/small><\/h3>\r\n\r\n\r\n
\r\n\t
\r\nFor the test guideline below we use the term field<\/em>.<\/p>\r\n\r\n\r\nTest #1: Do field labels align to the IPTC definition?<\/h2>\r\n\r\n\r\n
\r\nThis test checks if the label of a field in the tested software aligns with the IPTC definition.<\/strong><\/p>\r\n\r\n\r\nTest outline<\/h3>\r\n\r\n\r\n
Test procedure, step by step show\/hide this section<\/a><\/small><\/h3>\r\n\r\n\r\n
\r\n\t
\r\nThis may look like:
<\/li>\r\n\t
\r\n– by writing down the field’s label and the IPTC name shown as the field’s value
\r\n– by taking a screenshot of the whole metadata panel or at least this region of the panel.<\/li>\r\n<\/ol>\r\n<\/div>\r\n\r\n\r\nWhat IPTC expects as test result<\/h3>\r\n\r\n\r\n
Test #2: Does the software read and write embedded metadata correctly?<\/h2>\r\n\r\n\r\n
\r\nThis test checks if software used for this metadata workflow is reading and writing values correctly.<\/strong>
\r\n(Note: some desktop software and most DAM\/MAM systems read the metadata into a local database and the metadata is embedded into in image file only by an export action. IPTC considers this as the internal metadata management of software which should align to this outlined metadata workflow: the metadata fields should be read and saved correctly.)<\/p>\r\n\r\n\r\nTest outline<\/h3>\r\n\r\n\r\n
\r\n1. If the intentionally edited IPTC files have a value different to the IPTC reference image file, as expected, or still the same.
\r\n2. If other IPTC fields than the ones edited by you have unexpectedly a value different to the IPTC reference image file. (Possible cases: changed value, no value.)<\/p>\r\n\r\n\r\nTest procedure, step by step show\/hide this section<\/a><\/small><\/h3>\r\n\r\n\r\n
\r\n\t
\r\n(See also the IPTC Photo Metadata Standard page<\/a>). Create a copy of the file and rename it to something like “softwareA-test2-1.jpg”.<\/li>\r\n\t\r\n\t
\r\nThe details of what is shown there is explained on the Test 2 – RESULT page.<\/li>\r\n\t
\r\nThen start the next test with step 2.<\/li>\r\n<\/ol>\r\n<\/div>\r\n\r\n\r\nWhat IPTC expects as test result<\/h3>\r\n\r\n\r\n
\r\nIPTC expects only the values of the intentionally changed fields in the test image file are different from the IPTC reference image file.<\/strong><\/p>\r\n\r\n\r\n
\r\n– only a field or some fields listed in step 4 above have been changed and
\r\n– if these field(s) have been checked on the page for uploading the local image
\r\nthis field is\/these fields should be highlighted in green in the test result showing “… value CHANGED”. This is telling “the change of this value is ok, it was done intentionally”. This is an expected change of values.
\r\nCheck if all fields with values changed by you are shown with “… value CHANGED” in green. <\/span>
\r\nBad result:<\/strong> if such fields do not show “… value CHANGED”, the software did not save the changed value(s) correctly<\/strong>.
\r\nIf “… value CHANGED – but NOT the … value!” is shown:<\/span> for this IPTC field the use of the XMP and the IIM format is specified; if the the value of this field is changed then both the XMP value and the IIM value must be changed. This “- but NOT the … (XMP\/IIM)” tells the value was changed only in one format but not in the other one – field values are partially not saved correctly and the values are inconsistent now!<\/strong><\/p>\r\n\r\n\r\n
\r\nTherefore the Test #2-Result should not <\/em>show “… value CHANGED” or “… is MISSING” <\/span>for fields you have not changed! If this is the case the tested software modified values on its own or even removed some metadata fields. This is a serious violation of metadata interoperability.<\/strong><\/p>\r\n\r\n\r\nTest #3: Which IPTC fields are supported by the software – and which not?<\/h2>\r\n\r\n\r\n
\r\nThis test investigates and lists which of the IPTC defined fields are supported, and which not.<\/strong><\/p>\r\n\r\n\r\nTest outline<\/h3>\r\n\r\n\r\n
\r\nFinally all the filled in values should be saved to this image file.\u00a0
\r\nNext this file should be uploaded to the IPTC Interoperability Test site and \u201cTest #3\u201d should be executed there. The generated test result shows all fields and sub-fields defined by the IPTC Photo Metadata Standard and for each one if a value in the XMP format was found and – if specified by the standard – also a value in the IIM format was found. If the values of a field in XMP and IIM were found the result also shows if the values are the same, if they are in sync.<\/p>\r\n\r\n\r\nTest procedure, step by step show\/hide this section<\/a><\/small><\/h3>\r\n\r\n\r\n
\r\n\t
What IPTC expects as test result<\/h3>\r\n\r\n\r\n
\r\nThe best test result <\/strong>shows in all rows of the IPTC-defined fields that XMP and IIM Values were found<\/span><\/strong> – not a single MISSING<\/span> result is shown, ignore the “not spec” in the IIM Value column. The only exception is the Image Region\/Other Metadata Property row, having a metadata field in this structure is not required by the IPTC Standard.
\r\nIf all results in the XMP Value column are shown as MISSING<\/span> the software apparently does not support the XMP format.
\r\nIf results in the IIM Value column show only MISSING<\/span> or “not spec” the software apparently does not support the IIM format.
\r\n
\r\nA bad result is this mix<\/strong>: the XMP Value cell of a metadata field row shows found<\/span> and the IIM Value cell in this row shows MISSING<\/span> – and IIM Value cells in other rows show found<\/span>. Apparently for this field only the XMP format is supported but not the IIM format.
\r\nThe same applies vice versa: the IIM Value cell shows found<\/span> and the XMP Value cell shows MISSING<\/span>.
\r\nIn these cases the Sync Values cell of this row shows NOT in sync<\/span>: one value exists, the other one should exist too but does not.
\r\n
\r\nIf both the XMP Value and the IIM Value cells of a row show found<\/span> a value in both formats exists. In this case the Sync Values column should show “in sync”, telling the values are the same, they are in sync<\/em>. If NOT in sync<\/span> is shown XMP and IIM values exist but they are different – a very bad case as nobody knows which value is the correct one<\/strong>.<\/p>\r\n\r\n\r\n
\r\n– Embedded Encoded Metadata Rights Expression: IPTC recommends to set the values of this structure by software and not by hand.
\r\n– Digital Image GUID: IPTC recommends to set the value of this field by software, not by hand.
\r\n– Image Region: should be used by a user interface feature integrated into imaging software, if the feature is not available setting the Image Region data by hand would be very hard.<\/p>\r\n\r\n\r\nAfter the tests …<\/h3>\r\n\r\n\r\n
\r\nDavid Riecks<\/span><\/em> and Michael Steidl<\/span><\/em>, Leads of the IPTC Photo Metadata Working Group<\/a><\/p>\r\n\r\n\r\n