Работа с сервисами
8 800 555-89-02
Войти
Документация
CTRL+K
Standalone2410
SaaS

Работа с сервисами

В этой статье

Работа с сервисами осуществляется с помощью блоков:

Получить календари

С помощью блока можно получить список календарей сотрудника.

Для этого введите домен или логин пользователя или добавьте его с помощью маппинга в поле Домен\логин.

Получить календари

После выполнения блок возвращает список календарей пользователя, которые можно использовать в блоке Получить события календаря.

При настройке подключения вы можете активировать режим имперсонализации данных. Если он включен, данные о календарях и событиях будут поступать от имени пользователя, чей электронный адрес указан в настройках блока.

Режим имперсонализации данных

Получить события календаря

Блок позволяет получить список событий календаря.

Параметры блока:

  • Идентификатор календаря (обязательное поле, заполняется вручную или с помощью маппинга)
  • Условие сбора событий (обязательное поле)

Получить события календаря

Если поле Условие сбора событий:

  • Заполнить значением sync_state, то в выходных данных отобразятся повторяющиеся, неповторяющиеся и отмененные события, которые были созданы или обновлены с момента времени последнего выполнения скрипта. Значение sync_state уникально для каждого события и опирается на дату последнего изменения события
  • Заполнить значением даты в миллисекундах, то в выходных данных отобразятся только те события, которые начинаются с этой даты. Значение даты опирается на время начала события. В этом случае в выходных данных отобразятся неповторяющиеся события, повторяющиеся события разобьются на отдельные встречи. Отмененные события отображаться не будут

Блок выводит данные событий указанного календаря. На основе полученных данных можно создать таблицу и построить процесс.

Отправить письмо

Блок позволяет отправлять письма на указанный адрес электронной почты.

Параметры:

  • Подключение (выбор существующего подключения или добавление нового)
  • Адрес получателя
  • Тема письма
  • Сообщение (формат: Текст или HTML)
  • Вложение
  • Копия
  • Скрытая копия

Все параметры блока, кроме подключения, можно указать с помощью маппинга.

Отправить письмо

Отправить письмо можно с адреса, указанного при настройке подключения SMTP, или из системы, выбрав блок Отправить письмо в пакете «Письма из системы».

Отправить письмо

Для отправки письма из пакета «Письма из системы» необходимо настроить сервер исходящей почты.

Особенности работы блока:

  • В блоке можно использовать значения только одного блока-источника. Например, перед блоком «4. Отправить письмо» есть еще 2 блока. Данные можно получить только из одного из них. Если указываются значения из обоих блоков, появляется ошибка
  • Перед блоком обязательно должен быть другой. Количество отправленных писем будет зависеть от количества возвращенных записей. Например, предыдущий блок вернул 5 записей, значит, будет отправлено 5 писем
  • В поле Адрес получателя можно указать нескольких пользователей текстом через запятую

Пример:

  1. Добавляем блок Отправить письмо и вводим адрес получателя. Если получателей несколько, указываем все адреса в поле Адрес получателя текстом через запятую. Заполняем другие поля блока и нажимаем Тестировать. Отправить письмо
  2. Когда тест завершится, письмо будет отправлено на указанные адреса.

HTTP-запрос

Блок позволяет отправлять HTTP-запрос на указанный адрес.

Параметры:

  • Подключение (выбор существующего подключения или добавление нового)
  • URL
  • Метод (GET, POST)
  • Заголовок (ключ и значение)
  • Тело запроса (при методе POST)
  • Пакетная обработка (при методе POST, позволяет ускоренно отправлять данные)

Метод выбирается из списка, все остальные параметры могут быть заданы вручную или с помощью маппинга.

HTTP-запрос

Пример:

  1. Вводим URL и тестируем по нажатию кнопки Тестировать. Параметры
  2. Когда тест завершен, получаем выходные данные во вкладке Тест. Тест

