XML-формат файла Sitemap - XML

В этом документе приведено описание XML-схемы протокола Sitemap.

Формат протокола Sitemap состоит из XML-тегов. Для всех значений данных в файле Sitemap должно использоваться маскирование. В файле необходимо использовать кодировку UTF-8.

• В начале поставьте открывающий тег <urlset>. а в конце поставьте закрывающий тег </urlset> .
• Укажите область имен (стандарт протокола) в теге <urlset> .
• Включите запись <url> для каждого URL-адреса как родительский тег XML.
• Включите дочернюю запись <loc> для каждого <url> родительского тега.

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

Ниже приведен пример файла Sitemap, в котором содержится только один URL-адрес и использованы все необязательные теги. Необязательные теги выделены курсивом.

См. также пример с несколькими URL-адресами.

Ниже описаны доступные XML-теги.

Кроме того, для всех URL (включая URL из Вашего файла Sitemap) должны использоваться маскирование и кодировка для удобочитаемости веб-сервером, на котором они размещаются. Однако, если для создания своих URL Вы используете какой-либо вид скрипта, инструментального средства или журнала (любой способ кроме ввода их вручную), то маскировка и кодировка применяются автоматически. Убедитесь в том, что все URL соответствуют стандарту RFC-3986 для URI, стандарту RFC-3987 для IRI и XML-стандарту.

Ниже приведен пример URL-адреса, в котором используется символ, отличный от ASCII ( ü ), а также символ, для которого необходимо маскирование ( & ):

Ниже этот же URL-адрес приведен в кодировке ISO-8859-1 (для размещения на сервере, который использует эту кодировку) с маскированием:

Ниже этот же URL-адрес приведен в кодировке UTF-8 (для размещения на сервере, который использует эту кодировку) и с использованием маскирования:

Ниже приведен тот же URL-адрес, но с использованием маскирования:

В следующем примере показан файл Sitemap в XML-формате. Sitemap в этом примере содержит небольшое число URL-адресов, каждый из которых использует разное сочетание необязательных параметров.

Можно предоставить несколько файлов Sitemap, однако в каждом из этих файлов должно быть не более 50000 URL, а размер каждого из этих файлов не должен превышать 10 МБ. При необходимости файл Sitemap можно сжать с помощью архиватора gzip, чтобы его размер не превышал 10 МБ, и тем самым уменьшить требования к пропускной способности канала. Если необходимо перечислить более 50000 URL, следует создать несколько файлов Sitemap.

Если требуется передать несколько файлов Sitemap, необходимо перечислить каждый из этих файлов в файле индекса Sitemap. В файле индекса Sitemap может быть перечислено не более 1000 файлов Sitemap. Размер этого файла не должен превышать 10 МБ. Формат XML-файла индекса Sitemap очень похож на формат XML-файла Sitemap.

Файл индекса Sitemap должен:

• В начале поставьте открывающий тег <sitemapindex>. а в конце поставьте закрывающий тег </sitemapindex> .
• Добавьте запись <sitemap> для каждого файла Sitemap как родительский XML-тег.
• Включите дочернюю запись <loc> для каждого <sitemap> родительского тега.

Необязательный тег <lastmod> также доступен для файлов индекса Sitemap.

Примечание. Файл индекса Sitemap может указывать только файлы Sitemap, которые находятся на том же сайте, что и файл индекса Sitemap. Например, файл индекса http://www.vashsait.ru/sitemap_index.xml может включать файлы Sitemap, размещенные на сайте http://www.vashsait.ru, но не на сайте http://www.primer.ru или http://vashkhost.vashsait.ru. Для файла индекса Sitemap, как и для файлов Sitemap, необходимо использовать кодировку UTF-8.

Протокол Sitemap дает возможность обеспечить поисковые системы подробной информацией о страницах, и мы рекомендуем его использовать, поскольку при этом можно указать дополнительные сведения о страницах сайта, а не только их URL. Помимо протокола XML мы также поддерживаем каналы RSS и текстовые файлы, которые предоставляют более ограниченную информацию.

