--- title: "Формат вывода данных HTTP-коннектора" slug: "how-to-format-http-connector-outputs-1" updated: 2026-10-22T10:24:26Z published: 2026-10-22T10:24:26Z canonical: "support.tulip.co/how-to-format-http-connector-outputs-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Формат вывода данных HTTP-коннектора *Узнайте, как структурировать выходные данные HTTP-коннектора.* ## Обзор Редактор функций коннекторов в Tulip позволяет структурировать данные, возвращаемые вашими функциями коннекторов, так, чтобы они были полезны и применимы в ваших приложениях. В этой статье мы рассмотрим основы форматирования выходов функций коннекторов Output, познакомив вас со следующим: - Понятие вывода коннектора - Инструментам, доступным для форматирования вывода - Различные распространенные форматы вывода ## Что такое выводы? Выводы используются для определения и структурирования результатов, возвращаемых функцией коннектора. С их помощью вы извлекаете из большого тела HTTP-ответа информацию, важную для ваших приложений. ![Testing Outputs.gif](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Testing%20Outputs.gif) ## Как структурировать выходы Найдите раздел **«Выходы** » в левом нижнем углу редактора функций коннектора. ![Outputs3.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Outputs3.png) Чтобы начать добавление выходов, нажмите **«Добавить выходы функции**». Рекомендуется присваивать выходам понятные имена. Эти имена отображаются в приложениях как «Переменные», поэтому важно, чтобы их можно было различать. ![Screenshot 2023-03-23 at 9.57.16 AM.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Screenshot%202023-03-23%20at%209.57.16%20AM%282%29.png) Чтобы понять результаты HTTP-запроса, важно сначала разобраться в структуре объекта, возвращаемого в **«Результатах теста**». На приведенной ниже схеме показано, как результаты разбиты на разделы «Объекты» и «Массивы». ![Object Anatomy Diagram.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Object%20Anatomy%20Diagram.png) NOTE If you haven’t worked with JSON before, you may be unfamiliar with two critical datatypes, objects and arrays. Arrays are lists of values of the same type. For example, [1,2,3,5], or [oak, elm, alder, hickory]. Values in arrays are contained within square brackets, [ ]. Objects are a datatype for holding key:value pairs. The key:value pairs within an object can be of multiple different types, including arrays and nested objects. Objects are contained with curly brackets, { }. Для получения дополнительной информации об объектах и массивах ознакомьтесь со статьёй [«Понимание массивов и объектов в выходных данных функций Connector](/r230/docs/understanding-arrays-and-objects-in-connector-function-outputs)». ### Точечная нотация В HTTP-коннекторах в выводах используется формат, называемый . Точечная нотация позволяет получать доступ к значениям внутри объекта. Точечная нотация полезна для извлечения только необходимой информации из большого тела ответа JSON и обеспечивает большую гибкость при форматировании функций HTTP-коннекторов. Проще говоря: это структурированный формат, основанный на значениях, вложенных друг в друга. Давайте разберем на примере, как точечная нотация используется в выводах коннекторов. Следующий пример объекта, названного «employees», содержит массив объектов с подробными сведениями о каждом сотруднике. Если нам нужен только титул каждого сотрудника, мы используем следующий синтаксис: employees.title. Мы используем точку для доступа к значениям, связанным с интересующими нас ключами. Предположим, что нам нужен только первый элемент. Для этого нужно указать индекс, вставив его между именем главного объекта «employees» и интересующим нас значением «title». Синтаксис будет выглядеть так: employees.0.title. В случае более сложных объектов может потребоваться проникнуть глубже в объект, чтобы извлечь нужную информацию. ![Outputs Ex2.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Outputs%20Ex2.png) Рассмотрим ещё один пример, чтобы углубить понимание. Допустим, в данном случае нас интересует создание функции-коннектора для извлечения информации, связанной со статьями в базе знаний. Наш коннектор возвращает следующий JSON-объект с именем «data», содержащий данные о конкретной статье: ![Test Results Article Ex.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Test%20Results%20Article%20Ex.png) Если бы нам нужно было извлечь, например, только ID, заголовок, версию и информацию о том, скрыта ли статья, нам пришлось бы указать это с помощью выходов. Давайте посмотрим, как выглядит точечная нотация в разделе выходов редактора: ![Outputs to Test Results Annotated.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Outputs%20to%20Test%20Results%20Annotated.png) Чтобы извлечь такие результаты, как «id» и «title», нам нужно указать, где именно в JSON находятся эти результаты. Тело вывода — это «data», что соответствует первому раскрывающемуся списку в разделе **«Результаты теста** ». Каждый результат в раскрывающемся списке «data» вложен в этот объект. В разделе **«Выводы** » точка означает переход на один уровень глубже в объект «data». NOTE It doesn’t matter whether the dot is placed in the body, or in front of individual properties, so long as there is a dot separating each layer of the JSON. ![Outputs to Test Results2.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Outputs%20to%20Test%20Results2.png) Когда мы нажимаем вкладку **«Выводы»** в разделе **«Результаты тестирования»**, выводы фильтруют остальные данные, и мы видим только ту информацию, которая нас интересует. Ещё один способ написания выводов — в одной строке. Это позволяет отобразить полный путь в одном запросе. ![Outputs Single Line.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Outputs%20Single%20Line.png) Чтобы упростить написание пути вывода, можно также щелкнуть строку данных, чтобы добавить её в качестве нового вывода. ![Create Output Path.gif](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Create%20Output%20Path.gif) Для получения дополнительной информации об использовании точечной нотации см. этот ресурс: [Processmaker: JSON Dot Notation](https://docs.processmaker.com/docs/json#json-dot-notation). ### Результаты вывода Существует множество способов структурирования выводов, но выбор конкретного способа полностью зависит от того, что вы хотите делать с данными в своих приложениях. Прежде чем приступить к структурированию выводов, подумайте о своей конечной цели. Хотите ли вы отобразить несколько типов данных в отдельных переменных? Или у вас одни и те же типы данных в одном массиве, который вы просто хотите проанализировать для извлечения нужной информации? Все приведенные ниже примеры основаны на одной и той же функции коннектора, и в каждом случае основная часть результатов теста одинакова. Однако выводные данные различаются в зависимости от того, как они структурированы. В следующем примере показано, как коннектор выводит данные по пути JSON data.hits.slug. Благодаря такой структуре вывода коннектор возвращает большой массив всех URL-слагов статей базы знаний. В наших приложениях к этому возвращаемому значению коннектора можно будет получить доступ через переменную типа массива. ![Output 3x540 v2.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Output%203x540%20v2.png) Мы можем структурировать выходные данные в виде списка объектов и извлекать отдельные типы данных из результатов, создавая несколько объектов данных, которые можно отображать по отдельности в приложениях. ![Output 540x3.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Output%20540x3.png) Списки объектов — это объекты, содержащие в себе несколько вложенных типов данных. Чтобы использовать списки объектов, щелкните тип вывода и переключите переключатель «Список» в правом углу. ![Outputs Lists Toggle.gif](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Outputs%20Lists%20Toggle%281%29.gif) Имея список объектов, вы можете легко использовать различные типы данных в качестве отдельных элементов данных в своих приложениях. Вернёмся к приведённому выше примеру: давайте преобразуем путь вывода **data.hits.slug** в список. Как видно из приведённых ниже результатов, Tulip структурирует возвращаемые данные этого коннектора в виде массива слэгов, причём каждый индекс указан рядом с соответствующим значением. ![Test Results as Slugs.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Test%20Results%20as%20Slugs.png) Имея в виду это понимание выходных данных, теперь вы можете сопоставить выходные данные с вашими собственными функциями коннекторов и оптимизировать результаты, возвращаемые вашими коннекторами! ## Используйте Tulip AI для извлечения выходных данных Быстро структурируйте свои выходные данные, используя примеры и концепции, уже рассмотренные в статье, такие как ( и Список объектов). Tulip AI предоставляет мощный инструмент для автоматического анализа JSON-ответа в ваших результатах тестирования и генерации соответствующих путей в точечной нотации. Он пытается воспроизвести вложенную структуру объектов, но при необходимости упрощает сложные массивы или объекты. Tulip AI не изменяет ваши существующие выводы и извлечения. Он лишь генерирует новые или не указанные ранее выводы, чтобы ускорить процесс первоначальной настройки вывода. После того как Tulip AI сгенерирует выводы, вам необходимо проверить их на соответствие целям вашего приложения. При проверке следуйте этим рекомендациям:* Удалите все ненужные выводы* Переименуйте переменные для большей ясности* Вручную скорректируйте структуру вывода (например, убедитесь, что массивы правильно заданы как списки объектов) Эти шаги гарантируют, что вы извлекаете только те данные, которые необходимы для вашего приложения. ![Image](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Copilot%20for%20connector%20output.gif) ## Дополнительная информация - [Использование HTTP-коннекторов в приложениях](/r230/docs/using-http-connectors-in-apps) - [Отображение интерактивных списков записей таблиц или результатов работы коннекторов в приложениях](/r230/docs/displaying-interactive-lists-of-table-records-or-connector-output-in-apps) {{snippet.Нашли ли вы то, что искали?}} **Output** An **output** is the transmission of data from a program to a data set. **JSON** **JSON (JavaScript Object Notation)** is a light-weight, text-based data format that is used to store and transfer data.