Интеграция с внешними системами > Запросы к сервису интеграции > Получение сущностей

Через сервис интеграции можно получить сущности с цепочками из свойств-ссылок. Цепочка свойств-ссылок образуется, когда у типа сущности есть свойство-ссылка на второй тип сущности и у этого типа сущности есть свойство-ссылка на третий тип.

Например, у дополнительных соглашений есть свойство-ссылка Договор (LeadingDocument). Свойство вынесено на форму. Пользователи указывают в поле договор, для которого создано дополнительное соглашение:

В свою очередь у типа документа «Договор» есть свойство-ссылка Автор. Нужно написать GET-запрос, чтобы получить все дополнительные соглашения и при этом узнать связанные с доп. соглашениями договоры и авторов этих договоров.

Формат URL:

{Протокол https или http}://{имя сервера, на котором установлен сервис интеграции}/{имя сервиса интеграции}/odata/{Интерфейс типа сущности во множественном числе})?$expand={Имя свойства-ссылки 1}($expand={Имя свойства-ссылки 2})

Пример:

GET /Integration/odata/ISupAgreements?$expand=LeadingDocument($expand=Author) HTTP/1.1
Host: DirectumRXServer.com
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
Content-Type: application/json
Accept: application/json

При таком запросе сервис интеграции вернет ответ.

{
    "@odata.context": "https://DirectumRXServer.com/odata/$metadata#ISupAgreements(LeadingDocument(Author()))",
    "value": [
        {
            "Name": "Доп. соглашение №1 от 12.05.2021 к договор аренды №001-2021 с Рим \"График технического обслуживания\"",
            "Created": "2021-05-12T09:24:57Z",
            "Modified": "2021-05-12T10:08:18Z",
            "HasRelations": true,
            "LastVersionSignatureType": null,
            "LastVersionApproved": false,
            "HasVersions": true,
            "HasPublicBody": false,
            "VersionsLocked": false,
            "Id": 83,
            "RegistrationNumber": "1",
            "Index": 1,
            "RegistrationDate": "2021-05-12T00:00:00Z",
            ...
            "LeadingDocument": {
                "@odata.type": "#Sungero.IntegrationService.Models.Generated.Contracts.IContractDto",
                "Name": "Договор аренды №001-2021 от 12.05.2021 с Рим \"Насос Quattro Elementi Giardino 801 Ci\"",
                "Created": "2021-05-12T09:23:18Z",
                "Modified": "2021-05-12T09:23:20Z",
                "HasRelations": true,
                "LastVersionSignatureType": null,
                "LastVersionApproved": false,
                "HasVersions": true,
                "HasPublicBody": false,
                "VersionsLocked": false,
                "Id": 82,
                "RegistrationNumber": "001-2021",
                ...
                "Author": {
                    "@odata.type": "#Sungero.IntegrationService.Models.Generated.Company.IEmployeeDto",
                    "Sid": "506c9866-51f9-42d4-b245-fbcf184441d5",
                    "Name": "Ардо Наталья Михайловна",
                    "Description": null,
                    "IsSystem": null,
                    "Status": "Active",
                    "Id": 105,
                    "PersonalPhotoHash": "8916804d46554a2b0a8cb27adcb7e4c5",
                    "Phone": "55-40-55",
                    "Note": null,
                    "Email": "Ardo_NM@technosystem.ru",
                    "NeedNotifyExpiredAssignments": false,
                    "NeedNotifyNewAssignments": false,
                    "PersonnelNumber": null
                }
            }
        }
    ]
}

Сейчас в одном запросе можно получить цепочку из пяти свойств-коллекций, то есть использовать пять параметров $expand.

Чтение цепочек из свойств-ссылок

Чтение цепочек из свойств-ссылок