Вы можете предоставить канал RSS 2.0, Atom 0.3 или 1.0. Как правило, этот формат используется только в том случае, если на сайте уже есть канал синдикации. Обратите внимание, что в этом случае поисковые системы, возможно, не получат информацию обо всех URL на вашем сайте, поскольку данный канал предоставляет информацию только по последним URL. Однако поисковые системы могут использовать эту информацию, чтобы обнаружить другие страницы сайта, переходя по ссылкам на страницах канала в процессе обычного сканирования. Убедитесь, что канал расположен в каталоге самого высокого уровня, который должен сканироваться поисковой системой. Поисковые системы извлекают информацию из канала следующим образом.

• поле <Ссылка> – указывает URL
• поле даты изменения (поле <Дата публикации> для каналов RSS и дата <изменения> для каналов Atom) – указывает, когда каждый URL был изменен в последний раз. Использовать поле даты изменения необязательно.

Вы можете предоставить простой текстовый файл, содержащий один URL в строке. Этот текстовый файл должен соответствовать следующим требованиям.

• В этом текстовом файле в каждой строке должен быть только один URL. Эти URL не могут содержать новые внедренные строки.
• Необходимо указать URL полностью, включая префикс http.
• Каждый текстовый файл может содержать не более 50000 URL. Если сайт включает более 50000 URL, можно разделить этот список на несколько текстовых файлов и передать каждый файл отдельно.
• Для этого текстового файла необходимо использовать кодировку UTF-8. Ее можно задать при сохранении файла (например, в программе "Блокнот" она указана в меню "Кодировка" диалогового окна "Сохранить как").
• Этот текстовый файл не должен включать никаких других данных, кроме списка URL.
• Этот текстовый файл не должен содержать данных заголовка или нижнего колонтитула.
• Этому текстовому файлу можно присвоить любое имя.
• Загрузите этот текстовый файл в каталог самого высокого уровня, который должен сканироваться поисковой системой, и убедитесь, что в файл не внесены адреса URL, находящиеся в каталоге более высокого уровня.

Ниже приведен пример строк текстового файла.

Протокол Sitemap можно расширить с помощью Вашего собственного пространства имен. Просто укажите это пространство имен в корневом элементе. Например:

После того как файл Sitemap создан и размещен на веб-сервере, необходимо сообщить о местонахождении этого файла поисковым системам, поддерживающим этот протокол. Это можно сделать следующим образом.

• передача файла Sitemap с помощью интерфейса передачи поисковой системы
• как указать местоположение файла Sitemap в файле robots.txt
• отправка HTTP-запроса
  

Затем поисковые системы смогут извлечь файл Sitemap и разрешить своим сканерам доступ к URL-адресам.

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

Можно указать местоположение файла Sitemap, используя файл robots.txt. Для этого просто добавьте следующую строку:

URL <sitemap_location> должен быть полным URL для файла Sitemap, например: http://www.primer.ru/sitemap.xml

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

Чтобы отправить файл Sitemap с помощью HTTP-запроса (замените <searchengine_URL>на URL, указанный поисковой системой), создайте запрос для следующего URL-адреса.

Например, если файл Sitemap находится в архивном файле http://www.primer.ru/sitemap.gz, URL-адрес будет следующим:

Добавьте кодировку URL для всех символов после /ping?sitemap=:

Можно отправить http-запрос, используя "wget", "curl" или другой механизм по выбору. Успешный запрос возвратит код отклика HTTP 200; если получен другой отклик, необходимо повторно передать запрос. Код отклика HTTP 200 указывает только на то, что поисковая система получила Ваш файл Sitemap, но это не значит, что сам файл Sitemap или содержащиеся в нем URL допустимы. Самый простой способ — создать автоматическое задание для регулярного создания и передачи файлов Sitemap.
Примечание. Предоставляя файл индекса Sitemap, необходимо инициировать только один http-запрос, который включает местоположение файла индекса Sitemap; отправлять отдельные запросы для каждого файла Sitemap, указанного в этом индексе, не нужно.

