> For the complete documentation index, see [llms.txt](https://docs.helmut.de/helmut4-releases/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helmut.de/helmut4-releases/v4.13.0/helmut4-components/streamdesigner/nodes/actions/third-party/vidispine/vidicore/vidicore-get-item-id-by-file-path-action.md).

# VidiCore Get Item ID By File Path Action

This node retrieves the corresponding **VidiCore item ID** for a file by using its relative file path.

It can be used when a file already exists in VidiCore and a following workflow step requires the related item ID, for example to add metadata, apply deletion locks, add the item to a collection, or perform further VidiCore operations.

If the file cannot be found in VidiCore, the node fails.

<figure><img src="/files/u7kgc4fSF6YWIaSvu0tR" alt=""><figcaption><p>VidiCore Get Item ID By File Path Action node</p></figcaption></figure>

***

#### Configurable Settings

**Async**

Enables or disables asynchronous execution.

**URL**

The URL of the VidiCore system.

Example:

```
https://myVidiCore.com
```

**Vidispine Wildcard**

Defines whether the file name can be searched independently of its exact storage location.

If enabled, wildcard searches are allowed. This makes it possible to search for a file globally, regardless of its folder path. In the background, the query parameter `wildcard=true` is used.

Example:

```
*/ITEM-VX-12667.mxf
```

If disabled, the relative file path must be provided completely. In this mode, wildcard searches are not supported.

**Relative File Path**

The relative path of the file on the VidiCore system, including the file extension.

Example without wildcard:

```
folder/subfolder/ITEM-VX-12667.mxf
```

Example with wildcard enabled:

```
*/ITEM-VX-12667.mxf
```

**Storage ID**

Optional ID of the VidiCore storage on which the file is located.

This can be used in multi-storage environments to avoid ambiguous results when identical relative file paths exist on different storages.

If a **Storage ID** is provided, only files on the specified storage are considered.

If this field is empty, the first matching file found by VidiCore is returned.

Example:

```
VX-1
```

***

#### Node Result

The node result contains the resolved **VidiCore item ID**.

Example:

```
{node.result.?}
```

Typical usage:

```
Relative File Path: */ITEM-VX-12667.mxf
Vidispine Wildcard: true
Storage ID: VX-1
```

Result:

```
VX-12345
```