Structure Manipulation Web Services provides endpoints for the following:
This documentation describes installation, administration and usage of Structure Manipulation Web Services. As all JChem Microservices modules, it is available in two modes:
In microservices system mode, the Structure Manipulation Web Services runs together with the Config, Discovery and Gateway services. These three services are mandatory, and optionally other services can also be part of the system. All configuration must be done in the Config service.
The default configuration applies to the microservices system mode.
The web application runs on host <server-host> and listens on port <gateway-server-port>.
In standalone web application mode, the Structure Manipulation Web Services runs alone, without the Config, Discovery and Gateway services (however, the installer installs them as well).
The default configuration must be changed according to the standalone web application mode. Set the following in the application.properties file
eureka.client.enabled=false
spring.cloud.config.enabled=false
spring.config.import=
All configuration must be done in the Structure-Manipulation module.
The web application runs on host <server-host> and listens on port <server-port>.
See here.
See here
See here.
Module is installed into folder: jws/jws-structure
See here.
See here.
Default configuration:
application.properties | |
---|---|
server.port=8063 | |
logging.file.name=../logs/jws-structure.log | |
spring.config.import=optional:configserver:${CONFIG_SERVER_URI:http\://localhost\:8888} | Added in version 22.6.0. |
eureka.client.enabled=true | set eureka.client.enabled=false to switch to standalone Structure Manipulation application mode |
bootstrap.properties |
---|
spring.cloud.config.failFast=true #Removed in version 22.6.0. spring.cloud.config.uri=${CONFIG_SERVER_URI:http\://localhost\:8888/} #Removed in version 22.6.0. spring.cloud.config.retry.initialInterval=3000 #Removed in version 22.6.0. spring.cloud.config.retry.multiplier=1.2 #Removed in version 22.6.0. spring.cloud.config.retry.maxInterval=60000 #Removed in version 22.6.0. spring.cloud.config.retry.maxAttempts=100 #Removed in version 22.6.0. |
For more configuration options, see the Spring documentation page.
Prerequisites in case of microservices system mode:
Config service is running
Discovery service is running
Gateway service is running
Run the service in command line in folder jws/jws-structure:
jws-structure-service.exe --install
jws-structure-service.exe --start
(on Windows in administrator's terminal)
jws-structure-service start
(on Linux)
or
run-jws-structure.exe
(on Windows)
Find and try out the API on the Swagger UI.
Mode | URL of Swagger UI | Default URL of Swagger UI |
---|---|---|
Microservices system | <serverhost>:<gateway-port>/structure-manipulation/API/ | localhost:8080/structure-manipulation/API/ |
Standalone web application mode | <serverhost>:<server-port>/API/ | localhost:8063/API/ |
For detailed description check out the JWS Structure Manipulation demo site:
https://jchem-microservices.chemaxon.com/structure-manipulation/api/index.html
Follow the guidelines, examples on the Demo site or on the Swagger UI API documentation of your installed module.
This controller makes extraction of textbox content from chemical structures - represented in string - possible.
This controller provides endpoints for cutting chemical structures - represented in string - to their fragments. It can cut:
any molecules into components,
markush molecules into scaffold and rgroups,
markush reaction molecules into components,
simple molecules into fragments,
reaction molecules into components.
For input structures plain text chemical file formats are supported.
The output format can be set as a parameter.
Converts different molecular string representations into JSON format and molecular JSON representations to string.
Methods for 2D and 3D cleaning of chemical structures.
For input structures plain text chemical file formats are supported.
The format of the output structure is MRV.
Different cleaning options can be set for the 2D and 3D cleaning procedures.
Available from version 19.26.0
Standardizes the input list of molecules according to the specified standardizer actions.
The guidelines, examples on the Demo site or on the Swagger UI API documentation of your installed module display the methods and syntax implemented for reaching the functionalities of Standardizer Actions product.
Available from version 19.24.0
Creates a multistep reaction from the input single step reactions.