Merge pull request #116 from rbw/feature/docs-usage-filtering

Add field filter usage example

docs/full_examples/filtering.rst

@@ -0,0 +1,21 @@
+Filtering fields
+================
+
+The `fields` parameter can be used for selecting which fields to return in the response.
+
+
+.. code-block:: python
+
+    import pysnow
+
+    # Create client object
+    c = pysnow.Client(instance='myinstance', user='myusername', password='mypassword')
+
+    # Define a resource, here we'll use the incident table API
+    incident = c.resource(api_path='/table/incident')
+
+    # Query for incidents with state 3
+    response = incident.get(query={'state': 3}, fields=['sys_id', 'number', 'description'])
+
+    # Print out the first match
+    print(response.first())

docs/index.rst

@@ -49,6 +49,7 @@ ServiceNow HTTP client library written in Python.
    full_examples/update
    full_examples/delete
    full_examples/sorting
+   full_examples/filtering
    full_examples/oauth_client
    full_examples/query_builder
    full_examples/attachments