~clearcorp-drivers/openobject-doc/5.0-ccorp

Импорт и экспорт данных

=========================

.. i18n: Every form in OpenERP has a standard mechanism for importing data from a CSV file through the client user interface. 

Каждая форма в OpenERP обладает стандартным механизмом для импорта данных из файла CSV через клиентский пользовательский интерфейс. Этот же формат используется в языковых переводах.

.. note:: Формы и списки

   В веб-клиенте у вас есть доступ к функциям импорта и экспорта на виде формы в режиме «только для чтения» -- вы не можете использовать импорт и экспорт в каком-либо другом виде или когда форма находится в режиме редактирования. Если вы используете клиент GTK, эти функции находятся в верхнем меню :menuselection:`[Форма --> Импорт...] (Form --> Import...)` и :menuselection:`[Форма --> Экспорт...] (Form --> Export...)`.

Формат файла CSV -- это текстовый формат, совместимый с большинством программ-табличных калькуляторов (таких, как OpenOffice Calc и Microsoft Excel) и легко редактируется как таблица. Первая строка содержит название полей формы. Все последующие строки -- это данные, помещенные в свои соответствующие столбцы.

Экспорт данных OpenERP в CSV

Начните экспорт данных OpenERP в формат CSV с ограниченно сложного набора данных, контрагентов и адресов контрагентов в демонстрационных данных.

Перейдите в :menuselection:`[Контрагенты --> Контрагенты] (Partners --> Partners)`, чтобы получить список контрагентов и затем прокрутите экран до нижней части списка, чтобы нажать ссылку :guilabel:`[Экспорт] (Export)`. Это вызовет диалоговое окно :guilabel:`Экспорт данных (Export Data)`. Выберите следующие поля:

* :guilabel:`Название (Name)`,

 

* :guilabel:`Имя контакта (Contact Name)` в меню :guilabel:`[Контакты] (Contacts)`,

 

* :guilabel:`Город (City)` в меню :guilabel:`[Контакты] (Contacts)`.

Вы можете либо выбирать и добавлять их по одному, либо щелкая левой кнопкой мыши при нажатой клавише :kbd:`<Ctrl>` и добавить затем множественный выбор -- поля будут перечислены в том порядке, в котором вы их выбирали.

Затем нажмите :guilabel:`[Экспорт] (Export)` и сохраните результирующий файл :file:`data.csv` где-либо в доступном месте, например -- на рабочем столе. Вы можете открыть этот файл в табличном калькуляторе или текстовом редакторе.

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

.. tip:: Ограничения списка

   На количество записей, которые вы можете экспортировать в клиентском ПО, существует ограничение -- это количество записей, которые вы можете реально видеть и ограничение равно максимум 100 записям в веб-клиенте, но может быть произвольно выбрано в клиенте GTK.

   Так что если вы хотите экспортировать все, используйте клиент GTK. Установите лимит экспорта в достаточно большое значение (при помощи кнопки :guilabel:`[+]` для воздействия на :guilabel:`Параметры (Parameters)` и :guilabel:`Ограничения (Limit)`), затем нажмите :menuselection:`[Форма --> Экспорт данных...] (Form --> Export data...)`, задайте поля для экспорта, и приготовьтесь подождать.

Импорт данных CSV в OpenERP

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

Например, для импорта контрагентов, с несколькими контактами, для которых вы можете указать имя и город, вы можете создать следующий файл CSV из экспортированного файла:

.. csv-table:: Пример импорта адресных полей контрагента

   :header: "Название (Name)", "Контакты/Имена контактов (Contacts/Contact Name)", "Контакты/Город (Contacts/City)"

   "Whole Globe Technologies","Graham Global","Афины (Athens)"

   "","Wanda World","Рим (Rome)"

   "","Emerson Earth","Нью-Йорк (New York)"

