Update First_configuration.rst

custom_manual/First_configuration.rst

@@ -409,3 +409,53 @@ source /opt/synergy/jboss/standalone/configuration/itsm.properties
 Реализован скрипт contractExpirationNotice.sh . Данный скрипт запускает запись реестра "Реестр для отправки уведомлений по срокам действия контрактов" и находит документы, по которым необходимо направить уведомления в текущем месяце. И соответственно направляются уведомления на почту. Для удобства данный скрипт необходимо поставить в крон в подходящее время. Но перед этим его нужно сделать исполняемым с помощью следующей команды:  
 
 $ chmod a+x /opt/synergy/apps/itsm/scripts/contractExpirationNotice.sh  
+
+
+
+Для регистрации обращений из внешних систем
+-----------------------------------------------
+
+Для регистрации обращений из внешних систем можно использовать кастомную API ${HOST}/itsm/rest/incident/create
+
+Для каждого описанного ниже апи, для авторизации необходимо передавать заголовок:
+"Authorization", "Basic " + btoa(unescape(encodeURIComponent(login + ":" + password)))
+
+
+1. вызвать метод для создания временного файла на сервере: ${HOST}/Synergy/rest/api/storage/start_upload (start_upload)
+Method: GET
+В ответе получаем путь до временного файла, пример ответа:
+{
+   "errorCode": "0",
+   "file": "/opt/synergy/jboss/standalone/tmp/Synergy/upload.tmp/96f50f11-17e7-4aa9-9798-cba4d81f4135"
+}
+
+
+
+2. Далее необходимо загрузить данные во временный файл с помощью метода ${HOST}/Synergy/rest/api/storage/upload_part (upload_part)
+Method: POST
+Enctype: multipart/form-data
+
+3. после загрузки файлов на сервер, необходимо вызвать метод создания обращения ${HOST}/itsm/rest/incident/create
+Method: POST
+Content Type: application/json; charset=utf-8
+пример передаваемых параметров:
+{
+    "theme": "text theme",
+    "description": "text description",
+    "files": [
+        {
+            "name": "file.txt",
+            "path": "/opt/synergy/jboss/standalone/tmp/Synergy/upload.tmp/96f50f11-17e7-4aa9-9798-cba4d81f4135"
+        }
+    ]
+}
+
+В параметр files передается массив объектов, в каждом объекте передается имя файла и путь до временного файла на сервере, который получается при выполнении апи rest/api/storage/start_upload
+пример успешного ответа:
+{
+    "regNumber": "inc-29181",
+    "dataUUID": "67423",
+    "documentID": "e924f754-d23e-4528-90a0-4b81d3085fd5"
+}
+
+Если необходимости в передачи файлов нет, то можно сразу вызвать апи ${HOST}/itsm/rest/incident/create без параметра files, пропустив первые 2 шага.