How to stitch multiple files to an existing item [VC UG]

Stitching is done using the functions "Timeline API" and "Item conform" in Vidispine.

What is "Timeline API"?

Timeline API is used to store and retrieve timelines in the system. A timeline is represented in the system as a combination of:

The timeline itself (in the native format, but can be converted to other formats)
The rendered result as a new item.
The timeline with its constituent parts as a collection.

More information on API Timeline;

http://apidoc.vidispine.com/latest/ref/item/timeline.html

What is "Item conform"?

The conform resource exposes a simple way to combine media from one or more items into a new item. It is also possible to select specific parts from the input by specifying an input interval. There are two different types of conforming;

Start a confirm job = Starts a new CONFORM job that creates a new item and one or more shapes that contains media according to the conform timeline.The rendered result as a new item.
Start a conform job for an existing item = Starts a new CONFORM job that creates one or more shapes that contains media according to the conform timeline.

More information on Item conform and different query parameters;

http://apidoc.vidispine.com/latest/ref/item/conform.html

In the example guide below we will be using "Start a conform job for an existing item".

Example guide;

It's only for the item that the resulting shape should belong to that needs a conform job as a timeline. For example, given three items VX-1, VX-2 and VX-3 with original shapes with media. To concatenate these into a new shape for item VX-100 one would do:

PUT API/item/VX-100/timeline/vidispine

CODE

<ConformDocument xmlns="http://xml.vidispine.com/schema/vidispine">
    <timeBase>
    <numerator>1</numerator>
        <denominator>25</denominator>
    </timeBase>
    <timeline>
    <segment>
      <source>
        <id>VX-1</id>
      </source>
    </segment>
    <segment>
      <source>
        <id>VX-2</id>
      </source>
    </segment>
    <segment>
      <source>
        <id>VX-3</id>
      </source>
    </segment>
  </timeline>
</ConformDocument>

Then start the conform job using:

POST /API/item/VX-100/timeline/vidispine/conform?sourceTag=original&tag=house

This would then create a shape on VX-100 tagged with house containing the media from those three files. Note that the source items (VX-1, VX-2 and VX-3) do not need a timeline on them.