Elements Integration¶
[Team : Johnson Team] [Tech Lead : jh2636] [Service Owner : TBC] [Service Manager : weer2] [Product Manager : TBC]
This page gives an overview of the Elements Integration, describing its current status, where and how it's developed and deployed, and who is responsible for maintaining it.
Service Description¶
The Elements Integration bulk-uploads record data into Symplectic Elements — in particular the grants held by Principal Investigators, and the links between those grants and PIs. Users upload CSV files of records and relationships through a web application, which validates them and pushes them to Elements through the Elements API.
It is the replacement for the legacy Seymour desktop tool, reimplemented as a web application on the Unified DevOps Platform.
Service Status¶
The Elements Integration is currently in development, and replaces the legacy Seymour tool.
Contact¶
Technical queries and support should be directed to uis-devops-division@lists.cam.ac.uk and will be picked up by a member of the team working on the service. To ensure that you receive a response, always direct requests to uis-devops-division@lists.cam.ac.uk rather than reaching out to team members directly.
Issues discovered in the service or new feature requests should be opened as GitLab issues in the application repository.
Environments¶
The Elements Integration is deployed to GCP Cloud Run (region europe-west2), provisioned and
managed by the Terraform configuration in the infrastructure repository (see Source
code below):
| Name | Application URL |
|---|---|
| Production | https://webapp-104308964130.europe-west2.run.app/ |
| UAT | https://webapp-560479719258.europe-west2.run.app/ |
Outbound calls to the Symplectic Elements API leave through a reserved static egress IP address, so that the integration can be added to the Elements API's IP allowlist.
Source code¶
The source code for the Elements Integration is spread over the following repositories:
| Repository | Description |
|---|---|
| Web Application | The Django/React web application: CSV upload, validation, and the Elements API client. |
| Infrastructure Deployment | The Terraform infrastructure code for deploying the web application to GCP. |
Technologies used¶
The following gives an overview of the technologies the Elements Integration is built on.
| Category | Language | Framework |
|---|---|---|
| Server | Python | Django |
| Client | TypeScript | React |
| Infrastructure | HCL | Terraform |
| Platform | Unified DevOps Platform |
Service Management¶
The Team responsible for this service is Johnson Team.
The Tech Lead for this service is jh2636.
The Service Owner for this service is TBC.
The Service Manager for this service is weer2.
The Product Manager for this service is TBC.