README.md 2.76 KB
Newer Older
1
# Eph-client
2
3
4
5
6

Python client for accessing ephorte.

## Ephorte

7
8
9
Ephorte is a "saksbehandling and arkiv" system which is used in the universities.
The ephorte has a integration component, EiS. This component is used in this integration.

10
At the moment, EiS is used for UiB, UiO, UiT, and NTNU.  
11
In order to consume the service following are required:
12
13
14
- gravitee with EiS credentials 
- sshutle with uio account
  
15
### UiO
Karan Rajanayagam's avatar
Karan Rajanayagam committed
16
- vpn is required for running integration test (ip level restriction)
karanr's avatar
karanr committed
17
- How to setup [VPN](https://www.uio.no/tjenester/it/nett/vpn/)
18
19
## Test

20
### Unit test: 
21
22
```python -m pytest``` 

23
24
25
26
27
### Integration test
Required to have all configurations are set in `config.yaml` locally.   
- Run all tests. `python -m pytest -m integration`
- Run one specific test: `python -m pytest -m integration -k test_name`
- Run with xml logging: `python -m  pytest -m integration -k test_fetch_sak --log-cli-level=DEBUG` 
Karan Rajanayagam's avatar
Karan Rajanayagam committed
28

29
30
31
32
33
34
One can maintain different config locally by having for example `config-uio.yaml` and `config-uib.yaml`.

UiO: VPN login (Cisco any connect) is required to run (not enough with sshutle).  

When there is new database (migration is done), normally the ids are required to be updated, so some tests will fail.  
Specially `def_saksbehandler_pn_id` is required to be updated. The saksbehandler is the integration user itself.  
35

36
37
## EiS
### Object model service
karanr's avatar
karanr committed
38
To check the domain model in Ephorte (Sak, Journalpost and etc) use `xsd/eis-object-model.xsd`.  
39
40
To search, create, delete Sak, Jounalpost

karanr's avatar
karanr committed
41
UiB: <https://gw-uib.intark.uh-it.no/eis/test/nCore/Services/objectmodel/v3/no/ObjectModelService.svc>  
Karan Rajanayagam's avatar
Karan Rajanayagam committed
42
UiO: <https://gw-uio.intark.uh-it.no/eis/test/nCore/services/ObjectModel/v3/no/ObjectModelService.svc?wsdl>
43

44
### Document service
45
46

To upload documents
karanr's avatar
karanr committed
47
UiB: <https://gw-uib.intark.uh-it.no/eis/test/nCore/Services/documents/V3/DocumentService.svc?wsdl>  
Karan Rajanayagam's avatar
Karan Rajanayagam committed
48
UiO: <https://gw-uio.intark.uh-it.no/eis/test/nCore/services/documents/v3/DocumentService.svc?wsdl>
49
50

## Ephorte web
51

52
53
IE is required for ephorte web (firefox and other web browser may not work properly)
### Ephorte web kurs (test) 
karanr's avatar
karanr committed
54
UiB: https://eph-uib-kurs.uhad.no (required to have uib user account with vpn access)  
55
UiO: https://eph-uio-kurs.uhad.no/ephorte (possible to enter via view.uio.no -> kontor -> IE )
Karan Rajanayagam's avatar
Karan Rajanayagam committed
56
57
58
59


## Ephorte search
The search is behave differently since UiO has different version(4.x) of EiS 
60
compared to UiB (6.x).
Karan Rajanayagam's avatar
Karan Rajanayagam committed
61

62
63
64

## References
[Ephorte production spesification (old version)](https://teams.microsoft.com/_#/school/files/General?threadId=19%3Abdea4527b6c44ea7956f2ab9cab618be%40thread.tacv2&ctx=channel&context=old-eis-doc&rootfolder=%252Fsites%252FBOTTintegrasjonsutviklingsteam%252FDelte%2520dokumenter%252FGeneral%252FTOA%252FeIS%2520(filer%2520fra%2520Frank%2520S%25C3%25B8rensen%2520hos%2520Sikri)%252Fold-eis-doc)