Задача [0503]: Метод API для трансфера файлов вложений из одного документа в другой

Формулировка проблемы: нет возможности добавить во вложения документа файлы из другого документа.

Решение: необходимо реализовать следующий метод, который позволяет добавлять файлы вложений из одного документа в другой документ:

URL метода: rest/api/docflow/doc/attachment/transfer

Тип запроса: POST

Метод принимает следующие параметры (json):

Метод возвращает json-объект с полями:

Пример передаваемого запроса:


{
"toDocId" : "359e0450-5248-11e6-81e4-5a14ad700067",
"path": "ase:workContainer",
"fromDocId" : "96491790-4e33-11e6-a28a-5a14ad700067",
"fileCollision" : "version", 
"files":
    [        
        { "fileUUID" : "0db3a170-4e38-11e6-8030-001ef892a4ee" 
        },

        { "fileUUID" : "f30f6b31-4cbe-11e6-8030-001ef892a4ee" 
        }, 

        { "fileUUID" : "831b5d10-4da5-11e6-812b-5a14ad700067",
          "fileName" : "test.pdf",
          "filePath" : "ase:workContainer"
        },

        {  "fileName" : "test.htd", 
           "filePath" : "ase:workContainer`"
        },
        {  "fileName" : "file1.pdf"
        } 
    ]
}

Пример возвращаемого json-объекта при успешном выполнении метода:


{
    "errorCode": 0,
    "errorMessage": "Файлы добавлены"
}

Альтернативные потоки событий

Альтернативный поток №1. Не передан либо передан некорректный (несуществующий) параметр toDocID. Сервер возвращает ошибку HTTP 400 с сообщением:

{
    "errorCode" : 3,
    "errorMessage" : "Не передан либо передан некорректный параметр toDocID"
}

действие не выполняется.

Альтернативный поток №2. Не передан либо передан некорректный (несуществующий) параметр fromDocID. Сервер возвращает ошибку HTTP 400 с сообщением:

{
    "errorCode" : 3,
    "errorMessage" : "Не передан либо передан некорректный параметр fromDocID"
}

действие не выполняется.

Альтернативный поток №3. Не передан или передан некорректный (состоит из элементов, несуществующих в документе, из которого передаются файлы, или не переданы обязательные параметры) массив files. Сервер возвращает ошибку HTTP 400 с сообщением:

{
    "errorCode" : 3,
    "errorMessage" : "Не передан либо передан некорректный массив files"
}

действие не выполняется.

Если хотя бы один из элементов массива некорректный, возвращается данная ошибка и действие не выполняется.

Альтернативный поток №4. У пользователя нет прав на добавления файлов в папку "Приложения". Сервер возвращает ошибку HTTP 403 с сообщением:


{
    "errorCode": 2,
    "errorMessage": "У вас отсутствуют права на добавления файлов"
}

действие не выполняется.