1с 7 создание документа
После того как табличный документ сформирован в "1С:Предприятии" и выведен на экран, его можно распечатать и сохранить во внешний файл. Например, для последующей отправки контрагенту-покупателю по электронной почте.
В "1С:Предприятии" имеется возможность сохранить полученный документ в нескольких форматах. В частности, доступны:
- формат "1С:Предприятие" - табличный документ для версий платформы 7.7 и 8 (файлы с расширением "*.mxl");
- текстовый формат ("*.txt") с различными кодировками (ANSI, UTF-8);
- формат HTML различных стандартов ("*.htm");
- формат MS Excel различных стандартов ("*.xls").
Каждый из форматов является довольно распространенным в компьютерном мире. В частности, формат "1С:Предприятия" ("*.mxl") используется для передачи табличных документов между пользователями платформ 7.7 и 8. Текстовый формат ("*.txt"), как правило, используется для передачи текстовой информации (без форматирования) и может быть прочитан практически на любом компьютерном устройстве. Формат HTML - самый распространенный формат отображения информации в сети Интернет (например, странички и сайты, которые вы просматриваете в Интернете, с большой долей вероятности используют именно формат HTML или его разновидности). А формат MS Excel в комментариях, мы считаем, не нуждается - мало какой компьютер не умеет работать с "офисными" документами.
Для того, чтобы сохранить документ из "1С:Предприятия" в любой из перечисленных выше форматов, достаточно выбрать в меню "Файл" опцию "Сохранить копию…", после чего в появившемся диалоге сохранения файла, в разделе "Тип файла" выбрать нужный нам тип.
Среди всех вышеперечисленных типов файлов, обратим внимание на три самых интересных с практической точки зрения - т. е. те, которые максимально полно сохранят форматирование в табличном документе и в дальнейшем позволят другим пользователям комфортно просматривать то, что мы сохранили, распечатывать это или даже редактировать.
Первый формат - "табличный документ" "1С:Предприятия". Он записывается в файлы с расширением ".mxl" и может быть прочитан и отредактирован только средствами платформы "1С:Предприятие". Открыть такой файл можно программой "1С:Предприятие", установленной на компьютер пользователя или бесплатным редактором файлов форматов 1С "1С:Предприятие-Работа с файлами".
Программу "1С:Предприятие-Работа с файлами" можно бесплатно скачать по адресу http://v8.1c.ru/metod/fileworkshopdownload.htm, описание программы и примеры работы можно увидеть по адресу http://v8.1c.ru/metod/fileworkshop.htm. Данный редактор позволяет открывать и редактировать различные форматы файлов, которые могут быть созданы средствами платформы "1С:Предприятия". Поддерживаются следующие форматы:
- текстовые документы различных кодировок ("*.txt");
- табличные документы версий платформы 7.7 и 8 ("*.mxl");
- HTML-документы ("*.htm, *.html");
- графические схемы ("*.grs");
- географические схемы ("*.geo").
По сути, используя эту программу, вы получаете все возможности по работе с этими файлами, доступные в любой другой версии платформы "1С:Предприятие" версии 8. Кроме, собственно, редактирования и просмотра файлов, "1С:Предприятие-Работа с файлами" позволяет проводить сравнение файлов встроенными в платформу 8 возможностями. Поддерживается сравнение двух текстовых файлов("*.txt"), двух табличных документов в формате 1С ("*.mxl") или двоичное сравнение. Для использования этой возможности, достаточно в меню "Файл" выбрать пункт "Сравнить файлы", а в появившемся диалоге выбрать тип сравнения и указать два файла, которые будем сравнивать (см. рис. 1). Если файлы не идентичны, то будет открыто окно, наглядно отображающее, чем файлы друг от друга отличаются (см. рис. 2). Причем, как видно из рисунка, можно быстро перемещаться по всем обнаруженным различиям, по позиции в одном документе попадать в ту же позицию другого. Все различия наглядно помечены цветом. В результате вы всегда имеете под рукой мощный механизм сравнения, который позволит быстро выявить различия, например в однотипных документах или отчетах, что может существенно ускорить работу с ними.
В заключение стоит упомянуть, что в программу "1С:Предприятие-Работа с файлами" встроены также календарь и калькулятор, уже знакомые многим по платформе 1С версии 8.
Второй полезный многим формат - "Лист Excel" ("*.xls"). Заметим, что в версии 8.1 платформы "1С:Предприятие 8", появилась поддержка формата Excel97 (подробнее см. здесь), который позволяет корректно сохранять разнообразное форматирование, группировку, примечания и т. п. Благодаря поддержке этого формата, вы может сохранить и передать, например, своему контрагенту расходную накладную ТОРГ-12, в формате Excel без каких-либо потерь в форматировании этого документа. Т. е. получатель откроет в своей программе Excel файл и увидит его ровно таким, каким он был создан в программе 1С.
Третий формат, на который хотелось бы обратить ваше внимание - "Документ HTML" ("*.htm"). Пожалуй, это самый распространенный формат в Интернет. Польза для нас в том, что документ этого формата может быть открыт массой WEB-браузеров, например, Internet Explorer, Mozilla, Firefox, Opera и т. п. То есть на компьютере пользователя, которому вы отправляем документ в формате HTML, вообще могут отсутствовать программы 1С.
В заключение, хочется отметить развитые возможности программ "1С:Предприятие" по экспорту своих данных в другие форматы. Это реализовано с целью упростить и облегчить процесс обмена рабочими данными и документами между разнородным программным обеспечением различных организаций.
Примечание:
* Группа компаний "Блик", г. Королев, Октябрьский б-р, д. 14, оф. 9, тел (495) 585-06-80.
Создает объект агрегатного типа данных и возвращает ссылку на него.
Англоязычный синоним:
Строковое выражение, значение которого содержит имя агрегатного типа данных, объявленного в конфигураторе.
Возвращаемое значение:
Ссылка на созданный объект агрегатного типа данных.
Функция СоздатьОбъект создает объект агрегатного типа данных и возвращает ссылку на него. Данная функция обычно используется одновременно с неявным определением переменной и присвоением ей ссылки на объект агрегатного типа данных.
Замечание. Объекты, такие как документ и справочник, созданные при помощи функции СоздатьОбъект , изначально не определены, т. е. не содержат никакого значения. Чтобы начать с ними работать, их предварительно надо позиционировать (установить на конкретный документ или элемент справочника). Для документов позиционирование выполняется при помощи методов НайтиДокумент , НайтиПоНомеру , ПолучитьДокумент . Для справочников позиционирование выполняется при помощи методов НайтиЭлемент , НайтиПоКоду , ПолучитьЭлемент .
СтатусВозврата
Установить/определить статуса возврата предопределенной процедуры.
Англоязычный синоним:
Необязательный параметр. Числовое выражение. Если задано значение 1, то устанавливается статус возврата — Выполнить Действие. Если задано значение 0, то устанавливается статус возврата — Отменить Действие. Если параметр опущен, то статус возврата предопределенной процедуры не меняется.
Возвращаемое значение:
Число 1 — если статус возврата — Выполнить Действие;
Число 0 — если статус возврата — Отменить Действие.
Применять функцию СтатусВозврата имеет смысл только в теле предопределенных процедур. При помощи функции СтатусВозврата можно установить или прочитать текущее значение статуса возврата конкретной предопределенной процедуры, где была вызвана данная функция.
Значение статуса возврата предопределенной процедуры используется системой при завершении отработки любой предопределенной процедуры, чтобы определить, выполнять ли системно событие, которое вызвало данную предопределенную процедуру.
Замечание: Начальное значение статуса возврата предопределенной процедуры равно 1 (Выполнить Действие), которое устанавливается системой при вызове предопределенной процедуры.
В тексте программного модуля возможно использование данного оператора как процедуры или как функции. При использовании в качестве функции, возвращаемое значение соответствует текущему статусу возврата предопределенной процедуры, которое было до вызова данной функции. В данном случае параметр < Статус > можно опускать.
Если параметр < Статус > задан явно, то после выполнения данной функции статус возврата установится в заданное значение. Пример:
* Если в предопределенной процедуре ПриЗаписи установить статус возврата — 0 (например, если неверно заполнены реквизиты), то документ не будет записываться.
Если Клиент.Выбран() = 0 Тогда
Предупреждение("Запись отменена! Не задан клиент!");
* Если в предопределенной процедуре ВводНаОсновании установить статус возврата — 0, то ввод нового документа будет отменен и форма нового документа не откроется.
Если (ДокВид = "Счет") ИЛИ (ДокВид = "Счет_фактура")
ИЛИ (ДокВид = "РасходнаяКредит") ИЛИ (ДокВид = РасходнаяРеализ") Тогда
Основание = ДокВид + " № " + ДокОснование.НомерДок;
Предупреждение("Недопустимый вид документа основания!");
См. также: «Системные предопределенные процедуры»
ОткрытьФорму
Выполняет открытие формы из'встроенного языка.
ОткрытьФорму (<Параметр1>, <КонтекстФормы>, < Параметр 3>. )
Англоязычный синоним:
В зависимости от типа открываемой формы используется различные значения данного параметра.
Необязательный параметр. Имя переменной, куда можно задать значение любого типа для передачи в открываемую форму. Данное значение будет доступно в открытой форме как атрибут Форма.Параметр.
После исполнения данного метода система вернет в данную переменную контекст открытой формы (см. Передача контекста в качестве параметра). С помощью значения этого контекста можно затем произвольно манипулировать открытой формой, пока она открыта. Пока форма открыта, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта — 0.
В зависимости от типа открываемой формы используется различный состав и значения остальных параметров.
Возвращаемое значение:
Число 1 — если действие выполнено;
Число 0 — если действие не выполнено.
Функция ОткрытьФорму позволяет открыть форму документа, справочника, журнала документов, и других форм используемых в системе 1С:Предприятие.
Замечание. Метод ОткрытьФорму нельзя вызывать в «теле» глобального модуля (части глобального модуля, расположенной после последней процедуры). Для его вызова при старте программы следует размещать его в процедуре ПриНачалеРаботыСистемы .
Для открытия разных форм следует использовать разный синтаксис вызова данной функции:
Открытие формы существующего документа.
ОткрытьФорму(<Документ>, <КонтекстФормы>, <РежимПросмотра>)
Значение типа «Документ».
Необязательный параметр. Числовое выражение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотренный текущим значением параметра «Режим открытия объектов» установленного пользователем. По умолчанию — 0.
Открытие формы нового документа
ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <ДокументОснование>)
"Документ.ХХХХХ", где ХХХХХ — идентификатор вида документа;
Необязательный параметр. Выражение типа «документ», задающий документ-основание для открытия формы ввода нового документа в режиме ввода на основании.
Открытие формы журнала документов.
"Журнал . ХХХХХ. YYYYY", где ХХХХХ — идентификатор журнала документов; YYYYY — идентификатор формы журнала документов;
Кроме того, в качестве идентификатора журнала можно указывать идентификатор конкретного вида документа, тогда откроется журнал просмотра документов именно указанного вида, например:
Открытие формы журнала подчиненных документов.
ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <Документ>)
Строковое выражение. "Журнал.Подчиненные";
Значение типа «документ», задающее документ, для которого будут выводиться подчиненные документы.
Открытие формы существующего элемента справочника.
ОткрытьФорму(<Элемент>, <КонтекстФормы>, <РежимПросмотра>)
Значение типа «Справочник».
Необязательный параметр. Числовое выражение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотренный текущим значением параметра «Режим открытия объектов» установленного пользователем. По умолчанию — 0.
Открытие формы нового элемента справочника.
ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы> , <ГруппаРодитель>,
"Элемент. ХХХХХ", где ХХХХХ — вид справочника;
Необязательный параметр. Выражение типа «справочник», задающий родительскую группу для открытия формы ввода нового элемента (группы) справочника.
Необязательный параметр. Числовое выражение, задающее форму ввода нового элемента (группы) справочника: 1 — ввод новой группы, 0 — ввод нового элемента. По умолчанию — 0.
Необязательный параметр. Выражение типа «справочник», задающий элемент справочника-владельца для открытия формы ввода нового элемента (группы) подчиненного справочника.
Открытие формы списка справочника.
"Справочник.ХХХХХ.YYYYY", где ХХХХХ — вид справочника, YYYYY — имя выбранной формы списка справочника;
Открытие формы отчета.
Строковое выражение. "Отчет. ХХХХХ" , где ХХХХХ — вид отчета;
Открытие формы обработки.
Строковое выражение. "Обработка.ХХХХХ", где ХХХХХ — вид обработки;
Открытие формы внешнего отчета.
ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <ИмяФайла>)
Строковое выражение. "Отчет";
Строковое выражение — полное имя файла внешнего отчета.
Открытие формы журнала расчетов.
"ЖурналРасчетов. ХХХХХ", где ХХХХХ — вид журнала расчетов;
Открытие формы существующего счета.
ОткрытьФорму(<Счет>, <КонтекстФормы>, <РежимПросмотра>)
Значение типа «Счет».
Необязательный параметр. Числовое выражение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотренный текущим значением параметра «Режим открытия объектов» установленного пользователем. По умолчанию — 0.
Открытие формы нового счета.
"Счет. ХХХХХ" , где ХХХХХ — идентификатор плана счетов;
Открытие формы списка счетов (плана счетов).
"ПланСчетов.ХХХХ.YYYY", где ХХХХХ — идентификатор плана счетов; YYYYY — идентификатор формы плана счетов.
Открытие формы существующей операции.
ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <Документ>, <Проводка>,
Строковое выражение. "Операция".
Значение типа «документ», операция которого будет открываться.
Необязательный параметр. Числовое выражение — номер проводки, на которую нужно позиционировать курсор при открытии операции.
Необязательный параметр. Числовое выражение — номер корреспонденции указанной проводки, на которую нужно позиционировать курсор при открытии операции.
Необязательный параметр. Числовое выражение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотренный текущим значением параметра «Режим открытия объектов» установленного пользователем. По умолчанию — 0.
Открытие формы ввода новой операции.
ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <ТиповаяОперация>)
Строковое выражение. "Операция".
Необязательный параметр. Строковое выражение — наименование типовой операции, которую следует использовать при вводе новой операции. Если значение не задано или пустое, то ввод операции выполняется без использования типовой.
Открытие формы журнала операций.
ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <Документ>, <Пров>, <Корр>)
"ЖурналОпераций.YYYYY", где YYYYY — идентификатор формы журнала операций;
Значение типа «документ», операция которого будет использована для первоначального позиционирования.
Номер проводки, которая будет использована для первоначального позиционирования курсора, если в журнале операций используется режим показа проводок.
Номер корреспонденции, которая будет использована для первоначального позиционирования курсора, если в журнале операций используется режим показа проводок.
Открытие формы журнала проводок.
ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <Документ>, <Проводка>,
"ЖурналПроводок.YYYYY", где YYYYY — идентификатор формы журнала проводок;
Значение типа «документ», операция которого будет использована для первоначального позиционирования.
Необязательный параметр. Числовое выражение — номер проводки операции, на которую нужно в начале позиционироваться.
Необязательный параметр. Числовое выражение — номер корреспонденции указанной проводки, на которую нужно в начале позиционироваться.
Открытие окна истории значений периодических констант, реквизитов справочников и счетов.
ОткрытьФорму("История.Счет", , <Счет>, <УстНаДату>)
Идентификатор периодической константы, как он задан в конфигураторе.
Идентификатор справочника, как он задан в конфигураторе.
Идентификатор периодического реквизита справочника, как он задан в конфигураторе.
Элемент справочника, для периодического реквизита которого открывается окно истории значений.
Счет, для которого открывается окно истории значений.
Необязательный параметр. Дата, на которую нужно установить курсор при открытии окна.
ОткрытьФормуМодально
Выполняет открытие модальной формы из встроенного языка.
ОткрытьФормуМодально(<Параметр1>, <КонтекстФормы>, <ПараметрЗ>. )
Англоязычный синоним:
Параметры: см. параметры метода ОткрытьФорму
Возвращаемое значение: см. метод ОткрытьФорму .
Функция ОткрытьФормуМодально позволяет открыть модальную форму документа, справочника, журнала документов, и других форм используемых в системе 1С:Предприятие. Синтаксис и описание см. метод ОткрытьФорму .
См. также: ОткрытьФорму
ТипЗначения
Получить тип значения данных.
Англоязычный синоним:
< 3начение > Выражение, тип данных значения которого надо определить.
Возвращаемое значение:
Функция возвращает числовое значение:
0 — неопределенный тип данных;
1 — числовой тип данных;
2 — строковый тип данных;
3 — тип данных — дата;
10 — агрегатный тип данных «Перечисление»;
11 — агрегатный тип данных «Справочник»;
12 — агрегатный тип данных «Документ»;
13 — агрегатный тип данных «Календарь»;
14 — агрегатный тип данных «ВидРасчета»;
15 — агрегатный тип данных «Счет»;
16 — агрегатный тип данных «ВидСубконто»;
17 — агрегатный тип данных «ПланСчетов»;
100 — так называемый внешний объект. В этот класс попадают все агрегатные объекты, не вошедшие в вышеперечисленный список, такие как «Текст», «Таблица», «Запрос», «ЖурналРасчетов» и т. п.
Функция ТипЗначения определяет, к какому типу данных принадлежит переданный параметр < 3начение > и возвращает числовой результат:
Если ТипЗначения(Код)<>1 Тогда
Предупреждение("Код имеет не числовой тип . ");
ТипЗначенияСтр
Получить строковое обозначение типа данных.
Англоязычный синоним:
< 3начение > Выражение, тип данных значения которого надо определить.
Возвращаемое значение:
Функция возвращает строковое значение в русскоязычном или в англоязычном написании — в зависимости от текущей установки основного языка конфигурации:
Читайте также: