Resolve Media Reference

Category: Pr Bins & Project Items

This is a read-only resolver. It never imports or changes Premiere state. Name modes require a bounded Project bin or filesystem folder and use exact matching. Multiple matches return `AMBIGUOUS` instead of selecting the first. Filesystem modes require an import bin, reuse exactly one media-path match inside that bin including subbins, and otherwise return `NEEDS_IMPORT`. `AUTO` recognizes only a currently resolvable Project Item ref or an existing filesystem path; unresolved names return `NEEDS_MODE_CHOICE`. Visible Project Panel metadata, complete Project Metadata, and media XMP remain separate surfaces and are not automatic fallbacks.

Inputs

Input	Required	Value Kind	Types	Enum Values
reference	yes	expression	—	—
mode	yes	expression	enum-string	AUTO, PROJECT_ITEM_REF, PROJECT_ITEM_NAME, FILESYSTEM_PATH, FILESYSTEM_NAME
projectBin	no	expression	—	—
importBin	no	expression	—	—
filesystemFolder	no	expression	—	—
includeSubbins	no	expression	—	—
includeSubfolders	no	expression	—	—
caseSensitive	no	expression	—	—
storeStatusIn	no	variable-name	—	—
storeDetectedModeIn	no	variable-name	—	—
storeActionIn	no	variable-name	—	—
storeProjectItemIn	no	variable-name	—	—
storeFilePathIn	no	variable-name	—	—
storeMessageIn	no	variable-name	—	—

Notes

• Resolves one table- or file-supplied media locator without importing or changing Premiere state.
• The explicit modes are PROJECT_ITEM_REF, PROJECT_ITEM_NAME, FILESYSTEM_PATH, and FILESYSTEM_NAME; AUTO recognizes only a currently resolvable Project Item ref or an existing filesystem path and otherwise returns NEEDS_MODE_CHOICE.
• Name modes require a bounded Project bin or filesystem folder. Matching is exact, and multiple matches return AMBIGUOUS rather than choosing the first result.
• Filesystem modes also require an import bin. The resolver reuses exactly one Project Item whose media path matches inside that bin including subbins, or returns NEEDS_IMPORT; the block itself never imports.
• Persisted run-scoped ~prbind_ refs and ordinary-media-unsupported .mogrt/.aegraphic files are rejected explicitly.
• This block does not consult visible Project Panel metadata, complete Project Metadata, or media XMP. Those are separate surfaces and are not resolver fallbacks.