Перейти к основному содержимому

RSS/Atom

Модуль 1С/OSOPI_RSSКоманда CLIrss#Использоватьoint/api/rss

Этот раздел посвящен библиотеке для работы с RSS и Atom форматами в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы

Начало работы​

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

Библиотека не требует авторизации или дополнительных настроек - все методы работают автономно и могут использоваться сразу после подключения.

Работа с RSS​

RSS (Really Simple Syndication) — это формат для распространения новостей и другого контента веб-сайтов.

Создание RSS фида​

Для создания RSS фида используйте функцию СоздатьФидRSS:

НазваниеКанала = "Мой блог";
ОписаниеКанала = "Последние новости и статьи";
СсылкаКанала   = "https://example.com";

Элементы = Новый Массив;

Элемент = OPI_RSS.ПолучитьСтруктуруЭлементаФидаRSS(Истина);

Элемент.title       = "Первая статья";
Элемент.description = "Описание первой статьи";
Элемент.link        = "https://example.com/article1";
Элемент.pubDate     = ТекущаяДата();
Элемент.author      = "author@example.com";
Элемент.guid        = "article1";

Элементы.Добавить(Элемент);

ФидRSS = OPI_RSS.СоздатьФидRSS(НазваниеКанала, ОписаниеКанала, СсылкаКанала, Элементы);

Структура элемента RSS​

Функция ПолучитьСтруктуруЭлементаФидаRSS возвращает структуру со следующими полями:

  • title — заголовок элемента
  • description — описание/содержимое элемента
  • link — URL элемента
  • pubDate — дата публикации
  • author — email автора
  • guid — уникальный идентификатор элемента

Разбор RSS фида​

Для разбора существующего RSS фида используйте функцию РазобратьФидRSS:

XMLТекст = "<?xml version=""1.0""?>..."; // XML содержимое фида
Канал    = OPI_RSS.РазобратьФидRSS(XMLТекст);

Работа с Atom​

Atom — это альтернативный формат синдикации контента, более современный и гибкий чем RSS.

Создание Atom фида​

Для создания Atom фида используйте функцию СоздатьФидAtom:

НазваниеФида = "Мой блог";
СсылкаФида   = "https://example.com";
IDФида       = "https://example.com/feed";

Элементы = Новый Массив;

Элемент = OPI_RSS.ПолучитьСтруктуруЭлементаФидаAtom(Истина);

Элемент.title     = "Первая статья";
Элемент.id        = "article1";
Элемент.link      = "https://example.com/article1";
Элемент.updated   = ТекущаяДата();
Элемент.summary   = "Краткое описание";
Элемент.content   = "Полное содержимое статьи";
Элемент.author    = "Иван Иванов";
Элемент.published = ТекущаяДата();

Элементы.Добавить(Элемент);

ФидAtom = OPI_RSS.СоздатьФидAtom(НазваниеФида, СсылкаФида, IDФида, Элементы);

Структура элемента Atom​

Функция ПолучитьСтруктуруЭлементаФидаAtom возвращает структуру со следующими полями:

  • title — заголовок элемента
  • id — уникальный идентификатор элемента
  • link — URL элемента
  • updated — дата обновления
  • summary — краткое описание
  • content — полное содержимое
  • author — имя автора
  • published — дата публикации

Разбор Atom фида​

Для разбора существующего Atom фида используйте функцию РазобратьФидAtom:

XMLТекст = "<?xml version=""1.0""?>..."; // XML содержимое фида
Фид      = OPI_RSS.РазобратьФидAtom(XMLТекст);

Особенности использования​

  • При создании фидов даты автоматически преобразуются в соответствующие форматы (RFC822 для RSS, ISO8601 для Atom)
  • Если дата обновления не указана, используется текущая дата
  • Разбор фидов возвращает структуры с данными канала/фида и массивом элементов