В списке контрагентов нажмите кнопку :guilabel:`[Импорт] (Import)` и затем в окне :guilabel:`Импорт данных (Import Data)` нажмите :guilabel:`[Открыть] (Open)` для того, чтобы выбрать и импортировать новый файл :file:`data.csv`. Веб-клиент автоматически ставит соответствие по названиям колонок, но клиент GTK требует нажатия кнопки :guilabel:`[Автоопределение] (Auto detect)`.

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

Формат файла CSV для структур сложных баз данных

--------------------------------------------------

.. i18n: ``.csv``\  flat files. To do this, two solutions are possible in OpenERP:

Когда вы импортируете данные, вам необходимо решить проблему представления структуры базы данных в плоских файлах ``.csv``. Для этого в OpenERP возможны два решения:

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

* импорт нескольких файлов CSV, каждый из которых соответствует конкретной таблице базы данных, с заданными явными ссылками между таблицами.

.. note:: Импорт на стороне сервера

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

.. i18n: interested in and select the fields that you want to import into your OpenERP database. You must

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

   *Выбор полей для импорта с использованием файла CSV*

.. i18n: OpenERP will automatically match the column name to the field name of the table. When you've

Используйте названия полей в качестве названий столбцов в первой строке вашего файла CSV, добавляя одно поле на столбец. Если в вашем файле CSV в первой строке будут присутствовать эти названия, то при импорте файла CSV OpenERP будет автоматически устанавливать соответствие названия столбца с названием поля в таблице. Когда вы создадите ваш файл CSV, проделайте, нажав кнопку :guilabel:`[Ничего] (Nothing)`, чтобы очистить :guilabel:`Поля для импорта (Fields to Import)`, затем выберите ваш файл CSV в окне :guilabel:`Файл для импорта (File to import)`, и нажмите кнопку :guilabel:`[Автоопределение] Auto Detect`.

.. i18n: of field in the OpenERP interface:  *many-to-many*  fields (between multiple sources and

Для импорта данных CSV, которые соответствуют структуре вашей базы данных, вам надо делать различие между следующими типами полей в интерфейсе OpenERP: поля *многие-ко-многим (many-to-many)*  (между различными источниками и назначениями), поля *многие-к-одному (many-to-one)* (от многих источников к одному назначению), и поля *один-ко-многим (one-to-many)* (от одного источника ко многим назначениям).

.. note:: Активная таблица

 

   Каждый из этих типов описан в отношении к активной таблице -- т.е. той таблице, форму ввода которой вы и записи которой будут изменены простым файлом CSV.

 

   То, что одно из этих полей с отношением присутствует в активной таблице, не означает, что существует обратное поле в таблице, к которой построено отношение -- но такое поле может и существовать.

 

   Так, в форме Пользователь (User) *не существует* поля типа один-ко-многим (one-to-many) для отображения поля :guilabel:`user_id` Продавец (Salesman) типа многие-к-одному (many-to-one) :guilabel:`user_id` из формы Контрагента (Partner), но *существует* поле Контрагент(Partner) типа много-к-одному (many-to-one) :guilabel:`partner_id` на форме Контакт контрагента (Partner contact) для отображения поля Контакты контрагента (Partner contacts) из формы Контрагент (Partner) для отображения поля типа один-ко-многим (one-to-many) :guilabel:`child_ids`.

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

   *Поле многие-к-одному (many-to-one): продавец связан с контрагентом*

   *Поле многие-ко-многим (many-to-many): категории контрагентов*

   *Поле один-ко-многим (one-to-many): контакты контрагента*

Все остальные поля вносятся в файл CSV просто как одна текстовая строка в каждом столбце.

Поля многие-к-одному

^^^^^^^^^^^^^^^^^^^^^

.. i18n: database where the foreground table has a single entry for the other table. OpenERP tries to link 

Поля типа многие-к-одному (many-to-one) представляют отношение между активной таблицей и другой таблицей в базе данных, где активная таблица имеет одну запись для для другой таблицы. OpenERP пытается связать новую запись в активной таблице с полем в другой таблице путем сравнения значений поля.

.. i18n:    This considerably simplifies the importation of another database into OpenERP.

.. tip:: Идентификаторы полей

 

   Если вы работаете на стороне сервера, вам надо использовать идентификаторы, а не названия ресурсов для связи таблиц. Чтобы сделать это, импортируйте первый файл (например, Продукты (Products)) с колонкой, которая называется :guilabel:`id` в вашем файле CSV, содержащем уникальный идентификатор для каждого продукта. Это может быть увеличивающееся число.

 

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

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

Поля многие-ко-многим

^^^^^^^^^^^^^^^^^^^^^^^

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

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

Поля один-ко-многим

^^^^^^^^^^^^^^^^^^^^^

Поля типа один-ко-многим немного другие. Рассмотрим в качестве примера поле :guilabel:`Контакты контрагента (Partner Contacts)` на форме партнера, которое содержит все связанные контакты.

Чтобы импортировать такое поле, вам не нужно связывать его с существующей записью в другой таблице, но вы можете создать и связать несколько контактов партнера, используя тот самый же файл. Вы можете затем указать несколько значений для различных полей, связанных с этим объектом полем типа один-ко-многим. Каждое поле должно быть помещено в столбец таблицы, и заголовок этого столбца должен быть выражен в виде ``field_one-to-many/field_linked-object``. Данные партнера, которые вы импортировали ранее, были оформлены именно таким образом.

.. note::  Симметрия в полях отношений

 

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

 

        Например, вы можете:

 

        * импортировать одного контрагента с различными контактами в одном файле (один-ко-многим),

 

        * вначале импортировать контрагентов, а затем контакты с полем, связанным с контрагентом в формате многие-к-одному).

