1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
Advanced usage
==============
Batch requests
--------------
Example of batch request that contains 3 simple entity queries:
.. code-block:: python
batch = northwind.create_batch()
batch.add_request(northwind.entity_sets.Employees.get_entity(108))
batch.add_request(northwind.entity_sets.Employees.get_entity(234))
batch.add_request(northwind.entity_sets.Employees.get_entity(23))
response = batch.execute()
print(response[0].EmployeeID, response[0].LastName)
print(response[1].EmployeeID, response[1].LastName)
print(response[2].EmployeeID, response[2].LastName)
Example of batch request that contains simple entity query as well
as changest consisting of two requests for entity modification:
.. code-block:: python
batch = northwind.create_batch()
batch.add_request(northwind.entity_sets.Employees.get_entity(108))
changeset = northwind.create_changeset()
changeset.add_request(northwind.entity_sets.Employees.update_entity(45).set(LastName='Douglas'))
batch.add_request(changeset)
response = batch.execute()
print(response[0].EmployeeID, response[0].LastName)
Error handling
--------------
PyOData returns *HttpError* when the response code does not match the expected
code. Basically the exception is raised for all status codes >= 400 and its
instances have the property response which holds return value of the library
making HTTP requests.
For example, the following code show how to print out error details if
Python Requests is used as the HTTP communication library.
.. code-block:: python
try:
new_data = create_request.execute()
except pyodata.exceptions.HttpError as ex:
print(ex.response.text)
In the case you know the implementation of back-end part and you want to show
accurate errors reported by your service, you can replace *HttpError* by your
sub-class *HttpError* by assigning your type into the class member *VendorType* of
the class *HttpError*.
.. code-block:: python
from pyodata.exceptions import HttpError
class MyHttpError(HttpError):
def __init__(self, message, response):
super(MyHttpError, self).__init__('Better message', response)
HttpError.VendorType = MyHttpError
The class *pyodata.vendor.SAP.BusinessGatewayError* is an example of such
an HTTP error handling.
Enable Logging
--------------
.. _Python logging: https://docs.python.org/3/library/logging.html
The library uses `Python logging`_ without own handler, so to enable logging
it is enough to set log level to the desired value.
.. code-block:: python
import logging
logging.basicConfig()
root_logger = logging.getLogger()
root_logger.setLevel(logging.DEBUG)
Dynamically referenced EntitySet
------------------------------------------------
If you need to work with many Entity Sets the same way or if you just need to pick up the used Entity Set name in run-time, you may find out the ability to get an instance of Entity Set proxy dynamically. Here is an example of how you can print a count of all employees:
.. code-block:: python
count = getattr(northwind.entity_sets, 'Employees').get_entities().count().execute()
print(count)
|
