1.    Общие положения

1.1.         Введение

Система ASystemExchange предназначена для обмена данными с внешними системами.

ASystemExchange входит в стандартную поставку системы.

ASystemExchange может осуществлять импорт и экспорт данных в формате XML. Кроме того, возможен импорт данных в формате CSV (текстовый файл с разделителями).

1.2.         Настройка и запуск ASystemExchange

Программа запускается следующим образом:

AsystemExchange.exe  [–dsn:ODBC_SOURCE] [-user:USERNAME], где

ODBC_SOURCEисточник данных ODBC, настроенный на необходимую базу данных (по умолчанию используется asystem),

USERNAME – имя (login) пользователя для входа в систему.

После запуска необходимо ввести имя (login) пользователя (если оно не указано в параметрах запуска) и пароль (Рисунок 1.1).

 

01.bmp

Рисунок 1.1. Вход в систему

При запуске можно установить флаг «Запоминать имя и пароль пользователя». В этом случае при следующем входе в систему их не надо будет набирать заново.

Если имя или пароль набраны неправильно, то будет выдано соответствующее сообщение (Рисунок 1.2).

 

02.bmp

Рисунок 1.2. Ошибка при входе в систему

Нажав кнопку «Дополнительно», можно посмотреть состояние текущего языка ввода и статус клавиши Caps Lock (Рисунок 1.3). Кроме того, эта информация отображается при неправильно введенном пароле.

 

03.bmp

Рисунок 1.3. Дополнительная информация

1.3.         Экспорт данных

1.3.1.      Структура файла экспорта

Как уже говорилось выше, экспорт данных осуществляется в формате XML.

XML-файл имеет следующую структуру:

·        Корневым элементом является элемент «Экспорт», атрибутами которого являются «Источник» (значением является версия подсистемы экспорта), «Пользователь» (пользователь, осуществлявший экспорт) и «ДатаВремя» (дата и время начала процедуры экспорта).

·        На следующем уровне располагаются экспортируемые элементы: «Контрагент», «ТМЦ», «Документ», атрибуты элементов являются жестко фиксированными и описаны ниже.

·        Для них подчиненными элементами могут являться:

o   Элемент «Свойство», атрибутами которого являются «Код» (код реквизита в ASystem), «Наименование» (наименование реквизита в ASystem) и «Значение» (отображаемое системой значение реквизита). Этот элемент создается для каждого настроенного пользователем реквизита в режиме настройки списка экспортируемых реквизитов. Подробнее о настройке списка реквизитов в разделе 1.3.2. Обязательные реквизиты экспорта.

o   Элементы «Договор», «БанковскийСчет», «КонтактноеЛицо» для контрагентов.

o   Элемент «СтрокаФактуры» для документов (учетных операций).

o   Элемент «Объект» для строк фактурной части.

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

·        Для объектов фактурной части создается подчиненный элемент в том случае, если этот объект является номенклатурой или строкой фактурной части.

1.3.2.      Обязательные реквизиты экспорта

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

·        Для контрагентов:

o   Идентификатор контрагента в ASystem («ВнутреннийИдентификатор»).

o   Код контрагента во внешней системе («ВнешнийИдентификатор»).

o   Наименование контрагента («Наименование»).

o   Системная классификация контрагента в ASystem («Классификатор»).

·        Для договоров:

o   Идентификатор договора в ASystem («ВнутреннийИдентификатор»).

o   Код договора во внешней системе («ВнешнийИдентификатор»).

o   Номер (наименование) договора («Наименование»).

o   Дата начала действия договора («ДатаНачалаДействия»).

o   Дата окончания действия договора («ДатаОкончанияДействия»).

·        Для банковских счетов:

o   Идентификатор счета в ASystem («ВнутреннийИдентификатор»).

o   Код счета во внешней системе («ВнешнийИдентификатор»).

o   Наименование счета («Наименование»).

·        Для контактных лиц:

o   Идентификатор контактного лица в ASystem («ВнутреннийИдентификатор»).

o   Код контактного лица во внешней системе («ВнешнийИдентификатор»)

o   ФИО контактного лица («Наименование»)

·        Для ТМЦ:

o   Идентификатор ТМЦ в ASystem («ВнутреннийИдентификатор»).

o   Код ТМЦ во внешней системе («ВнешнийИдентификатор»).

