Skip to content

File Associations and Creation

The Import Engine allows you to create a file record and associate it with an Arena Item in a single import step. This is handled via the ITEM_FILES resource.

Mode Behaviors

CREATE

  • With Existing Files: If you provide file.guid or file.number, the engine creates an association to that existing file.
  • New Files: If you use FILE_SUMMARY fields without a GUID/Number, the engine creates a new file record and associates it.

EDIT

Edits the association attributes only.

Note: You cannot edit the file summary attributes (metadata of the file itself) using an ITEM_FILES import.

OVERWRITE

  • If ID provided: Behaves like EDIT (updates association).
  • If ID missing: Behaves like CREATE (creates new file and association).

REPLACE

  • If ID provided + Association exists: Behaves like EDIT.
  • If ID provided + No Association: Creates a new association to the existing file.
  • If ID missing: Creates a new file and a new association.