Запуск скрипта с помощью GraphQL-запроса

  1. Получите GUID скрипта и ID рабочего пространства, выполнив следующий запрос в GraphiQL:
    query{
      automation{
        script{
          script_general(id: <id_скрипта>){
            id
            guid
            workspace{
              id
            }
          }
        }
      }
    }
    
    ID пространства можно также получить в системной таблице workspace, если подключена привилегия Системные таблицы.
  2. В блоке HTTP-запрос введите URL-адрес вашего сервера GraphQL с ключом API в формате https://{адрес_сервера}/graphql?api_key=ключ.
  3. Выберите метод POST.
  4. В поле Тело запроса введите запрос:
    {"query":"mutation{
      automation{
        script{
          execute_by_guid(guid:\"<полученный_GUID_скрипта\", workspace_id:<полученный_id_пространства>){
            guid
          }
        }
      }
    }"}
    
    Запуск скрипта с помощью GraphQL-запроса
  5. Нажмите Тестировать.
  6. Когда тест завершится, выходные данные отобразятся во вкладке Тест. Выходные данные

Выполнить код

Блок позволяет обрабатывать данные с помощью JS-кода.

Выполнить код

Используйте блок, чтобы:

  • Выполнять множественные/связанные HTTP-запросы
  • Выгружать/загружать файлы с помощью HTTP-запросов
  • Совершать математические действия над данными (переменными)
  • Обрабатывать строки в JSON и фильтровать значения

Чтобы выполнить действие, введите JS-код в поле JavaScript в параметрах блока. С помощью маппинга в код можно подставить переменные.

Блок может содержать z-метод для хеширования и обработки ошибок. Возможные методы для выполнения в JS-среде:

  • z.base64Encode() — производит base64-кодирование входной строки. Например: const auth = z.base64Encode(login + ':' + password);
  • z.base64Decode() — производит base64-декодирование входной строки. Например: const originalText = z.base64Decode(encodedText);
  • z.request() — выполняет HTTP-запрос. Ожидает на вход объект с конфигурацией запроса. Параметры:
    • url — адрес, куда будет отправлен запрос
    • method — по умолчанию GET. Возможные значения: GET, POST, DELETE, PUT
    • headers — список заголовков HTTP-запроса
    • jsonBody/multipartBody — тело запроса. Обязательный параметр для методов POST и PUT

Запуск скрипта с помощью JS-кода

  1. Введите код в поле JavaScript:
    const apiKey = 'ключ';
    const scriptGuid = 'GUID_скрипта';
    const workspaceId = 1;
    
    var resp1 = z.request({
        url: 'https://адрес_сервера/graphql?api_key=' + apiKey,
        method: 'POST',
        jsonBody: '{"query":"mutation{automation{script{execute_by_guid(guid:\\"' +     scriptGuid + '\\", workspace_id:' + workspaceId + '){guid}}}}"}'
    });
    
    const app = {
        output: () => ({
                resp_1_body: JSON.stringify(resp1.response),
                resp_1_header: JSON.stringify(resp1.headers),
                resp_1_status: resp1.status,
                ["var-with-hard-name-1"]: resp1.headers.date,
                ["var-with-hard-name-2"]: resp1.headers["cache-control"],
                content_type: resp1.headers["content-type"],
                content_length: resp1.headers["content-length"]
            }
        )
    }
    
  2. Нажмите Тестировать.
  3. Когда тест завершится, выходные данные отобразятся во вкладке Тест.

Запустить скрипт по GUID

Получение файла с Jira

  1. Введите код в поле JavaScript:
    const login = 'логин';
    const password = 'пароль';
    const auth = z.base64Encode(login + ':' + password);
    
    var resp1 = z.request({
        url: 'https://jira.office.infomaximum.com/secure/attachment/76158/Screenshot_1.jpg',
        method: 'GET',
        headers: {
            Authorization: 'Basic ' + auth
        }
    });
    
    const app = {
        output: () => ({
                resp_1_body: JSON.stringify(resp1.response),
                resp_1_header: JSON.stringify(resp1.headers),
                resp_1_status: resp1.status,
                file_content: resp1.response,
                ["var-with-hard-name-1"]: resp1.headers.date,
                ["var-with-hard-name-2"]: resp1.headers["cache-control"],
                content_type: resp1.headers["content-type"],
                content_length: resp1.headers["content-length"]
            }
        )
    }
    
  2. Нажмите Тестировать.
  3. Когда тест завершится, выходные данные отобразятся во вкладке Тест.

Получить файл с Jira

Была ли статья полезна?

Да
Нет
Предыдущая
Работа с файлами
8 (800) 555-89-028 (495) 150-31-45team@infomaximum.com
Для бизнеса
© 20102024. ООО «Инфомаксимум»
Мы используем файлы cookies, чтобы сайт был лучше для вас.