Библиотека алгоритмов - История изменений

Харин Владимир: /* Разработка библиотек алгоритмов */

2017-11-22T12:38:40Z

‎Разработка библиотек алгоритмов

Харин Владимир в 12:32, 22 ноября 2017

2017-11-22T12:32:11Z

Харин Владимир в 12:31, 22 ноября 2017

2017-11-22T12:31:18Z

Харин Владимир в 12:29, 22 ноября 2017

2017-11-22T12:29:44Z

Харина Александра в 07:23, 15 ноября 2017

2017-11-15T07:23:04Z

Харина Александра в 07:12, 15 ноября 2017

2017-11-15T07:12:08Z

Харина Александра в 07:08, 15 ноября 2017

2017-11-15T07:08:53Z

Харина Александра в 06:39, 15 ноября 2017

2017-11-15T06:39:09Z

Харина Александра в 06:37, 15 ноября 2017

2017-11-15T06:37:18Z

Харина Александра: Новая страница: «Библиотека алгоритмов представляет собой список алгоритмов - блоков программного кода…»

2017-11-15T06:33:47Z

Новая страница: «Библиотека алгоритмов представляет собой список алгоритмов - блоков программного кода…»

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

Библиотека алгоритмов представляет собой список алгоритмов - блоков программного кода на встроенном языке 1С. К алгоритмам можно обращаться из правил заполнения шаблонов. Алгоритмы используются в ситуациях, когда невозможно извлечь необходимые для заполнения шаблона данные стандартными средствами (через укаказние поля объекта).

Каждый алгоритм библиотеки имеет имя, и описывается программным кодом на встроенном языке 1С.

На закладке "Алгоритмы" в верхней части формы - список алгоритмов, а ниже - программный код выбранного алгоритма.

Редактирование алгоритмов доступно только под полными правами.

На закладке "Описание" - текстовое описание библиотеки алгоритмов.

Использование библиотек алгоритмов
Библиотеки алгоритмов можно сравнить с общими модулями в структуре конфигурации 1С, а отдельные алгоритмы - с функциями. Использование библиотек алгоритмов позволяет

- упростить описание правил заполнения шаблонов (при описании способа заполнения закладки не нужно будет каждый раз писать программный код алгоритма получения данных - достаточно указать библиотеку и алгоритм);

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

Алгоритмы выполняются на сервере. Контекст алгоритма библиотеки содержит следующие переменные:

- Результат - в эту переменную должен быть присвоен результат выполнения алгоритма;

- Объект - ссылка на объект информационной базы 1С, на основе которого заполняется шаблон;

- ПараметрАлгоритма - произвольный параметр, обычно строковый, который может быть передан алгоритму;

- кэш - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);

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

Алгоритм библиотеки может быть вызван из другого алгоритма путем следующей строки кода:

РезультатВыполненияАлгоритма = ПолучитьРезультатВыполненияАлгоритмаБиблиотеки(Библиотека, ИмяАлгоритма, ПараметрАлгоритма, Объект)

где

- Библиотека - имя библиотеки алгоритмов;

- ИмяАлгоритма - имя алгоритма внутри указанной библиотеки;

- ПараметрАлгоритма - произвольный параметр, передаваемый алгоритму (параметр передается по значению);

- Объект - обычно в данный параметр передается ссылка на объект 1С, на основе которого заполняется шаблон (если объект не нужен, то можно, например, передать Неопределено).

← Предыдущая		Версия 12:38, 22 ноября 2017
Строка 19:		Строка 19:
	* сделать программный код подготовки данных для заполнения шаблонов более модульным (возможен вызов одного алгоритма из другого как функции).		* сделать программный код подготовки данных для заполнения шаблонов более модульным (возможен вызов одного алгоритма из другого как функции).

−	~~Алгоритмы выполняются на сервере. Контекст алгоритма библиотеки содержит следующие переменные:~~	+	Подробнее о разработке алгоритмов см. раздел [[Разработка_алгоритмов\|Разработка алгоритмов]].
−
−	* '''Результат''' - в эту переменную должен быть присвоен результат выполнения алгоритма;
−	* '''Объект''' - ссылка на объект информационной базы 1С, на основе которого заполняется шаблон;
−	* '''ПараметрАлгоритма''' - произвольный параметр, обычно строковый, который может быть передан алгоритму;
−	* '''кэш''' - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
−	* '''текВалюта''' - данную переменную желательно устанавливать в случаях, когда алгоритм возвращает суммовые данные (в рублях или в валюте). Это позволит корректно выводить эту сумму прописью (см. о [[~~Форматирование_значений_закладок~~\|~~форматировании~~]]).
−
−	~~Алгоритм библиотеки может быть вызван из другого алгоритма путем следующей строки кода:~~
−
−	<code>РезультатВыполненияАлгоритма = ПолучитьРезультатВыполненияАлгоритмаБиблиотеки(Библиотека, ИмяАлгоритма, ПараметрАлгоритма, Объект)</code>
−
−	~~где~~
−
−	*'''Библиотека''' - имя библиотеки алгоритмов;
−	*'''ИмяАлгоритма''' - имя алгоритма внутри указанной библиотеки;
−	*'''ПараметрАлгоритма''' - произвольный параметр, передаваемый алгоритму (параметр передается по значению);
−	*'''Объект''' - обычно в данный параметр передается ссылка на объект 1С, на основе которого заполняется шаблон (если объект не нужен, то можно, например, передать Неопределено).

