Skip to main content

Вкладка YAML в настройках ноды

Вкладка YAML объединяет все данные из других вкладок (Design, Script, Environment, Catalog) в единое представление, которое определяет всё о вашей ноде - от технических метаданных до её позиции в рабочем пространстве пайплайна.

Интерфейс вкладки YAML

Что такое YAML представление?​

Вкладка YAML служит "исходным кодом" вашей ноды. Она объединяет:

  • Определения входных и выходных данных из вкладки Design
  • JavaScript код из вкладки Script
  • Технические метаданные из вкладки Catalog
  • Переменные окружения из вкладки Environment
  • Позиционирование ноды и связи внутри пайплайна

Это полное представление позволяет точно дублировать ноды, копируя их YAML конфигурацию в другие пайплайны.

Структура YAML​

YAML конфигурация организована в логические секции:

Техническая информация​

_id: merge_text_to_json
version: 1
category:
  _id: processing
  title: en=Processing;ru=Обработка
package: custom
title: en=Merge text to JSON;ru=Объединение текста в JSON
source: node
execution: regular

Эти поля определяют идентификатор ноды, версию, классификацию по категориям и привязку к пакету.

Скрипт выполнения​

script: |-
  export async function run({ inputs }) {
      const { NextNode } = DEFINITIONS;

      const jsonArray = [];

      if (inputs.string1) {
          jsonArray.push(inputs.string1);
      }
      if (inputs.string2) {
          jsonArray.push(inputs.string2);
      }
      if (inputs.string3) {
          jsonArray.push(inputs.string3);
      }
      if (inputs.string4) {
          jsonArray.push(inputs.string4);
      }

      return NextNode.from({
          outputs: {
              json_output: jsonArray
          }
      });
  }

Содержит полный кастомный JavaScript код, который мы написали во вкладке Script.

Позиционирование ноды​

arrange:
  x: 170
  y: 290

Определяет точное положение ноды в рабочем пространстве пайплайна.

Определения входных/выходных данных​

inputs:
  string1:
    title: en=String 1;ru=Строка 1
    type: string
    required: false
  string2:
    title: en=String 2;ru=Строка 2
    type: string
    required: false
  string3:
    title: en=String 3;ru=Строка 3
    type: string
    required: false
  string4:
    title: en=String 4;ru=Строка 4
    type: string
    required: false

outputs:
  json_output:
    title: en=JSON;ru=JSON
    type: json

Полные спецификации для всех 4 входных параметров и 1 выходного параметра, которые мы настроили во вкладке Design.

Информация каталога (опционально)​

catalog:
  _id: merge_text_to_json
  version: 1
  category:
    _id: service_nodes
    title: Service Nodes
  package: service_nodes

Метаданные для публикации и организации вашей кастомной ноды в каталоге.

Переменные окружения (опционально)​

environment:
  OPEN_PAAS_USER:
    title: PaaS user
    type: string
    scope: global

Все переменные окружения и API ключи, необходимые для подключения ноды к внешним провайдерам.

Копирование и повторное использование нод​

Самая мощная функция вкладки YAML - возможность создания точных дубликатов ноды:

  1. Скопируйте YAML - Выделите весь код во вкладке YAML и скопируйте его
  2. Создайте новую ноду - Добавьте новую ноду в любой пайплайн
  3. Вставьте конфигурацию - Замените YAML новой ноды на скопированный код
  4. Сохраните изменения - Нода будет воссоздана с идентичной функциональностью

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

Только для чтения​

Вкладка YAML в основном предназначена для просмотра и копирования. Хотя вы можете видеть полную конфигурацию ноды здесь, изменения следует вносить через соответствующие вкладки (Script для изменений кода, Design для модификации входных/выходных данных и т.д.), чтобы обеспечить правильную валидацию и форматирование.