The Web service mechanism allows to use 1C:Enterprise 8 as a set of services in complex distributed and heterogeneous systems, as well as integrate it with other industrial systems using the service-oriented architecture.
The created Web services are published to a respective directory on a Web server.
To add a Web service to the configuration tree, select Common - Web Services and click Add in the context menu.
It will open a Web service module editing window along with the properties palette, containing the properties of the new Web service.
Every Web service described in the configuration tree can contain a set of operations. Each operation must have a corresponding export procedure, described in the Web service module.
Additionally, each operation can contain a set of parameters with their names corresponding to the names of the procedure parameters describing this operation.
In addition to the common configuration object properties, Web services contain the following properties:
- Namespace URI – contains the URI of the Web service name space. Each Web service can be uniquely identified by its name and the URI of the namespace to which it belongs;
- XDTO packages – list of XDTO packages whose types can be used as returned value types for Web service operations and types of operation parameters;
- Publication file name – name of the Web service description file located on the Web server.
The properties palette for the Web service also contains a Module reference, which allows you to open the Web service module for editing.
In addition to the common object configuration properties, Web service operation contains the following properties:
- Type of Returned Value – value type returned by Web service operation. It can be XDTO value type or XDTO object type;
- Null possible – indicates whether the returned value can have an unassigned value;
- In Transaction – indicates whether the code of the Web service module will be executed in a transaction. If the property is checked, the transaction will start automatically when the Web service is called, and upon completion, the transaction will be either submitted or rolled back (depending on the results of execution). If the property is not checked, the transaction is not started when Web service module execution starts;
- Procedure name – a name of the Web service module procedure that will be executed when this property is called.
In addition to the common object configuration properties, the Web service operation parameter contains the following properties:
- Value Type – type of value of the Web service operation parameter. It can be a XDTO value type or a XDTO object type;
- Null Possible – indicates whether the operation parameter value can take unassigned value;
- Transmit direction – defines the direction of data transmission using this parameter. Available values:
- Input – means that the parameter is used for data transmission to the Web service;
- Output – means that the parameter is used for data retrieval from the Web service;
- Input – Output – means that the parameter can be used both for transmission and retrieval of data to/from the Web service.