clappform-integrations

clappform-integrations

git pull --recurse-submodules git submodule update --recursive --remote

Itris API Wrapper Documentation

The Itris API wrapper facilitates interaction with the Itris system through both REST and SOAP protocols. It allows users to fetch data from various endpoints and handle cases efficiently.

Installation

First, you need to download the Python package via pip::

$ pip install clappform_integrations==1.0.26

Import package

from clappform_integrations import Itris
import pandas as pd

Initialization

REST Part

To initialize the REST part of the wrapper:

# Formatting of the REST credentials
BASEURL_REST = "https://acc-webservices.itris.net/services/acc-istl-vip"
CLIENT_ID_REST = ""
CLIENT_SECRET_REST = ""
USERNAME_REST = ""
PASSWORD_REST = ""
headers_rest = {
    'accept': 'application/json',
    'Authorization': '', 
}
timeout_rest = 600

itrisrest = Itris.ItrisREST(
    BASEURL_REST,
    CLIENT_ID_REST,
    CLIENT_SECRET_REST,
    USERNAME_REST,
    PASSWORD_REST,
    headers_rest,
    timeout_rest
)

SOAP Part

Similarly for the SOAP part of the API, initialize the ItrisSOAP object with the following parameters:

# Formatting of the SOAP credentials
BASEURL_LOGIN_SOAP= 'https://acc-webservices.itris.net/services/acc-istl-soap?WSDL'
BASEURL_SOAP= 'https://acc-webservices.itris.net/services/acc-istl-cad'
PASSWORD_SOAP= ''
PLAINPASSWD_SOAP= ''
SOAPUSERID_SOAP= ''
USERNAME_SOAP= ''
headers_soap= {
'Content-Type' : 'text/xml'
},
timeout_soap= 600

itrissoap = Itris.ItrisSOAP(
    BASEURL_LOGIN_SOAP,
    BASEURL_SOAP,
    USERNAME_SOAP,
    PASSWORD_SOAP,
    SOAPUSERID_SOAP,
    PLAINPASSWD_SOAP,
    headers_soap,
    timeout_soap
)

Fetching Data

REST Part

• To retrieve data in JSON format, use fetch_data_from_endpoint.
• To retrieve data in DataFrame format, use fetch_data_as_dataframe.

SOAP Part

Call the desired endpoint directly using call_endpoint. It will return the data in XML format.

Filters

When fetching data from the REST API, several filters can be applied:

• $expand: Retrieve related data along with the main data.
• $skip: Pagination for fetching data in chunks or pages.

Predefined Endpoints

REST Part

The wrapper includes predefined endpoints such as:

• FetchRentalObjectsWithHierarchy is utilized alongside the "$expand" filter, pertaining to the hierarchy of rental objects. Within this hierarchy, we retrieve both the units and the complexes they correspond to.

For example:

qParams = { "$expand": "Hierarchie_verhuurbare_objecten", "$skip":0} 
unit_df = itrisrest.fetch_data_as_dataframe("FetchRentalObjectsWithHierarchy", qParams)

Custom Endpoints

Users can interact with endpoints not explicitly defined by providing the endpoint's identifier.

For example the Contracten endpoint is a new endpoint:

qParams = { }
contracts = itrisrest.fetch_data_as_dataframe("Contracten", qParams)

SOAP Part

Predefined SOAP endpoints include:

• GetCaseTypeDefinitions
• GetCases
• GetCaseStartState

For example to get the complaints from the SOAP part you can use:

qParams = { }
response_GetCaseTypeDefinitions = itrissoap.call_endpoint("GetCaseTypeDefinitions", qParams)