OData Class

Properties   Methods   Events   Configuration Settings   Errors  

The OData class implements the Open Data Protocol (OData). It can be used to query, parse, and update/modify data contained within an OData service.

Syntax

class ipworks.OData

Remarks

The OData Class supports both plaintext and SSL/TLS connections. When connecting over SSL/TLS the on_ssl_server_authentication event allows you to check the server identity and other security attributes. The on_ssl_status event provides information about the SSL handshake. Additional SSL related settings are also supported via the config method.

The OData component allows you to easily query OData services and create, update, and delete entries within a service. To query a service, you can set the service_root_uri to the service's root URI and resource_path to the collection within the service that you wish to query. Optionally you can set the Query*** properties to filter the results. query_service can then be called to retrieve the results (which can be viewed via the Entry*** properties).

  OData1.ServiceRootURI = "http://services.odata.org/OData/OData.svc"
  OData1.ResourcePath = "Products"
  OData1.QueryService()

To create a new entry, you can set the service_root_uri to the service's root URI and resource_path to the collection within the service that you wish to add the entry to. The Entry*** properties can be set to the values you wish to use to create the entry. create_entry can then be called to create the entry.

  OData1.ServiceRootURI = "http://services.odata.org/OData/OData.svc"
  OData1.ResourcePath = "Products"
  OData1.EntryProperties
  OData1.CreateEntry()

If you wish to update an entry, you can set the service_root_uri to the service's root URI and resource_path to the specific entry you wish to update. The Entry*** properties can be set to the values you wish to update. update_entry can then be called to update the entry.

  OData1.ServiceRootURI = "http://services.odata.org/OData/OData.svc"
  OData1.ResourcePath = "Products(1)"
  // Index 1 is the "Name" property.
  OData1.EntryProperties[1].Value = "MyNewName"
  OData1.UpdateEntry()

Deleting an entry requires that you first set the service_root_uri to the service's root URI and resource_path to the specific entry you wish to delete. delete_entry can then be called to delete the entry.

  OData1.ServiceRootURI = "http://services.odata.org/OData/OData.svc"
  OData1.ResourcePath = "Products(1)"
  OData1.DeleteEntry()

In addition to querying a service and manipulating its containing data, the OData component also allows you to retrieve the schema (metadata document) to determine the structure of a service. After setting service_root_uri to the root URI of the service, get_schema can be called to retrieve the metadata document. The Schema*** properties will be populated upon successful retrieval of the metadata document allowing you to identify the structure of the service.

  OData1.ServiceRootURI = "http://services.odata.org/OData/OData.svc"
  OData1.GetSchema()