Другой пример файла импорта CSV

Чтобы проиллюстрировать импорт данных, рассмотрим ниже еще один пример. Вначале импортируем категории контрагентов, а затем импортируем нескольких контрагентов и их контакты вместе со ссылками на только что созданные категории категории. Хотя вы можете создавать новые контакты одновременно с созданием контрагентов, (потому что вы можете делать это для отношений *один-ко-многим*), вы не можете создать этим путем новые категории (потому что они используют отношения *многие-ко-многим*). Вы должны создать новые категории в отдельном шаге.

Категории контрагентов

^^^^^^^^^^^^^^^^^^^^^^^^

Начните путем создания категорий контрагентов в файле CSV:

#. Создайте следующую таблицу в вашем табличном калькуляторе:

   .. csv-table:: Файл категорий контрагентов

      :header: "","Столбец A (Column A)","Столбец B (Column B)"

      "Строка 1 (Line 1)","Название категории (Category Name)","Родительская категория (Parent Category)"

      "Строка 2 (Line 2)","Качество (Quality)",""

      "Строка 3 (Line 3)","Золотой (Gold)","Качество (Quality)"

      "Строка 4 (Line 4)","Серебряный (Silver)","Качество (Quality)"

      "Строка 5 (Line 5)","Бронзовый (Bronze)","Качество (Quality)"

 

   В первой строке, :guilabel:`Название категории (Category Name)` и :guilabel:`Родительская категория (Parent Category)` -- это заголовки столбцов, которые соответствуют именам полей в форме :guilabel:`Категории контрагентов (Partner category)`.

 

   :guilabel:`Столбец A (Column A)` содержит различные категории контрагентов, а :guilabel:`Столбец B (Column B)` показывает, имеется ли родительская категория для данной категории. Если :guilabel:`Столбец B (Column B)` пуст, то категория располагается на верхнем уровне.

.. i18n: #. In OpenERP, select :menuselection:`Partners --> Configuration --> Categories --> Edit

#. Сохраните таблицу в файл CSV -- разделенный запятыми -- и назовите файл ``categories.csv``.

 