o   Наименование ТМЦ («Наименование»).

o   Системная классификация ТМЦ в ASystem («Классификатор»).

·        Для документов (учетных операций):

o   Идентификатор документа в ASystem («ВнутреннийИдентификатор»).

o   Код документа во внешней системе («ВнешнийИдентификатор»).

o   Системная классификация документа в ASystem («Классификатор»).

o   Номер документа («Номер»).

o   Дата документа («Дата»).

o   Черновик/чистовик («Черновик»).

·        Для фактуры документов (учетных операций):

o   Идентификатор строки документа в ASystem («ВнутреннийИдентификатор»).

o   Код строки документа во внешней системе («ВнешнийИдентификатор»).

o   Код родительской строки («ВнутреннийИдентификаторРодительскойСтроки»). Передается только при условии, что для строки документа есть расшифровка в альтернативных единицах измерения.

·        Для объектов строк фактурной части:

o   Идентификатор объекта в ASystem («ВнутреннийИдентификатор»).

o   Тип объекта в ASystem («ВнутреннийТип»).

·        Для валюты:

o   Идентификатор валюты в ASystem ("ВнутреннийИдентификатор").

o   Код валюты во внешней системе ("ВнешнийИдентификатор").

o   Наименование валюты ("Наименование").

o   Краткое наименование валюты ("КраткоеНаименование").

o   Числовой код валюты ISO ("Код").

·        Для единиц измерения:

o   Идентификатор единицы измерения в ASystem («ВнутреннийИдентификатор»).

o   Код единицы измерения во внешней системе («ВнешнийИдентификатор»).

o   Полное наименование единицы измерения («Наименование»).

o   Краткое наименование единицы измерения («КраткоеНаименование»).

Замечание. Не экспортируются скрытые (неактуальные) расчетные счета и контактные лица контрагентов.

1.3.3.      Настройка дополнительных реквизитов экспорта

Для настройки дополнительных реквизитов экспорта необходимо выбрать меню «Настройка – Реквизиты – Экспорт…». Будет открыто окно настройки реквизитов экспорта (Рисунок 1.4).

 

Рисунок 1.4. Окно настройки реквизитов экспорта

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

Для добавления реквизитов необходимо нажать кнопку «Добавить». Появится окно добавления реквизитов (Рисунок 1.5).

 

Рисунок 1.5. Добавление реквизитов

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

Для измерения порядка реквизитов в списке нужно использовать кнопки «Переместить вверх» и «Переместить вниз».

Для удаления реквизита из списка необходимо нажать кнопку «Удалить».

После завершения настройки реквизитов можно начинать экспорт.

1.3.4.      Экспорт

Для экспорта данных необходимо выбрать меню «Данные – Экспорт…». Будет открыто окно экспорта данных (Рисунок 1.6).

 

Рисунок 1.6. Окно экспорта данных

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

·        Выбрать файл, в который будет производиться экспорт (Рисунок 1.7).

 

Рисунок 1.7. Выбор файла экспорта

·        Выбрать действие на случай, если такой файл уже существует (пересоздать файл заново или добавить данные в существующий файл).

·        Выбрать экспортируемые объекты (контрагенты, номенклатура, документы). Для документов отдельно выбирается, нужно ли экспортировать черновики. Для всех экспортируемых типов объектов присутствует возможность отфильтровать записи по веткам системного классификатора. Чтобы открыть окно настройки фильтра (Рисунок 1.8), необходимо нажать соответствующую кнопку, расположенную справа от наименования типа объектов.

 

Рисунок 1.8. Настройка фильтра

В случае, когда фильтр настроен, на кнопке появляется значок в виде красной «галочки» (Рисунок 1.9).

 

Рисунок 1.9. Признак настроенного фильтра

Сохранение настроек фильтра управляется флагом «Сохранять настройки фильтрации» в окне общих настроек (меню «Настройка – Общие…») (Рисунок 1.10).

 

Рисунок 1.10. Сохранение настроек фильтрации

·        Указать принцип отбора записей:

o   Все.

o   Измененные с момента последнего экспорта.

o   Измененные в определенные период.

·        Определить, куда будет выводиться информация о ходе экспорта (протокол) – на экран или в файл. В случае выбора значения «В файл» необходимо указать имя файла. Если ни один из флагов не установлен, протокол формироваться не будет.

