Обзор

Пользовательские поля позволяют вам расширить стандартную структуру записей Blue дополнительными полями данных, специфичными для ваших бизнес-потребностей. Они предоставляют мощный способ захвата структурированных данных, выходящих за рамки встроенных полей, таких как заголовок, описание и срок выполнения.

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

Доступные операции

Управление основными полями

Значения полей

Типы пользовательских полей

Текстовые поля

Поля выбора

Числовые поля

Поля контактов

Поля даты и времени

Местоположение и география

Файлы и медиа

Системные поля

Интерактивные поля

Ключевые концепции

Определение поля

• Пользовательские поля определяются на уровне проекта
• Каждое поле имеет уникальное имя и тип
• Поля могут включать правила и ограничения валидации
• Опции конфигурации варьируются в зависимости от типа поля

Значения полей

• Значения хранятся в отдельных записях (делах)
• Каждая запись может иметь разные значения для одного и того же поля
• Пустые/нулевые значения допускаются для необязательных полей
• Значения проверяются в соответствии с правилами типа поля

Модель разрешений

Пользовательские поля учитывают разрешения на уровне проекта:

*Редактирование полей относится к изменению настроек поля (имя, тип, опции, правила валидации) - не к установке значений полей в записях

Разрешения для пользовательских ролей

• Проекты могут иметь пользовательские роли с разрешениями, специфичными для полей
• Поля могут быть помечены как редактируемые/не редактируемые для каждой роли
• Пользовательские роли могут ограничивать доступ к конкретным полям

Общие шаблоны

Создание базового пользовательского поля

mutation CreateCustomField {
  createCustomField(input: {
    name: "Priority Level"
    type: SELECT_SINGLE
    description: "Task priority level"
    customFieldOptions: [
      { title: "Low", color: "#28a745" }
      { title: "Medium", color: "#ffc107" }
      { title: "High", color: "#fd7e14" }
      { title: "Critical", color: "#dc3545" }
    ]
  }) {
    id
    name
    type
    customFieldOptions {
      id
      title
      color
    }
  }
}

Установка значений полей в записях

mutation SetFieldValue {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    customFieldOptionId: "option_789"  # For SELECT_SINGLE
  })
}

Запрос записей с пользовательскими полями

query GetTodosWithCustomFields {
  todos(projectId: "project_123") {
    id
    title
    customFields {
      id
      customField {
        name
        type
      }
      # Type-specific value fields
      text           # TEXT_SINGLE, TEXT_MULTI, EMAIL, etc.
      number         # NUMBER, CURRENCY, PERCENT, RATING
      selectedOption # SELECT_SINGLE
      selectedOptions # SELECT_MULTI
      checked        # CHECKBOX
      date           # DATE
    }
  }
}

Создание записей с значениями пользовательских полей

mutation CreateTodoWithCustomFields {
  createTodo(input: {
    title: "New task"
    todoListId: "list_123"
    customFields: [
      { customFieldId: "priority_field", value: "high_priority_option" }
      { customFieldId: "budget_field", value: "5000" }
      { customFieldId: "notes_field", value: "Additional context here" }
    ]
  }) {
    id
    title
    customFields {
      customField { name }
      value
    }
  }
}

Лучшие практики

Дизайн полей

1. Используйте описательные названия - Сделайте цели полей ясными
2. Выбирайте подходящие типы - Соответствуйте тип поля требованиям к данным
3. Устанавливайте правила валидации - Используйте минимальные/максимальные значения, обязательные поля
4. Организуйте логически - Группируйте связанные поля вместе

Учет производительности

1. Ограничьте количество полей - Слишком много полей может повлиять на производительность
2. Используйте пагинацию - При запросе больших наборов данных
3. Индексируйте ключевые поля - Для полей, используемых в фильтрации/сортировке
4. Избегайте глубокого вложения - Держите отношения между полями простыми

Качество данных

1. Проверяйте ввод - Используйте подходящие типы полей с валидацией
2. Предоставляйте значения по умолчанию - Устанавливайте разумные значения по умолчанию, где это уместно
3. Используйте единообразные форматы - Стандартизируйте шаблоны ввода данных
4. Регулярная очистка - Удаляйте неиспользуемые поля и опции

Пользовательский опыт

1. Ясные описания - Предоставляйте полезные описания полей
2. Логичный порядок - Расположите поля в естественном порядке рабочего процесса
3. Визуальная иерархия - Эффективно используйте цвета и форматирование
4. Постепенное раскрытие - Показывайте поля, когда это актуально

Обработка ошибок

Распространенные ошибки при работе с пользовательскими полями:

Связанные ресурсы

• API записей - Работа с записями, содержащими пользовательские поля
• API проектов - Управление проектами, содержащими пользовательские поля
• API автоматизации - Автоматизация рабочих процессов с триггерами пользовательских полей
• API управления пользователями - Управление разрешениями на пользовательские поля