010
Создание инстанции бизнес-объекта (БО) по
011 идентификатору
012
013
Предусловие: Для загрузки у вас должно иметься БО (Что это такое и как
015 создать?)
016
017
Запрос (Request):
018
019
020 POST /api/v1/boi/create-with-id
021 Content-Type: application/json
022 API-TOKEN/TOKEN: your_token
023
024
025
026
044
045
Входные данные:
046
047
048 {
049 "boId": "идентификатор БО",
050 "initialFieldValues": {
051 "Идентификатор поля 1": "Значение поля 1",
052 "Идентификатор поля 2": "Значение поля 2",
053 "Идентификатор поля 3": "Значение поля 3"
054 },
055 "fieldRefAdd": [
056 {
057 "fieldCode": "код поля 4",
058 "boCode": "код БО который содержит в себе поле с кодом поля 4",
059 "fieldRefUniqCode": "код уникального поля 1",
060 "apiValues": [
061 "значение 1 уникального поля 1",
062 "значение 2 уникального поля 1"
063 ]
064 },
065 ...
066 ],
067 "multiLanguage": true / false
068 }
069
070
071
072
073
074
075 | Атрибут входного JSON |
076 Описание |
077
078
079
080
081
082 | boId |
083 (String): Идентификатор бизнес-объекта.
084 Как получить идентификаторы БО? |
085
086
087
088 | initialFieldValues.key |
089 (String): Код определенного поля внутри
090 БО. Как получить идентификаторы
091 полей? |
092
093
094
095 | initialFieldValues.value |
096 (String): Значение определенного поля
097 внутри БО. Какие значения для
098 каких полей надо вводить? |
099
100
101
102 | fieldRefAdd |
103 (Массив объектов): Для добавления
104 ссылок в поле БО по значениям уникальных полей вложенного БО |
105
106
107
108 | fieldRefAdd.fieldCode |
109 (String): Код поля БО. Смотрите
110 выше как получить код поля? |
111
112
113
114 | fieldRefAdd.boCode |
115 (String): Если поле с
116 fieldCode находится внутри СО, то данное поле
117 обязательное к заполнению, так как она будет
118 показывать к какому БО относится ваше поле. |
119
120
121
122 | fieldRefAdd.fieldRefUniqCode |
123 (String): Код уникального поля БО на
124 которое ссылается ваше поле. Смотрите выше как получить код
125 поля? |
126
127
128
129 | fieldRefAdd.apiValues |
130 (Массив String): Значения уникальных
131 полей которы надо добавить. Если в fieldRefRemove, то удалить. |
132
133
134
135 | multiLanguage |
136 (Boolean): Только для отображения
137 мультиязычных полей созданной инстанции. Значение по умолчанию
138 false - значит у вас будет отображаться значение на
139 выбранном языке текущего пользователя. При true, вам
140 будет отправляться массив объектов
141 fieldValuesLang, содержащая текст по всем языкам
142 которые есть в системе для всех мультиязычных полей. |
143
144
145
146
147
Примечание: Вы можете указывать несколько
148 уникальных полей одного и того же БО.
149
150
Пример:
151
152
153 {
154 "boId": "gWmNg9ec3yI0wv4V", // Должно состоять только из 16 символов
155 "initialFieldValues": {
156 "UweuNeV8aG3~Tuvf": "545454",
157 "CV~4boDWzp2SpQ@U": "Alimzhan",
158 "84uP6Ml@gq87Fs2u": "1231231.0123",
159 "eK3Owd6xaY7YCODc": "2023-12-23T14:30:45.123Z",
160 "DybDzyYFS9csQLoJ": "mm6mHOUvo3w3w~Ud" // идентификатор значения из выборки
161 },
162 "multiLanguage": true
163 }
164
165
166
167
Ответ (Response):
168
169
Созданная инстанция БО:
170
171
172 {
173 "boiId": "Идентификатор инстанции БО",
174 "boCode": "Kод БО",
175 "state": "Одно из значений: ALL, REMOVED, ARCHIVED, DEV",
176 "isTouched": "Прочитано ли текущим пользователем данная инстанция? (true/false)",
177 "fieldValues": {
178 "идентификатор поля 1": {
179 "apiValue": "значение поля 1",
180 "displayValue": "значение поля для отображения 1",
181 "type": "Тип поля" // Подробнее о типах поля можете узнать по ссылке ниже
182 },
183 "идентификатор поля 2": {
184 "apiValue": "значение поля 2",
185 "displayValue": "значение поля для отображения 2",
186 "type": "Тип поля" // Подробнее о типах поля можете узнать по ссылке ниже
187 },
188 "идентификатор поля 3": {
189 "apiValue": "значение поля 3",
190 "displayValue": "значение поля для отображения 3",
191 "type": "Тип поля" // Подробнее о типах поля можете узнать по ссылке ниже
192 }
193 },
194 "fieldValuesLang": {
195 "код поля 4 ": {
196 "type": "тип мультиязычного поля 4",
197 "langApiValue": { // Значения по всем языкам которые есть в системе
198 "Код языка": "Значение мультиязычного поля на этом языке",
199 }
200 },
201 "код поля 5": {
202 "type": "тип мультиязычного поля 5",
203 "langApiValue": { // Значения по всем языкам которые есть в системе
204 "Код языка": "Значение мультиязычного поля на этом языке"
205 }
206 }
207 }
208 }
209
210
211
212
216
217
Значения поля state:
218
219
1) ALL - Рабочее состояние записи
220
221
2) REMOVED - Запись удалена
222
223
3) ARCHIVED - Запись в архиве
224
225
4) DEV - Запись используется для тестирования
226 процессов
227
228
Значение поля boiId можно позже использовать для
229 получения инстанции бизнес объекта.
230
231
Пример:
232
233
234 {
235 "boiId": "nnxn39PqFAmHv4ik",
236 "boId": "gWmNg9ec3yI0wv4V",
237 "state": "ALL",
238 "isTouched": true,
239 "fieldValues": {
240 "UweuNeV8aG3~Tuvf": {
241 "apiValue": "545454",
242 "displayValue": "545454",
243 "type": "INPUT_NUMBER"
244 },
245 "DybDzyYFS9csQLoJ": {
246 "apiValue": "mm6mHOUvo3w3w~Ud", // идентификатор значения из выборки
247 "displayValue": "Pending",
248 "type": "RADIO_BUTTON_GROUP"
249 },
250 "eK3Owd6xaY7YCODc": {
251 "apiValue": "2023-12-23T20:30:45.123+06",
252 "displayValue": "2023-12-23 20:30",
253 "type": "FULL_DATE"
254 },
255 "84uP6Ml@gq87Fs2u": {
256 "apiValue": "1231231.0123",
257 "displayValue": "1231231.0123",
258 "type": "INPUT_NUMBER"
259 },
260 "CV~4boDWzp2SpQ@U": {
261 "apiValue": "Temirlan",
262 "displayValue": "Temirlan",
263 "type": "INPUT_TEXT_LANG"
264 }
265 },
266 "fieldValuesLang": {
267 "CV~4boDWzp2SpQ@U": {
268 "type": "INPUT_TEXT_LANG",
269 "langApiValue": { // Значения по всем языкам которые есть в системе
270 "ENG": "Temirlan",
271 "RUS": "Темирлан",
272 "KAZ": "Темірлан",
273 "QAZ": "Temirlan"
274 }
275 }
276 }
277 }
278
279
280