Импорт с помощью REST API
Массовую загрузку данных в систему можно провести самостоятельно с помощью нашего API -- https://okdesk.ru/apidoc#!oborudovanie-sozdanie-oborudovaniya в связке с Goggle Apps Script https://developers.google.com/apps-script и Google таблицами https://www.google.ru/intl/ru/sheets/about/
Разберем на пример GET запроса по массовому поиску компаний, в нашем случае получению id компаний по их наименованию с примерами кодов
https://okdesk.ru/apidoc#!kompanii-poisk-kompanii
Создаем Google таблицу с полями, куда указываем название компании и полем, куда будет выводится id компании при нахождении по наименованию
Предварительно в Goggle Apps Script создаем панель для запуска наших проверок
function onOpen() { var ui = SpreadsheetApp.getUi(); ui.createMenu('OkDesk') .addItem('Copy Data', 'copyData') .addItem('Check Company', 'checkCompanyAndPrepareData') .addItem('Create Company', 'createCompanyFromData') .addToUi(); }В итоге получаем меню из которого проводим массовый запуск запросов по данным, которые находятся в таблице
Для запуска Check Company предварительно создаем fetchCompanyData_(companyName), где указываем наш get запрос
function fetchCompanyData_(companyName){ var url = “https://<account>.okdesk.ru/api/v1/companies/?api_token=3e9a214215f493c4&name=" + encodeURIComponent (companyName); //--- Запрос API var response = UrlFetchApp.fetch(url, {'muteHttpExceptions': true}); var json = response.getContentText(); var companyData = JSON.parse(json); return companyData; }Далее создаем function checkCompanyAndPrepareData() где указываем номера столбцов
COMPANY_NAME_COLUMN (столбец с названием компании) и COMPANY_ID_COLUMN (Столбец с получаемым id компании) из Google таблицы
function checkCompanyAndPrepareData(){ var COMPANY_NAME_COLUMN = 0; //------ номера столбцов в таблице, начиная с 0 var COMPANY_ID_COLUMN = 9; // Get the information in the active sheet. The data // is placed into a 2D array. var dataRange = SpreadsheetApp.getActiveSpreadsheet().getDataRange(); var companyValues = dataRange.getValues(); for(var row = 1; row < 2; row++){ //-------------- номера строк в таблице, по которым проводится загрузка var companyName = companyValues[row][COMPANY_NAME_COLUMN]; if(companyName != ""){ var companyData = fetchCompanyData_(companyName); if ((companyData != "[]") && (companyData != null)) { if(companyData.id){ companyValues[row][COMPANY_ID_COLUMN] = companyData.id; continue; } } companyValues[row][COMPANY_ID_COLUMN] = "Не найдено"; //--- вывод информации если по заданным параметрам ничего не найдено } } }Перед запуском указываем номера строк Google таблицы, которые передаем в запросе for(var row = 1; row < 2; row++)
По результату запуска получаем массовый список id компаний по их наименованию
Массовое создание компаний на примере POST запроса с примерами кодов
https://okdesk.ru/apidoc#!kompanii-sozdanie-kompanii
Создаем Google таблицу с полями, куда указываем названия параметров, по которым необходимо создать компанию
Для запуска Create Company создаем function createCompanyFromData()
Пример кода, в котором указаны блоки полей, где указаны столбцы таблицы, из которых заполняются данные, сам api запрос и тело запроса var data:
function createCompanyFromData(){ var COMPANY_NAME_COLUMN = 0; //------ номера столбцов в таблице, начиная с 0 var COMPANY_ADD_NAME_COLUMN = 1; var COMPANY_SITE_COLUMN = 2; var COMPANY_EMAIL_COLUMN = 3; var COMPANY_PHONE_COLUMN = 4; var COMPANY_COMMENT_COLUMN = 5; var COMPANY_CUST_ATTR1_COLUMN = 6; var COMPANY_CUST_ATTR2_COLUMN = 7; var COMPANY_Coordinates_1_COLUMN = 8; var COMPANY_Coordinates_2_COLUMN = 9; var COMPANY_CUST_ATTR3_COLUMN = 10; var COMPANY_ADRESS_COLUMN = 11; var COMPANY_NEW_ID_COLUMN = 13; var COMPANY_NEW_NAME_ID_COLUMN = 14; var CREATE_COMPANY_RESPONSE_COLUMN = 15; var dataRange = SpreadsheetApp.getActiveSpreadsheet().getDataRange(); var companyValues = dataRange.getValues(); for(var row = 1; row < 2; row++){ //-------------- номера строк в таблице, по которым проводится загрузка var companyName = companyValues[row][COMPANY_NAME_COLUMN]; //---- запись столбцов в переменные var companyAddName = companyValues[row][COMPANY_ADD_NAME_COLUMN]; var companySite = companyValues[row][COMPANY_SITE_COLUMN]; var companyPhone = companyValues[row][COMPANY_PHONE_COLUMN]; var companyEmail = companyValues[row][COMPANY_EMAIL_COLUMN]; var companyComment = companyValues[row][COMPANY_COMMENT_COLUMN]; var companyCustAttr1 = companyValues[row][COMPANY_CUST_ATTR1_COLUMN]; var companyCustAttr2 = companyValues[row][COMPANY_CUST_ATTR2_COLUMN]; var companyCustAttr3 = companyValues[row][COMPANY_CUST_ATTR3_COLUMN]; var companyCoordinates_1 = companyValues[row][COMPANY_Coordinates_1_COLUMN]; var companyCoordinates_2 = companyValues[row][COMPANY_Coordinates_2_COLUMN]; var companyAddress = companyValues[row][COMPANY_ADRESS_COLUMN]; var url = "https://<account>.okdesk.ru/api/v1/companies/?api_token=3e9a214215f493c4 "; //—- api запрос var data = { //-----тело запроса с подстановкой переменных столбцов "company": { "name": companyName.toString(), "additional_name": companyAddName.toString(), "site": companySite.toString(), "email": companyEmail, "phone": companyPhone.toString(), "coordinates": [companyCoordinates_1,companyCoordinates_2], "address": companyAddress, "comment": companyComment, "custom_parameters": { "custom_parameters_code1": companyCustAttr1.toString(), "custom_parameters_code2": companyCustAttr2.toString(), "custom_parameters_code3": companyCustAttr3.toString() }, }, }; var options = { 'muteHttpExceptions': true, 'method' : 'post', 'contentType': 'application/json', 'payload' : JSON.stringify(data) }; var response = UrlFetchApp.fetch(url, options); var json = response.getContentText(); var companyData = JSON.parse(json); Utilities.sleep(400); if(companyName != ""){ if ((companyData != "[]") && (companyData != null)) { if(companyData.id){ companyValues[row][COMPANY_NEW_ID_COLUMN] = companyData.id; companyValues[row][COMPANY_NEW_NAME_ID_COLUMN] = companyData.name; continue; } } companyValues[row][COMPANY_NEW_ID_COLUMN] = "Не создан"; //---вывод информации если по заданным параметрам ничего не найдено companyValues[row][CREATE_COMPANY_RESPONSE_COLUMN] = json; } } dataRange.setValues(companyValues); }
По итогу успешной загрузки в поле Response получаем лог с ответом по заполненным данным
Таким образом по аналогии можно проводить загрузку других сущностей в Okdesk таких как объекты, оборудование, контактных лиц.
ВАЖНО. Приведенные выше блоки кодов указаны для примера. Рекомендуем проводить массовый импорт данных с привлечением IT специалистов со своей стороны для написания своих скриптов.
Загрузка данных...