Python 2.7/3.8 module to manage the SomConnexio's ERP integration with OTRS
This library manages all the business logic between the Som Connexio's systems and the ticketing tool OTRS.
Processes
OTRS Configuration
Configure the web services in OTRS:
Ticket Connector (Provider)
-
Usage: It exposes the Ticket, Article and DynamicFields object and allows to get, create, update and remove tickets. We use the PyOTRS to interact with it. Look in the PyOTRS docs for more info.
-
Configuration: Use the template provided by the PyOTRS client: https://gitlab.com/rhab/PyOTRS/-/blob/master/webservices_templates/GenericTicketConnectorREST.yml
CustomerUser Connector (Provider)
-
Usage: It's a RPCConnector. It interacts with the OTRS objects directly calling the class methods.
-
Configuration: You need admin permissions to manage it. Contact with your OTRS provider.
MMCaller Connector (Requester)
-
Usage: It calls MMProxy when an event is raised.
-
Configuration: https://gitlab.com/coopdevs/somconnexio-documentation/-/blob/master/integracions/masmovil.md#webservice-dotrs
Environment configuration
OTRSClient
The client to interact with OTRS. You need to define the next environment variables to use the client:
OTRS_URL= # Baseurl of the OTRS instance
OTRS_USER= # Creadencials of user with write acces to OTRS
OTRS_PASSW=
Python version
We are using Pyenv to fix the Python version and the virtualenv to test the package.
You need:
- Intall and configure
pyenv - Install and configure
pyenv-virtualenvwrapper - Intall locally the version of python needed:
$ pyenv install 3.8.2
- Create the virtualenv to use:
$ pyenv virtualenv 3.8.2 otrs_somconnexio
Python packages requirements
Install the Python packages in the virtual environment:
$ pyenv exec pip install -r requirements.txt
Run tests
To run the test you can run:
$ tox
Also you can run only the tests running:
$ pytest .
and if you want the coverage info:
$ pytest --cov .
If running the tests with tox, they will be tested with both python3.8 and python2.7. This is because OTRS-SomConnexio works with an ERP which uses python2, as well as with other packages that use python3.
Release process
Release and publish the package to PyPi:
- Update the VERSION var in setup.py matching the version you specified in the CHANGELOG.
- Open a merge request with these changes for the team to approve.
- Merge it, add a git tag on the Deployments > Releases section and push it.
- Once the pipeline has successfully passed, approve the publish step.
2 maintainers
Metadata
2 maintainers
Release files for otrs-somconnexio 0.8.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| otrs_somconnexio-0.8.7.tar.gz | 76.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| otrs_somconnexio-0.8.7-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details |
Total release size: 228.7 kB
Release files / otrs_somconnexio-0.8.7.tar.gz
| Download URL | otrs_somconnexio-0.8.7.tar.gz |
|---|---|
| Size | 76.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
322deac8b235800d11fb0d980524b92087e057669fb6a7e504e04eaf16dff37c
|
|
BLAKE2b-256 checksum How to use checksums |
15a86d879eb6bebd082d0c520fc656c6fd449f5b23067bc5590f16990cacc570
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.8.20
|
Release files / otrs_somconnexio-0.8.7-py2.py3-none-any.whl
| Download URL | otrs_somconnexio-0.8.7-py2.py3-none-any.whl |
|---|---|
| Size | 152.4 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
2ff4e016f0b847fe3c18cf2565dc2d63d40a955ebcd9b3d6089c870ba9fb284f
|
|
BLAKE2b-256 checksum How to use checksums |
159aba70d46951feed22083b67bfb21e64b3d460a9b8ed7d83a98735fdaef01d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.8.20
|