·        Определить, нужно ли в протокол выводить всю информацию о ходе процесса или же только ошибки.

·        Определить максимальный уровень вложенности элементов (Рисунок 1.11). Эта настройка предназначена для управления ограничением уровня вложенности элементов. Например, вы экспортируете учетную операцию. На втором уровне экспорта будет ее фактурная часть. На третьем – объект, указанный в ней (материал). На четвертом – реквизит этой ТМЦ, предположим, поставщик по умолчанию. На пятом, в этом случае, – договоры этого поставщика. На шестом – реквизит «Наше предприятие» договора с поставщиком, на седьмом – реквизит нашего предприятия, который опять-таки может выбираться из справочника. Настройка определяет, до какого уровня вложенности элементов производится экспорт.

 

Рисунок 1.11. Максимальный уровень вложенности элементов

·        Определить, нужно ли создавать отдельные элементы для реквизитов, которые выбираются из справочника единиц измерения, из справочника валют, из справочника контрагентов, из справочника аффилированных предприятий, из справочника расчетных счетов, из справочника договоров, из списка ТМЦ или из списка ГП (Рисунок 1.12).

 

Рисунок 1.12. Настройка создания отдельных элементов для реквизитов

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

·        Определить, нужно ли при выгрузке контрагентов выгружать его договоры, расчетные счета и контактные лица (Рисунок 1.13).

 

Рисунок 1.13. Настройка экспорта контрагентов

После выполнения этих действий можно начинать экспорт с помощью кнопки «Начать». При экспорте учетных операций автоматически экспортируется фактура этих учетных операций.

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

 

07

Рисунок 1.14. Протокол экспорта

 

01

Рисунок 1.15. Индикатор хода процесса экспорта

1.3.5.      Экспорт из списка учетных операций ASystem

Документы могут быть экспортированы вручную. Для этого необходимо в любом режиме работы с учетными операциями ASystem пометить необходимое количество операций и нажать кнопку «Экспортировать данные» (Рисунок 1.16).

 

Рисунок 1.16. Экспорт документов из списка учетных операций

После этого необходимо выбрать файл, куда будут экспортироваться данные (Рисунок 1.17).

 

Рисунок 1.17. Выбор файла экспорта

После окончания экспорта на экран будет выдано соответствующее сообщение (Рисунок 1.18).

 

03

Рисунок 1.18. Сообщение об окончании экспорта

Экспорт будет осуществляться в соответствии с настройкой реквизитов, определенной в ASystemExchange.

Права доступа к экспорту учетных операций настраиваются в подсистеме определения прав доступа (закладка «Функции», ветка «Формы – Учетные операции») (Рисунок 1.19).

 

Рисунок 1.19. Настройка прав доступа к экспорту учетных операций

Экспорт отдельных учетных операций возможен также с помощью кнопки «Экспортировать данные» в окне редактирования учетной операции и в списке учетных операций по заказу.

1.3.6.      Автоматический экспорт из ASystem

Для настройки автоматического экспорта необходимо в ASystemExchange выбрать меню «Настройка – Экспорт…».

В этом режиме можно настроить экспорт документов при сохранении (Рисунок 1.20)

 

Рисунок 1.20. Настройка экспорта документов при сохранении

Для каждого типа документов необходимо указать, нужно ли этот тип документов экспортировать при сохранении. Если нужно, то дополнительно вводятся следующие параметры:

·        Нужно ли экспортировать черновики.

·        Имя файла экспорта.

·        Действие на случай, если такой файл уже существует (пересоздать файл заново или добавить данные в существующий файл).

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

·        Нужно ли вести протокол автоматического экспорта. Если флаг установлен, то необходимо заполнить поле с именем файла протокола. В имени файла протокола допустимы метасимволы <GroupID> и <ID>.

Помимо настройки экспорта документов можно настроить экспорт материалов при передаче в производство. Для этого необходимо выбрать закладку «Материалы» (Рисунок 1.21).

 

Рисунок 1.21. Настройка экспорта материалов при передаче в производство

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

Автоматический экспорт документов и материалов будет осуществляться в соответствии с настройкой реквизитов, определенной в ASystemExchange.

1.4.         Импорт данных в формате CSV

