19.4.1.29 WriteAsset

This allows an authenticated user to create/update the key asset data (i.e. code, description, synopsis, type and station), artists' data (i.e. name, surname, etc.), genres data (i.e. description, group, etc.), flexible-metadata (e.g. performer, mood, etc.), EDL marks (i.e. visible segments, editing segments, etc.) and EDL flexi-metadata (e.g. origin, editor, etc.) of all assets matching given ID(s).

_user: Login name of the executor

_pwd: Password of the executor

_xmlparams: A XML string that specifies the fields to be updated. There are some considerations:

1) The creation/update action depends on the value of the "idAsset" field:
• Blank: The asset is created, and its ID is returned.
• Exist: The asset is updated.
• Not exist: An error message is returned ("asset id not found").
2) The "code", "type", and "coduser" can be blank, in which case a default value will be used. However they are mandatory in the xml, otherwise the error "Invalid input parameters" will be returned.
3) If an <Asset>, <Genre>, < Artist>, <EDL_data>, <Asset_fleximetadata> and <EDL_fleximetadata> already exist, they are updated. Otherwise, they are created.
4) Specify <Asset>, <Genre>, <Artist>, <EDL_data>, <Asset_fleximetadata> and <EDL_fleximetadata> so many as required.
5) <Asset>, <Genre>, < Artist>, <EDL_data>, <Asset_fleximetadata>, and <EDL_fleximetadata> are not mandatory; you can specify only the ones to be created/modified.
6) <EDL_Rows> can be added only for EDL with a specified <EDL_Header>

Below are some examples:

Create a new asset:

Update existing assets:

<AssetData>
    <Asset code="C3806" coduser="1" description="Wonderw all unplugged" idAsset="3806" sinopsys="This song is a 90's hit..." type="TVSE"/>
    <Genre code="4" description="pop" genretypedesc="Music" group="M" idAsset="3806"/>
    <Genre code="2" description="rock" genretypedesc="Music" group="M" idAsset="3806"/>
    <Artist description="Gallagher Noel" idAsset="3806" name="Noel" nationalitycode="044" surname="Gallagher"/>
    <Artist description="Oasis" idAsset="3806" name="" nationalitycode="044" surname=""/>
    <ASSET_fleximetadata>
        <ASSET_flexi idAsset="3806" item="0F.13.00.00.00.00.00.00" itemvalue="male singer"/>
        <ASSET_flexi idAsset="3806" item="0F.14.00.00.00.00.00.00" itemvalue="stage performance"/>
    </ASSET_fleximetadata>
    <EDL_Data>
        <EDL_Header description="1st EDL" eom="89999" idAsset="3806" som="0" version="7"/>
        <EDL_Row edltype="E" idAsset="3806" markin="45000" markout="55000" notes="notes" type="TVSE" version="7"/>
        <EDL_Row edltype="E" idAsset="3806" markin="60000" markout="70000" notes="notes" type="TVSE" version="7"/>
        <EDL_Row edltype="E" idAsset="3806" markin="75000" markout="85000" notes="notes" type="TVSE" version="7"/>
    </EDL_Data>
    <EDL_fleximetadata>
        <EDL_flexi idAsset="3806" item="0F.13.00.00.00.00.00.00" itemvalue="dubbed" markin="-1" markout="-1" version="9"/>
        <EDL_flexi idAsset="3806" item="0F.14.00.00.00.00.00.00" itemvalue="censored" markin="-1" markout="-1" version="9"/>
    </EDL_fleximetadata>
</AssetData>

Input forms described as Parameter (type): description

<Asset>
• idAsset (integer): Asset's unique identification number in Etere. If blank, a new asset will be created to hold data.
• code (string): Asset's identification code string.
• description (string): Brief description of the asset.
• sinopsys (string): Detailed description of the asset.
• type (string): Type of the asset (e.g. Clip, Tv series, Film, etc.).
• coduser (integer): Number of the station (e.g. Channel 01).
• validitystartdate (string): The date when the asset begins to be valid. This field must be written in ISO format, that is "YYYYMMDDTHH:MM:ss" (e.g.: 20260410T12:30:00).
• expirydate (string): The date since when the asset is not valid anymore. This field must be written in ISO format, that is "YYYYMMDDTHH:MM:ss" (e.g.: 20260401T00:00:00).
• note_a (string): Field NOTE_A of the asset, in the tab Properties of media library.
• note_b (string): Field NOTE_B of the asset, in the tab Properties of media library.
• note_c (string): Field NOTE_C of the asset, in the tab Properties of media library.
• epg1 (string): Field Epg Language 1 of the asset, in the tab EPG of media library.
• epg2 (string): Field Epg Language 2 of the asset, in the tab EPG of media library.
• personincharge (integer): The id of the user who takes care of the tapeless reception process. This field corresponds to the field Person in charge in the tab Tapeless reception of media library.
• supplier (integer): The id of the user who provides the file and links it to the asset. This field corresponds to the field Supplier in the tab Tapeless reception of media library.
• flags (string): This field can contain the following values:
A = Need to explode
C = Blacks
D = Visible segments
• scheduledarrival (datetime): The date when the media has been provided by the supplier. It corresponds to the field Scheduled Arrival in media library's Tapeless reception tab (e.g. 01/01/2026).
• productiondate (datetime): The date when the media has been produced. It corresponds to the field Production Date in media library's General data tab (e.g. 01/01/2026).

