This page was machine-translated from German as a first draft and is currently under review. The authoritative source remains the German original (see the language switch above).

When a 4.12 version is first started, the document attachments are migrated. For this, a new table T_UD_DOCUMENTFILE is filled with the existing entries from all document-attachment attributes. Afterwards, a new reference column to this new table is generated and populated in the original tables. The old column is deleted after the migration.

If an attribute is defined as mandatory and a record contains a file name that cannot be found, a "NULL" record is created and referenced and a WARN is reported in the migration log. The warning also appears in the log if it is not a mandatory attribute.

The migration log is located at NUCLOS_HOME/logs/migration_04_12_0003.log
Check it for warnings or errors. 

The files in the file system are also renamed by this action. Instead of the file name a UID is used, but the extension is preserved.

If you use data sources or extensions that access the column or the files of a document-attachment attribute directly, these must be reworked manually.

You can find further details in the ticket NUCLOS-5233

The feature for configuring a directory path for storing files placed via the standard Nuclos document-attachment subform will be removed in the future. This feature conflicts with the new requirements for refactoring the document-attachment attributes.