1с підприємство 8.2 прості приклади. Чим завантажувані товари краще

Електронна книга розповсюджується у вигляді архіву, що містить:

• виконуваний exe-файл, який включає в себе як саму книгу, так і програму SunRav BookReader, призначену для перегляду цієї книги
• каталог з додатковими матеріалами до книги.
• книга призначена для читання під ОС Windows

Книга 1С: Підприємство 8.1. Прості приклади розробки   являє собою довідковий посібник, що ілюструє прості приклади розробки алгоритмів на платформі 1С: Підприємство 8.1.

Видання буде корисним початківцям розробникам, адміністраторам, у яких на підприємстві впроваджується система, і просунутим користувачам, які хочуть самостійно допрацьовувати прикладні рішення.

книга 1С: Підприємство 8.1. Прості приклади розробки   містить велику кількість практичних прикладів, згрупованих за тематикою використання.

На допомогу розробникам прикладних рішень до книги додаються коди описаних прикладів. Код прикладів представлений у вигляді файлу шаблонів тексту 1С: Підприємство 8. Цей файл можна підключити до будь-якої конфігурації і перетягувати приклади мишею чи вставляти їх в модуль, використовуючи автозаміну.

Після підтвердження оплати книги ви отримаєте:

* Файли.epub на комп'ютері рекомендується читати з використанням програми для читання Adobe Digital Editions. При читанні за допомогою інших програм не рекомендується використовувати режим перегляду, який передбачає показ двох сторінок одночасно - в зв'язку з великою кількістю зображень можливе некоректне відображення.

Чим завантажувані товари краще?

Не треба платити за доставку, ви отримуєте журнал в пару кліків в будь-який час доби;

Швидкість скачування залежить тільки від можливостей вашого підключення, менеджери закачування підтримуються;

При виникненні проблем з отриманням покупки ви можете звернутися до наших онлайн-консультантам;