Протокол Sitemaps предоставляет поисковым системам информацию о содержании, которое необходимо включить в индекс. Чтобы сообщить поисковым системам о содержании, которое не следует включать в индекс, используйте файл robots.txt или метатег robots. Более подробную информацию о том, как исключить содержание из поисковых систем, см. на странице robotstxt.org.

Примеры работы с XML-файлами

Рассмотрим несколько простых примеров по работе с XML-файлами с использованием сборки XML языка Fore .

Для загрузки XML-файла необходимо:

Инициализировать объект одного из доступных классов: DOMDocument. DOMDocument40. DOMDocument60. FreeThreadedDOMDocument. FreeThreadedDOMDocument60. Первые три класса позволяют работать с различными версиями MSXML (3.0, 4.0, и 6.0 соответственно). Последние два класса используются, если осуществляется разработка приложения, в котором предусмотрен многопоточный доступ к одним и тем же данным.

Полученный объект может быть приведен к одному из следующих интерфейсов: IXmlDomDocument. IXmlDomDocument2. IXmlDomDocument3. IXmlDomDocument - содержит базовые свойства и методы для работы с XML-структурами; IXmlDomDocument2 - расширение интерфейса IXmlDomDocument. которое поддерживает схемы кэширования и функции проверки, включая поддержку XPath-выражений; IXmlDomDocument3 - продолжение IXmlDomDocument2 с двумя новыми методами importNode и validateNode .

Используя метод load или loadXML интерфейса IXmlDomDocument (описание методов представлено в MSDN), можно загрузить XML-документ, с которым в дальнейшем будет осуществляться работа.

Примечание. Начиная с Prognoz Platform версии 8.0 работа с XML-файлами осуществляется только через службы MSXML версии 6.0.

Sub  Sample1;
Var
    XMLDoc: IXMLDOMDocument;
    XMLName: String =  "c:\Data.xml" ;
    Loaded: Boolean;
Begin
    XMLDoc :=  New  DOMDocument.Create;
    Loaded := XMLDoc.load(XMLName);
     If  Loaded  Then
         //Дальнейшая работа с загруженным документом
         //.
        XMLDoc.save(XMLName);
     End   If ;
End   Sub  Sample1;

Sub  Sample2(strXML: String);
Var
    XMLDoc: IXMLDOMDocument3;
    Loaded: Boolean;
Begin
    XMLDoc :=  New  DOMDocument60.Create;
    Loaded := XMLDoc.loadXML(strXML);
     If  Loaded  Then
         //Дальнейшая работа с загруженным документом
     End   If ;
End   Sub  Sample2;

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

Sub  Sample3;
Var
    XMLDoc: IXMLDOMDocument;
    Loaded: Boolean;
    Nodes: IXmlDomNodeList;
    Node, NewNode: IXmlDomNode;
    NewAttr: IXmlDomAttribute;
Begin
     //Загрузка документа
     //.
     If  Loaded  Then
         //Корневая вершина
        Node := XMLDOc.documentElement;
         //Получение вершин, дочерних для корневой вершины
        Nodes := Node.childNodes;
         //Получение необходимых вершин в соответствии с XPath-запросом
        Nodes := XMLDOc.selectNodes( "<XPath-запрос для отбора вершин>" );
         //Новая вершина
        NewNode := XMLDOc.createNode( "element" ,  "Comments" ,  "" );
         //Новый атрибут для вершины
        NewAttr := XMLDOc.createAttribute( "text" );
        NewAttr.value :=  "Comment. " ;
        NewNode.attributes.setNamedItem(NewAttr);
         //Добавление созданной вершины в дерево
        Node.appendChild(NewNode);
         //Получение необходимой вершины в соответствии с XPath-запросом
        Node := XMLDOc.selectSingleNode( "<XPath-запрос для отбора вершины>" );
         //.
End   Sub  Sample3;

Ниже приведены различные примеры работы с XML-файлами:

Примеры файлов-приложений к НДС

Книги покупок и продаж в формате xml

