Утилиты
=======

AS.FORMS.ApiUtils
~~~~~~~~~~~~~~~~~

.. js:class:: AS.FORMS.ApiUtils

    Утилиты для работы с REST API Synergy

    .. js:function:: simpleAsyncGet(urlPart[, callback[, dataType[, data[, errorHandler]]]])

        Выполнить GET запрос по указанному URL REST API.
        Хост и порт Synergy прописываются при подключении проигрывателя форм.
        Является оберткой над `jQuery.ajax() <http://api.jquery.com/jquery.ajax/>`_, поэтому обладает всеми его свойствами.

        :param string urlPart:        Часть URL метода REST API, без ``http://host:port/Synergy/``,
                                      например ``rest/api/registry/create_doc?registryCode=someregistry``
        :param function callback:     Функция, которая будет вызвана в случае успешного выполнения запроса.
                                      В данную функцию передается один параметр - ответ на запрос.
        :param string dataType:       Тип данных ответа на запрос.
                                      Может принимать значения: ``"xml"``, ``"html"``, ``"script"``, ``"json"``, ``"jsonp"``, ``"text"``.
                                      Если не передавать параметр, то будет использоваться дефолтное значение ``"json"``.
        :param object data:           Данные запроса. Могут быть строкой, объектом или массивом.
                                      Конвертируются в строку запроса и добавляются к URL.
        :param function errorHandler: Функция, которая будет вызвана в случае неуспешного выполнения запроса.

    .. js:function:: simpleAsyncPost(urlPart[, callback[, dataType[, data[, contentType[, errorHandler]]]]])

        Выполнить POST запрос по указанному URL REST API.

        :param string urlPart:        Часть URL метода REST API, без ``http://host:port/Synergy/``,
                                      например ``rest/api/asforms/data/save``
        :param function callback:     Функция, которая будет вызвана в случае успешного выполнения запроса.
                                      В данную функцию передается один параметр - ответ на запрос.
        :param string dataType:       ``default:'json'`` Тип данных ответа на запрос.
                                      Может принимать значения: ``"xml"``, ``"html"``, ``"script"``, ``"json"``, ``"jsonp"``, ``"text"``.
        :param object data:           Данные запроса. Могут быть строкой, объектом или массивом.
                                      Конвертируются в строку запроса и добавляются к URL.
        :param string contentType:    ``default:'application/x-www-form-urlencoded; charset=UTF-8'`` Тип данных запроса.
        :param function errorHandler: Функция, которая будет вызвана в случае неуспешного выполнения запроса.