← Предыдущая		Версия 12:32, 22 ноября 2017
Строка 10:		Строка 10:

	На закладке "Описание" - текстовое описание библиотеки алгоритмов.		На закладке "Описание" - текстовое описание библиотеки алгоритмов.
		+
		+	== Разработка библиотек алгоритмов ==

	<span style="color:#ff0000">Информация для технических специалистов (программисты, консультанты, администраторы)</span>		<span style="color:#ff0000">Информация для технических специалистов (программисты, консультанты, администраторы)</span>

@@ Строка 23: / Строка 23: @@
 * '''ПараметрАлгоритма''' - произвольный параметр, обычно строковый, который может быть передан алгоритму;
 * '''кэш''' - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
-* '''текВалюта''' - данную переменную желательно устанавливать в случаях, когда алгоритм возвращает суммовые данные (в рублях или в валюте). Это позволит корректно выводить эту сумму прописью (см. о форматировании в разделе о [[Правила_заполнения_шаблонов|правилах заполнения]]).
+* '''текВалюта''' - данную переменную желательно устанавливать в случаях, когда алгоритм возвращает суммовые данные (в рублях или в валюте). Это позволит корректно выводить эту сумму прописью (см. о [[Форматирование_значений_закладок|форматировании]]).
 Алгоритм библиотеки может быть вызван из другого алгоритма путем следующей строки кода:

@@ Строка 1: / Строка 1: @@
-Библиотека алгоритмов представляет собой список алгоритмов - блоков программного кода на встроенном языке 1С. К алгоритмам можно обращаться из [[Правила_заполнения|правил заполнения]] шаблонов. Алгоритмы используются в ситуациях, когда невозможно извлечь необходимые для заполнения шаблона данные  стандартными средствами (через укаказние поля объекта).
+Библиотека алгоритмов представляет собой список алгоритмов - блоков программного кода на встроенном языке 1С. К алгоритмам можно обращаться из [[Правила_заполнения_шаблонов|правил заполнения шаблонов]]. Алгоритмы используются в ситуациях, когда невозможно извлечь необходимые для заполнения шаблона данные  стандартными средствами (через укаказние поля объекта).
 Каждый алгоритм библиотеки имеет имя, и описывается программным кодом на встроенном языке 1С.
@@ Строка 13: / Строка 13: @@
 Использование библиотек алгоритмов
 Библиотеки алгоритмов можно сравнить с общими модулями в структуре конфигурации 1С, а отдельные алгоритмы - с функциями. Использование библиотек алгоритмов позволяет
-* упростить описание [[Правила_заполнения|правил заполнения]] шаблонов (при описании способа заполнения закладки не нужно будет каждый раз писать программный код алгоритма получения данных - достаточно указать библиотеку и алгоритм);
+* упростить описание [[Правила_заполнения_шаблонов|правил заполнения шаблонов]] (при описании способа заполнения закладки не нужно будет каждый раз писать программный код алгоритма получения данных - достаточно указать библиотеку и алгоритм);
 * сделать программный код подготовки данных для заполнения шаблонов более модульным (возможен вызов одного алгоритма из другого как функции).
@@ Строка 22: / Строка 22: @@
 * '''ПараметрАлгоритма''' - произвольный параметр, обычно строковый, который может быть передан алгоритму;
 * '''кэш''' - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
-* '''текВалюта''' - данную переменную желательно устанавливать в случаях, когда алгоритм возвращает суммовые данные (в рублях или в валюте). Это позволит корректно выводить эту сумму прописью (см. о форматировании в разделе о [[Правила_заполнения|правилах заполнения]]).
+* '''текВалюта''' - данную переменную желательно устанавливать в случаях, когда алгоритм возвращает суммовые данные (в рублях или в валюте). Это позволит корректно выводить эту сумму прописью (см. о форматировании в разделе о [[Правила_заполнения_шаблонов|правилах заполнения]]).
 Алгоритм библиотеки может быть вызван из другого алгоритма путем следующей строки кода:

@@ Строка 1: / Строка 1: @@
-Библиотека алгоритмов представляет собой список алгоритмов - блоков программного кода на встроенном языке 1С. К алгоритмам можно обращаться из правил заполнения шаблонов. Алгоритмы используются в ситуациях, когда невозможно извлечь необходимые для заполнения шаблона данные  стандартными средствами (через укаказние поля объекта).
+Библиотека алгоритмов представляет собой список алгоритмов - блоков программного кода на встроенном языке 1С. К алгоритмам можно обращаться из [[Правила_заполнения|правил заполнения]] шаблонов. Алгоритмы используются в ситуациях, когда невозможно извлечь необходимые для заполнения шаблона данные  стандартными средствами (через укаказние поля объекта).
 Каждый алгоритм библиотеки имеет имя, и описывается программным кодом на встроенном языке 1С.