#. В OpenERP выберите :menuselection:`[Контрагенты --> Настройки --> Категории --> Изменить категории] (Partners --> Configuration --> Categories --> Edit Categories)`.

 

#. Нажмите :guilabel:`[Импорт] Import` (внизу слева от списка), чтоыб вызвать диалоговое окно :guilabel:`[Импорт данных] Import Data`, в котором вы увидите список полей для импорта.

 

#. Нажмите :guilabel:`[Просмотр] Browse...` в поле :guilabel:`[Файл для импорта] File to import` и выберите файл CSV, который вы только что создали, ``categories.csv``. Затем нажмите :guilabel:`[Автоопределение] Auto Detect` для поиска соответствия названий столбцов в файле CSV с именами полей, доступных в :guilabel:`Категории контрагентов (Partner Categories)`.

 

#. Нажмите :guilabel:`[Импорт] (Import)` справа внизу диалогового окна для загрузки ваших данных. Вы должны получить сообщение ``4 объекта импортировано (4 objects imported)`` в носом диалоговом окне. Закройте оба окна -- это и диалоговое окно :guilabel:`Импорт данных (Import Data)`, чтобы вернуться к исходной странице.

 

#. Нажмите :menuselection:`[Контрагенты --> Контрагенты по категориям] (Partners --> Partners by category)`, чтобы увидеть древо категорий, включая новую ветку ``Качество (Quality)``, которую вы загрузили.

Новые контрагенты

^^^^^^^^^^^^^^^^^^^

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

#. Создайте в вашем табличном калькуляторе следующую таблицу.

   .. csv-table:: Файл данных контрагентов - partners.csv

      :header: "","Столбец A (Column A)","Столбец B (Column B)","Столбец C (Column C)","Столбец D (Column D)"

      "Строка 1 (Line 1)","Название (Name)","Категории (Categories)","Контакты/Имя контакта (Contacts/Contact Name)","Выделенный продавец (Dedicated Salesman)"

      "Строка 2 (Line 2)","Black Advertising","Silver,Gold","George Black","Administrator"

      "Строка 3 (Line 3)","","","Jean Green",""

      "Строка 4 (Line 4)","Tiny sprl","","Fabien Pinckaers","Administrator"

#. Вторая строка соответствует созданию нового контрагента, с двумя существующими категориями, у которого есть два контакта и который связан с продавцом.

 

#. Сохраните файл под именем ``partners.csv``.

 

#. В OpenERP выберите :menuselection:`[Контрагенты --> Контрагенты] (Partners --> Partners)`, затем импортируйте только что сохраненный вами файл. Будет выведено сообщение, подтверждающее что ваши данные импортированы и сохранены.

 

#. Убедитесь, что данные импортированы успешно. Должен появиться новый контрагент (``NoirAdvertising``), с продавцом (``Administrator``), двумя контактами (``George Black`` и ``Jean Green``) и двумя категориями (``Silver`` and ``Gold``).

Экспорт данных в других видах

-------------------------------

.. i18n: OpenERP's generic export mechanism lets you easily export any of your data to any location on your

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

Вы использовать механизм для экспорта ваших данных в табличные файлы или иные системы, такие как специализированные бухгалтерские пакеты. Обычно формат экспорта -- это формат CSV, но вы можете также подсоединяться непосредственно к Microsoft Excel при помощи механизма COM Microsoft.

.. i18n:        Developers can also use other techniques to automatically access the OpenERP database. The two

.. tip:: Доступ к базе данных

 

        Разработчики могут также использовать другие методы для автоматического доступа к базе данных OpenERP. Два наиболее полезных:

 

        * использование веб-сервиса XML-RPC,

 

        * прямой доступ к базе данных PostgreSQL.

.. i18n:        If you want to enter data into OpenERP manually, you should use the Module Recorder, described in

.. tip:: Записывающий модуль

 

        Если вы хотите вводить данные в OpenERP вручную, вам лучше использовать записывающий модуль, описанный в первом разделе данной главы.

 

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