<Genre>
• IDAsset (integer): Asset's unique identification number in Etere.
• Code (string): Asset's identification code string.
• Description (string): Genre's name.
• Group (string): Genre's group ID.
• GenreTypeDesc (string): Genre's group name (e.g. music, films, etc.).

<Artist>
• IDAsset (integer): Asset's unique identification number in Etere.
• Description (string): Asset's identification code string.
• Name (string): Artist's name.
• Surname (string): Artist's surname.
• NationalityCode (string): International country code related to Artist.

<ASSET_fleximetadata>
• asset (integer): Asset's unique identification number in Etere.
• item (string): Code of the flexi-metadata item (e.g.: 0F.14.00.00.00.00.00.00).
• itemvalue (string): Value assigned to the flexi-metadata.

<EDL_Data> <EDL_Header>
• IDAsset (integer): Asset's unique identification number in Etere.
• Version (integer): EDL number (between 1 and 9).
• Description (string): EDL's brief description.
• SOM (integer): Starting timecode of the EDL (in frames).
• EOM (integer): Ending timecode of the EDL (in frames).

<EDL_Data> <EDL_Row>
• IDAsset (integer): Asset's unique identification number in Etere.
• Notes (string): Brief text describing the segment.
• Type (string): Type of the segment (e.g. Clip, Tv series, Film, etc.). Type is used only for V, E or B segments.
• Mark_In (integer): Starting timecode of the segment (in frames). This field is an offset of the asset's inf_digit.
• Mark_Out (integer): Ending timecode of the segment(in frames). This field is an offset of the asset's inf_digit.
• Version (integer): EDL number (between 1 and 9).
• EDLtype (string): The type of EDL can be:
V: Visible segment
E: Editing segment
I: Insertion point
B: Video fault
Note: EDL type must be the same for all segments.

<EDL_fleximetadata> <EDL_flexi>
• asset (integer): Asset's unique identification number in Etere.
• version (integer): EDL number (between 1 and 9).
• markin (integer): Starting timecode of the segment (in frames).
• markout (integer): Ending timecode of the segment (in frames).
• item (string): Code of the flexi-metadata item (e.g. 0F.14.00.00.00.00.00.00).
• itemvalue (string): Value assigned to the flexi-metadata.

<Result> (for assets)
• IDAsset (integer): Asset's unique identification number in Etere.
• Code (string): Asset's identification code string.
• Description (string): "Succeeded operation" or "Asset ID not found".

<Result> (for genres)
• IDAsset (integer): Asset's unique identification number in Etere.
• Code (string): Asset's identification code string.
• Genre (string): Genre's name.
• Description (string): "Success" or "Error".

<Result> (for artists)
• IDAsset (integer): Asset's unique identification number in Etere.
• Code (string): Asset's identification code string.
• Artist (string): Artist's name.
• Description (string): "Success" or "Error".

<Result> (for asset flexi-metadata)
• ID Asset (integer): Asset's unique identification number in Etere.
• item (string): Code of the flexi-metadata item.
• Description (string): "Success" or "Error", in the latter case:
<Error = 10100> : Flexi item not in a dictionary
<Error = 10200> : Invalid flexi item value format
<Error = 10300> : Error during insert flexi item value

<Result> (for edl headers)
• IDAsset (integer): Asset's unique identification number in Etere.
• EDL_version (integer): EDL number (between 1 and 9).
• Description (string): "Success" or "Error", in the latter case:
<Error = 10000> : Unable to add EDL header
<Error = 10003> : Invalid EDL version

<Result> (for all rows)
• IDAsset (integer): Asset's unique identification number in Etere.
• Version (integer): EDL number (between 1 and 9).
• Mark_In (integer): Starting timecode of the mark.
• Mark_Out (integer): Ending timecode of the mark.
• Description (integer): "Success" or "Error", in the latter case:
<Error = 10001> : Invalid EDL version or missing EDL header
<Error = 10002> : Unknow n EDL type

<Result> (for edl flexi-metadata)
• IDAsset (integer): Asset's unique identification number in Etere.
• EDL_version (integer): EDL number (between 1 and 9).
• item (string): Code of the flexi-metadata item.
• Description (string): "Success" or "Error", in the latter case:
<Error = 10100> : Flexi item not in a dictionary
<Error = 10200> : Invalid flexi item value format
<Error = 10300> : Error during insert flexi item value