@@ Строка 13: / Строка 13: @@
 Использование библиотек алгоритмов
 Библиотеки алгоритмов можно сравнить с общими модулями в структуре конфигурации 1С, а отдельные алгоритмы - с функциями. Использование библиотек алгоритмов позволяет
-* упростить описание правил заполнения шаблонов (при описании способа заполнения закладки не нужно будет каждый раз писать программный код алгоритма получения данных - достаточно указать библиотеку и алгоритм);
+* упростить описание [[Правила_заполнения|правил заполнения]] шаблонов (при описании способа заполнения закладки не нужно будет каждый раз писать программный код алгоритма получения данных - достаточно указать библиотеку и алгоритм);
 * сделать программный код подготовки данных для заполнения шаблонов более модульным (возможен вызов одного алгоритма из другого как функции).
@@ Строка 22: / Строка 22: @@
 * '''ПараметрАлгоритма''' - произвольный параметр, обычно строковый, который может быть передан алгоритму;
 * '''кэш''' - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
-* '''текВалюта''' - данную переменную желательно устанавливать в случаях, когда алгоритм возвращает суммовые данные (в рублях или в валюте). Это позволит корректно выводить эту сумму прописью (см. о форматировании в разделе о правилах заполнения).
+* '''текВалюта''' - данную переменную желательно устанавливать в случаях, когда алгоритм возвращает суммовые данные (в рублях или в валюте). Это позволит корректно выводить эту сумму прописью (см. о форматировании в разделе о [[Правила_заполнения|правилах заполнения]]).
 Алгоритм библиотеки может быть вызван из другого алгоритма путем следующей строки кода:
@@ Строка 30: / Строка 30: @@
 где
-*Библиотека - имя библиотеки алгоритмов;
+*'''Библиотека''' - имя библиотеки алгоритмов;
+*'''ИмяАлгоритма''' - имя алгоритма внутри указанной библиотеки;
-*ИмяАлгоритма - имя алгоритма внутри указанной библиотеки;
+*'''ПараметрАлгоритма''' - произвольный параметр, передаваемый алгоритму (параметр передается по значению);
+*'''Объект''' - обычно в данный параметр передается ссылка на объект 1С, на основе которого заполняется шаблон (если объект не нужен, то можно, например, передать Неопределено).

@@ Строка 19: / Строка 19: @@
 * '''Результат''' - в эту переменную должен быть присвоен результат выполнения алгоритма;
 * '''Объект''' - ссылка на объект информационной базы 1С, на основе которого заполняется шаблон;
 * '''ПараметрАлгоритма''' - произвольный параметр, обычно строковый, который может быть передан алгоритму;
 * '''кэш''' - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
 * '''текВалюта''' - данную переменную желательно устанавливать в случаях, когда алгоритм возвращает суммовые данные (в рублях или в валюте). Это позволит корректно выводить эту сумму прописью (см. о форматировании в разделе о правилах заполнения).
 Алгоритм библиотеки может быть вызван из другого алгоритма путем следующей строки кода:
-РезультатВыполненияАлгоритма = ПолучитьРезультатВыполненияАлгоритмаБиблиотеки(Библиотека, ИмяАлгоритма, ПараметрАлгоритма, Объект)
+<code>РезультатВыполненияАлгоритма = ПолучитьРезультатВыполненияАлгоритмаБиблиотеки(Библиотека, ИмяАлгоритма, ПараметрАлгоритма, Объект)</code>
 где
-- Библиотека - имя библиотеки алгоритмов;
+*Библиотека - имя библиотеки алгоритмов;
-- ИмяАлгоритма - имя алгоритма внутри указанной библиотеки;
+*ИмяАлгоритма - имя алгоритма внутри указанной библиотеки;
-- ПараметрАлгоритма - произвольный параметр, передаваемый алгоритму (параметр передается по значению);
+*ПараметрАлгоритма - произвольный параметр, передаваемый алгоритму (параметр передается по значению);
-- Объект - обычно в данный параметр передается ссылка на объект 1С, на основе которого заполняется шаблон (если объект не нужен, то можно, например, передать Неопределено).
+*Объект - обычно в данный параметр передается ссылка на объект 1С, на основе которого заполняется шаблон (если объект не нужен, то можно, например, передать Неопределено).

@@ Строка 3: / Строка 3: @@
 Каждый алгоритм библиотеки имеет имя, и описывается программным кодом на встроенном языке 1С.
+[[File:Alglib.png|Библиотека алгоритмов]]
 На закладке "Алгоритмы" в верхней части формы - список алгоритмов, а ниже - программный код выбранного алгоритма.