Find One Project Item

Category: Pr Bins & Project Items

Searches project items and returns one matching item. Use fields to choose where the search runs, for example NAME, MEDIA_PATH, or NAME_OR_MEDIA_PATH. Use match to switch between EXACT or CONTAINS matching. Set caseSensitive when upper/lower case should matter during matching. Use scopeBin to restrict project-item searches to one bin. Use includeSubbins to search only the current bin or also its children, for example BIN_ONLY or BIN_AND_SUBBINS. Use types to filter by item kinds such as TYPE_FOOTAGE, TYPE_SEQUENCE, TYPE_MULTICAM_SEQUENCE, TYPE_MERGED_CLIP, TYPE_BIN, or TYPE_FILE. Use resultMode to decide whether the search must find exactly one item or may fall back to the first match, for example REQUIRE_EXACTLY_ONE or FIRST_OR_EMPTY.

Inputs

Input	Required	Value Kind	Types	Enum Values
query	yes	expression	string	—
fields	no	enum	enum-string	NAME, MEDIA_PATH, NAME_OR_MEDIA_PATH
match	no	enum	enum-string	EXACT, CONTAINS
caseSensitive	no	expression	boolean	—
scopeBin	no	expression	reference, string, null	—
includeSubbins	no	expression	enum-string, boolean	BIN_ONLY, BIN_AND_SUBBINS
types	no	array	enum-string	TYPE_FOOTAGE, TYPE_SEQUENCE, TYPE_MULTICAM_SEQUENCE, TYPE_MERGED_CLIP, TYPE_BIN, TYPE_FILE
resultMode	no	enum	enum-string	REQUIRE_EXACTLY_ONE, FIRST_OR_EMPTY

Notes

No additional notes are available yet.

See Also

• Premiere Reference Paths: Explains Premiere reference path strings for project items, sequences, tracks, timeline items, markers, components, and parameters.