1.4.1.      Общие положения

Импорт в формате CSV осуществляется из файлов с расширением «.csv» или «.txt». В файле для импорта должны быть следующие данные:

·        Заголовок секции в виде «//Имя секции».

·        Строки с данными. В начале каждой строки должны следовать обязательные реквизиты, определённые для каждого вида данных. После них могут идти настраиваемые реквизиты. Разделителем реквизитов может быть запятая, точка с запятой или табуляция. Текстовые значения могут быть не ограничены, либо ограничены одинарными или двойными кавычками. После того, как будут определены разделители и ограничители текстовых значений необходимо сделать соответствующие настройки в системе (меню «Настройка – Общие…», закладка «Импорт») (Рисунок 1.22).

 

Рисунок 1.22. Общие настройки

1.4.2.      Виды импортируемых данных

В формате CSV могут импортироваться следующие виды данных:

·        Курсы валют.

Заголовок секции – «//КУРСЫ ВАЛЮТ».

Реквизиты для импорта курсов валют не настраиваются. Импортируются следующие реквизиты:

o   Код валюты.

o   Курс.

o   Дата начала действия курса.

·        Контрагенты.

Заголовок секции – «//КОНТРАГЕНТЫ».

Обязательные реквизиты:

o   Код контрагента во внешней системе.

o   Группа контрагента во внешней системе.

o   Наименование контрагента.

·        Договоры

Заголовок секции – «//ДОГОВОРЫ».

Обязательные реквизиты:

o   Код контрагента во внешней системе.

o   Номер (наименование) договора.

o   Дата начала действия договора.

o   Дата окончания действия договора.

·        Банковские счета.

Заголовок секции – «//БАНКОВСКИЕ СЧЕТА».

Обязательные реквизиты:

o   Код контрагента во внешней системе.

o   Наименование счета.

·        Контактные лица.

Заголовок секции – «//КОНТАКТНЫЕ ЛИЦА».

Обязательные реквизиты:

o   Код контрагента во внешней системе.

o   ФИО контактного лица.

·        Единицы измерения.

Заголовок секции – «//ЕДИНИЦЫ ИЗМЕРЕНИЯ».

Обязательные реквизиты:

o   Код единицы измерения во внешней системе.

o   Краткое наименование единицы измерения.

o   Полное наименование единицы измерения.

·        Материалы.

Заголовок секции – «//МАТЕРИАЛЫ».

Обязательные реквизиты:

o   Код ТМЦ во внешней системе.

o   Группа ТМЦ во внешней системе.

o   Полное наименование ТМЦ.

o   Полное наименование единицы измерения.

o   Код единицы измерения во внешней системе.

·        Платежи («//ПЛАТЕЖИ»).

Заголовок секции – «//ПЛАТЕЖИ».

Обязательные реквизиты:

o   Номер документа оплаты.

o   Дата документа оплаты.

o   Черновик/чистовик.

o   Код плательщика во внешней системе.

o   Сумма платежа.

o   Валюта платежа.

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

Если в меню «Настройка – Общие» на закладке «Импорт» установлен флаг «Включать внешний код в список реквизитов договоров, банковских счетов и контактных лиц» (Рисунок 1.23), то этот реквизит должен идти первым в списке импортируемых реквизитов договоров, банковских счетов и контактных лиц.

 

Рисунок 1.23. Настройка «Включать внешний код в список реквизитов договоров, банковских счетов и контактных лиц»

Данная настройка относится только к импорту данных в формате CSV и неприменима к импорту в формате XML.

1.4.3.      Настройка реквизитов

Помимо обязательных реквизитов можно для каждого типа объектов настроить дополнительные реквизиты. Для этого необходимо выбрать меню «Настройка – Реквизиты – Импорт…».  На экране появится окно настройки реквизитов (Рисунок 1.24).

 

Рисунок 1.24. Окно настройки реквизитов

В левой части окна выбирается объект, для которого настраиваются дополнительные реквизиты, в правой части – список настроенных реквизитов. Обязательные реквизиты помечены красным квадратиком (04).

Для добавления реквизитов необходимо нажать кнопку «Добавить». Появится окно добавления реквизитов (Рисунок 1.25).

 

Рисунок 1.25. Добавление реквизитов

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

Для измерения порядка реквизитов в списке нужно использовать кнопки «Переместить вверх» и «Переместить вниз».

Для удаления реквизита из списка необходимо нажать кнопку «Удалить».

По умолчанию данные из файла пишутся в значение соответствующего реквизита без изменений. Если для какого-то реквизита необходима специальная обработка, то нужно на этом реквизите нажать правую кнопку мыши и выбрать меню «Специальная обработка…» (Рисунок 1.26).

 

Рисунок 1.26. Меню "Специальная обработка"

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

 

Рисунок 1.27. Скрипт специальной обработки

После настройки реквизитов необходимо нажать кнопку «Создать процедуру импорта». Если создание процедуры пройдёт без ошибок, то будет выдано соответствующее сообщение (Рисунок 1.28).

 

Рисунок 1.28. Успешное создание процедуры импорта

Если при создании процедуры импорта будут выявлены ошибки, то будет выдано сообщение об ошибке и процедура создана не будет.

1.4.4.      Настройка классификации

Классификация настраивается для объектов «Контрагенты» и «Материалы». Для этого необходимо выбрать меню «Настройка – Классификация…». На экране появится окно настройки классификации (Рисунок 1.29).

 

Рисунок 1.29. Настройка классификации

Для добавления групп необходимо нажать кнопку «Добавить запись». Группа во внешней системе может быть набрана вручную, либо выбрана из списка. Для заполнения списка для выбора необходимо либо нажать кнопку «Загрузить группы из файла», либо нажать кнопку «Добавить запись», попытаться выбрать группу во внешней системе из списка и ответить утвердительно  на заданный вопрос (Рисунок 1.30).

 

Рисунок 1.30. Вопрос о необходимости загрузки групп из файла

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

 

Рисунок 1.31. Выбор файла для загрузки

Файл должен соответствовать вышеописанной структуре (то есть вторым реквизитом должна идти группа контрагента и разделители должны соответствовать тем, что указаны в настройках).

В результате список будет заполнен значениями групп, которые встречаются в файле (Рисунок 1.32).

 

03

Рисунок 1.32. Список значений групп во внешней системе

После этого необходимо группе во внешней системе поставить в соответствие ветку классификатора в ASystem (Рисунок 1.33).

 

05

Рисунок 1.33. Сопоставление группы во внешней системе с классификатором в ASystem

Группы контрагентов во внешней системе могут быть заведены и вручную.

После этого можно приступать собственно к импорту данных.

1.4.5.      Импорт

Для импорта данных необходимо выбрать меню «Данные – Импорт…». На экране появится окно импорта данных (Рисунок 1.34).

 

Рисунок 1.34. Окно импорта данных

Прежде чем начать импорт, необходимо выполнить следующие действия:

·        Выбрать исходный файл (Рисунок 1.35).

 

Рисунок 1.35. Выбор файла импорта

·        Определить, что делать с файлом после импорта:

o   Оставить без изменений.

o   Переместить. В этом случае необходимо выбрать место, куда будет перемещен исходный файл (Рисунок 1.36).

 

Рисунок 1.36. Выбор места для перемещения файла

o   Удалить.

·        Отметить нужные объекты для импорта (Рисунок 1.37).

 

Рисунок 1.37. Объекты для импорта

·        В случае необходимости выбрать нужные группы для импорта, нажав кнопку справа от соответствующего объекта (Рисунок 1.38)

 

Рисунок 1.38. Выбор групп  объектов для импорта

·        Установить нужные значения следующих флагов:

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

Если флаг установлен, то при обновлении данных учитывается настройка «Обновлять данные для подчиненных объектов», задаваемая  в меню «Настройка – Общие» на закладке «Импорт» (Рисунок 1.39).

 

Рисунок 1.39. Настройка «Обновлять данные для подчиненных объектов»

Здесь перечислены объекты, являющиеся подчиненными при импорте учетных операций: «Контрагенты», «Расчетные счета», «ТМЦ», «Единицы измерения» и «Валюты». Если флажок рядом с объектом будет снят, то при импорте с установленным флагом «Обновлять данные для уже существующих записей» соответствующие подчиненные объекты не будут обновляться.

o   Игнорировать ошибки. При импорте могут возникать ошибки SQL (например, в случае, если после настройки реквизитов не была нажата кнопка «Создать процедуру импорта»). Если флаг не установлен, то при возникновении такой ошибки на экране будет появляться сообщение о возникшей ошибке с возможностью продолжить или прервать импорт. Если флаг установлен, то импорт не будет прерываться, а возникающие ошибки будут внесены в протокол.

·        Определить, куда будет выводиться информация о ходе импорта (протокол) – на экран или в файл. В случае выбора значения «В файл» необходимо указать имя файла. Если ни один из флагов не установлен, протокол формироваться не будет.

·        Определить, нужно ли в протокол выводить всю информацию о ходе процесса или же только ошибки.

После этого по нажатию кнопки «Начать» будет начат импорт информации. Если указано, что необходим протокол, то будет выводиться протокол импорта (в файл и/или на экран). Кроме того, в левом нижнем углу окна ASystemExchange  будет выдаваться индикатор хода процесса импорта (Рисунок 1.40).

 

01

Рисунок 1.40. Индикатор хода процесса импорта

Если в меню «Настройка – Общие» на закладке «Импорт» установлен флаг «Запрещать редактирование учетных операций после импорта» (Рисунок 1.41), то после импорта учетным операциям автоматически устанавливается событие «Заблокирована».

 

Рисунок 1.41. Флаг «Запрещать редактирование учетных операций после импорта»

1.5.         Импорт данных в формате XML

Импорт данных в формате XML осуществляется из файлов с расширением «.xml». Структура файла, принимаемого на вход системы импорта, в целом аналогична структуре документа, получающегося в результате экспорта с помощью модуля обмена данными, описанного в разделе 1.3.1. Структура файла экспорта. При этом следует отметить следующие особенности:

·        Корневой элемент документа может быть любым. Его атрибуты не обрабатываются.

·        Атрибут «Наименование» в элементе «Свойство» не обрабатывается и может отсутствовать, вся информация по реквизиту вычитывается на основании его кода. Настройка реквизитов не требуется – будут импортироваться все реквизиты, имеющиеся в файле.

·        Атрибут «Классификатор» элементов «Контрагент», «Номенклатура» и «Документ» должен содержать наименование группы во внешней системе. Соответствие между группами во внешней системе и классификацией в ASystem определяется в режиме «Настройки – классификация». Настройка классификации не отличается от настройки для формата CSV, описанной в разделе 1.4.4. Настройка классификации, за исключением того, что группы во внешней системе не могут быть подгружены автоматически.

·        После импорта оплаты можно распределить оплату по указанному в xml-файле счету. Для этого обрабатывается атрибут «ВнутреннийИдентификаторСчета». Если этот атрибут заполнен, то оплата будет распределена в рамках этого счета. Возможно также распределять оплату по указанным в атрибуте «ВнутреннийИдентификаторСчета» счетам с указанием конкретных сумм по каждому счету. Сумма указывается после идентификатора счета после знака «=»

·        Для документов оплаты атрибут документа «Курс» перекрывает системный курс при распределении оплаты по счетам.

·        Есть возможность удалять учетные операции. Для этого отдельно обрабатывается атрибут «Действие»: если его значением является «Удалить», то указанный документ удаляется. При этом должен быть определен его внутренний или внешний идентификатор. Аналогично атрибут «Действие» поддерживается для строк фактуры. Если значением атрибута «Действие» является «Очистить», перед загрузкой полностью очищается фактурная часть документа.

·        При импорте договоров, расчетных счетов и контактных лиц можно указать признак «По умолчанию». Для определения этого признака необходимо использовать атрибут «ПоУмолчанию», который может принимать значения «Да» и «Нет». В первом случае запись помечается как строка по умолчанию, во втором (при обновлении данных для уже существующих записей) признак «По умолчанию» снимается. Если атрибут отсутствует, признак у существующих записей остается без изменений.

·        Поиск существующих договоров по номеру и периоду действия производится с учетом атрибута договора «НашеПредприятие».

·        Значения автоматически рассчитываемых реквизитов при импорте игнорируются.

Процедура импорта ничем не отличается от процедуры импорта в формате CSV и описана в разделе 1.4.5. Импорт.

1.6.         Автоматический режим работы ASystemExchange

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

ASystemExchange поддерживает следующие параметры импорта:

·        -dontcalcintsums. При указании этого параметра после импорта документов не производится расчет внутренних стоимостей списания.

·        -import:[RCUM] (R – курсы валют, C – контрагенты, U – единицы измерения, M – материалы, D – документы). Выбираются перечисленные после двоеточия типы объектов.

·        -infile:<filename>. Указанное после двоеточия имя файла заносится в поле «Исходный файл».

·        -update. Устанавливается флаг «Обновлять данные для уже существующих записей».

·        -ignoreerrors. Устанавливается флаг «Игнорировать ошибки».

·        -importlogfile:<filename>. Указанное после двоеточия имя файла заносится в поле «Файл» в группе «Протокол». При этом устанавливается флаг «В файл» в той же группе.

·        -importlogappend. Если указан этот параметр, то протокол дописывается в файл с указанным именем, в противном случае файл пересоздается.

ASystemExchange поддерживает следующие параметры экспорта:

·        -export:[CMD] (C – контрагенты, M – материалы, D – документы). Выбираются перечисленные после двоеточия типы объектов.

·        -outfile:<filename>. Указанное после двоеточия имя файла заносится в поле «Результирующий файл». В имени файла для экспорта могут быть использованы метасимволы <GroupID> (будет заменен на внутренний код классификатора группы документов) и <ID> (будет заменен на внутренний уникальный код конкретного документа).

·        -ifexists:{0|1}. Если значение параметра 1, то в списке действий на случай, если файл уже существует, выбирается «Добавить», иначе файл пересоздается.

·        -records:{0|1|2[dd.mm.yyyy,dd.mm.yyyy]}. Отбор записей производится по следующему принципу: для значения 0 – все записи, 1 – измененные с момента последнего экспорта, 2 – измененные за указанный период. Период указывается в виде двух дат, следующих за цифрой 2.

·        -exportlogfile:<filename>. Указанное после двоеточия имя файла заносится в поле «Файл» в группе «Протокол». При этом устанавливается флажок «В файл» в той же группе.

·        -exportlogappend. Если указан этот параметр, то протокол дописывается в файл с указанным именем, в противном случае файл пересоздается.

ASystemExchange поддерживает следующие параметры, которые могут использоваться как для  импорта, так и для экспорта.

·        -autostart. После обработки всех параметров автоматически запускается процедура обмена данными. Если не указано имя файла импорта и/или экспорта или не выбран ни один тип объектов, то автоматического запуска не происходит.

·        -autoclose. После выполнения процедуры обмена данными программа автоматически закрывается. Если процедура обмена данными не была запушена автоматически, то автоматического закрытия не происходит.

·        -log2screen. Устанавливается флажок «На экран» в группе «Протокол».

·        -logonlyerrors. Устанавливается флаг «Только ошибки» в группе «Протокол».

1.7.         Соответствие кодов

В режиме «Соответствие кодов» можно просматривать внутренние и внешние коды экспортированных и импортированных объектов, а также редактировать в случае необходимости значения кодов объектов во внешней системе.

Для этого необходимо выбрать пункт меню «Данные – Соответствие кодов». После этого, выбрав тип объекта («Контрагенты», «Договоры», «Расчетные счета», «Контактные лица», «ТМЦ», «Учетные операции», «Строки фактуры учетных операций», «Услуги») и нажав кнопку «Перечитать», можно получить список объектов с указанием их внутреннего и внешнего (если есть) кода (Рисунок 1.42). Внешний код может быть указан вручную.

 

Рисунок 1.42. Соответствие кодов

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

Для договоров, расчетных счетов и контактных лиц в колонке «Внешний код родителя» отображается внешний код контрагента, для строк фактуры учетных операций – внешний код учётной операции.

1.8.         История

В режиме «История» можно просмотреть историю сессий экспорта и импорта данных (Рисунок 1.43).

 

Рисунок 1.43. История обмена данными

История на верхнем уровне сгруппирована по видам обмена (экспорт или импорт), на следующем – по объекту (контрагенты, ТМЦ и т.д.). На нижнем уровне находятся строки с датой и временем сессии экспорта или импорта данных.

2.   Приложения

2.1.         Примеры файлов экспорта/импорта в формате XML

2.1.1.      Контрагенты

01

2.1.2.      Материалы

02

2.1.3.      Документы

1

 

2.2.         Пример файла импорта в формате CSV

05