А.П. Габец, Д.І. Гончаров 1С: Підприємство 8.0 Прості приклади розробки Москва ТОВ «1С-Паблішинг" 2005 УДК 658.012.011.56:004.42 ББК 65.29 Г12 Габец Андрій Петрович, Гончаров Дмитро Ігорович Г12 1С: Підприємство 8.0. Прості приклади М .: ТОВ «1С-Паблішинг», 2005. - 420 с: ил. розробки, ISBN 5-9677-0056-0 Книга являє собою довідковий посібник, що ілюструє прості приклади розробки алгоритмів на платформі «1С: Підприємство 8.0». Видання буде корисним початківцям розробникам, адміністраторам, у яких на підприємстві впроваджується система, і просунутим користувачам, які хочуть самостійно допрацьовувати прикладні рішення. Книга містить велику кількість практичних прикладів, згрупованих за тематикою використання. Крім цього книга містить докладний покажчик на використовувані в прикладах властивості, методи і події вбудованої мови. Дана книга доповнює, але не замінює штатну документацію до програмного продукту, що входить в комплект поставки, і дозволяє більш ефективно використовувати можливості програми. Під редакцією М.Г. Радченко. 4601546 025616 ISBN 5-9677-0056-0 Право тиражування і розповсюдження книги належить фірмі "1С-Паблішинг". При повному або частковому використанні матеріалів книги без письмового дозволу фірми "1С-Паблішинг" забороняється. ТОВ "1С-Па6лішінгм, 2005 ЗМІСТ Введення 16 Як працювати з виданням? Примітивні типи, системні функції 17 18 (D Як явно вказати потрібну дату? Як перевірити дату на порожнє значення? Як порівняти дві дати (дні)? Як додати до дати день , місяць? Як можна перевірити тип значення змінної на рівність потрібного? Як очистити реквізит форми, що має контрольний тип? Як очистити значення, яке має тип «Сховище значення»? Як перевірити тип значення, який міститься в реквізит має тип «Сховище значення»? Як стиснути дані, що поміщаються в сховище зна ия? Як надати користувачеві можливість вибору значення складеного типу? Як застосувати округлення при роботі з обчислюються числовими полями в запиті? Як вивести многострочное попередження? Як при виконанні обробки повідомити користувачеві даний час? Як вивести число прописом по-російськи, але без дробової частини? як вивести число прописом по-російськи, з зазначенням сотих в дробової частини? як вивести прописом число кілограмів із зазначенням дробової частини в грамах? Як доларову суму вивести прописом по-англійськи? Як завантажити зовнішню компоненту? Як виконати команду операційної системи? Як реалізувати код процедури в залежності від режиму виконання (на клієнті, на сервері, в зовнішньому з'єднанні)? Як при груповій обробці об'єктів реалізувати стратегію «або все, або нічого»? Як порахувати суму за формулою складного відсотка? Універсальні колекції Масив (D В яких ситуаціях зазвичай використовуються масиви? ® Як створити масив? Ф Як створити багатовимірний масив? Ф Як додати елементи в масив? 18 18 19 19 20 21 21 21 22 23 24 24 25 25 26 27 27 27 28 29 30 31 32 32 32 32 33 34 Зміст ф Як визначити розмір масиву? ф Як звернутися до елементу масиву? ® Як перебрати елементи масиву? ф Як видалити елемент масиву? ф Як видалити всі елементи масиву? Як видалити повторювані елементи масиву? Як скопіювати масив ? Як перевірити, що два масиви ідентичні? У масив вивантажені дані, що містять н аіменованія контрагентів. Як їх впорядкувати? Є масив, в який вивантажені значення типу СправочнікСсилка.Номенклатура. Як видалити всі порожні значення масиву? Як отримати масив номенклатурних позицій, використаних в табличних частинах «Номенклатура» і «Тара» накладної? Є дві таблиці значень. як отримати масив співпадаючих імен колонок? як в запиті зробити відбір за кількома варіантами заповнення реквізиту типу «ПеречісленіеСсилка»? Як з регістра відомостей «РасчетчікіЗарплатиОрганізаціі» отримати у вигляді масиву всіх розраховувачів зарплати певного підрозділу організації? Структура Ф В яких ситуаціях зазвичай використовуються об'єкти типу «Структура»? ф Як створити структуру? ф Як додати елементи в структуру? Ф Як звернутися до елементу структури? ф Як перебрати елементи структури? ф Як видалити елемент структури? Як в структурі встановити значення для елемента з певним ключем? Як отримати в структуру багатовимірні дані? Як зібрати інформацію за встановленими в формі журналу відбором? Як визначити, чи є в структурі елемент з ключем «Контрагент», і якщо є, але містить пусте значення довідника або Не визначено - видалити цей елемент? Як з табличній частині «Товари» документа отримати всі рядки, де значення реквізиту «Ціна» дорівнює нулю, а значення реквізиту «СтавкаНДС» дорівнює значенню «ПДВ 18» перерахування «СтавкіНДС»? Як отримати дані про поточну облікову політику бухгалтерського обліку організації з періодичного регістра відомостей на задану дату? Як сформувати структуру назв реквізитів табличній частині довільного документа? Як отримати запитом дані табличній частині документа, маючи структуру назв реквізитів табличній частині? Відповідність 34 34 35 36 37 37 38 39 40 41 42 43 44 45 47 47 47 48 48 49 50 50 51 52 53 53 55 55 57 Зміст ф В яких ситуаціях зазвичай використовуються об'єкти типу «Відповідність»? ф Як створити відповідність? ф Як додати елементи у відповідність? ф Як звернутися до елементу відповідності? Ф Як перебрати елементи відповідності? ф Як видалити елемент відповідності? Як отримати дані з відповідності? Як отримати багаторівневе відповідність видів розрахунків, що володіють базовими видами розрахунків? 57 57 57 58 58 59 59 60 Список значень, таблиця значень, дерево значень 63 ф В яких ситуаціях зазвичай використовуються списки значень, таблиці значень, дерево значень? ф Як створити список значень? ф Як додати елементи в список значень? ф Як знайти елемент списку значень? ф Як звернутися до елементу списку значень? ф Як перебрати елементи списку значень? ф Як видалити елемент списку значень? ф Як створити таблицю значень і заповнити її поля? ф Як знайти значення в таблиці значень? ® Як перебрати рядки таблиці значень? ф Як видалити рядки (колонки) таблиці значень? Як заповнити таблицю значень, якщо імена колонок містяться в змінних? Як заповнити всю колонку таблиці значень потрібним значенням? Як таблицю значень «ТабліцаПолучатель» заповнити даними таблиці значень «ІсходнаяТабліца»? Як додати колонки до таблиці значень «ТабліцаЗначеній» з обмеженнями по типу? Як змінити тип значення колонки таблиці значень, отриманої вивантаженням із запиту? Як самостійно заповнити дерево значень? Прикладні об'єкти Довідники Ф Як створити елемент (групу) довідника? ф Як знайти елемент довідника? ф Як видалити елемент довідника? ф Як перебрати елементи довідника? ф Як вибрати всі елементи з певної групи? Ф Як перебрати елементи підлеглого довідника за допомогою запиту? Ф Як перебрати елементи підлеглого довідника за допомогою вибірки довідника? ф Як відкрити форму списку (елементу) довідника? 63 64 64 65 65 66 66 67 68 69 69 71 71 72 74 75 76 78 78 78 80 81 82 83 85 86 86 Зміст ф Як додати запис в табличну частину елемента довідника? ф Як видалити рядки з табличній частині довідника? Ф Як перебрати рядки табличній частини довідника? Ф Як створити елемент в потрібній групі? Як дізнатися, чи є у поточного елемента підлеглі? Як дізнатися кількість підлеглих елементів у обраного елемента довідника? Як дізнатися кількість підлеглих елементів у обраного елемента довідника, якщо кількість підлеглих довідників більше ніж один? Як отримати всіх батьків обраного елемента довідника? Як отримати запитом «повний» код елементів довідника, якщо тип коду - Рядок? Як отримати всі елементи довідника, що містять в найменуванні певну підрядок, з усією ієрархією, в яку вони входять? Як знайти всі елементи довідника, в яких не заповнений строковий реквізит? Як перенести всі елементи довідника «Контрагенти» з однієї групи в іншу? Як організувати програмний вибір елемента довідника? Як зберегти фотографію співробітника в довіднику «Співробітники»? Документи ® Як створити новий документ? ф Як знайти документ? Ф Як відкрити форму документа? ф Як змінити значення реквізиту і записати документ? Ф Як додати рядок в табличну частину документа, маючи посилання на документ? ф Як видалити рядки з табличній частині документа? ф Як перебрати рядки документа? ф Як вивантажити табличну частину документа? ф Як порахувати підсумок в табличній частині документа? ф Як провести документ? ф Як перебрати документи? ф Як позначити на видалення всі прибуткові накладні? ф Як, маючи посилання на документ, створити в базі його копію? ф Як, маючи посилання на документ, прочитати його руху по регістру? Як визначити, по яким регістрів документ виконав руху? Як в табличній частині документа видалити рядки з нульовим значенням реквізиту «Кількість»? Як очистити колонку «СтавкаНДС» в табличному полі «Товари» вже заповненого документа? Як заповнити значення властивостей нового документа на підставі існуючого? 87 87 88 89 90 91 93 94 96 97 98 99 100 102 104 104 104 105 106 107 107 108 108 108 109 109 111 111 112 113 115 116 117 Зміст Як отримати перелік прибуткових накладних, в яких не заповнені номенклатурні позиції? Як на дату видаткової накладної визначити курс валюти управлінського обліку? Валюта управлінського обліку зберігатися в періодичному регістрі відомостей Як з форми документа викликати його неоперативне проведення? Як в обробці проведення отримати залишки, актуальні на позицію документа? Як визначити кількість документів і кількість різних значень реквізиту в таблиці записів документа? У послідовність «ПартіоннийУчет» додано вимір «Організація». Як тепер отримати дані по межах послідовності для кожного значення цього виміру? Зберігання відомостей ® Як додати запис в неперіодична незалежний регістр відомостей? ф Як рахувати вміст непериодического незалежного регістра відомостей? «СобственниеКонтрагенти»? Ф Як видалити всі записи з незалежного регістра відомостей? ф Як видалити записи незалежного регістра відомостей з відбором по конкретної організації? ф Як додати запис в періодичний незалежний регістр відомостей? ф Як прочитати (змінити) записи в періодичному незалежному регістрі відомостей? ф Як видалити записи в періодичному незалежному регістрі відомостей? Як в періодичному незалежному регістрі відомостей «КурсиВалют» видалити всі записи по валютах з найменуваннями «EUR» і «USD», період яких менше 01 січня 2005 роки? Як прочитати дані, актуальні на певну дату, з регістра відомостей «Курси валют» з відбором по декількох валют (відбір за вимірюваннями)? Як поміняти період у записів періодичного незалежного регістра, що відповідають ряду умов? Як «зробити періодичним» реквізит вже заповненого довідника? ф Як додати записи в регістр відомостей, підлеглий реєстратору? ф Як прочитати (змінити) записи в регістрі відомостей, підпорядкованому реєстратору? ф Як видалити записи з реєстру відомостей, підлеглого реєстратору? Бухгалтерський облік Ф Як в регістрі бухгалтерії сформувати проводки? ф Як отримати залишок по рахунку? ф Як отримати обороти по рахунку? ф Як отримати залишки але рахунках? 118 119 120 121 122 123 124 124 125 126 126 127 128 128 129 131 132 134 137 138 139 140 140 142 143 143 Зміст Ф Як перенести залишок з рахунку на рахунок? Як знайти першу роботу, що призвів до появи кредитового залишку на рахунку? Як вибрати всі рахунки, в аналітиці яких присутні або вид субконто «Контрагент», або вид субконто «Договір»? Як вибрати всі рахунки, в аналітиці яких присутні як вид субконто «Контрагент», так і вид субконто «Номенклатура»? Як додати новий вид субконто до рахунку? Як з регістра бухгалтерії «Госпрозрахунковий» отримати обороти тільки по валютних рахунках? Як вибрати в регістрі бухгалтерії «Госпрозрахунковий» обороти по «60-их» рахунках, виключивши внутрішні обороти між ними? Як реалізувати метод «червоного сторно» для регістра бухгалтерії? Складні періодичні розрахунки (D Як отримати суму нарахування по конкретному виду розрахунку зазначеного співробітнику в зазначеному періоді? (D Як отримати суму всіх нарахувань вказаною співробітнику в зазначеному періоді? Як отримати таблицю перерахунків по перерахунках декількох регістрів? Як для документа «НачісленіеЗарплатиРаботнікам» визначити номери рядків записів повністю витіснених видів розрахунку? Як сформувати розрахунковий листок працівниці? Як організувати сторнування вже проведених розрахунків минулих періодів? Бізнес-ін оцессе Як визначити бізнес процес, в якому кількість послідовних етапів визначається індивідуально на момент старту примірника процесу? Як при роботі з бізнес процесами відмовитися від стандартного способу формування завдання і сформувати її програмно? Інші прикладні об'єкти ф Як, не відкриваючи форму зовнішньої обробки, виконати її процедуру для певного об'єкта? (D Як швидко отримати інформацію, по всіх об'єктах, що знаходяться в компетенції конкретного менеджера (елемент довідника «Користувачі») з продажу? Форми і елементи управління Робота з формами (D Як відкрити форму документа? Ф Як відкрити форму зовнішньої обробки? (D Як відрити форму звіту так, щоб вона не перекривала собою ту форму, з якої вона відкрита? 144 145 146 147 147 149 151 152 154 154 155 156 157 158 159 162 162 167 169 169 169 172 172 172 172 173 Зміст ® Як відкрити форму звіту на весь екран? Як з форми документа відкрити форму списку даного документа, спозіціоніро авшісь на ньому ж? ® В документі є реквізит «Контрагент». Як відкрити форму підлеглого йому довідника «ДоговориКонтрагентов»? ф Як в формі відобразити картинку, збережену в реквізиті довідника? ф Як в журналі документів «УчетКадров» відібрати тільки документи «ПріемНаРаботу» ? ф Як дізнатися інтервал дат у відкритому поточному журналі? Як при відкритті довідника зробити відбір по контрагентам, які входять в список? Як забезпечити, щоб для вибору значення покупця у видатковій накладній довідник контрагенти відкривався відразу з відкритою групою «Покупці»? Табличне поле ф Як заборонити користувачеві змінювати порядок слідування колонок в табличному полі? Ф Як заборонити користувачеві змінювати будь-які налаштування колонок табличного поля? ф Як вивести інформацію про те, який відбір встановлений в журналі документів? ф Як в формі довідника встановити курсор на елемент з відомим найменуванням? ф Як в формі списку зробити відбір за значенням реквізиту? ф Як заборонити видачу повідомлення: «Введені дані не відображені в списку, так як не відповідають відбору» при додаванні нових елементів в довідник? ф Як заповнити осередок табличного поля даними? Як змінити колір фону комірки табличного поля в залежності від значення, що виводиться в неї? Як в табличное поле «ВибранниеКонтрагенти» додати нову колонку «ОсновнойДоговор», заповнити її значення і дати можливість відкриття цих значень? Як задати список вибору для колонки «ВідДокумента» табличного поля? Як забезпечити можливість відбору і сортування даних за реквізитами, які не відображуваним в табличному полі форми списку довідника? Як реалізувати перетягування між елементами управління? Як вивести залишки на складах в списку номенклатури? Інші елементи керування ® В формі є панель зі сторінками. Як розмістити картинку на закладці? Ф Як забезпечити, щоб при відкритті форми вже записаного елемента довідника «Контрагенти» активною була закладка «СчетаІДоговори» панелі «Панель»? Як організувати вибір з кількох списків документів для відкриття? Як можна організувати підстановку звернення до персони? 173 174 175 176 176 177 177 178 181 181 181 182 182 183 184 185 186 187 189 190 190 193 194 194 195 195 197 Зміст Як в командній панелі створити підміню з кнопками? Як створеної кнопці призначити «гарячі клавіші»? Як реалізувати заповнення можливих значень поля вибору «ОбрабативаемаяТаблічнаяЧасть» при заповненні поля введення «ОбрабативаемийДокумент»? ф Якщо користувач вказав кілька дат в поле календаря як їх перебрати? ф Як організувати роботу з індикатором? Як у елемента управління змінити джерело даних? ф Як задати системне значення цієї дати, що відображається в полі введення за замовчуванням? Ф Як вивести текст в поле картинки в тому випадку, якщо картинка не обрана? Ф Як відкрити користувачеві стандартний діалог вибору кольору? Як заповнити список в формі даними запиту? ф Як відобразити у формі файл графічної схеми? Інтерфейси, стилі ф Як задати різні стилі 1С: Підприємства для різних категорій користувачів? Є список імен інтерфейсів з позначками. Як зробити помічені інтерфейси видимими? Як з форми обробки відключити глобальний обробник очікувань? Запити, звіти Запити Як отримати дані з табличній частині документів? Як отримати дані з табличній частині документів і подати їх в ієрархічному вигляді? Як підрахувати кількість однакових елементів в обираних даних? Як застосовувати умови для відбору за значеннями полів, обчислених як результат агрегатної функції? Як обмежити вибірку з віртуальної таблиці? Як підсумувати дані за однаковими значеннями одного з полів вибірки? Як отримати тільки ті записи, в яких значення певного поля перевищує вказане значення? Як звернутися до підлеглих полям у запиті? Як об'єднати результати декількох запитів? Як вибрати дані з двох таблиць, що задовольняють певній умові? Як доповнити дані однієї таблиці даними, обраними з іншої таблиці за певним умові? Як об'єднати дані з двох таблиць по певній умові? Як вивести деяке значення замість NULL в запиті? 10 198 200 201 202 203 205 206 209 211 212 212 213 213 214 215 216 216 216 217 218 219 220 221 223 224 225 226 227 228 231 Зміст Як разом з даними деякої таблиці отримати загальні підсумки з цієї ж таблиці? Як отримати ієрархічні підсумки по групі довідника? Як станом на задану дату по регістру «ОстаткіНаСкладе» знайти останній документ «ПоступленіеТоваровУслуг», за яким приходила номенклатура? Як підрахувати кількість записів з однаковим значенням деякого поля? Як в підсумкових записах вивести кількість різних записів? Як дізнатися кількість записів в результаті запиту? Як перевірити достатність залишків товарів на складах, зазначених у документі? Як в запиті здійснити відбір за значенням перерахування? Як отримати курси валют на дві цікавлять дати? Як одним запитом отримати таблицю розбіжностей курсів взаєморозрахунків всіх виписаних документів «ЗаказПокупателя» з офіційним курсом? Як написати запит таким чином, щоб на певному рівні ієрархії запиту вважалися одні підсумкові функції, а на іншому рівні інші? Як отримати перелік документів, що призвели дані підлеглого періодичного регістра відомостей до певного стану? Як встановити параметри запиту, якщо текст запиту заздалегідь не відомий? Аналіз даних ф Як отримати дані про товари, що продаються разом? (D Як порекомендувати супутні товари? (D Як подивитися, що буде купуватися в подальшому? Представлення результатів звітів табличний документ, текстовий документ Як вивести результат запиту в табличний документ? Як вивести дані в табличний документ з можливістю згортання і розгортання даних по угрупованням? Як при виведенні даних в табличний документ згорнути всі виведені угруповання? Як при виведенні даних в табличний документ довільно визначити склад згорнутих і розгорнутих угрупувань? (D Як вивантажити ре ультат запиту з показом ієрархії? (D Де і як можна побачити макет, автоматично генерується будівником звіту? Ф Як з будівника звіту передати дані в зведену таблицю? Звіт формується будівником звіту. Як прибрати одну з колонок, помістивши її дані в розшифровку інший? 231 233 235 237 239 240 240 243 245 246 248 250 252 253 253 254 255 257 257 257 260 260 261 261 262 263 264 11 Зміст Як зберегти настройки будівника звіту до наступного відкриття форми звіту? Як організувати показ приміток в формованому табличному документі? ф Як забезпечити, щоб при введенні на печатка не друкувалися перша колонка і перший рядок табличного документа «ДокументРезультат»? Ф Як забезпечити фіксацію верхньої частини табличного документа, що генерується будівником звіту, по зрізу шапки таблиці? ф Табличний документ формується будівником звіту. Як при друку табличного документа забезпечити виведення шапки таблиці на кожній сторінці? ф Як при виведенні на друк «довгого» документа вказати в колонтитулах сторінок номер документа, дату і номер сторінки? ® Табличний документ формується за макетом, автоматично генерується будівником звіту. Як задати орієнтацію сторінки при друку? Табличний документ формується будівником звіту. Як для всіх виведених числових показників встановити висновок без дробової частини? ф Як для будівника звіту поєднати призначення свого макета і застосування одного зі стандартних макетів оформлення? Як при отриманні даних із запиту обійти тільки підсумкові записи? Як при отриманні даних із запиту обійти тільки ієрархічні підсумкові записи? ф Як вивести картинку в табличний документ? Як вивести картинку в табличний документ без зміни макету? Як працювати зі зведеною таблицею? Як програмно розмістити дані в зведеній таблиці і оформити її? Як створити друковану форму за допомогою текстового шаблону? Діаграми ф Як заповнити діаграму даними? Як заповнити даними вимірювальну діаграму? ф Як вивести результат запиту в зведену діаграму? ф Як заповнити діаграму Ганта даними? Як зв'язати інтервали діаграми Ганта? Як обробити інтерактивне зміна інтервалів діаграми Ганта? Як розмістити неперіодичні мітки в діаграмі Ганта? Як виділити деякі інтервали фону діаграми Ганта? Географічна схема ф Як відобразити у формі файл географічної схеми? ф Як відобразити у формі макет географічної схеми? ф Як змінити масштаб географічної схеми? 12 266 268 271 271 272 273 273 274 276 276 278 279 280 280 282 283 287 287 289 291 293 295 296 298 300 301 301 301 301 Зміст Як відобразити на географічній схемі обраний місто? Як використовувати таблицю значень в якості джерела даних географічної схеми? Адміністрування Запуск 1С: Підприємства з командного рядка © Як запустити 1С: Підприємство з командного рядка? Як з командного рядка змусити 1С: Підприємство зробити вивантаження бази даних? Як з командного рядка оновити зміни поточної конфігурації в конфігурації бази даних? Як виконати тестування і виправлення інформаційної бази без перевірки посилальної цілісності в автоматичному режимі? Як виконати перевірку конфігурації в автоматичному режимі з виведенням результатів перевірки в файл? Як скоротити журнал реєстрації програмно? Як вивантажити модулі прикладного рішення у вигляді текстових файлів з командного рядка? Як завантажити в прикладне рішення файли довідки, збережені у форматі htm? Різне ф Як поміняти значення робочої дати? Ф Як встановити / зняти монопольний режим? ф Як внести запис до журналу реєстрації? ф Як отримати дані про зареєстрованих користувачів інформаційної бази? ф Як визначити загальну системну інформацію? Як програмно додати користувача в інформаційну базу? Як створити власний лог-файл для запису результатів роботи зовнішньої обробки? Як в формі відобразити список користувачів, які працюють з даною інформаційною базою? Як вивантажити журнал реєстрації в XML-форматі? Як примусово завершити роботу всіх користувачів інформаційної бази в клієнт-серверному варіанті роботи? Інтеграція 302 303 305 305 305 306 306 307 307 309 309 310 311 311 311 312 313 314 315 317 318 318 320 321 Текстовий файл 321 XML 324 ф Як вивантажити дані з довідника в текстовий файл? ф Як завантажити дані з текстового файлу? Робота з текстом. Модель послідовного доступу ф Як з однієї бази перенести документ в іншу базу? 321 322 322 324 13 Зміст Як можна сформувати XML-документ довільної структури? Як сформувати XML-документ в рядок? Як можна обмінюватися даними, використовуючи XMLсеріалізацію через файли інших форматів? Як можна завантажити XML документ довільної структури? 326 327 328 329 DBF-файли 331 Робота з HTML-документами 332 ф Як можна побудувати вивантаження-завантаження за допомогою файлів DBF? Ф Заповнення HTML-анкет Робота з файлами ф Як організувати діалог вибору текстового файлу? Ф Як прочитати інформацію про фото? ф Як отримати список файлів в зазначеному каталозі? Як перемістити файл, викладений на ftp до себе на локальний комп'ютер? Як розділити великий файл на декілька файлів певного розміру? Як помістити файли в архів? Як порівняти два текстові файли? Як організувати контроль формування файлу зовнішнім додатком? ActiveX Ф Як використовувати елементи управління ActiveX? 331 332 335 335 336 336 337 337 338 338 340 341 341 Макети Active Document 343 Робота з Інтернет 345 Робота з СОМ-об'єктами 351 Як сформувати новий договір на підставі файлу Microsoft Word? 343 Робота з електронною поштою 345 Як організувати роботу з електронною поштою через встановленого поштового клієнта? 345 Як організувати роботу з поштою без встановленого поштового клієнта на комп'ютері користувача? 346 Робота з файлами 349 Завантаження файлів по FTP 349 Виконання HTTP запиту 350 ф Як з однієї бази 1С: Підприємство 8. 0 перенести залишки товарів в іншу базу, використовуючи СОМ-з'єднання Приклад звернення до програми 1С: Підприємство 8.0 з модуля MS Excel через СОМ-з'єднання ф Як організувати зчитування даних з файлів * .xls? Як запустити макрос, записаний в книзі Microsoft Excel? Як створити документ програми Microsoft Excel no оформлення, наведеним в іншому документі? ф Як вивантажити прайс-лист в документ програми Microsoft Word? 14 351 353 355 356 357 359 Зміст ф Як виконати запит до довільної базі даних SQL? Automation Client / Server (OLE) ф Як з однієї бази 1С: Підприємство 8.0 інтерактивно заповнити документ в іншій базі, використовуючи Automation Client / Server (OLE)? Як з таблиці Excel завантажити список номенклатури в 1С: Підприємство з можливістю редагування? Обмін даними<Э Как организовать работу удаленных складов? Как при создании начального образа управлять тем, какие виды объектов перегружаются, а какие нет? Как просмотреть объекты, для которых зарегистрированы изменения? Как организовать обмен данными между произвольными конфигурациями 1С:Предприятие 8.0? Как принудительно зарегистрировать изменения объектов? WEB-расширение ф Как в форме списка номенклатуры отменить все установленные отборы? Как запретить перенос содержимого ячеек в форме списка расходных накладных? Как открыть список расходных накладных с отбором, установленным по определенному складу? Как добавить кнопку для ввода документа на основании? Указатель 362 363 363 364 366 366 369 371 372 379 380 380 382 384 388 389 15 Введение Идея написать эту книгу возникла у нас не случайно. Платформа системы «1С: Предприятие 8.0» специально ориентирована на то, что ее будут использовать не только как средство разработки, но и как инструмент быстрой доработки «на месте». В таких случаях специалисту важно в сжатые сроки решить конкретную задачу без долгого изучения всех возможностей системы. Как преподаватели учебного центра - мы, разумеется, только за то, чтобы специалист был изначально методологически и всесторонне «подкован». Но как практикующие разработчики, кроме всего прочего, зачастую и сами с большей радостью используем описанные примеры решения тех или иных задач, нежели пытаемся воссоздать их по памяти или по методическим материалам. Собственно говоря, именно с целью помочь в подобных ситуациях, и была написана эта книга. Основой ее создания послужил опыт преподавания «программистских курсов» по системе, работа на конкретных внедрениях и активное общение в форумах, посвященных данному кругу проблем. Фактически книга составлена в результате анализа того, какие задачи приходится решать чаще всего как начинающим, так и продвинутым разработчикам. При подборе примеров мы исходили из того, что спектр навыков и знаний специалистов, которые будут работать с данным изданием, может быть очень широк. Поэтому пусть Вас не смущают некоторые особо «бородатые» советы или, наоборот, - отсутствие подробного описания тех или иных технологий. А для тех, кто практически не знаком с системой «1С:Предприятие 8.0», материал самых простых примеров, объясняющих азы использования объектов и механизмов системы, помечен специальным значком ф. Кроме этого, поскольку работа с настоящим изданием не требует досконального чтения всего материала, по тексту намеренно вставлены повторы некоторых приемов или предостережений в тех случаях, когда это имеет смысл. Также следует заметить, что мы стремились сделать именно сборник простых примеров, поэтому некоторые материалы вошли в издание в «разрезанном» виде. То есть вместо сложных и громоздких «сквозных» примеров, мы старались представить отдельные части, «кирпичики», из которых впоследствии можно собрать желаемое. 16 Введение Стиль изложения соответствует цели издания, поэтому материал предоставляется в форме вопросов и ответов, как, например, в следующем разделе: Как работать с изданием? Решение данного вопроса - многовариантно. Можно читать классическим способом. От начала до конца, помечая или закладывая понравившиеся места. Впоследствии, при возникновении конкретных вопросов, зрительная память или закладки помогут найти нужное решение. Можно читать выборочно. Любимая поговорка крутых программистов: «Мануал открывать надо уже в последний момент». То есть, проблема возникла - нашли раздел и попытались найти решение, или идею решения по аналогии. Но поговорку, на самом деле, мы совсем не одобряем! Можно вообще не читать. Не читать комментарии. А рассматривать издание как сборник «шпаргалок» кода, решающего те или иные вопросы. Остальные варианты использования издания или не очень нравятся авторам, или достаточно опасны. Например, не надо рассматривать эту книжку как замену полноценного обучения или работы с методическими материалами. 17 Примитивные типы, системные функции Как явно указать нужную дату? Для указания нужной даты можно пользоваться: литералом вида ТГГГММДДччммсс" встроенного языка; встроенной функцией преобразования значений Дата(); литералом типа Дата языка запросов. В таблице ниже приводится ряд возможностей явного указания даты при помощи встроенного языка: Выражение "20050308" Дата(2005, 1,1) Дата(1, 1, 1) Дата(2005, 1, 1, 10, 29, 50) Значение результата (тип) 08.03.2005 0:00:00 (Дата) 01.01.2005 0:00:00 (Дата) 01.01.0001 0:00:00 (Дата) 01.01.2005 10:29:50 (Дата) В случае же, если в тексте запроса необходимо жестко указать некую дату - используется литерал ДАТАВРЕМЯ(). Например, поле со значением "01.01.2005 0:00:00" можно получить так: Как проверить дату на пустое значение? Значение типа Дата не бывает «пустым». Если в явном виде значение переменной типа Дата не задано, она будет иметь значение по умолчанию: начало первого дня первого месяца первого года (00 часов 00 минут 00 секунд). Поэтому проверку проще сделать так: 18 Примитивные типы, системные функции Как сравнить две даты (дни)? Точность данных типа Дата - до секунды. А сравнивать нужно именно дни. Тогда проще предварительно для сравниваемых дат воспользоваться функцией, которая возвращает, например, дату начала дня. А потом уже сравнивать полученные значения. Как прибавить к дате день, месяц? Так как тип Дата содержит дату и время с точностью до секунды, то для того чтобы к некоторой дате прибавить один день, нужно увеличить ее значение на количество секунд, содержащихся в одном дне: Для увеличения или уменьшения даты на некоторое количество месяцев, можно использовать: функции работы со значением типа Дата во встроенном языке; функции работы со значением типа Дата в запросах. В таблице ниже приводится ряд возможностей использования функций встроенного языка: Выражение ДобавитьМесяц(Дата(2005, 1, 31), 1) ДобавитьМесяц(Дата(2005, 2, 28), -1) КонецМесяца(ДобавитьМесяц(Дата(2005, 2, 28), -1)) Значение результата (тип) 28.02.2005 0:00:00 (Дата) 28.01.2005 0:00:00 (Дата) 31.01.2005 23:59:59 (Дата) 19 Примитивные типы, системные функции А вот пример функции, добавляющей количество дней к исходной дате при помощи запроса: В тексте запроса используем функцию ДОБАВИТЬКДАТЕ(). В качестве параметров ей необходимо передать исходную дату, тип добавляемых периодов (в нашем случае жестко прописали «День») и количество добавляемых периодов. Первый и последний параметры передали запросу, считав их из параметров (заголовка) нашей функции. Далее запрос выполняется, и из него получаем значение выходного поля по первой (и единственной) строке. Результаты выполнения вышеприведенной функции будут такими: ПолучитьДень("20052802", 10) = 10.03.2005 0:00:00 ПолучитьДень("20042802", 10) - 09.03.2004 0:00:00, поскольку 2004 год был високосным! Как можно проверить тип значения переменной на равенство нужному? 20 Примитивные типы, системные функции ТипЗнч() - функция языка, возвращающая по значению его тип. Тип () - функция языка, возвращающая значение типа Тип по строковому имени типа. Как очистить реквизит формы, имеющий ссылочный тип? К примеру, реквизит (имя «Товар») имеет тип СправочникСсылка.Номенклатура. Для очистки значения в связанном с ним элементе управления на форме, необходимо выполнить строку кода: То есть необходимо установить значение по умолчанию. А им, в данном случае, будет пустая ссылка на элемент справочника «Номенклатура». Как очистить значение, имеющее тип «Хранилище значения»? Очистить значение, записанное в реквизит или ресурс «РеквизитХранилище») можно следующим образом: (имя Как проверить тип значения, помещенного в реквизит имеющий тип «Хранилище значения»? По причинам не связанным с возможностями системы 1С:Предприятие 8.0, в реквизит «Фотография» (тип ХранилищеЗначения) справочника «Сотрудники» помещалась либо Строка (преобразованная к типу ХранилищеЗначения), либо Картинка (преобразованная к типу ХранилищеЗначения). Как проверить, что было записано? 21 Примитивные типы, системные функции Проверку можно осуществить, используя следующие строки кода: Следует отметить, что в реквизит имеющий тип ХранилищеЗначения можно поместить только значение, имеющее тип ХранилищеЗначения. Работа со значением, помещенным в хранилище значения, может начаться только после его получения (метод Получить()). После получения значение «восстанавливает свой прежний тип». Если полученное значение равно Неопределено, то это означает, что никакое значение в реквизит не записывалось. Как сжать данные, помещаемые в хранилище значения? Допустим, в реквизит «СопроводительнаяИнформация» (тип значения - Хранилище значения) помещается значение переменной «ПомещаемоеЗначение». Нужно обеспечить максимальное сжатие данных закладываемого значения. Вторым параметром конструктора хранилища значения передается объект СжатиеДанных. Он тоже получен соответствующим конструктором, с указанием максимального уровня сжатия. 22 Примитивные типы, системные функции Как предоставить пользователю возможность выбора значения составного типа? Для реализации этой задачи необходимо воспользоваться конструктором объекта ОписаниеТипов. А для него необходимо передавать в качестве параметра массив разрешенных для вводимого значения типов значения. Когда конструктором «ОписаниеВозможныхТипов» собрано применяем функцию для вызова диалога ввода данных ВвестиЗначение(). Первым параметром функции необходимо указать доступную в данном модуле переменную для принятия введенного значения. Вторым - заголовок открываемого окна. Третьим - объект ОписаниеТипов. После ввода значения пользователем можно считать значение с переменной, переданной первым параметром. 23 Примитивные типы, системные функции Как применить округление при работе с вычисляемыми числовыми полями в запросе? Например, составляется запрос для оценок средней цены продажи по данным регистра «Продажи». Для получения данных с точностью до двух знаков после запятой текст запроса может выглядеть следующим образом: Источником для запроса является виртуальная таблица «РегистрНакопления.Продажи.Обороты», построенная по данным регистра в интервале между «ДатаНач» и «ДатаКон». В качестве выходных полей берем «Номенклатура» и результат деления значения полей источника «СтоимостьОборот» и «КоличествоОборот». Причем оператором ВЫРАЗИТЬ() тип последнего поля приводится к примитивному типу ЧИСЛО с определенным форматом (длинна 15, точность 2). Как вывести многострочное предупреждение? Переменные «Остаток» и «Зарезервировано» содержат значения, которые необходимо вывести в виде предупреждения. Кроме того, нужно еще вывести свободный остаток, вычисляемый по формуле: СвободныйОстаток = Остаток - Зарезервировано. Все это может быть выполнено следующим образом: 24 Примитивные типы, системные функции Процедура глобального контекста Предупреждение() выводит на экран модальное окно предупреждения. Текст предупреждения передается первым параметром, вторым - таймаут, содержащий указание количества секунд, через которое окно самостоятельно закроется (если раньше его не закроет пользователь), третьим - указывается заголовок окна. Многострочность предупреждения в нашем примере осуществляется за счет добавления значения ПС (перевод строки) системного набора значений СИМВОЛЫ в текст предупреждения. Обратите внимание на вычисление свободного остатка в скобках для обеспечения корректности выполнения арифметических действий и преобразования данных к типу Строка. Кроме того, хотелось бы предупредить об опасности попыток применения процедуры Предупреждение() в ходе проведения документов. Проведение документов выполняется в транзакции, поэтому использование каких либо интерфейсных решений, останавливающих работу системы, является совершенно неприемлемым. В подобных случаях лучше информировать пользователей посредством Сообщить(). Как при выполнении обработки сообщить пользователю текущее время? Метод ТекущаяДата() возвращает системную дату. Тип значения Дата. В его значение входит и дата и время. Для получения представления только времени можно применяем функцию Формат(). Как вывести число прописью по-русски, но без дробной части? Для этого используется функция ЧислоПрописью(). У нее могут быть указаны в качестве параметров: преобразуемое число; форматная строка; параметры предмета исчисления (вид этой форматной строки определяется значением кода локализации). 25 Примитивные типы, системные функции Все возможные варианты локализаций описаны в файле Locllnfo.txt, входящем в комплект поставки программы. Для решения нашей задачи можно использовать следующий текст: В форматной строке указываем код локализации - Русский(Россия). В параметрах предмета исчисления показываем, что дробная часть не должна содержать ни одного разряда. Для ВыводимоеЧисло = 234,4 результат будет: «Двести тридцать четыре». Как вывести число прописью по-русски, с указанием сотых в дробной части? В параметрах предмета исчисления указываем возможные спряжения и склонения слов «целая» и «сотая», а так же количество разрядов дробной части, которые будут выводиться прописью. В форматной строке указываются код языка локализации и необходимость вывода дробной части прописью. Для ВыводимоеЧисло - 123,45 результат будет: «Сто двадцать три целых сорок пять сотых». 26 Примитивные типы, системные функции Как вывести прописью число килограммов с указанием дробной части в граммах? В отличие от вышеприведенного примера здесь предметами исчисления являются килограммы и граммы, а количество разрядов дробной части - три. Для ВыводимоеЧисло = 12,345 результат будет: «Двенадцать килограммов триста сорок пять граммов» Как долларовую сумму вывести прописью поанглийски? Для ВыводимоеЧисло = 1 232,45 результат будет: «One thousand two hundreds thirty two dollars 45 cents» Какзагрузитьвнешнююкомпоненту? Загрузим компоненту, позволяющую работать со сканером штрихкодов: 27 Примитивные типы, системные функции В случае ошибки загрузки компоненты или создания объекта возникает исключительная ситуация, которую рекомендуется отрабатывать с помощью конструкции Попытка. Как выполнить команду операционной системы? К примеру, требуется удалить все файлы из указанного каталога. Для реализации данной возможности достаточно выполнить следующую строку кода: Для просмотра доступных команд можно в командной строке системы выполнить команду «help». Вызвать командную строку, можно выполнив строку кода: Кроме этого, для запуска внешнего приложения (или открытия файла с использованием ассоциированного с ним приложения) может быть использован метод глобального контекста ЗапуститьПриложение(). В этом случае запуск приложения будет осуществляться непосредственно, минуя командный интерпретатор. Например: 28 Примитивные типы, системные функции Как реализовать код процедуры в зависимости от режима выполнения (на клиенте, на сервере, во внешнем соединении) ? Если алгоритм должен выполняться по-разному в зависимости от места выполнения процедуры, то можно воспользоваться инструкциями препроцессора: 29 Примитивные типы, системные функции Как при групповой обработке объектов реализовать стратегию «либо все, либо ничего»? Требуется загрузить либо все данные по справочнику «Единицы измерения», либо, в случае возникновения ошибки, нужно чтобы ни один элемент не был записан. Для реализации стратегии «либо все, либо ничего» можно использовать следующий фрагмент кода: Если необходимо но мере накопления каких-либо признаков «искусственно» отменить действия, совершаемые в транзакции, можно использовать метод системы: МО Примитивные типы, системные функции Как посчитать сумму по формуле сложного процента? Возведение в степень реализуется функцией Pow(). Первым параметром передается основание степени, вторым - показатель степени. Замечание: кроме работы со степенями математический аппарат системы позволяет работать с корнями, логарифмами и тригонометрическими функциями. 31 Универсальные коллекции Массив В каких ситуациях обычно используются массивы? Массив является универсальной коллекцией, то есть объектом, предназначенным для работы с временными наборами данных в течение сеанса работы пользователя. Необходимость в его использовании возникает, когда требуется работать с временным набором данных. Чаще всего это промежуточные операции обработки информации: подготовка отборов, реализация поиска, подготовка группирования, передача параметров и проч. Массивы могут создаваться оператором Новый или получаться в результате применения методов некоторых объектов. Как создать массив? Создание массивов чаще всего происходит посредством оператора Новый: где «СозданныйМассив» - имя переменной, которая будет содержать созданный объект типа Массив. После создания к массиву можно добавлять элементы (произвольное количество). Если же мы хотим создать массив с заранее определенной размерностью, это можно сделать так: В результате в переменной «СозданныйМассив» будет создан массив с десятью значениями. Для такого массива можно потом сразу обращаться к любому из десяти значений (начиная с нулевого по девятое) для записи или для чтения. А при необходимости к такому массиву можно так же еще добавлять новые элементы. Первый же добавленный элемент получит индекс «10». 32 Массив Как создать многомерный массив? Массив является линейной динамической коллекцией с произвольным типом значений. Поэтому значениями массива могут выступать другие массивы. То есть создание массива массивов и решает задачу создания многомерного массива. Это можно делать при использовании конструктора массива: или в процессе добавления очередных элементов к массиву: И в том и в другом случае мы решим задачу создания двумерного массива размерностью 2x8. Чтение и запись значений такого массива можно производить посредством директивного указания индексов: или при помощи метода Получить(): Хотелось бы еще раз отметить, что создание массива определенной размерности конструктором ограничивает только количество возможных к заполнению значений массива, но не препятствует добавлению новых значений (в качестве которых могут выступать массивы произвольной размерности). 33 Универсальные коллекции Как добавить элементы в массив? Допустим, массив, к которому нужно добавить значение из переменной «НовоеЗначение», называется «НашМассив». Если нужно просто добавить очередной элемент (с индексом на единицу больше самого старшего) - действуем следующим образом: Если нужно, чтобы новые значения добавлялись с определенным индексом, то можно использовать метод Вставить(): Как определить размер массива? Чтобы определить можно сделать так: количество элементов массива «НашМассив» Однако имейте в виду, поскольку индексация элементов массива начинается с нуля - значение переменной «Размер» будет на единицу больше значения самого старшего индекса. Как обратиться к элементу массива? При обращении как для записи, так и для чтения элементов массива лучше пользоваться оператором , указывая индекс элемента. Помните, что индексация начинается с нуля. Пусть в переменную «ПервоеЗначение» нужно считать значение самого первого элемента массива, а в элемент массива с индексом «9» записать значение из переменной «ДесятоеЗначение»: 34 Массив Аналогичных результатов можно добиться при помощи методов Получить() и Установить(): Замечание: в любом случае, чтобы иметь возможность обратиться к элементу массива, он должен уже существовать. Иначе получим ошибку с сообщением о том, что индекс находится за границами массива. Как перебрать элементы массива? Если перебор элементов массива нужен для чтения данных из массива - проще всего организовывать посредством цикла перебора коллекции. Например, чтобы вывести сообщения о каждом числе, найденном в массиве «МассивЭлементов», достаточно сделать следующее: Обратите внимание, «ЭлементМассива» - это произвольное имя переменной, принимающей в себя очередное значение элемента коллекции при выполнении цикла. Если же при переборе элементов массива нужно их редактировать, то для этого нужно работать еще и с индексами элементов. Лучше тогда использовать так называемый «цикл-счетчик». Например, чтобы обнулить все числовые элементы массива, достаточно сделать следующее: 35 Универсальные коллекции «Сч» - это переменная, принимающее очередное значение счетчика на каждом выполнении цикла. Именно из нее и будем считывать значение индекса очередного элемента массива. Значение самого большого индекса массива определяется посредством метода ВГраница(). Как удалить элемент массива? Удаление отдельных элементов массива происходит с обязательным указанием индекса удаляемого элемента. Так, например, будет удален первый элемент массива: Естественно, если указанный индекс будет выходить за границы массива - получим сообщение об ошибке. Кроме того, необходимо учитывать, что удаление элемента «из середины» массива приведет к уменьшению на единицу индексов элементов, стоявших «после» удаленного. Массив как бы «сомкнет ряды». Поэтому, например, один из наиболее простых вариантов удаления всех числовых элементов массива может выглядеть так: Сначала определяем самый старший индекс элементов массива. Цикл проверок и удалений чисел будет выполняться, пока очередное значение индекса не окажется меньше нуля. В цикле определяем тип значения элемента с текущим индексом. Если это число - удаляем данный элемент. Кроме того, в любом случае уменьшаем на единицу значение переменной «Индекс». В результате, поскольку перебор элементов массива проводится с конца, эффект «смыкания рядов» будет производиться только для уже проверенных элементов. 36 Массив ® Как удалить все элементы массива? Если требуется полное удаление элементов из массива, операция выполняется гораздо проще: Как удалить повторяющиеся элементы массива? Поскольку объект «массив» является одной из самых простых универсальных коллекций, методами поиска по значению он не обладает. Поэтому для того, чтобы удалить повторяющиеся элементы, следует перебрать все элементы массива и проверить их значения. Для выполнения поставленной задачи организуется два цикла: в первом цикле осуществляется перебор элементов массива и для каждого выбранного элемента осуществляется вложенный цикл сравнения 37 Универсальные коллекции текущего элемента с последующими элементами массива. В случае совпадения значений последующий элемент массива удаляется. Когда для очередного элемента с индексом «ТекущийИндекс» завершился вложенный цикл проверки с последующими - увеличиваем значение «ТекущийИндекс» на единицу с тем, чтобы следующий по индексу элемент попал в положение проверяемого. Как скопировать массив? Для получения копии массива в другом объекте (массиве) необходимо создать новый массив (массив-копию) конструктором. Далее в цикле перебора элементов исходного массива добавлять эти элементы в массив-копию. Массив Как проверить, что два массива идентичны? Это можно выполнить при помощи следующей функции. В качестве параметров ей передаются сами проверяемые массивы «ПервыйМассив» и «ВторойМассив». Сначала проверяем совпадение наибольших индексов в массивах, если совпадения нет - массивы уже не идентичны. Значит функция возвращает значение ЛОЖЬ. Далее необходимо произвести проверку идентичности элементов массивов с одинаковыми индексами. Поскольку индексация элементов массива начинается с нулевого значения - выполняем цикл-счетчик от нуля до значения наибольшего индекса массива. Внутри цикла при выполнении неравенства очередных элементов функция возвращает значение Ложь. Если цикл пройден до конца - значения всех элементов с одинаковыми индексами совпали. Значит функция может вернуть значение Истина. 39 Универсальные коллекции В массив выгружены данные, содержащие наименования контрагентов. Как их отсортировать? Список значений позволяет выполнять сортировки по представлению или по значению и, кроме того, обладает возможностями загрузки данных из массива и выгрузки в массив. Поэтому один из вариантов решения данной задачи может быть таким: Создаем список значений. Загружаем значения из массива «МассивНаименований». Сортируем список значений по значениям. Поскольку параметр не указали, направление сортировки будет - по возрастанию. Если нужно по убыванию - в качестве параметра надо передать соответствующее значение системного перечисления НаправлениеСорТИрОВКИ: После выполнения сортировки выгружаем значения из списка значений в массив. 40 Массив Есть массив, в который выгружены значения типа СправочникСсылка.Номенклатура. Как удалить все пустые значения массива? Получаем в виде параметра процедуры массив номенклатурных позиций. Устанавливаем нулевое значение счетчика - переменной «Счетчик». Организуем цикл, который будет выполняться, пока значение переменной «Счетчик» меньше количества элементов массива. Поскольку индексы элементов массива начинаются с нулевого значения, то наш цикл прервется в момент, когда значения индекса («Счетчик») и количества элементов совпадут. Внутри цикла проверяется условие, является ли ссылка, содержащаяся в очередном элементе массива - пустой. Если это так текущий элемент массива удаляется. В результате у следующих за ним элементов автоматически на единицу уменьшаться индексы. Кроме того, необходимо уменьшить на единицу значение переменной, отслеживающей количество элементов в массиве. Если же ссылка не пустая - увеличивается на единицу значение «Счетчик» с тем, чтобы на следующем ходе цикла работать уже со следующим элементом. 41 Универсальные коллекции Замечание: проверка на пустое значение для разных типов данных проводится по-разному. Только для ссылочных типов данных можно ее осуществлять посредством метода Пустая(). Как получить массив номенклатурных позиций, использованных в табличных частях «Номенклатура» и «Тара» накладной? Имеем ссылку на документ «СсылкаНаДокумент». Номенклатурные позиции могут быть указаны в колонке «Номенклат}фа» табличной части «Номенклатура» и в колонке «Номенклатура» табличной части «Тара». Тогда массив номенклатуры из обеих табличных частей можно получить следующим образом: Формируем массив «МассивНоменклатуры» посредством выгрузки колонки «Номенклатура» табличной части «Товары» документа. Аналогично формируем массив «МассивНоменклатурыТара» по табличной части «Тара». Далее в цикле перебора элементов второго массива добавляем их в первый. 42 Массив Есть две таблицы значений. Как получить массив совпадающих имен колонок? Данная операция может применяться для вспомогательного контроля перед загрузкой таблицы значений в таблицу записей регистра. Итак, есть «ТаблицаИсточник» PI «ТаблицаПриемник», требуется получить массив имен совпадающих по имени колонок. Создаем сначала конструктором «МассивСовпадающихКолонок». Далее выполняем цикл перебора колонок одной из таблиц. Внутри цикла в переменную «ИмяКолонки» получаем имя очередной колонки. Далее обращаемся к коллекции колонок другой таблицы значений и при помощи метода Найти() пытаемся найти такую же по имени колонку. Если поиск успехом не увенчается - метод выдаст значение Неопределено. А если удалось - добавляем очередной элемент к массиву «МассивСовпадающихКолонок». 43 Универсальные коллекции Как в запросе сделать отбор по нескольким вариантам заполнения реквизита типа «ПеречислениеСсылка»? Одним из приемов программирования, использующим массивы, является формирование коллекции возможных значений для заполнения параметров запроса. Это выполняется, например, когда в запросе используются отборы с операндами В или В ИЕРАРХИИ. Вот пример решения задачи: В параметр «МассивПричин» устанавливается значение - массив возможных причин, набранный из элементов перечисления « ПричиныОтсутствия». Замечание: для решения подобных задач (с операндами В и В ИЕРАРХИИ) можно передавать не только данные типа Массив, можно еще СписокЗначениЙ или вообще сформировать коллекцию возможных значений вложенным запросом в самом тексте запроса. Вариант выбора заполнения параметра зависит от конкретики самой задачи. 44 Массив Как из регистра сведений «РасчетчикиЗарплатыОрганизации» получить в виде массива всех расчетчиков зарплаты определенного подразделения организации? Периодический независимый регистр сведений «РасчетчикиЗарплатыОрганизации» имеет следующую структуру: Данную задачу можно решить посредством применения методов объектной модели или запросом. Пример решения посредством объектной модели: Создаем набор записей регистра. Устанавливаем отбор по значению измерения «ПодразделениеОрганизации». Читаем данные набора записей. Выгружаем колонку набора записей «Пользователь» в массив. Пример решения задачи посредством запроса: 45 Универсальные коллекции Источником в запросе будет таблица регистра «РегистрСведений.РасчетчикиЗарплатыОрганизации». Накладываем отбор по условию равенства поля «ПодразделениеОрганизации» определенному значению. В качестве выходных полей выбираем только «Пользователь». После выполнения запроса делаем выборку по результату запроса и в цикле перебора ее - формируем нужный массив. В данных примерах оба способа возвращают одинаковые результаты примерно за одинаковое время потому, что никаких дополнительных действий в процессе получения информации не требуется. Второй способ на первый взгляд кажется более длинным в отношении написания кода. Но если нам понадобится произвести отбор более чем по одному условию, или получить массив неповторяющихся значений - то вторым способом получить такие данные будет значительно легче и быстрее с точки зрения скорости исполнения. 46 Структура ® В каких ситуациях обычно используются объекты типа «Структура»? Структура является универсальной коллекцией, то есть объектом, предназначенным для работы с не хранящимися в базе данных совокупностями значений. Необходимость в ее использовании возникает, когда требуется работать с временным набором данных с чуть более сложной природой, нежели в массиве. Если элемент массива можно было характеризовать только числовым индексом и значением произвольного типа, то элемент структуры характеризуется строковым ключом и значением произвольного типа. Чаще всего структуры применяют в ситуациях, когда необходимо узнать или использовать имена реквизитов, свойств, полей, подчиненных объектов для тех или иных объектов; узнать или использовать значения реквизитов, свойств, полей, подчиненных объектов по их именам для тех или иных объектов. Кроме того, структуры удобно использовать для передачи параметров при работе с различными объектами. Структуры могут создаваться конструктором НОВЫЙ или получаться в результате применения методов некоторых объектов. Ввод элементов в структуру можно осуществлять как посредством параметров конструктора, так и посредством метода Вставить(). Как создать структуру? Создание структуры чаще всего происходит посредством оператора НОВЫЙ: где «СозданнаяСтруктура» - имя переменной, которая будет содержать созданный объект типа Структура. После вышеприведенного создания в структуру можно вставлять элементы (произвольное количество). 47 Универсальные коллекции Если же мы хотим создать структуру с заранее определенными элементами - это можно сделать, например, так: Первым параметром передается строка, в которой через запятую перечисляются ключи элементов структуры. Остальные параметры содержат значения для элементов структуры в том же порядке, в котором были перечислены ключи. Для такой структуры впоследствии можно обращаться к любому из элементов для записи или для чтения значения. А так же, при необходимости, к этой структуре можно еще добавлять новые элементы. Как добавить элементы в структуру? Для добавления элементов в структуру используется метод Вставить(). Первым параметром указывается ключ, вторым - значение нового элемента. Замечание: если в составе структуры уже был элемент с подобным ключом - то старый элемент будет замещен новым. Например: Как обратиться к элементу структуры? Для чтения значений элементов структуры можно использовать несколько вариантов написания кода. Для структуры «Оппонент», в составе которой есть элемент с ключом «Возраст» можно использовать явное указание значения ключа: 18 Структрура или передачу ключа в переменной: Также можно использовать метод СвоЙСТВО(), который получает значение элемента структуры по указанному ключу: Для записи значений элементов структуры использовать несколько вариантов написания кода. Если мы хотим изменить значение возраста в вышеописанного примера - можно это сделать так: также можно структуре из или так: или так: Как перебрать элементы структуры? Поскольку структура является коллекцией - перебрать элементы структуры можно посредством цикла перебора коллекции. Например, чтобы сообщить обо всех ключах и значениях элементов структуры «СтруктураПараметров», можно сделать следующее: 49 Универсальные коллекции Как удалить элемент структуры? Чтобы удалить элемент структуры - необходимо знать его ключ. Например, чтобы удалить из структуры «СтруктураПараметров» элемент с ключом «Номенклатура», достаточно сделать следующее: Если же нужно удалить все элементы структуры - применяется метод ОЧИСТИТЬ(): Как в структуре установить значение для элемента с определенным ключом? Все ключи элементов структуры - уникальны. Поэтому добавление новых элементов и замена (установка) значений для «старых» элементов выполняется одним и тем же методом Вставить^): Результатом примера выше будет структура, состоящая только из одного элемента: ключ у него - «Цвет», значение - «Синий» из системного набора значений \Л/еЬЦвета. Структрура Как получить в структуру многомерные данные? Как собрать информацию по установленным в форме журнала отборам? Для формы журнала документов установлены некие отборы. Чтобы сформировать многомерную структуру всех используемых отборов объекта «ЖурналДокументовСписок», можно сделать следующее: Создаем конструкторами две структуры. Структура «СтруктураОтборов» впоследствии будет содержать элементы, где в качестве ключа будет указано название отбора, а в качестве значения « СтруктураПараметровОтбора». В цикле перебора коллекции отборов объекта «ЖурналДокументовСписок» сначала проверяем, используется ли данный отбор. Если используется - заполняем структуру параметров данного отбора. Полученную структуру используем в качестве значения добавляемого элемента объекта «СтруктураОтборов». Впоследствии, если нам потребуется информация из полученной структуры, можно будет, например, перебрать элементы 51 Универсальные коллекции «СтруктураОтбора», а для каждого из этих элементов - перебрать элементы ее значения - структуры «ПараметрыОтбора» Как определить, есть ли в структуре элемент с ключом «Контрагент», и если есть, но содержит пустое значение справочника или Неопределено - удалить этот элемент? В качестве параметров метода СвоЙСТВО() можно указать ключ и переменную для получения значения по ключу. Кроме того, сам метод возвращает Истина, если элемент с данным ключом существует, и Ложь - если нет. Получив значение и проверив его на требуемые условия, удаляем элемент с указанным ключом из структуры. Замечание: кроме метода СвоЙСТВО() получить значения элемента структуры позволяют следующие варианты обращения по ключу: Структура-Контрагент или Структура[ "Контрагент" Структрура Как из табличной части «Товары» документа получить все строки, где значение реквизита «Цена» равно нулю, а значение реквизита «СтавкаНДС» равно значению «НДС18» перечисления «СтавкиНДС»? Для поиска строк, соответствующих условию определенного отбора, можно сделать следующее: СтруктураДляПоиска = Новый Структура("Цена, СтавкаНДС", О, Перечисления.СтавкиНДС.НДС 18); МассивСтрок = Товары. НайтиСтроки(СтруктураДляПоиска); Сначала создаем структуру для поиска. Далее посредством метода НаЙТиСтр0КИ() из табличной части документа «Товары» получаем массив строк, соответствующих отбору по структуре поиска. Обратите внимание, в данном примере был показан вариант добавления и заполнения элементов структуры непосредственно в конструкторе. Как получить данные о текущей учетной политике бухгалтерского учета организации из периодического регистра сведений на заданную дату? Периодический регистр сведений «УчетнаяПолитикаБухгалтерскийУчет» имеет следующую структуру: Тип значения измерения «Организация» СправочникСсылка. Организации. Ссылка на организацию находится в переменной «ЮрЛицо». Дата, на которую необходимо получить данные - переменная «ДатаПолучения». 53 Универсальные коллекции Получение необходимых данных можно организовать посредством метода ПолучитьПоследнее() менеджера регистра: Метод предназначен для получения данных наиболее поздней записи регистра, соответствующей указанным периоду и значениям измерений регистра. Значения измерений регистра должны предаваться в виде структуры. Каждый элемент структуры в качестве ключа должен использовать имя измерения. В качестве значения элемента структуры передаем значение отбора по этому измерению. Дату получения и полученную структуру отбора используем в качестве параметров для метода ПолучитьПоследнее(). Результатом применения метода к периодическому регистру сведений «УчетнаяПолитикаБухгалтерскийУчет» будет структура. Элементы полученной структуры состоят из названия ресурса в качестве ключа и значения ресурса в качестве значения. 54 Структрура Как сформировать структуру названий реквизитов табличной части произвольного документа? Пример функции, решающую данную задачу - ниже. В качестве параметров необходимо передать ссылку на документ и имя табличной части документа. Конструктором создаем структуру « Стру ктураТабл ичнойЧасти Доку мента». В цикле перебора реквизитов нужной табличной части полученного документа вставляем в структуру элементы с названиями полученных реквизитов. Замечание: значения элементам структуры можно было и не указывать - все зависит от того, как в дальнейшем собираемся использовать полученную структуру. Как получить запросом данные табличной части документа, имея структуру названий реквизитов табличной части? Пример функции, решающей данную задачу - ниже. В качестве параметров необходимо передать ссылку на документ или объект документа, имя табличной части и структуру названий реквизитов этой табличной части. 55 Универсальные коллекции Функция основана на сборе информации запросом, чей текст собирается «кусочками» из строковых переменных: Создаем переменную «ПоляРеквизитов». В цикле перебора элементов структуры имен полей табличной части добавляем к переменной «ПоляРеквизитов» «по кусочкам» будущие имена выходных полей запроса. Добавляются они через запятую. Далее формируем запрос, к тексту которого добавляем строку имен выходных полей запроса. Источником указываем таблицу нужной табличной части нужного документа. Кроме того, накладываем отбор по полю «Ссылка». Функция возвращает результат выполнения запроса. 56 Соответствие ф В каких ситуациях обычно используются объекты типа «Соответствие»? Соответствие является универсальной коллекцией, то есть объектом, предназначенным для работы с не хранящимися в базе данных совокупностями значений. Необходимость в его использовании возникает, когда требуется работать с временным набором данных с чуть более сложной природой, нежели в структуре. Если элемент структуры можно было характеризовать только строковым ключом и значением произвольного типа, то элемент соответствия характеризуется ключом произвольного типа и значением произвольного типа. Чаще всего соответствия применяют в ситуациях, когда необходимо хранить в оперативной памяти для последующей обработки данные с ключами произвольного типа. Кроме того, соответствия удобно использовать для передачи параметров при работе с различными объектами. Соответствия могут создаваться конструктором НОВЫЙ. ф Как создать соответствие? Создание соответствия происходит посредством оператора Новый: I СозданноеСоответствие = Новый Соответствие(); где «СозданноеСоответствие» «СозданноеСоответствие» - имя переменной, которая будет содержать созданный созданный объект типа типа Соответствие. Соответствие. содержать После вышеприведенного создания в соответствие можно вставлять элементы (произвольное количество). количество). элементы (произвольное ф Как добавить элементы в соответствие? Допустим к соответствию Допустим соответствию «ВозрастСотрудников» «ВозрастСотрудников» нужно добавить новый элемент. В качестве ключа должна выступать ссылка на сотрудника (ее можно считать из переменной «Сотрудник»), в качестве значения - возраст сотрудника (его можно считать из переменной «ВозрастСотрудника»). «ВозрастСотрудника»). 57 Универсальные коллекции Тогда добавление нового элемента можно произвести так: или так: Как обратиться к элементу соответствия? Запись значений элементов соответствия можно выполнять теми же способами, которые рассмотрены в вопросе «Как добавить элемент в соответствие?» на странице 57. А чтение значений элементов соответствия можно выполнять следующим образом: или так: В приведенных примерах из соответствия «ВозрастСотрудников» по ссылке на сотрудника в качестве ключа будет получено значение элемента соответствия. Как перебрать элементы соответствия? Поскольку соответствие является коллекцией - перебрать элементы соответствия можно посредством цикла перебора коллекции. Например, чтобы сообщить обо всех ключах и значениях элементов соответствия «Замены», можно сделать следующее: 58 Соответствие Как удалить элемент соответствия? Чтобы удалить элемент соответствия - необходимо знать его ключ. Например, чтобы удалить из соответствия «Замены» элемент со ссылкой на объект, содержащийся в переменной «УдаляемыйТовар», в качестве ключа, достаточно сделать следующее: Если же нужно удалить все элементы соответствия - применяется метод ОЧИСТИТЬ(): Как получить данные из соответствия? В соответствии «КурсыВалютДокумента» в качестве ключа используется значение валюты, а значениями являются структуры, содержащие «Курс» и «Кратность». Как получить курс и кратность валюты «УправленческаяВалюта» ? Сначала по ключу (ссылке на управленческую валюту) получаем значение соответствия. Поскольку значением является структура курса валют - далее получаем значения структуры по их названиям. 59 Универсальные коллекции Как получить многоуровневое соответствие видов расчетов, обладающих базовыми видами расчетов? Для плана видов расчетов «ОсновныеНачисления» необходимо получить соответствие «ВидыРасчетов», где в качестве ключей будут использоваться виды расчетов, обладающие базовыми. А в качестве значений - соответствия базовых видов расчетов. В качестве ключей последних - базовые виды расчета, в качестве значений - структуры, содержащие их свойства «Наименование» и «Предопределенный». Виды расчета Базовые виды расчета Оклад по дням Оклад по часам Ежегодный отпуск Оплата по часовому т арифу Оплата по дневному тарифу Оплата по произволе твенным нарядам Оклад по дням Надбавка за в редность Оклад по часам Оплата по произволе твенным нарядам Свойства базового вида расчета "Наименование" - "Оклад по дням" "Предопределенный" - Истина "Наименование" - "Оклад по часам" "Предопределенный" - Ложь "Наименование" "Оплата по часовому тарифу" "Предопределенный" - Ложь "Наименование" "Оплата по дневному тарифу" "Предопределенный" - Истина "Наименование" "Оплата по производственным нарядам" "Предопределенный" - Истина "Наименование" - "Оклад по дням" "Предопределенный" - Истина "Наименование" - "Оклад по часам" "Предопределенный" - Ложь "Наименование" "Оплата по производственным нарядам" "Предопределенный" - Истина Первичный сбор информации удобнее осуществить при помощи запроса с использованием итогов. Последующий перебор группировок результат запроса даст возможность сформировать необходимые объекты: 60 Соответствие Для запроса источником является таблица «ПланВидовРасчета.ОсновныеНачисленияОрганизации.БазовыеВидыРас чета». Выходными полями делаем все, необходимые для решения нашей задачи. Кроме того, вводим дополнительные итоги по полю «Ссылка» (ссылка на виды расчета). После выполнения запроса делаем выборку по верхнему уровню группировок результата запроса. 61 Универсальные коллекции Создаем конструктором три объекта - соответствие «ВидыРасчетов», в которое будем впоследствии добавлять виды расчетов, обладающие базовыми; соответствие «БазовыеВидыРасчетов», в которое будем добавлять базовые виды расчетов для каждого отдельного вида (владельца); структуру «СвойстваВидовРасчетов» для добавления информации о свойствах базовых видах расчетов. В цикле перебора верхнего уровня группировок (по видам расчета) сначала очищаем соответствие «БазовыеВидыРасчета». Далее открываем цикл перебора записей второго уровня группировки результата запроса (то есть уже по базовым видам расчетов определенного владельца). В этом цикле заполняем значения структуры «СвойстваВидовРасчетов» по ключам - названиям свойств. Далее добавляем сформированные структуры в качестве значений соответствия «БазовыеВидыРасчета» с конкретным базовым видом расчета в качестве ключа. По окончании вложенного цикла добавляем очередной элемент в соответствие «ВидыРасчетов» с заполнением значения ключа из поля «Ссылка», и заполненным соответствием «БазовыеВидыРасчета» в качестве значения. Список значений, таблица значений, дерево значений ® В каких ситуациях обычно используются списки значений, таблицы значений, дерево значений? Все эти объекты являются универсальными коллекциями, то есть объектами, предназначенным для работы с не хранящимися в базе данных совокупностями значений. Необходимость в использовании списка значений возникает, когда требуется работать с временным набором данных для решения интерфейсных задач. Дело в том, что в отличие от более простых универсальных коллекций (массива, структуры, соответствия) список значений состоит из объектов - ЭлементСпискаЗначениЙ. А элемент списка значений характеризуется следующим набором свойств: Значение; Представление. Содержит строковое пользовательское представление. То есть именно его пользователь увидит на экране. По умолчанию - генерируется автоматически; Пометка; Картинка; Применение списков значений для обычных задач универсальных коллекций, но не связанных с интерфейсными действиями, как правило - излишне. Обычно с этой функциональностью справляются объекты «попроще»: Массив, Структура, Соответствие. Таблицы значений позволяют работать с данными сущностей, представимых в виде таблиц, то есть «раскладываемых» на колонки и строки. А ведь с точки зрения многих систем автоматизации вообще «весь мир = совокупность таблиц». При этом можно добавлять/удалять данные (и колонки, и строки, и значения); искать данные (и колонки, и строки, и значения); сортировать данные (по любым колонкам); выгружать-загружать данные; подсчитывать итоги по колонкам; сворачивать данные и т.д. Дерево значений позволяет в добавление к вышеприведенным операциям еще вводить уровни иерархии для этих данных и оперировать в пределах уровней или игнорируя их. 63 Универсальные коллекции Подобный набор возможностей помогает решать самый широкий спектр задач промежуточной обработки данных произвольного типа. Как создать список значений? Список значений можно создать посредством оператора НОВЫЙ: где «СозданныйСписок» - имя переменной, которая будет содержать созданный объект типа СписокЗначении. Как добавить элементы в список значений? Например, требуется добавить в список значений «СписокСотрудников» новый элемент со значением ссылки на сотрудника (содержится в переменной «ТекущийСотрудник»), ФИО сотрудника в качестве представления (содержится в реквизите «ФИО» объекта «ТекущийСотрудник») и фотографии сотрудника в качестве картинки (содержится в переменной «Фото»): Если нужно, чтобы новые значения добавлялись с определенным индексом (переменная «Инд»), то можно использовать метод Вставить(): Если при этом в списке значений уже был элемент с таким индексом, то старый элемент получит индекс на единицу больше предыдущего; аналогично сдвинуться индексы у всех последующих. Если при использовании метода Вставить() указать индекс, выходящий за границы списка, - получим сообщение об ошибке. 64 Список значений, таблица значений, дерево значений Как найти элемент списка значений? Например, в списке значений «СписокСотрудников» надо найти элемент, в котором в качестве значения указан сотрудник, на которого ссылается переменная «ИскомыйСотрудник». Затем нужно сообщить индекс найденного элемента. Это можно выполнить следующим образом: Замечание: если искомое значение в списке может встретиться несколько раз - при таком подходе найдем только первый элемент, где оно содержится. Поэтому смотрите по ситуации. Поскольку список значения - объект, предназначенный, прежде всего для визуализации возможностей выбора пользователем, обычно при его заполнении уже сразу предотвращают возможность повторов. Если же такая возможность осмыслена, то получить все элементы списка значений, содержащие определенное значение можно, например, в цикле перебора элементов списка значений. Как обратиться к элементу списка значений? Если требуется получить доступ к элементу списка значений с определенным индексом (пусть содержится в переменной «Инд»), можно поступить так: или так: В любом случае - то, что получаем, еще не есть значение, заложенное в этот элемент списка (это еще не сотрудник), а именно объект типа ЭлементСпискаЗначений. 65 Универсальные коллекции Впоследствии с него можно считать значения свойств: Как перебрать элементы списка значений? Поскольку имеем дело с индексированной коллекцией, то можно использовать цикл перебора элементов коллекции или «цикл-счетчик». Например, чтобы сообщить значения всех элементов списка значений «СписокСотрудников», можно использовать следующий код: То же через «цикл-счетчик»: Как удалить элемент списка значений? Удаление отдельных элементов списка значений происходит с обязательным указанием индекса удаляемого элемента. Так, например, будет удален первый элемент массива: Естественно, если указанный индекс будет выходить за границу индексов списка - получим сообщение об ошибке. Кроме того, необходимо учитывать, что удаление элемента «из середины» списка приведет к уменьшению на единицу индексов элементов, стоявших «после» удаленного. Список значений - «сомкнет ряды». 66 Список значений, таблица значений, дерево значений Решим задачу удаления всех элементов списка «СписокОбъектов», содержащих числовые значения: значений Сначала определяем самый старший индекс элементов списка значений. Цикл проверок и удалений элементов будет выполняться, пока очередное значение индекса не окажется меньше нуля. В цикле определяем тип значения элемента с текущим индексом. Если это число - удаляем данный элемент. Кроме того, в любом случае уменьшаем на единицу значение переменной «Индекс». В результате, поскольку перебор элементов списка значений производится с конца, то эффект «смыкания рядов» будет актуален только для уже проверенных элементов. ф Как создать таблицу значений и заполнить ее поля? Для создания таблицы значений используется оператор Новый: После этого молено создать колонки таблицы (при необходимости можно задать допустимые типы значений для колонки, заголовок и ширину колонки в символах). Затем можно добавить новую строку и установить значения в колонках таблицы: 67 Универсальные коллекции или так: Как найти значение в таблице значений? Если требуется «ТаблицаЗначений», сделать так: I найти первую где присутствует строку таблицы значений «ИскомоеЗначение», можно Найден наяСтрока = ТаблицаЗначений.Найти(ИскомоеЗначение); Если требуется найти первую строку, где «ИскомоеЗначение» может быть найдено, например, в колонках «Поставщик» и «Покупатель», то: Если же нужно найти все строки, где в колонке «Сотрудник» присутствует искомое значение, то это можно выполнить при помощи метода НаЙТиСтроки(): Сначала создаем структуру поиска, каждый элемент которой будет содержать название колонки таблицы значений в качестве ключа и искомое значение в этой колонке - в качестве значения. Далее структуру поиска передаем в качестве параметра методу НаЙТиСтроки(). Результат - массив строк таблицы значений, соответствующих структуре поиска. Список значений, таблица значений, дерево значений Замечание: если в этом примере в структуру поиска добавить поискнужного значения, например, еще и в колонке «Ответственный» - то в результате применения метода НаЙТиСтроки() получим все строки, где и «Сотрудник» и «Ответственный» равны искомому значению. Как перебрать строки таблицы значений? Поскольку имеем дело с индексированной коллекцией, то можно использовать цикл перебора элементов коллекции или «цикл-счетчик». Например, чтобы сообщить значения колонки «Сотрудник» всех строк таблицы значений «ТаблицаСотрудников», можно использовать следующий код: То же через «цикл-счетчик»: ® Как удалить строки (колонки) таблицы значений? Удаление отдельных строк таблицы значений происходит с обязательным указанием удаляемой строки или индекса удаляемой строки. Если нужно удалить строку «УдаляемаяСтрока», входящую в таблицу значений «ТаблицаЗначений»: А так, например, будет удалена первая строка таблицы значений: 69 Универсальные коллекции Естественно, если указанный индекс будет выходить за границу индексов строк таблицы значений - получим сообщение об ошибке. Аналогично и для колонок. Только работать уже надо с коллекцией колонок таблицы значений. Доступ к ней - через свойство КОЛОНКИ таблицы значений. или Кроме того необходимо учитывать, что удаление строки (или колонки) «из середины» таблицы значений приведет к уменьшению на единицу индексов строк, стоявших «после» удаленной (эффект «смыкания рядов», вернее -«смыкание строк»). Например, решим задачу удаления всех строк таблицы значений «ТаблицаЗначений», содержащих числовые значения хотя бы в одной колонке: Сначала определяем самые старшие индексы строк и колонок таблицы значений. Цикл проверок и удалений строк будет выполняться, пока очередное значение индекса строки не окажется меньше нуля. Внутри цикла но строкам делаем цикл-счетчик перебора индексов колонок. Во вложенном цикле определяем тин значения элемента находящегося в строке с текущим индексом и в очередной колонке. Если 70 Список значений, таблица значений, дерево значений это число - удаляем строку таблицы значений и прерываем вложенный цикл. Кроме того, в любом случае на каждом шаге внешнего цикла уменьшаем на единицу значение переменной «Индекс». В результате, поскольку перебор строк таблицы значений производится с конца, то эффект «смыкания рядов» будет актуален только для уже проверенных элементов. Как заполнить таблицу значений, если имена колонок содержатся в переменных? Если имя колонки, для которой требуется установить значение, содержится в переменной, можно использовать оператор : В вышеприведенном коде: «ТаблицаЗначений» - имя таблицы значений; «ИмяКолонки» - строковая переменная, содержащая имя колонки, по которой нужно заполнить значение; «Значение» - переменная, содержащая само заполняемое значение. Как заполнить всю колонку таблицы значений нужным значением? Колонку «ФлагФискального Учета» в таблице «ТаблицаЗначений» необходимо заполнить значением Ложь. значений Применяем для таблицы значений метод ЗаполнитьЗначения(). Первым параметром передаем заполняемое значение. Вторым параметром - имя заполняемой колонки. Замечание: если нужно заполнить несколько колонок значением - их имена указывают через запятую во втором параметре. Если не указать второй параметр - значением заполнятся все поля таблицы. 71 Универсальные коллекции Как таблицу значений «ТаблицаПолучатель» заполнить данными таблицы значений «ИсходнаяТаблица»? Если «ТаблицаПолучатель» на момент выполнения операции еще не существует, или ее предыдущие колонки сохранять не нужно, можно создать ее, как полную копию исходной: Вариант второй: таблица «ТаблицаПолучатель» существует, и жалко терять ее колонки и ограничения на типы данных колонок. Но нужно заполнить данные по колонкам, имена которых совпадают с именами исходной таблицы. Тогда можно так: Для каждой строки исходной таблицы добавляется новая строка в таблицу получатель и выполняется заполнение значений в тех колонках новой таблицы, имена которых совпадают с именами колонок в исходной таблице. Замечание: если у таблиц не будет колонок с одинаковыми именами - таблица-получатель будет в результате содержать столько же строк с пустыми значениями, сколько строк было в таблице-источнике. Если у каких-то одноименных колонок тип значения данных из таблицы-источника не попадет в массив разрешенных типов колонки таблицы-получателя - в таких полях получим пустые значения. Рассмотрим третий случай. В случае одноименных колонок - колонку таблицы-получателя нужно привести в полное соответствие колонке таблицы-источника. 72 Список значений, таблица значений, дерево значений Нам придется заменить колонку в таблице получателе на новую, чьи свойства полностью будут соответствовать колонке таблицы-источника. Поэтому в случае обнаружения в таблице-получателе одноименной колонки собираем в переменных все свойства для новой колонки. Далее удаляем старую и создаем новую колонку. Далее выполняем цикл перебора строк исходной таблицы. В цикле добавляем к таблице-получателю новую строку и открываем цикл перебора имен колонок в массиве совпадающих колонок. Внутри этого вложенного цикла производим заполнение ячеек таблицы получателя данными ячейки таблицы-источника. 73 Универсальные коллекции Как добавить колонки к таблице значений «ТаблицаЗначений» с ограничениями по типу? При добавлении колонки можно просто указать ее имя, а второй параметр метода Добавить() - не трогать. В этом случае тип данных колонки - произвольный. Можно заполнить значение второго параметра. Туда необходимо передавать описание разрешенного для колонки типа. Само описание можно получить при помощи конструктора, передав последнему в качестве параметра строковое название типа (если много типов - через запятую) или массив допустимых типов. Если среди типов разрешенных к заполнению данных колонки есть строка - можно ограничить ее разрядность (длину), указать использование неременной или фиксированной длинны. Все это обеспечивается созданием объекта при помощи конструктора КвалификаторыСтроки. Далее этот объект будет использован в качестве одного из параметров конструктора ОписаниеТипов. Аналогичные действия можно квалификаторов числа и даты. 74 осуществлять в отношении Список значений, таблица значений, дерево значений Обратите внимание, описание типов можно строить конструктором как «с нуля», так и использовать как основу уже существующее описание типов. Как изменить тип значения колонки таблицы значений, полученной выгрузкой из запроса? Запросом собираются данные по документам «Посту плениеТоваров Услуг» PI выгружаются в таблицу значений «ТаблицаСсылок» (колонка «Ссылка»). Впоследствии к этой таблице значений будут добавляться еще строки. Как обеспечить возможность добавления в полученную таблицу значений в колонку «Ссылка» документов других видов («ОприходованиеТоваров», « ВозвратОтПокупателя») ? При выгрузке данных из запроса в таблицу значений тип значения колонок определяется типом значений колонок результата запроса. Поэтому одним из самых простых вариантов решения задачи может быть воздействие на запрос, а не на таблицу значений. 75 Универсальные коллекции Создаем пустые ссылки на документы «ОприходованиеТоваров» и «ВозвратОтПокупателя». Далее в запросе делаем объединение с записями, содержащими эти пустые ссылки. Причем в объединяемых запросах по пустым ссылкам применяем ПЕРВЫЕ 0 для того, чтобы впоследствии не удалять строки с пустыми ссылками из таблицы выгруженного результата запроса После выполнения и выгрузки запроса в таблицу значений «ТаблицаСсылок» тип значения колонки «Ссылка» будет составным: «NULL, ДокументСсылка ЛоступлениеТоваровУ слуг, ДокументСсылка. ОприходованиеТоваров, ДокументСсылка.ВозвратОтПокупателя». То есть - то, что и требовалось. Как самостоятельно заполнить дерево значений? Для иллюстрации данной возможности создадим обработку, в которой определен реквизит «Дерево» (тип ДеревоЗначениЙ). В диалоге определено табличное поле, связанное через свойство данные с реквизитом «Дерево» (имя элемента управления «Дерево»). Следующая процедура произведет запись данных в дерево значений. 76 Список значений, таблица значений, дерево значений Следующая процедура показывает один из вариантов установки текущего значения в элементе управления, связанного с деревом (табличном поле). 77 Прикладные объекты Справочники © Как создать элемент (группу) справочника? Создание нового элемента в неиерархическом справочнике можно выполнить при помощи следующего кода: Если справочник иерархический, то выполнение этого кода приведет к созданию нового элемента в корне справочника. Для того чтобы создать новый элемент в определенной группе иерархического справочника, необходимо также указать родителя создаваемого элемента: Если требуется создать новую группу в иерархическом справочнике, то для этого следует использовать метод менеджера справочника Создать Груп пу (). Если группа должна находиться внутри 78 Справочники определенной группы справочника, также следует указать и родителя создаваемой группы: Следует обратить внимание на тот факт, что у реквизитов, в которые будет производиться запись значений в свойстве «Использование» должно стоять одно из перечисленных ниже значений: Для группы Для группы и элемента Если для справочника установлен вид иерархии Иерархия элементов, то для создания новых элементов следует использовать метод СоздатьЭлемент() менеджера справочника, а иерархия создаваемых элементов будет определяться значением свойства Родитель объекта справочника: 79 Прикладные объекты Как найти элемент справочника? Для поиска элемента справочника можно использовать несколько способов. По коду: При организации поиска по коду обращайте внимание на тип кода справочника (Число или Строка). По наименованию: По реквизиту: Во всех методах поиска есть параметры позволяющие искать в нужной группе, в рамках подчинения определенному элементу справочника владельца и ряд других параметров. 80 Справочники Как удалить элемент справочника? Для корректного удаления элемента справочника необходимо убедиться в том, что другие данные не содержат ссылок на удаляемый элемент справочника. Например, в переменной «СсылкаНаУдаляемыйЭлемент» содержится ссылка на удаляемый элемент справочника: Для пометки элемента справочника на удаление можно использовать метод УстановитьПометкуУдаления() объекта справочника: Использование этого метода позволяет установить или снять пометку на удаление элемента справочника, причем будут инициированы события Перед записью и При записи объекта справочника, поскольку выполняется сохранение измененного свойства ПометкаУдаления объекта справочника. 81 Прикладные объекты Как перебрать элементы справочника? Для того чтобы перебрать элементы справочника, необходимо сформировать выборку элементов с нужными параметрами и затем обойти ее в цикле. Например, для перебора всех элементов справочника «Номенклатура» в иерархическом порядке, можно использовать следующий код: Аналогичного результата можно добиться, используя запрос: Благодаря использованию запроса можно формировать выборку элементов справочника более «гибко», поскольку запрос позволяет задать произвольные условия на выбираемые данные. 82 Справочники ® Как выбрать все элементы из определенной группы? Организуем выборку элементов справочника из группы, ссылка на которую определена в переменной «ПолеВводаРодитель»: В результате работы этого кода будут получены все дочерние элементы выбранного элемента справочника. Аналогичное действие, выполняемое с помощью запроса, будет выглядеть следующим образом: 83 Прикладные объекты Если необходимо получить не только дочерние элементы, но и все элементы, находящиеся в иерархии выбранного элемента, следует, при использовании объектной техники, выполнять метод ВыбратьИерархически() менеджера справочника: а при использовании запроса применять условие В ИЕРАРХИИ: 81 Справочники ® Как перебрать элементы подчиненного справочника с помощью запроса? Справочник «КонтактныеЛица» подчинен справочнику «Контрагенты». Требуется перебрать всех контактных лиц определенного контрагента. Ссылка на данного контрагента находится в переменной «Контрагент». Делаем запрос по таблице справочника «Контактные лица» с отбором по полю «Владелец». В качестве владельца передаем ссылку на элемент справочника «Контрагенты». 85 Прикладные объекты ® Как перебрать элементы подчиненного справочника с помощью выборки справочника? Справочник «КонтактныеЛица» подчинен справочнику «Контрагенты». Требуется перебрать всех контактных лиц определенного контрагента. Ссылка на данного контрагента находится в переменной «Контрагент». ф Как открыть форму списка (элемента) справочника? Для того чтобы открыть форму списка справочника, можно воспользоваться методом ПолучитьФормуСписка() менеджера справочника: Для того чтобы открыть произвольную форму справочника, можно использовать метод ПолучитьФорму() менеджера справочника: Однако следует помнить, что если методом ПолучитьФорму() выполняется получение формы элемента или группы справочника, то будет получена форма нового элемента (группы). Справочники Для того чтобы открыть форму существующего элемента или группы справочника, следует использовать метод ПолучитьФорму() ссылки или объекта справочника: ® Как добавить запись в табличную часть элемента справочника? Имеется ссылка на элемент справочника «Контрагенты». Как добавить запись в табличную часть «ВидыДеятельности» этого элемента? Модифицировать можно только объект справочника. Поэтому так: Получаем объект справочника от ссылки на элемент. Добавляем новую строку к табличной части полученного объекта. Заполняем реквизиты табличной части в данной строке. Записываем измененный элемент справочника. Как удалить строки из табличной части справочника? Для того чтобы полностью очистить табличную часть элемента справочника, можно воспользоваться методом ОЧИСТИТЬ() табличной части справочника: 87 Прикладные объекты Если требуется выборочное удаление строк табличной части (например, в зависимости от значения их реквизитов), можно сначала отобрать строки, удовлетворяющие условию, а затем удалить каждую из них методом Удалить() табличной части справочника. В следующем примере подразумевается, что переменная «ВыбранныйЭлемент» содержит ссылку на обрабатываемый элемент справочника, а переменная «ВыбранныйВидДеятельности» содержит ссылку на вид деятельности, который не должен присутствовать у обрабатываемого элемента: ф Как перебрать строки табличной части справочника? Табличная часть справочника представляет собой коллекцию строк, которую можно перебрать в цикле. Реквизиты табличной части будут доступны как свойства строки табличной части. Например, перебор строк табличной части «ВидыДеятельности» справочника «Контрагенты» может быть выполнен следующим образом: Справочники ® Как создать элемент в нужной группе? Необходимо создать элемент справочника номенклатура, так чтобы при этом он попал в нужную группу. Если группы с указанным кодом нет, то тогда такая группа должна быть создана. Можно использовать предопределенную группу, в этом случае вместо поиска и создания новой группы можно использовать строку: 89 Прикладные объекты Обратите внимание на тот факт, что механизм работает, только если в справочнике установлен вид иерархии «Иерархия групп и элементов». В противном случае код будет выглядеть следующим образом: Если вид иерархии справочника «Иерархия элементов», то понятие группы в нем отсутствует. Как узнать, есть ли у текущего элемента подчиненные? Пусть ссылка на текущий элемент справочника содержится в переменной «Владелец». Необходимо узнать, есть ли в справочнике «Единицы измерения» элементы, подчиненные текущему элементу. Если использовать объектную модель доступа: 90 Справочники Фактически получаем выборку всех подчиненных элементов и если в выборке есть хоть одна позиция, считаем, что подчиненные элементы существуют. Именно этот факт и говорит о неэффективности использования данного варианта (выбираемые данные мы не используем, а получаемый блок данных может быть большим). Лучше всего подобную проверку можно выполнить, используя возможности запросов: Так как не предполагается, что нам понадобятся данные о подчиненном элементе, выборку результата запроса в переменной не сохраняем. Как узнать количество подчиненных элементов у выбранного элемента справочника? Необходимо определить количество элементов в справочнике «ЕдиницыИзмерения» подчиненных элементу справочника, ссылка на который находится в переменной «Владелец». С помощью объектной модели: 91 Прикладные объекты Данное решение в общем случае является не эффективным. Связано это с тем, что выборка фактически получает все данные о подчиненных элементах справочника, а в рамках данной задачи нужно только количество элементов. Если решать задачу с помощью запроса, то решение выглядит следующим образом: В результате в переменной «КоличествоЗаписей» будет находиться нужная нам величина. Справочники Как узнать количество подчиненных элементов у выбранного элемента справочника, если количество подчиненных справочников больше чем один? Если у справочника есть несколько подчиненных справочников, то запрос может выглядеть следующим образом: Данный запрос позволяет получить количество записей в двух подчиненных справочниках. В качестве источника данных в основном запросе используется подзапрос («ВложенныйЗапрос»). Сам подзапрос состоит из двух запросов (происходит их объединение). Каждый из объединяемых запросов получает данные о количестве записей в одном из подчиненных справочников. В выборке результата запроса (в случае если у элемента справочника, ссылка на который находится в переменной «Владелец», есть подчиненные элементы) будет одна строка, в поле «КоличествоПодчиненныхЭлементов» которой содержится количество подчиненных элементов. 93 Прикладные объекты Как получить всех родителей выбранного элемента справочника? В переменной «СсылкаНаЭлемент» находится ссылка на элемент справочника. Необходимо получить всех родителей данного элемента Перебрать всех родителей можно используя строки кода: Данную задачу можно решить и с помощью запроса, однако следует учитывать, что в языке запросов не предусмотрено специальных средств для получения всех родителей элемента. Для выполнения задачи можно воспользоваться, например, иерархическими итогами, текст запроса будет выглядеть следующим образом: Результат запроса будет содержать одну «лишнюю» запись, которую легко «отсеять» проверкой свойства «ЭтоГруппа». 94 Справочники Однако получение иерархических итогов оптимизировано для построения итогов большого количества записей, и не вполне эффективно для получения родителей одного элемента. Для более эффективного получения всех родительских записей элемента, рекомендуется перебирать в цикле его родителей небольшими порциями, например, так: 95 Прикладные объекты В данном примере в окно служебных сообщений выводятся все родители для ссылки, записанной в переменную «ЭлементНоменклатура». В цикле выбирается по 5 родителей ссылки. Если число уровней в справочнике ограничено и невелико, то возможно получение всех родителей одним запросом без цикла. Как получить запросом «полный» код элементов справочника, если тип кода Строка? Понятие «Полный код» соответствует объектной модели системы. Это свойство объектов «СправочникСсылка» и «СправочникОбъект», содержащее указание кодов элемента и всех родителей его иерархии. Представляет собой строку, в которой указаны коды всех вышестоящих элементов иерархии, начиная с самого верхнего уровня и разделяемые символом «/» заканчивая кодом самого элемента. В табличной модели хранения информации никакого поля «ПолныйКод» для таблиц справочника не существует. Однако можно говорить о значении поля «Родитель» каждой из записей таблиц справочников и о значении поля «Код». Поэтому запрос по трехуровневому справочнику «Контрагенты» будет выглядеть следующим образом: Источником является таблица справочника. Из нее выбираем поле «Ссылка» и вычисляемое поле «ПолныйКод». Вычисление полного кода производим путем сборки его из значений кодов самого элемента и кодов всех вышестоящих родителей. Для этого для каждой записи сначала определяем ее уровень. 96 Справочники Уровень определяем следующим образом: для записей корневого уровня поле «Родитель» содержит пустую ссылку на элемент справочника, поэтому значение поля «Код» этого «Родителя» будет NULL. Если это условие выполнилось - значит, элемент находится на корневом уровне, и в качестве полного кода достаточно указать код. Если условие не выполнилось - проверяем аналогичным способом элемент на принадлежность к первому уровню. В случае выполнения условия - выводим уже код родителя и код самого элемента через «/». Таким же образом можно построить «сборку» поля «ПолныйКод» для случаев 4-х, 5-ти и т.д. уровневых справочников. В отношении возможных возражений о «неуниверсальности» подобного подхода: хотя, в общем случае, количество уровней справочника может быть не ограничено, сложно представить себе реальную практику использования справочника более чем с 10 уровнями вложенности из-за явного неудобства работы пользователя с таким «глубоким» справочником. Как получить все элементы справочника, содержащие в наименовании определенную подстроку, со всей иерархией, в которую они входят? Допустим, речь идет о справочнике «Контрагенты». Лучше всего с данной задачей справится запрос со следующим текстом: 97 Прикладные объекты Источником запроса является таблица справочника. Делаем отбор по наименованиям, в составе которых присутствует значение параметра «ЧастьНаименования». Условие отбора обеспечивается посредством оператора проверки строки на подобие шаблону. В шаблоне служебными символами «%» обозначается, что перед и после части строки, считанной из «ПолеВводаПодстрока», может встречаться произвольное количество других символов. Как найти все элементы справочника, в которых не заполнен строковый реквизит? Получить желаемое можно таким запросом: Проверка пустой строки выполняется за счет операции сравнения «=». В данном случае будут отобраны и элементы, в которых пользователь ничего не вводил и даже те, в которые он ввел только пробел (или пробелы). Но на некоторые реквизиты при работе с формой накладывают маску. В таких случаях случайный ввод хотя бы одного пробела уже не позволяет данному реквизиту быть пустым. Его значение будет содержать маску с пробелами. Для того, чтобы «защитить пользователя от самого себя» в подобных случаях запрос лучше немножко изменить. Например, для реквизита с маской «999-999-999 99» запрос будет выглядеть таким образом: Количество пробелов соответствовать маске. перед и между символами «-» должно Справочники Как перенести все элементы справочника «Контрагенты» из одной группы в другую? Для этого необходимо перезаполнить значением нового родителя реквизит «Родитель» у элементов, непосредственно являющихся «потомками» исходного родителя. Итак, пусть переменная «СтарыйРодитель» содержит старого, а «НовыйРодитель» - нового родителя. Получение элементов справочника, которым нужно поменять родителя, производим следующим образом: Источником для запроса является таблица справочника «Контрагенты». Делаем отбор непосредственно по полю «Родитель» и получаем таблицу ссылок на нужные нам элементы справочника. Далее: В цикле обработки результата запроса производим получение объекта по ссылке. Для каждого полученного объекта производим запись нового родителя в реквизит «Родитель» и непосредственную запись объекта с измененными данными. 99 Прикладные объекты Как организовать программный выбор элемента справочника? Требуется из одной формы (например, формы документа) открыть для выбора элемента форму справочника. После того, как значение будет выбрано в форме справочника, его необходимо получить для дальнейшей обработки в форме документа. Для получения выбранного значения используется обработчик события Обработка выбора формы владельца (в нашем случае формы документа). Вместо метода Открыть() объекта Форма Выбора в ряде случаев можно использовать метод ОткрытьМодально(). В этом случае окно откроется в модальном режиме и пока данная форма не будет закрыта

Фірма 1С прикладає чимало зусиль для навчання програмістів, які ведуть розробку на базі 1С. Один з головних методів навчання - випуск літератури для на прикладному мовою 1С 8. Розглянемо докладніше найпопулярніші книги з програмування, які повинен прочитати кожен поважаючий себе.

Почнемо розгляд з дуже корисних книг, які йдуть в комплекті з кожною програмою 1С (комплект може незначно відрізнятися).

Книги з «коробки» програми 1С

1С: Підприємство 8 Керівництво по установці і запуску

Книга для початківців адміністраторів і програмістів, де розписані технічні нюанси, установки ключів ліцензій, рекомендовані настройки.

1С: Підприємство 8 Опис вбудованої мови

Книга випущена в чотирьох частинах. У них Ви знайдете достатню повний опис вбудованого, опис мови запитів, опис вбудованих методів, опис прикладних об'єктів і т.д.

1С: Підприємство 8 Конфігурація і адміністрування

Книга містить інформацію, яка буде корисна як програмістам, так і адміністраторам. Книга містить в собі опис основних об'єктів метаданих системи і способи її використання.

1С: Підприємство 8 клієнт-сервер. Особливості установки і використання (для поставок «клієнт-сервер»)

Дана література надається тільки з поставками для установки в клієнт-серверному режимі роботи. Книга описує методи настройки серверів 1С, особливості настройки клієнтських додатків, настройки захисту сервера, особливості функціонування та налаштування інформаційної системи.

1С: Підприємство 8.2. Прості приклади розробки

Відмінна книжка для початківців розробників. У літературі описані приклади реальних завдань і їх докладний рішення. Книга розділена на дев'ять глав, розсортовані за видами завдань. Ця невелика книга може стати вірним помічником на перших порах вивчення.

1С: Підприємство 8.3. Практичний посібник розробника

Отримайте 267 відеоуроків по 1С безкоштовно:

Книга є логічним продовженням «Простих прикладів розробки» - вона містить рішення більш складних прикладних задач. Книга написана з урахуванням останніх нововведень в системі 1С Підприємство 8.3, в т.ч. керовані форми.

З метою популяризації мови програмування фірма 1С встановила на цю книгу дуже вигідну ціну - від 140 рублів для партнерів і від 240 рублів для роздрібних покупців.

Рішення спеціальних прикладних задач в «1С: Підприємстві 8.2»

Дана книга дозволить заглибитися в рішення дійсно складних завдань. Причому складних не тільки з технічної точки зору, але і з методологічної. У книзі описано рішення вузькоспеціалізованих завдань, таких як автоматизація бізнес-процесів, аналіз даних, побудова аналітичних звітів і ін. Література призначена для досвідчених програмістів 1С.

Професійна розробка в системі 1С: Підприємство 8.3 "

Книга, яку охрестили «Біблією 1С». Книга має формат двотомника А4 і сумарно містить 1 400 аркушів знань. У літературі описаний весь спектр можливостей і функцій інтегрованого середовища розробки. Інформація викладена в енциклопедичність вигляді. Рекомендую як настільну книгу, за допомогою якої Ви можете в будь-який момент освіжити в пам'яті потрібний момент. Книга об'єднує в собі практично всю літературу по розробці.

Книга випущена для отримання відповідей на питання, які виникають в процесі розробки керованих форм. У літературі розглянуто величезна кількість прикладів, серед яких Ви напевно знайдете свою задачу. Книга розбита на чотири розділи - конструювання командного інтерфейсу, конструювання форм, програмування форм і оптимізація клієнт-серверної взаємодії.

Розробка складних звітів в «1С: Підприємстві 8.3». Система компоновки даних

  - дуже важливих механізм 1С підприємства. Однак разом з важливістю механізм вважається досить складним для розуміння розробників. У книзі вивчається система компонування даних починаючи з пояснення термінів і побудови легких звітів і закінчуючи найскладнішими аналітичними звітами.

Технології інтеграції 1С: Підприємства

Книга стане незамінним помічником для розробників, що займаються інтеграцією з іншими інформаційними системами. У книзі розглянуті інтеграційні приклади з використанням наступних технологій: txt, dbf, xml, zip, HTML, excel, FTP, HTTP, e-mail, Web-services і тд.

1С: Підприємство 8. Конвертація даних: обмін даними між прикладними рішеннями

Дана книга допоможе розібратися в створенні правил обміну між різними конфігураціями. У ній описані основи написання правил обміну в конфігурації. Однак багато в чому ця книга - копія вбудованої довідки в конфігурацію Конвертація даних.

Побудована проста конфігурація обліку руху картриджів для лазерної техніки в організації з використанням платформи 1С Підприємство 8.3 та інтерфейсу "Таксі". Враховується рух кожного картриджа (покупка, заправка, відновлення, ремонт, установка в принтер і ін.) І витрата коштів по кожному картриджу. Основна мета - освоїти розробку додатків на базі платформи 1С Підприємство 8.3 на прикладі побудови працездатного і корисного додатка.

Я програміст зі стажем, але 1С серйозно раніше не займався. Щоб поєднати приємне (знайомство з 1С Підприємство 8.3) з корисним (роботу ніхто не відміняв) спробуємо побудувати працездатну конфігурацію з використанням можливостей нової версії. Може бути процес розробки конфігурації буде для кого-то корисним і допоможе початківцям освоїти 1С.

Працюю у відділі IT великої організації з великою кількістю лазерних принтерів і МФУ. Облік руху картриджів для них є актуальним завданням і вимогою керівництва.

Постановка задачі.

Заправка тонером, відновлення, ремонт картриджів здійснюється сторонньою організацією. Необхідно враховувати рух кожного картриджа, тобто покупку, заправку тонером, відновлення, ремонт, установку в конкретний принтер (МФУ), місце свого перебування, списання та ін. Крім того треба враховувати витрати по кожному картриджу (витрати на покупку, заправку тонером та ін. в розрізі постачальників).

Ясна річ - потрібні якісь звіти. Само собою для користувачів все повинно бути якомога простіше і зрозуміліше.

План реалізації.

Використовуємо платформу 1С Підприємство 8.3 як найсучаснішу на поточний момент.

Для освоєння платформи постараємося використовувати якомога більше різних об'єктів конфігурації і, природно, новий інтерфейс «Таксі». Постараємося давати об'єктам зрозумілі і близькі до функціональним призначенням імена. Не будемо поки стосуватися «тонких» моментів роботи 1С, як-то оптимізація клієнт-серверного взаємодії, розподілу ролей та ін.

Припустимо для початку, що в нашій конфігурації будуть наступні об'єкти:

Довідники:

НоменклатураКартріджей

  картриджі

  НоменклатураКартріджейЦени

  Принтери

  номенклатура принтерів

  постачальники

документи:

ПоступленіеКартріджей

  ЗаменаКартріджа

  СпісаніеКартріджей

перерахування:

Та ні

  СостояніеКартріджей

  ПрічіниЗамениКартріджей

Регістри відомостей:

КартріджіЗамена

Регістри накопичень:

КартріджіОплата

Алгоритм роботи.

Основним «дійовою особою» є список наявних картриджів (Довідник картриджі). Спочатку список заповнюється документом ПоступленіеКартріджей НоменклатураКартріджей. При покупці картриджа значення реквізит стан   в документі вибирається як новий. Ціна покупки визначається за довідником НоменклатураКартріджейЦенинатекущую дату Серійний номер). реквізит Місцезнаходженнявизначається як «З скарб ».

Облік заправок, відновлення, ремонту та ін. Існуючих вже картриджів здійснюється також документом ПоступленіеКартріджей. Тип картриджів визначається за довідником НоменклатураКартріджей. Стан картриджа визначається з перерахування СостояніеКартріджей. Ціна роботи (заправка, відновлення) визначається за довідником НоменклатураКартріджейЦени. Унікальність картриджа визначається його серійним номером (реквізит Серійний номер).

При проведенні документа ПоступленіеКартріджей   в табличну частину ЗаменаКартріджей   довідника картриджі   додається рядок з реквізитами поточного документа і у відповідних картриджів (з серійним номером з документа) в довіднику картриджі   змінюється значення реквізитів стан   і Місцезнаходження.

Крім того, в регістрнакопленій   КартріджіОплата

Облік заміни картриджа в конкретному принтері (довідник Принтери) Здійснюється документом ЗаменаКартріджа. У документі вказується поточний принтер. Унікальність принтера визначається реквізитом Серійний номер. Вказується встановлюється і замінюється картридж (серійні номери картриджів).

При проведенні документа ЗаменаКартріджав табличній частині довідника Принтери   у поточного принтера додається рядок з реквізитами документа і змінюється реквізит картридж. У довіднику картриджі   у поточних картриджів змінюється значення реквізитів стан   і Місцезнаходження. Для встановленого картриджа в реквізиті Місцезнаходження   прописується поточний принтер, а у знятого картриджа - « склад ».

Крім того, в регістр   КартріджіЗамена   заноситься рух по даному документу.

Списання картриджів здійснюється окремим документом СпісаніеКартріджей.

Таким чином, в поточний момент часу в довіднику картриджі   кожен картридж має цілком певний стан (новий, заправлений, порожній і ін.) і певний місце розташування ( «Склад»або конкретний принтер), що шляхом нескладних звітів дозволяє оцінити наявність картриджів з заданим станом і зробити висновок про необхідність покупки, заправки і ін. Ну і врахувати витрати природно.

Реалізація.

Приступимо власне до конфігурації.

Створимо порожню базу в конфігураторі, назвемо її гордо «айтішників» і організуємо підсистему облік картриджів. Не буду описувати по кроках, як це зробити, оскільки з даного питання книг вистачає.

Спочатку додамо перерахування: Та ні, СостояніеКартріджей   і ПрічіниЗамениКартріджей   , Які нам знадобляться в подальшому. Склад перерахувань видно на Рис.2

Сконфігуріруем прості довідники НоменклатураКартріджей   і НоменклатураПрінтеров.

реквізиту ТіпКартріджа   в довіднику НоменклатураПрінтеров   дамо тип посилання на довідник НоменклатураКартріджей   (Рис.3). Не забуваємо, що все сформовані нами об'єкти конфігурації треба включити до складу підсистеми УчетКартріджей.

У довіднику Принтери   кілька реквізитів мають тип посилання:

Для подальшого тестування програми заповнимо в режимі Підприємство по кілька рядків у відкритих нами довідниках. Природно, спочатку заповнюємо прості довідники, потім - довідники з реквізитами посиланнями. Надалі завантаження повних реальних даних підприємства передбачається здійснити за допомогою обробки з таблиць Excel.

Тепер настала пора додавання в конфігурацію документів. Сконфігуріруем в дереві об'єктів конфігурації об'єкт документ ПоступленіеКартріджей   з реквізитами і табличній частиною НоменклатураДокумента   . Регістрів накопичення у нас в конфігурації поки немає - закладка рух   для документа залишається порожньою. Оскільки нам треба буде писати свою обробку документа, а пишеться програмний код в модулі форми документа, то і створимо цю саму форму (Рис.9). Робимо все за замовчуванням, як написано в книжках (Форма - Додати - ФормаДокумента).

Використовувати даний документ будемо при надходженні на склад як нових, так і заправлених (відновлених, відремонтованих) картриджів.

Нарешті, для обліку надходження картриджів заводимо регістр накопичення КартріджіОплатаз вимірами, ресурсами і реквізитами (Рис.10) .

У закладці реєстратори   вказуємо наш документ ПоступленіеКартріджей. Зберігаємо конфігурацію.

Повертаємося по дереву об'єктів в документ ПоступленіеКартріджей. на закладці рухвибираємо регістр КартріджіОплата, Запускаємо Конструктор рухів і заповнюємо поле Вираз значеннями реквізитів документа (Рис.11).

Тиснемо ОК і потрапляємо в модуль об'єкта   програмний код (Рис.12).

Тепер найцікавіше - треба додати в Модуль об'єкта програмний код, для забезпечення наступного функціоналу при проведенні документа ПоступленіеКартріджей.

При надходженні нового картриджа (купівля) в довіднику картриджі   повинна додаватися рядок з унікальним номером картриджа і відповідними (з документа) реквізитами. При цьому реквізит СостояніеКартріджа   матиме значення « новий», А реквізит Місцезнаходження- значення « склад». Таблична частина довідника картриджі   при цьому не заповнюється.

За алгоритмом роботи програми спочатку треба занести кожен картридж зі своїм унікальним номером в довідник картриджі   документом ПоступленіеКартріджей.

При надходженні заправленого тонером (відновленого, відремонтованого та ін.) Картриджа вважається, що картридж з таким номером вже є в довіднику картриджі, І в цьому випадку при проведенні документа ПоступленіеКартріджей,додається строкав Табличну частина заправкиі змінюються значення реквізитів місцезнаходження   і стану поточного картриджа. Доданий в Модуль об'єкта код показаний на Рис.13.

Тепер можна провести першу пробу працездатності програми. В Підприємство створюємо документ ПоступленіеКартріджей(Рис.14). натискаємо кнопку Провести і закрити. Переходимо в довідник картриджіі бачимо, що в ньому з'явилася рядок з реквізитами купленого картриджа з порожньою табличній частиною (Рис.15).

відкриємо регістр КартріджіОплата(Пункт в меню Регістр оплати картриджів) І побачимо там аналогічну рядок.

Створюємо і проводимо другий документ ПоступленіеКартріджей   з тим же картриджем, але заправленим (Рис.16).

Переходимо в довідник картриджі   і бачимо, що у заведеного нами картриджа додалася рядок в табличній частині заправки   і змінився реквізит стан   (Рис.17).

Ура! Програма працює!

Звичайно функціональність документа ПоступленіеКартріджей   треба доопрацювати, наприклад, хотілося б, щоб автоматично підставлялась остання за датою ціна послуги в поле вартість   документа з довідника НоменклатураКартріджейЦени   при виборі постачальника і для даного типу картриджа.

Це буде пізніше, а зараз займемося заміною картриджів - створимо документ ЗаменаКартріджаі відповідний регістр відомостей КартріджіЗамена.

Реквізити і таблична частина документа НоменклатураДокумента   показані на Рис.18. Відповідних регістрів накопичення і відомостей у нас в конфігурації поки немає, в закладка рух   для документа не будемо нічого відзначати. Оскільки нам треба буде писати свою обробку документа, то створюємо ФормуДокумента за замовчуванням.

Для обліку заміни картриджів заводимо для різноманітності регістр відомостей (НЕ регістр накопичень) КартріджіЗаменаз вимірами і реквізитами (Рис.19) . Вийшло поки без ресурсів якось .

У закладці реєстратори   вказуємо наш документ ЗаменаКартріджа.

Зберігаємо конфігурацію. Повертаємося по дереву об'єктів в документ ЗаменаКартріджа.   на закладці рухвибираємо регістр КартріджіЗамена, Запускаємо Конструктор рухів і заповнюємо поле Вираз значеннями реквізитів документа. Тиснемо ОК і потрапляємо в модуль об'єкта   документа, де і бачимо вже створений Конструктором руху регістрів   програмний код (Рис.20).

Тепер додаємо в модуль об'єкта   програмний код, для забезпечення наступного функціоналу при проведенні документа ЗаменаКартріджа. У довіднику Принтеридля принтера, у якого замінюється картридж повинна додатися рядок в табличній частині ЗаменаКартріджей   зі значеннями реквізитів з документа і зміниться значення реквізиту НомерКартріджаСейчас.У довіднику картриджі   у знятого і встановленого картриджів зміняться значення реквізитів Місцезнаходження   і стан   . Допрацьована процедура обробки проведення документа ЗаменаКартріджа   показана нижче.

Процедура ОбработкаПроведенія (Відмова, Режим)

// використовувані довідники

Принтери \u003d Справочнікі.Прінтери;

Картриджі \u003d Справочнікі.Картріджі;

// кінець вставки використовуються довідники

  // регістр КартріджіЗамена

Двіженія.КартріджіЗамена.Запісивать \u003d Істина;

Для Кожного ТекСтрокаНоменклатураДокумента З НоменклатураДокумента Цикл

Рух \u003d Двіженія.КартріджіЗамена.Добавіть ();

Двіженіе.НоменклатураКартріджей \u003d НоменклатураКартріджа;

Двіженіе.СнятКартріджНомер \u003d ТекСтрокаНоменклатураДокумента.СнятКартріджНомер;

Двіженіе.УстановленКартріджНомер \u003d

Двіженіе.МодельПрінтера \u003d МодельПрінтера;

Двіженіе.ПрінтерСерійнийНомер \u003d ТекСтрокаНоменклатураДокумента.ПрінтерСерійнийНомер;

Двіженіе.ПрінтерІнвентарнийНомер \u003d

Двіженіе.ТіпКартріджа \u003d ТекСтрокаНоменклатураДокумента.ТіпКартріджа;

Двіженіе.ЗаменаКтоДелал \u003d ЗаменаКтоДелал;

Двіженіе.ПрічінаЗамени \u003d ТекСтрокаНоменклатураДокумента.ПрічінаЗамени;

// змінюємо довідник Принтери

СтрокаНаіменованія \u003d ТекСтрокаНоменклатураДокумента.ПрінтерСерійнийНомер;

Тоді ТекущійОб'ект \u003d

Прінтери.НайтіПоРеквізіту ( "СерійнийНомер", СтрокаНаіменованія) .ПолучітьОб'ект ();

ТекущійОб'ект.НомерКартріджаСейчас \u003d

ТекСтрокаНоменклатураДокумента.УстановленКартріджНомер;

НоваяСтрока \u003d ТекущійОб'ект.ЗаменаКартріджей.Добавіть ();

НоваяСтрока.ДатаЗамени \u003d Дата;

НоваяСтрока.ВідКартріджа \u003d ТекСтрокаНоменклатураДокумента.ТіпКартріджа;

НоваяСтрока.НомерУстановленногоКартріджа \u003d

ТекСтрокаНоменклатураДокумента.УстановленКартріджНомер;

НоваяСтрока.НомерСнятогоКартріджа \u003d

ТекСтрокаНоменклатураДокумента.СнятКартріджНомер;

НоваяСтрока.КтоЗаменіл \u003d ЗаменаКтоДелал;

НоваяСтрока.ПрічінаЗамени \u003d ТекСтрокаНоменклатураДокумента.ПрічінаЗамени;

ТекущійОб'ект.Запісать ();

КонецЕсли;

// змінюємо довідник Картриджі - встановлений картридж

СтрокаНаіменованія \u003d ТекСтрокаНоменклатураДокумента.УстановленКартріджНомер;

тоді ТекущійОб'ект \u003d

Рядок \u003d "";

Рядок \u003d рядок + МодельПрінтера + "" +

ТекСтрокаНоменклатураДокумента.ПрінтерСерійнийНомер + "" +

ТекСтрокаНоменклатураДокумента.ПрінтерІнвентарнийНомер;

ТекущійОб'ект.МестоНахожденія \u003d Рядок;

ТекущійОб'ект.Запісать ();

КонецЕсли;

// знятий картридж

СтрокаНаіменованія \u003d ТекСтрокаНоменклатураДокумента.СнятКартріджНомер;

Тоді ТекущійОб'ект \u003d

Картріджі.НайтіПоРеквізіту ( "Номер", СтрокаНаіменованія) .ПолучітьОб'ект ();

ТекущійОб'ект.МестоНахожденія \u003d "Склад";

ТекущійОб'ект.Состояніе \u003d Перечісленія.СостояніеКартріджа.Пустой;

ТекущійОб'ект.Запісать ();

КонецЕсли;

// кінець зміни довідників

КонецЦікла;

КонецПроцедури;

Для перевірки заповнюємо і проводимо документ ЗаменаКартріджа(Рис.21) . Заходімв довідник Принтери   і бачимо, що у обраного принтера додалася рядок в табличну частину заправки   з реквізитами проведеного нами документа і реквізит НомерКартріджаСейчас   прийняв значення номера встановленого картриджа (Рис.22).

У довіднику картриджі   у картриджа, встановленого в принтер, в реквізит Місцезнаходження записалися дані поточного принтера (Рис.23). І крім того в регістр відомостей КартріджіЗамена   записалося рух по документу (Рис.24)

Таким чином на даний момент вийшла конфігурація з обліку руху картриджів для лазерної техніки, яку в принципі вже можна використовувати в роботі.

З точки зору «ідеології» 1С напевно неправильно змінювати реквізити довідників проведенням документів, використовувати довідник для зберігання поточних цін - тут позначається попередній досвід роботи з таблицями автора статті, а ніж довідник це не таблиця?

Природно потрібна доробка функціональності, додавання звітів, виправлення помилок та налагодження. Про це в наступній частині статті.

Повна версія статті приведена в файлі Часть1.doc