Cinema operator variable data

At Vista Head Office, variable data can be set up for certain fields of various entities per cinema operator or cinema operator group. For example, films will often have different distributors for different countries. In this case, all cinema operators for a country can be added to a group, and the correct distributor for the country can be defined against the relevant group.

Currently in Connect, only variable data for films is supported.

Films

Connect supports variable data for these fields on a Film entity:

• Rating (Censor in Head Office)
• Rating Description (Content in Head Office)
• Distributor
• Opening date

Note: ScheduledFilms entities already have relevant variable data applied, as this data comes from Vista Cinema rather than Head Office.

Variable data for a specific cinema operator

Call the Films endpoint, passing through the cinema ID and the code of the cinema operator in the URL.

GET: /OData.svc/Films?cinemaOperatorCinemaId=004&cinemaOperatorCode=ABC

{
    "value": [
        {
            "ID": "0000000001",
            "Title": "Star Wars",
            "Rating": "R",
            "RatingDescription": "Restricted",
            "OpeningDate": "2018-03-28:00:00",
            "DistributorName": "ABC Distributor"
        },
	}
}

The cinema ID and code for a cinema operator can be retrieved from the CinemaId and Code properties in the CinemaOperators endpoint.

GET: /OData.svc/CinemaOperators

{
    "value": [
        {
            "ID": "004-ABC",
            "CinemaId": "004",
            "Code": "ABC",
            "Name": "ABC Cinema",
            "ShortName": "ABC Cin",
            "IsDefault": true,
            "HoOperatorCode": "ABC"
        }
	}
}

Variable data for a cinema operator group

Call the Films endpoint, passing through the code of the cinema operator group in the URL.

GET: /OData.svc/Films?cinemaOperatorGroupCode=0000000001

{
    "value": [
        {
            "ID": "0000000001",
            "Title": "Star Wars",
            "Rating": "G",
            "RatingDescription": "General",
            "OpeningDate": "2018-03-27:00:00",
            "DistributorName": "NZ Distributor"
        },
	}
}

The code for a group can be retrieved from the ID property in the CinemaOperatorGroups endpoint.

GET: /OData.svc/CinemaOperatorGroups

{
    "value": [
        {
            "ID": "0000000001",
            "Description": "NEW ZEALAND",
            "Sequence": 1
        },
        {
            "ID": "0000000002",
            "Description": "AUSTRALIA",
            "Sequence": 2
        },
	}
}