Работа с таблицами из приложения

Как изменять таблицы в редакторе приложений

Вот как читать и записывать в таблицы из приложений для фронтальных операций.

В этом руководстве вы узнаете...

• Как читать существующие записи таблицы в приложении
• Как обновлять существующие записи таблицы в приложении
• Как создавать новые записи в таблице в приложении
• Как анализировать данные в таблицах на основе завершений приложения

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

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

При создании приложений вам может понадобиться решить, где хранить определенный фрагмент данных - в переменной или в записи таблицы.

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

Таблицы часто используются для отслеживания таких понятий, как:

• рабочие заказы
• отдельные SKU продукта
• спецификация материалов (BOM)
• матрица навыков
• ...и многое другое

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

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

Для чтения или обновления любой записи таблицы необходимо выполнить три шага:

1- Создайте "Держатель записи", чтобы дать имя этой конкретной записи таблицы в приложении.

2- Загрузите (или создайте) запись в триггерном действии.

3a- Если вы хотите написать логику вокруг значений в записи таблицы, то включите запись таблицы в оператор "If".

3b- Если вы хотите обновить отдельные поля в записи, включите запись таблицы в оператор "Then".

Создание держателя записи

Во-первых, вам нужно создать "Record Placeholder" в приложении, в котором вы будете обращаться к записи таблицы. Это держатели для записей, которые позже будут динамически загружаться в логику триггера.

Например, если вы хотите отредактировать запись из таблицы "Work Orders" в приложении, у вас может быть Record Placeholder под названием "Active Work Order". Позже вы загрузите запись динамически на основе ввода оператора, но она всегда будет упоминаться как "Активный заказ на работу".

Чтобы установить эти держатели, нажмите на вкладку "Записи" рядом со списком "Шаги".

[

Затем выберите "Добавить таблицу". Затем нажмите кнопку "Добавить местоположение записи". Вы сможете дать имя записи, которая будет загружаться динамически из триггера (т.е. "Active Work Order").

{height="" width=""}.

Обратите внимание на параметр "Сохранить для анализа". При выборе этого параметра запись таблицы, загруженная в этот Record Placeholder, будет сохранена в записи завершения приложения. В данных завершения вы увидите ссылку на запись.

Удаление держателей записей

Чтобы удалить держатель записи, выберите его в списке записей в левой части экрана. В примере ниже вы выбрали "Имя тестовой записи".

Затем выберите "Удалить" из следующего меню.

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

Доступ к записям в редакторе триггеров

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

Для этого можно использовать триггерные действия "Записи таблицы" и "Манипуляция данными". Вот как это сделать.

Затем утверждения

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

Записи таблицы/Загрузка записи: Загрузка записи с определенным идентификатором

Записи таблицы/Создать запись: Создать новую запись с определенным идентификатором

Table Records/ Create or Load Record: ЕСЛИ запись с определенным ID не существует, создайте ее. В противном случае загрузите запись с определенным идентификатором.

Загрузка существующих записей

Для того чтобы прочитать или отредактировать запись, необходимо сначала загрузить ее в приложение и дать ей имя-заполнитель. Часто это вызывается открытием шага или нажатием кнопки.

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

Для этого используйте оператор "Записи таблицы" "Загрузить запись".

{height="" width=""}
* "Загрузить запись"
* По ID: "text" - 0146
* В заполнитель "active_wo".

В этом примере запись с ID "0146" уже существует в таблице рабочих заказов.

Поскольку поле "ID" в каждой таблице является текстовым полем, для доступа к отдельным записям необходимо использовать текст. Вы можете использовать все типичные опции для выбора идентификатора:

• Запись таблицы
• Выражение
• Статическое значение
• Информация приложения
• Переменная

Вот пример, в котором используется переменная:

• "Table Records" "Load Record" by ID: "Variable" "text_wo_id" into: "Active Work Order"

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

Создание новых записей

Если вы хотите создать новую запись в таблице, вы должны использовать опцию "Создать" или "Создать или загрузить".

Если вы используете опцию "Создать", вы должны создать новую запись с идентификатором, который еще не существует в таблице. Если запись уже существует в таблице, приложение выдаст ошибку.

Если вы используете "Создать или загрузить", запись с определенным ID будет загружена, если она уже существует, или создана, если ID не существует в таблице.

В данном случае мы используем идентификатор "newID" для создания новой записи.

• "Записи таблицы" "Создать запись"
• по ID: "Static Value" "text" "newID"
• в: "active_wo"

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

Редактирование записей в редакторе триггеров

Для редактирования записи используется действие "Манипуляция данными", затем "Сохранить" для редактирования или обновления значения в записи.

Для того чтобы отредактировать запись, она должна быть загружена как заполнитель записи через "Table Records" "Load" или "Table Records" "Create".

Вот пример, в котором вы обновите поле "статус" записи, загруженной как "active_wo".

• "Манипуляция данными"
• "Хранить".
• "Текст": "Пройдено"
• "Запись таблицы" "active_wo"
• Поле: "статус"

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

Вы также можете увеличить значение из записи таблицы. О том, как это сделать, читайте в этом руководстве по таблицам инвентаризации

Использование условной логики с записями таблицы

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

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

Запись таблицы: Проверьте наличие определенного значения в поле загруженной записи таблицы.

• "Запись таблицы" "TestImg" "ID" "Contains" ...
• Таблица:* Проверьте, существует ли уже запись с определенным ID в таблице.

• "Table" "workorders" "has record with id" "Static Value" "text" "001"

Вот пример. В этом случае мы проверим, содержит ли поле "статус" какой-либо другой текст.

{ "height="" width=""}
* "Запись таблицы" "active_wo" "status"
* "Содержит"
* "Статическое значение" "text" "Пройдено"

Вы также можете использовать оператор "If", чтобы проверить, существует ли уже запись с заданным ID, а затем, например, выбросить определенное сообщение об ошибке.

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

ЕСЛИ

• "Таблица" "workorders" "имеет запись с id"
• "Static Value" "text" "024dfg45"

ТО

• "Show Error" "Static Value" "text" "Этот заказ уже существует, пожалуйста, введите новый".

Отображение записей таблицы на шагах

Чтобы добавить эту запись на шаг, выберите опцию "Запись таблицы" под кнопкой "Текст" в меню виджета.

[

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

[

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

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

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

Чтобы изменить количество столбцов, воспользуйтесь опцией "Столбцы" в контекстной панели.

Чтобы изменить отображение меток и значений, настройте цвет и размер шрифта в контекстной панели.

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

Очистка держателей записей

Иногда вы можете захотеть очистить держатель записи, чтобы в приложение не загружалась конкретная запись под этим держателем.

Вот как это сделать:

• "Записи таблицы" "Очистить держатель записи".

Отображение пользователей и их полей

Вы также можете создать Record Placeholder для пользователей и связанных с ними полей, а затем загрузить конкретного пользователя с помощью встроенной таблицы. Для получения более подробной информации см. отдельное руководство по полям пользователей.

Дальнейшее чтение

• Создайте свою первую таблицу (подробное описание)
• Как анализировать данные в записях таблицы
• Отображение списков записей в приложениях

Вы нашли то, что искали?

Вы также можете зайти на community.tulip.co, чтобы задать свой вопрос или узнать, сталкивались ли другие с подобным вопросом!