Декларация по НДС и приложения к ней передаются в налоговые в электронном xml-формате, утвержденном приказом ФНС № ММВ-7-3/558@ .

Сведения из книг покупок, продаж, журналов учета счетов-фактур в формате xml загружаются в Контур.Экстерн для отправки в ИФНС, либо загружаются в Конутр.Сверку для сверки с контрагентами.

Книги покупок и продаж в формате Еxcel

Книги покупок/продаж в формате xls, xlsx или csv можно загрузить в Контур.Экстерн для отправки в ИФНС, либо в Конутр.Сверку для сверки с контрагентами. Еxcel-файлы будут автоматически сконвертированы в формат xml.

Загружаемые excel-формы должны соответствовать требованиям Постановления Правительства РФ № 1137 .

Дополнительные листы книги покупок и книги продаж представляются только при подаче корректирующей декларации.

дополнительные листы из книги покупок и книги продаж в формате xml

Журналы выставленных и полученных счетов-фактур в формате xml

Журналы выставленных и полученных счетов-фактур также можно загружать в Контур.Экстерн для отправки в ИФНС, либо в Конутр.Сверку для сверки с контрагентами. При этом загружать можно только xml-файлы, соответствующие приказу ФНС № ММВ-7-3/558@.

Журналы выставленных и полученных счетов-фактур в формате Еxcel

Для конвертации excel-файлов журналов выставленных и полученных счетов-фактур в xml-формат можно воспользоваться следующей инструкцией.

Загружаемые excel-файлы должны соответствовать требованиям Постановления Правительства РФ № 1137 .

Раздел 12 декларации НДС (утвержден также приказом ФНС № ММВ-7-3/558@ ) заполняется только в случае выставления счета-фактуры с выделением суммы налога следующими лицами:

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

Пример сведений в формате xml

Была ли полезна информация?

Как создать XML-файл

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

Microsoft Excel 2003 даёт пользователям возможность работать с XML-данными — создать XML-файл можно из таблицы, сохранённой в формате XLS.

Быстрая навигация по статье

В качестве конвертора для XML-файлов можно использовать программу Microsoft Excel 2003, установив дополнительную надстройку. Для этого потребуется:

• Скачать и установить надстройку «XML Tools» на официальном сайте Microsoft (microsoft.com/en-us/download/details.aspx?id=3108);
• Запустить Microsoft Excel 2003;
• Зайти в главное меню программы;
• Открыть раздел «Параметры Excel», расположенный внизу;
• В появившемся окне слева щёлкнуть по вкладке «Надстройки»;
• Внизу окна нажать на клавишу «Перейти»;
• В новом окне открыть пункт «Обзор»;
• Найти в списке установленную надстройку «XML Tools»;
• Выбрать её и кликнуть по клавише «Ок».

В верхнем меню программы появится вкладка «Надстройка», а в командах — пункт «XML Tools».

Дополнительная надстройка «XML Tools» для программы Microsoft Excel позволяет выполнить экспорт данных формата xls в xml. Для этого необходимо:

• Открыть файл с данными в формате xls;
• Нажать на пункт «XML Tools» (запустится функциональное меню);
• Выбрать первую строку «Convert a Range to an XML List» (откроется окно);
• Если таблица с подзаголовком поставить галочку напротив пункта «Yes, first row contains column names»;
• При отсутствии заголовка выбрать пункт «No, first row contains data»;
• Нажать на прямоугольник в верхней строке;
• Выделить область конвертируемых данных;
• Вернуться в предыдущее окно;
• Кликнуть по клавише «Ок» — вид таблицы преобразится.

Для использования преобразованной таблицы как XML-данных необходимо её правильно сохранить. Для этого нужно:

• Зайти в главное меню Excel;
• Нажать на пункт «Сохранить как»;
• Выбрать поле «Другие форматы»;
• В строке «Тип файла» указать формат «XML-данные»;
• Щёлкнуть мышкой по клавише «Сохранить».

Поделитесь этой статьёй с друзьями в соц. сетях: