Передача данных через SQL-таблицу ExtDocs - История изменений

Belousov: /* Статусы и коды ошибок обработки записи */

2014-03-19T14:02:57Z

‎Статусы и коды ошибок обработки записи

Belousov: /* Статусы и коды ошибок обработки записи */

2014-03-19T13:59:33Z

‎Статусы и коды ошибок обработки записи

Zinoviev в 13:03, 19 марта 2014

2014-03-19T13:03:54Z

Zinoviev в 12:44, 19 марта 2014

2014-03-19T12:44:13Z

Belousov в 10:12, 19 марта 2014

2014-03-19T10:12:05Z

Admin: 1 версия: Все статьи из старой AltaPedia

2012-10-04T12:04:41Z

1 версия: Все статьи из старой AltaPedia

Popov в 12:44, 30 марта 2012

2012-03-30T12:44:19Z

Новая страница

Для передачи документов в программу "Альта-ГТД" из пользовательской КИС часто бывает удобнее вместо папки с файлами использовать таблицу на SQL-сервере. При этом в таблице хранятся по сути те же самые файлы (XML или бинарные), загруженные в поле типа BLOB.

Стандартное имя такой таблицы в рабочей БД ГТД - '''ExtDocs'''

При появлении в ней необработанных записей (Status=0 или NULL) на панели инструментов ГТД появляется кнопка "зеленая стрелка", которая позволяет загрузить их из таблицы в текущую папку рабочей БД. Это та же самая кнопка, которая показывает наличие документов в [[Форматы ввода вывода Альта-ГТД#Папка автозагрузки|папке "автозагрузки"]]. Выборочная загрузка возможна через меню "Каталог|Выгрузка/Загрузка дополнительная|Внешние документы из SQL-базы".

По умолчанию таблица ExtDocs в базе отсутствует, чтобы создать ее и начать работу с данным механизмом необходимо хотя бы один раз зайти в упомянутое меню "Внешние документы из SQL-базы". Так сделано чтобы не замедлять работу большинства пользователей ненужными SQL-запросами.

== Поля таблицы ExtDocs ==
Жирным шрифтом выделены обязательные для заполнения поля
{| class="standard"
!Поле
!Тип
!Описание
|-
|'''DocExt'''
|varchar(10)
|Тип файла, чаще всего "XML"
|-
|DocName
|varchar(50)
|Название док-та (для отображения в списке)
|-
|DocNum
|varchar(50)
|Номер документа (для отображения в списке)
|-
|SendDate
|datetime
|Время создания записи
|-
|SendFrom
|varchar(16)
|Имя создателя записи (для отображения в списке)
|-
|SendTo
|varchar(16)
|Имя загрузившего запись (логин пользователя в смысле "Альта-ГТД", заполняется при обработке записи)
|-
|GetDate
|datetime
|Время загрузки (заполняется при обработке записи)
|-
|'''Data'''
|image
|Собственно документ в одном из разрешенных форматов:
* XML таможенного формата (в соответствии с [http://www.customs.ru/index.php?option=com_content&view=article&id=14243&Itemid=2148 альбомами форматов] утвержденными ФТС).
* XML внутреннего формата "Альта-ГТД". Для ЭД-2 документов совпадает с таможенным, для ГТД и Инвойса существенно отличается. Примеры можно получить выгрузив любой готовый документ через меню "Каталог|Выгрузка/Загрузка дополнительная|Выгрузка в XML (Альта)".
* Бинарник внутреннего формата. Расширение соответствует типу документа, например "GTD" или "INV". Закрытый формат, получается выгрузкой из программы "Альта-ГТД" на другом рабочем месте.
* TXT, DBF, SCP, SCW, INI - в соответствии с [[Форматы ввода вывода Альта-ГТД|форматами ввода вывода Альта-ГТД]]
|-
|Status
|int
|Статус (при создании записи 0 или NULL, при обработке присваивается код результата операции)
|-
|Comment
|varchar(100)
|Комментарий (для отображения в списке)
|-
|DOCGUID
|uniqueidentifier
|Guid документа, для последующей его идентификации в таблице Docs рабочей БД.
* Если был передан из КИС, то используется как главный ключ Docs.GID для загружаемого документа.
* Если был пустой, то программа прописывает в это поле новый Docs.GID созданного документа.
|-
|GID
|uniqueidentifier
|Номер записи в таблице, PRIMARY KEY, присваивается автоматически
|}
== Статусы и коды ошибок обработки записи ==
{| class="standard"
!Код
!Описание
|-
|0
|Новая запись, не обработана
|-
|1
|Документ успешно загружен
|-
| -1
|Ошибка записи на диск
|-
| -2
|Неизвестный тип данных в поле DocExt
|-
| -3
|Ошибка при конвертации документа, неверный формат
|-
| -4
|Дубль, документ с таким DocGUID уже есть в базе
|}

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

[[Категория:Альта-ГТД]]
[[Категория:Автоматизация]]

@@ Строка 96: / Строка 96: @@
 Ниже приведен скрипт для создания таблицы '''ExtDocs'''. После его выполнения и перезапуска программы ГТД загрузка новых документов "зеленой стрелкой" начинает работать автоматически.
 <source lang=sql>
 CREATE TABLE [dbo].[ExtDocs](
@@ Строка 112: / Строка 113: @@
+)
 </source>
 == См. также ==

@@ Строка 95: / Строка 95: @@
 Ниже приведен скрипт для создания таблицы '''ExtDocs'''. После его выполнения и перезапуска программы ГТД загрузка новых документов "зеленой стрелкой" начинает работать автоматически.
-  CREATE TABLE [dbo].[ExtDocs](
      [DocExt] [varchar](10) NULL,
      [DocName] [varchar](50) NULL,
@@ Строка 107: / Строка 109: @@
      [Comment] [varchar](100) NULL,
      [DOCGUID] [uniqueidentifier] NULL,
-     [GID] [uniqueidentifier] ROWGUIDCOL  NOT NULL DEFAULT (newid()),
+     [GID] uniqueidentifier NOT NULL PRIMARY KEY NONCLUSTERED ROWGUIDCOL DEFAULT (newid())
-  PRIMARY KEY CLUSTERED ([GID] ASC) ON [PRIMARY]) ON [PRIMARY]
 == См. также ==

← Предыдущая		Версия 12:44, 19 марта 2014
Строка 94:		Строка 94:
	Удаление обработанных записей, как и их добавление, осуществляется внешней КИС. Таким образом ExtDocs может являться одновременно и логом с информацией о загруженных документах, если удалять их не сразу, а через какое-то время.		Удаление обработанных записей, как и их добавление, осуществляется внешней КИС. Таким образом ExtDocs может являться одновременно и логом с информацией о загруженных документах, если удалять их не сразу, а через какое-то время.

		+	Ниже приведен скрипт для создания таблицы '''ExtDocs'''. После его выполнения и перезапуска программы ГТД загрузка новых документов "зеленой стрелкой" начинает работать автоматически.
		+	CREATE TABLE [dbo].[ExtDocs](
		+	[DocExt] [varchar](10) NULL,
		+	[DocName] [varchar](50) NULL,
		+	[DocNum] [varchar](50) NULL,
		+	[SendDate] [datetime] NULL,
		+	[SendFrom] [varchar](16) NULL,
		+	[SendTo] [varchar](16) NULL,
		+	[GetDate] [datetime] NULL,
		+	[Data] [image] NULL,
		+	[Status] [int] NULL,
		+	[Comment] [varchar](100) NULL,
		+	[DOCGUID] [uniqueidentifier] NULL,
		+	[GID] [uniqueidentifier] ROWGUIDCOL NOT NULL DEFAULT (newid()),
		+	PRIMARY KEY CLUSTERED ([GID] ASC) ON [PRIMARY]) ON [PRIMARY]

	== См. также ==		== См. также ==

@@ Строка 45: / Строка 45: @@
   |image
   |Собственно документ в одном из разрешенных форматов:
-* XML таможенного формата (в соответствии с [http://www.customs.ru/index.php?option=com_content&view=article&id=14243&Itemid=2148 альбомами форматов] утвержденными ФТС).
+* XML таможенного формата (в соответствии с [http://www.customs.ru/index.php?option=com_content&view=article&id=17127 альбомами форматов] утвержденными ФТС).
 * XML внутреннего формата "Альта-ГТД". Для ЭД-2 документов совпадает с таможенным, для ГТД и Инвойса существенно отличается. Примеры можно получить выгрузив любой готовый документ через меню "Каталог|Выгрузка/Загрузка дополнительная|Выгрузка в XML (Альта)".
 * Бинарник внутреннего формата. Расширение соответствует типу документа, например "GTD" или "INV". Закрытый формат, получается выгрузкой из программы "Альта-ГТД" на другом рабочем месте.

@@ Строка 93: / Строка 93: @@
 Удаление обработанных записей, как и их добавление, осуществляется внешней КИС. Таким образом ExtDocs может являться одновременно и логом с информацией о загруженных документах, если удалять их не сразу, а через какое-то время.
 [[Категория:Альта-ГТД]]
 [[Категория:Автоматизация]]

← Предыдущая	Версия 12:04, 4 октября 2012
(нет различий)