Чтобы настроить сценарий робота, разместите действия на схеме, настройте их свойства и связи.

Список действий

На левой панели находится список действий, которые можно использовать при создании схемы робота. Действия в списке можно отфильтровать по языку реализации. Также необходимое действие можно найти по названию, используя поле «Поиск действия».

Управление действиями на схеме

Размещение

Чтобы разместить действие на схеме, выберите его в списке и, удерживая ЛКМ, перенесите на схему робота. На схеме отобразится индикатор, который покажет, где будет размещено действие.

Особенность при размещении действий на схеме: если в списке действий установлен фильтр по типу реализации, для размещённого на схеме действия будет установлена последняя версия той реализации, которая совпадает с выбранной в фильтре.

Выделение

Чтобы выделить действие и посмотреть его свойства, кликните по нему. Вы можете выделить несколько действий:

  • нажмите и удерживайте клавишу Shift, чтобы выделить все действия между первым и последним выбранными действиями (включая выбранные);
  • нажмите и удерживайте клавишу Ctrl, чтобы выделить нескольких отдельных действий;

Если на схеме выделено несколько действий, панель свойств не отображается.

Перемещение

Вы можете переместить выделенные действия:

  1. Захватите любое из выделенных действий нажатием и удержанием ЛКМ.
  2. Переместите действия в требуемое место.

Перемещение осуществляется так же, как размещение действий на схеме.

Панель «Свойства действия»

Вы можете редактировать свойства выбранного действия на панели справа.

Панель разделена на три блока:

  • Информация – базовые свойства действия. Подробнее читайте в разделе «Блок «Информация».
  • Параметры – входные значения, используемые действием. Подробнее читайте в разделе «Блок «Параметры».
  • Результаты – выходные значения, получаемые в результате работы действия. Подробнее читайте в разделе «Блок «Результаты».

Блок «Информация»

В блоке «Информация» вы можете:

  • изменить название действия. К нему добавляется индекс, который делает название уникальным;
  • выбрать версию действия из выпадающего списка. Выбрать устаревшую версию нельзя. Учтите, что смена версии может привести к потере установленных в свойствах действия значений;
  • вы можете установить выбранную версию для всех таких же действий на схеме робота, нажав кнопку справа от поля выбора версии;
  • установить время задержки старта – время ожидания перед выполнением действия;
  • выбрать уровень логирования действия. Подробнее читайте на странице «ROBIN Studio Web. Отладка робота»;
  • изменить описание действия.

Блок «Параметры» 

Параметр представлен в виде поля ввода с заголовком – названием параметра.

Вы можете указать значение в поле ввода или заполнить его в форме редактирования, нажав кнопку «Заполнить значение».

Чтобы выбрать уже имеющееся значение, нажмите кнопку «Выбрать значение» в параметре действия. В открывшемся блоке выберите результат действия или ресурс.

Учтите, что:

  • в списке выбора значения параметра:
    • отображаются только объекты, подходящие по типу;
    • результаты действий, расположенных после текущего, в списке не отображаются;
  • каждое действие имеет уникальный набор параметров. Подробное описание действий читайте на странице «ROBIN Studio. Описание действий».

Блок «Результаты» 

В блоке «Результаты» вы можете управлять выходными значениями действия.

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

Контекстное меню действия

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

Включение и выключение действия

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

Действия, вложенные внутрь отключённого действия, не выполняются.

Чтобы включить действие, вы можете кликнуть на переключатель в верхней части действия либо выбрать опцию «включить действие» в контекстном меню.

Установка точки останова

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

Чтобы удалить точку останова, в контекстном меню действия с точкой выберите опцию «удалить точку останова».

Учтите, что точка останова – инструмент отладки, который доступен только в редакторе робота и не влияет на работу опубликованного робота.

Копирование, вырезание, вставка действий

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

  • Чтобы скопировать действие, выберите опцию «копировать» в контекстном меню или нажмите Ctrl+C (⌘+С – для macOS);
  • Чтобы вырезать действие, выберите опцию «вырезать» в контекстном меню или нажмите Ctrl+X (⌘+Х – для macOS).

Чтобы вставить скопированные или вырезанные действия, выберите опцию «вставить» в контекстном меню или нажмите Ctrl+V (⌘+V – для macOS):

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

Учтите следующее:

  • Операции копирования и вырезания могут применяться к нескольким выделенным действиям. Подробнее читайте в разделе «Управление действиями на схеме».
  • Функция вставки скопированных или вырезанных действий не выполняется, если копируемые или вырезаемые действия были удалены.
  • Вырезанные действия не удаляются со схемы робота до того момента, как будет произведена вставка.

Удаление действий

Вы можете удалить действия со схемы робота, выбрав опцию «удалить» в контекстном меню или нажав Del на клавиатуре. Параметры действий, которые ссылались на результаты удалённых, будут очищены. 

Действия, вложенные внутрь удаленного действия, также удаляются.

Дальнейшие шаги

Если вы не знакомы с ресурсами и способами их применения:

После настройки сценария изучите возможности отладки робота – это поможет убедиться в его работоспособности до публикации:

После того как вы завершили создание робота, для использования его требуется опубликовать:

<script>
  AJS.toInit(function() {
    var toc        = document.querySelector('.toc-float');
    var aside      = toc.closest('.cell.aside');
    var mainHeader = document.getElementById('main-header');
    var auiHeader  = document.querySelector('nav.aui-header');
    var marginTop  = 10; // дополнительный отступ сверху

    // Вставка заголовка, если ещё не вставлен
    function insertHeader() {
      if (!toc.querySelector('.toc-header')) {
        var header = document.createElement('div');
        header.textContent = 'На этой странице:';
        header.className = 'toc-header';
        header.style.fontWeight = 'bold';
        header.style.marginBottom = '10px';
        toc.insertBefore(header, toc.firstChild);
      }
    }

    // Применение inline-стилей
    function applyStyles() {
      insertHeader();

      // Получаем ширину родителя
      var asideRect = aside.getBoundingClientRect();

      // Вычисляем вертикальный отступ
      var offset = 0;
      if (mainHeader) {
        var mhRect = mainHeader.getBoundingClientRect();
        if (mhRect.bottom > 0 && mhRect.top < window.innerHeight) {
          offset = mhRect.bottom;
        }
      }
      if (offset === 0 && auiHeader) {
        var ahRect = auiHeader.getBoundingClientRect();
        offset = ahRect.bottom;
      }
      var topOffset = Math.max(offset + marginTop, asideRect.top);

      Object.assign(toc.style, {
        position:     'fixed',
        top:          topOffset + 'px',
        left:         asideRect.left + 'px',
        width:        asideRect.width + 'px',
        maxHeight:    (window.innerHeight - topOffset - 20) + 'px',
        overflowY:    'auto',
        boxSizing:    'border-box',
        border:       '1px solid #ddd',
        borderRadius: '4px',
        padding:      '15px',
        zIndex:       'auto'
      });
    }

    // Инициалный вызов
    applyStyles();

    // Обновление при скролле, ресайзе окна
    window.addEventListener('scroll', applyStyles);
    window.addEventListener('resize', applyStyles);

    // Наблюдатель за изменением размеров родителя
    if (window.ResizeObserver) {
      new ResizeObserver(applyStyles).observe(aside);
    }
  });
</script>