1с преобразовать строку в адрес
Обновлено: 03.07.2024
Была очень сильно дописанная БП 2.0, необходимо было осуществить переход на УТ 11. В плане конвертации контактной информации было относительно просто: посмотрел, как это осуществлено в типовой конфигурации, сделал также - готово. Однако, незадача - адреса переносятся все "в свободной форме", как и остальное, а нужно, чтобы переносилось "красиво".
Задача: перенести контактную информацию из регистра сведений в табличные части объектов без потери "разбиения по заполнению", т.е. чтобы номер дома в пользовательском интерфейсе был на своем месте (в поле "Номер дома"), как и добавочный номер и т.п.
Допущение: правила конвертации для видов контактной информации уже написаны и работают как надо. Конфигурация-приемник имеет общие модули РаботаСАдресамиКлиентСервер, УправлениеКонтактнойИнформациейСлужебныйПовтИсп, УправлениеКонтактнойИнформацией (если конфигурация-приемник типовая, 99% что они есть).
Далее по тексту: КИ - контактная информация.
Поскольку в той базе, которую необходимо перенести, КИ есть лишь трех типов (адрес, email, телефон), рассматривал я только их, однако, полагаю, что и этой информации будет достаточно в 90% случаев.
Структура КИ старого формата.
Общие для всех типов КИ:
Тип - ПеречислениеСсылка.ТипыКонтактнойИнформации - Сам тип КИ.
Вид - СправочникСсылка.ВидыКонтактнойИнформации - Вид КИ, может быть создано сколь угодно.
КИ типа Адрес:
Поле1 - Строка - Индекс, т.е. "658702".
Поле2 - Строка - Регион, т.е. "Алтайский край".
Поле3 - Строка - Район региона, т.е. "Каменский р-н".
Поле4 - Строка - Город, т.е. "Камень-на-Оби г".
Поле5 - Строка - Населенный пункт, т.е. "Плотинная ст".
Поле6 - Строка - Улица, т.е. "Николаева ул".
Поле7 - Строка - Номер дома, т.е. "89".
Поле8 - Строка - Номер корпуса, т.е. "".
Поле9 - Строка - Номер квартиры, т.е. "186".
Поле10 - Строка - Так и не понял, зачем это поле, как бы ни старался заполнять адрес, так и не заполняется :)
КИ типа Телефон:
Если номер заполнен одной строкой, будет заполнено одно из вышеперечисленных полей.
Остальные поля особого смысла не имеют, с той лишь оговоркой, что переносить их все же нужно:
Комментарий - Строка - Собственно, комментарий.
ЗначениеПоУмолчанию - Булево - Нет необходимости переносить.
ТипДома - ПеречислениеСсылка.ТипыДомов - Нам нужно строковое представление поля.
ТипКорпуса - ПеречислениеСсылка.ТипыКорпусов - Нам нужно строковое представление поля.
ТипКвартиры - ПеречислениеСсылка.ТипыКвартир - Нам нужно строковое представление поля.
Структура КИ нового формата:
Структура табличной части объекта, у которого есть КИ:
Тип - ПеречислениеСсылка.ТипыКонтактнойИнформации
Вид - СправочникСсылка.ВидыКонтактнойИнформации
Представление - Строка
ЗначенияПолей - Строка - Строка XDTO
Страна - Строка
Регион - Строка
Город - Строка
АдресЭП - Строка
ДоменноеИмяСервера - Строка
НомерТелефона - Строка
НомерТелефонаБезКодов - Строка
ВидДляСписка - СправочникСсылка.ВидыКонтактнойИнформации
Значение - Строка - Строка JSON
Рассмотрим структуру реквизита "Значение" более подробно. Вся информация хранится в виде строковых представлений.
В общем случае для поля есть три характеризующих значения, их имена формируются следующим образом:
*ИмяПоля* - само поле
*ИмяПоля*Type - сокращение, например, "г.", "с.", "ул.", "край" и т.п.
*ИмяПоля*id - уникальный идентификатор по адресному классификатору.
Общие для любого типа КИ
value - Представление
comment - Комментарий
type - Тип КИ
Поля для типа "Адрес":
country - Страна
countryCode - код страны
addressType - Тип адреса, если заполняется автоматически из адресного классификатора - "Административно-территориальный",
если заполнен вручную, но не одной строкой - "Муниципальный", если одной строкой - "ВСвободнойФорме".
Если тип адреса задан в свободной форме, все поля, расположенные ниже, не заполняются.
ZIPcode - индекс
area - Регион страны (как субъект РФ)
areaType
city - Город
cityType
street - Улица
streetType
если есть модуль РаботаСАдресамиКлиентСервер:
id - уникальный идентификатор
areaCode
areaId
district - Район
districtType
districtId
munDistrict - Муниципальный район (только если тип адреса - Муниципальный)
munDistrictType
munDistrictId
cityId
settlement - Поселение (только если тип адреса - Муниципальный)
settlementType
settlementId
cityDistrict - Внутригородской район
cityDistrictType
cityDistrictId
territory - Территория (только если тип адреса - Муниципальный)
territoryType
territoryId
locality - Населенный пункт
localityType
localityId
streetId -
houseType - тип дома
houseNumber - номер дома
houseId
buildings - тип корпуса, массив с полями type, number
apartments - тип квартиры, массив с полями type, number
Поля ниже заполняются только при заполнении адреса по классификатору:
codeKLADR
oktmo
okato
asInDocument
ifnsFLCode
ifnsULCode
ifnsFLAreaCode
ifnsULAreaCode
stead
steadId
Значения для всех полей - строковые, однако, поля buildings и apartments заполняются в виде массива следующим образом:
"buildings": [
"type": "Корпус", // Тип корпуса
"number": "1" // Номер корпуса
>
Поля для типов "Телефон" и "Факс":
countryCode - код страны
areaCode - код города
number - номер
extNumber - добавочный номер
Вся суть нового формата заключается в реквизите Значение, который в формате JSON хранит всю информацию. В БСП уже есть функции, которые очень сильно помогают по работе с данным полем, к тому же, по значению данного поля могут быть заполнены все остальные реквизиты табличной части, поэтому, для выполнения задачи требуется получить значение лишь этого реквизита.
В общем случае код процедуры переноса КИ будет выглядеть примерно следующим образом:
- Получаем данные в "старом" виде.
- По виду КИ получаем структуру, в которой содержатся все возможные поля для данного вида КИ.
- Заполняем структуру.
- По заполненной структуре формируем строку JSON и заполняем остальные поля табличной части КонтактнаяИнформация (этот пункт уже реализован в БСП).
Алгоритм совсем не сложный, сложно было разобраться, какие именно поля необходимо заполнять.
В начале хотел прикрепить к публикации правила конвертации для КД 2.1, однако, решил, что проще будет прикрепить обработку, на которой можно алгоритм протестировать, ведь тому, кто знаком с Конвертацией данных, будет несложно добавить алгоритм в обработчики, а тому, кто с ней не знаком - несложно переделать обработку (например, добавить COM-соединение с нужно базой, брать данные по множеству объектов и заполнять также множество объектов). Она, скорее, дополнение ко всему вышесказанному, нежели суть статьи.
В обработке необходимо указать ссылку на объект, в который загружается КИ, а также указать саму КИ.
Для удобства и ускорения загрузки КИ можно воспользоваться табличным документом.
Для этого можно в консоли запросов получить данные, вывести их в табличный документ, а затем копипастом вставить в обработку. На вкладке "Контактная информация" нажать кнопку "Заполнить из табличного документа" и вручную указать те виды КИ, которые не нашлись по наименованию.
После того, как заполняемый объект выбран и табличная часть заполнена, необходимо нажать кнопку "Загрузить контактную информацию", после чего КИ будет добавлена в выбранный объект.
Алгоритм тестировался на платформе 8.3.15.1489, конфигурация УТ 11.4.11.104 с версией БСП 3.0.3.272.
Разберем основные вопросы преобразования типов в 1С 8.3: из строки в число, из числа в строку, из даты в число и прочие варианты. В этой статье мы рассмотрим функции преобразования значений, и я соберу в едино все варианты преобразования примитивных типов.
Строка в число в 1С
Узнаем, как в 1С 8.3 преобразовать строку в число.
Пусть, у нас есть числа в таком виде.
Для того, чтобы выполнить преобразование этих строк в число, необходимо воспользоваться методом Число. Этот метод преобразует параметр в число.
Обратите внимание, что разделять дробную часть можно в строке как при помощи символа точка «.», так и при помощи символа запятая «,». Если перед каким-то числом в строке стоят нули, то они отсекаются. У нас будет следующий результат.
Число в строку в 1С
Рассмотрим обратную задачу, когда в 1С 8.3 нужно преобразовать число в строку. Самый простой вариант использовать метод Строка, который преобразует собственный параметр в строку.
И какой результат возвращает этот код:
У этого способа имеется недостаток: он ставит пробелы между разрядами у длинных чисел. Для того, чтобы в 1С преобразовать число в строку без пробелов нужно воспользоваться функцией Формат. Данная функция имеет два параметра: преобразуемое значение и форматную строку. Если нам нужно указать, что число преобразуется в строку без пробелов в разряде, то необходимо указать в форматной строке, что порядок разделения группировки разрядов числа или равен 0, или пустой.
Результат будет без разрядов:
Строка в дату 1С
Узнаем, как преобразовать в 1С 8.3 строку в дату. Для этого необходимо использовать метод Дата, который преобразует параметр (в том числе строку ) в дату . Причем, замечу, что строка должна быть задана в таком формате «ГГГГММДДЧЧММСС».
Подробнее о форматах дат читайте в этой статье: даты в 1С.
Если мы зададим дату в не верном формате, то преобразование не произойдет и возникнет ошибка «Преобразование значения к типу Дата не может быть выполнено».
Например, этот код:
Приведет к ошибке:
Дата в строку в 1С
Преобразовать дату в строку можно несколькими способами. Первый способ: воспользоваться уже знакомым нам методом Строка.
В этом случае у нас выйдет строка в обычном «полном» формате даты.
А чтобы получить дату в том формате, в каком нам нужно, необходимо воспользоваться методом Формат.
Форматов дат может быть великое множество ,все я разбирать в этой статье не буду, покажу только как можно быстро воспользоваться этой функцией.
Мы изменим предыдущий код, написав вместо метода Строка метод Формат, а в качестве второго параметра у метода Формат напишем просто две кавычки.
После нужно между кавычками поставить курсор, вызвать контекстное меню, и применить в нем команду Конструктор форматной строки.
В этом конструкторе на закладке Дата вы можете выбрать удобный вам формат даты.
И после нажатия кнопки ОК этого конструктора, нужный формат появится в виде строки.
В результате метода Формат, дата будет преобразована в строку в том виде, в каком нам необходимо.
Строка в булево в 1С
При помощи метода Булево мы можем некоторые строковые представления (Да, Нет, Истина, Ложь) преобразовывать в значения Истина или Ложь.
Например, следующие переменные:
Будут иметь такие значения:
Булево в строку в 1С
Разберем, как в 1С можно выразить тип булево строкой. Булево значение можно преобразовать в строку несколькими способами. Во-первых, можно просто воспользоваться методом Строка.
Например, как здесь:
У нас будет выходить следующий результат:
В этом случае, булево в строку преобразовалось согласно региональным установкам информационной базы.
Если мы, как-то по-другому хотим преобразовать булево в строку, то можно воспользоваться уже знакомым нам методом Формат.
Переделаем, предыдущий код:
Знакомым способом вызовем конструктор форматной строки, где на закладке Булево введем преставление значений Истина и Ложь.
После нажатия кнопки ОК конструктора, второй параметр метода Формат заполнится:
И будет следующий результат:
Число в булево в 1С
В 1С 8.3. мы можем преобразовать любое число в булево по следующему правилу: 0 будет преобразован в Ложь, все остальные значения в Истина.
Будет следующий результат:
Булево в число в 1С
Можно сделать и обратное преобразование. Булево значение в число.
Для этого нужно воспользоваться методом Число, где в качестве параметра указать булево значение. Тогда Истина будет преобразована в 1С, а Ложь – в 0.
Например, как в этом коде:
С таким результатом:
Статьи о примитивных типах в 1С:
- Книга посылается на электронную почту в формате PDF. Можно открыть на любом устройстве!
- Научитесь понимать архитектуру 1С;
- Станете писать код на языке 1С;
- Освоите основные приемы программирования;
- Закрепите полученные знания при помощи задачника.
Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.
- Очень доступный и понятный язык изложения
- Книга посылается на электронную почту в формате PDF. Можно открыть на любом устройстве!
- Поймете идеологию управляемого приложения 1С
- Узнаете, как разрабатывать управляемое приложение;
- Научитесь разрабатывать управляемые формы 1С;
- Сможете работать с основными и нужными элементами управляемых форм
- Программирование под управляемым приложением станет понятным
Эти книги, плюс книга по программированию оперативного учета имеются в едином комплекте: комплект книг по разработке в 1С.
Только для читателей моего блога,
промо-код на скидку в 300 рублей на весь комплект: blog
Если Вам понравился этот урок, был полезен или помог решить какую-нибудь проблему, то Вы можете поддержать мой проект, перечислив любую сумму.
можно оплатить вручную:
Функции работы со строками в 1С
Рассмотрим основные функции встроенного языка программирования 1С.
Строка
Функция Строка() позволяет получить текстовое представление переменных других типов.
СтрДлина
Функция позволяет получить количество символов в строке 1C, включая пробелы и незначащие символы.
СокрЛП, СокрЛ, СокрП
Если вы только начинаете программировать в 1С или просто хотите систематизировать свои знания - попробуйте Школу программирования 1С нашего друга Владимира Милькина. Пошаговые и понятные уроки даже для новичка с поддержкой учителя.
Попробуйте бесплатно по ссылке >>
Помимо пробелов, функция 1C удаляет такие символы, как перенос строки, неразрывный пробел и т.д.
Лев, Прав, Сред
С помощью данных функций очень просто получить первые (Лев) или последние (Прав) символы в строке, а также произвольное количество символов (Сред).
Найти
ВРег, НРег, ТРег
ПустаяСтрока
Функция, позволяющая сравнить исходную строку с пустой строкой. Проверяется наличие незначащих символов.
Аналогично можно проверить строку на пустое значение следующим образом:
СтрЗаменить
Функция СтрЗаменить позволяет массово заменить искомое значение на нужное нам. Синтаксис:
СтрЧислоСтрок
Позволяет получить количество строк в многострочном тексте. Функция считает количество переносов строк (Символы.ПС).
Например, построчная обработка текстового фрагмента:
СтрПолучитьСтроку
СтрЧислоВхождений
Функция для подсчета числа вхождений произвольного фрагмента в строку. Например, подсчитать количество вхождений определенных символов или слов в текст.
Символ и КодСимвола
Две обратные функции. С помощью КодСимвола можно получить код символа в кодировке Unicode. Функцией Символ можно получить символ, зная Unicode кодификатор.
Часто встречающиеся задачи по работе со строками в 1С
Рассмотрим классические примеры решения задач в работе с текстовыми переменными.
Конкатенация строк в 1С
Преобразовать число в строку
Однако может смущать наличие неразрывного пробела.
Его можно убрать с помощью замены неразрывного пробела на пустую строку:
или с помощью метода Формат:
Кавычки в строке 1С
Для новичков достаточно трудно установить кавычки внутри строки, хотя в этом нет ничего сложного. Достаточно внутри строки поставить вместо одних кавычек двое.
Символ переноса строки
Сравнение строк в 1С
Однако для получения корректного сравнения часто требуется возвести строки в один регистр и убрать незначащие символы:
Таким образом, мы получим более точное сравнение двух строк.
Убрать пробелы в строке 1С
Достаточно часто нужно убрать пробелы в строке 1С.
Если требуется убрать пробелы справа и слева:
Если требуется убрать абсолютно все пробелы, можно заменить их на пустую строку:
Если требуется убрать неразрывные пробелы из строки, которая получена из числового типа, сделать это можно так:
Другие статьи по 1С:
В предыдущей статье мы узнали, как работать со строками в 1С 8.3. В этой статье изучим самые часто применяемые функции для работы со строками 1С.
Длина строки 1С
В платформе 1С имеется функция, которая вычисляет длину строки – СтрДлина. Эта функция имеет единственный параметр – строку, и возвращает количество символов в этой строке, т.е. её длину. Причем считаются все символы, в том числе пробелы.
Регистр строки 1С
В 1С имеются функции для работы с регистрами строк.
НРег – переводит строку в нижний регистр
ВРег – переводит строку в верхний регистр
ТРег – переводит строку в титульный регистр (каждое слово начинается с заглавной буквы).
Замечу, эти функции не изменяют строку в параметре, а создают новую строку в нужном регистре.
Убрать пробелы в строке 1С
Часто возникает, что в строке 1С в начале строки или в конце строки есть лишние пробелы, которые нужно убрать. Для этих целей служат следующие функции.
СокрЛП – убирает пробелы справа и слева строки.
Рассмотрим пример (добавлю символы перед и после функциями, чтобы было понятно как они работают).
Эти функции, также, не изменяют строку в параметре, а создают новую строку с обрезанными пробелами.
Сократить строку 1С
Если предыдущие функции сокращали только пробелы, то в платформе 1С имеется возможность сократить и саму строку на нужное количество символов. Или наоборот – оставить нужное количество символов. Для этих целей служат следующие функции.
Лев – оставляет нужное количество символов слева. Имеет следующий синтаксис: Лев(<Cтрока>,<ЧислоСимволов>)
Прав – оставляет нужно количество символов справа. Имеет следующий синтаксис: Лев(<Cтрока>,<ЧислоСимволов>)
Сред – оставляет нужное количество символов в строке. Имеет следующий синтаксис: Лев(<Cтрока>,<НачальныйНомер>, <ЧислоСимволов>).
Функции Лев и Прав – создают новую строку, в которой оставлено слева и справа соответственно, то количество символов, которое указанно во втором параметре.
Функция Сред также создает новую строку, в которой оставлено то количество символов, которое указано в третьем параметре. Но, если предыдущие функции оставлялись символы или с начала строки, или с конца, то эта функция оставляет символы с любого места строки. Для этого во втором параметре нужно указать номер символа, с которого будут оставлены остальные символы (включая символ, номер которого мы указали).
По сути, эти функции позволяют сокращать как нужно строки, но работают наоборот – они оставляют то количество символов, которое необходимо.
Найти в строке 1С
Иногда нужно найти в строке или нужный символ, или нужную группу символов. Для этих целей применятся функция СтрНайти(). Эта функция имеет следующий синтаксис.
Данная функция возвращает позицию первого знака подстроки, которая была найдена. Если 0, то ни чего не найдено.
Строка – строка, по которой осуществляется поиск;
ПодстрокаПоиска – подстрока (или символ), которая ищется в строке поиска;
НаправлениеПоиска – системное перечисление, которое задает в какую сторону осуществляется поиск. Имеет два значения: НаправлениеПоиска.Сначала, НаправлениеПоиска.Сконца. Необязательный параметр.
НачальнаяПозиция – номер символа, с которого начинается поиск. Должен быть в диапазоне от 1 до количества символов, иначе будет ошибка. Необязательный параметр. Если он не задан и установлен параметр НаправлениеПоиска, то в случае поиска Сначала по умолчанию равен 1, а если поиск СКонца, то по умолчанию равен количеству символов в строке.
НомерВхождения – искомая подстрока (или символ) может несколько раз входить в исходную строку, этот параметр указывает, какое вхождение нас интересует. По умолчанию равен 1.
И результат работы функции
Т.е. когда мы ищем в строке «Иванов Сидоров Иванов» подстроку «Иванов», то при поиске без дополнительных параметров функция возвращает 1, это номер символа с которого начинается искомая подстрока. Если же мы ищем в направлении СКонца, то возвращается номер символа, с которого начинается второе вхождение подстроки в строку. В третьем случае мы искали в направлении СКонца, но указали номер символа, с которого нужно искать строку, поэтому функция вернула 1, поскольку при поиске начиная с 10 символа с конца строки, искомая подстрока находится только в начале строки. И в последнем примере, мы ищем подстроку с начала, но ищем второе вхождение этой подстроки.
Заменить в строке 1С
В платформе 1С 8.3. имеется метод, при помощи которого можно менять в строке определенные символы на другие символы.
Этот метод СтрЗаменить, и он имеете следующий синтаксис: СтрЗаменить(<Строка>,<СтрокаПоиска>,<СтрокаЗамены>)
Данные метод возвращается строку, в которой будет выполнена замена или нет, в зависимости от того найдена строка поиска или нет.
Как видите, при помощи этого метода можно не только менять символы, но и вырезать не нужные символы.
Функции для многострочных строк в 1С
Из предыдущей статьи вы знаете, что в 1С можно задать многострочную строку, делается это при помощи символа «|». Сейчас мы разберем несколько функций, которые могут пригодиться при работе с многострочной строкой.
СтрЧислоСтрок(<Строка>) – позволяет узнать, сколько в строке строк.
В этой статье я разобрал основные функции, которые были в платформе 8.1, в платформе 8.2 и перешли в платформу 8.3 (кроме функции СтрНайти, но это улучшенная версия функция Найти, которая была в старых платформах) . В следующей статье рассмотрим функции работы со строками, которые появились в платформе 8.3:
Статьи о примитивных типах
- Книга посылается на электронную почту в формате PDF. Можно открыть на любом устройстве!
- Научитесь понимать архитектуру 1С;
- Станете писать код на языке 1С;
- Освоите основные приемы программирования;
- Закрепите полученные знания при помощи задачника.
Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.
- Очень доступный и понятный язык изложения
- Книга посылается на электронную почту в формате PDF. Можно открыть на любом устройстве!
- Поймете идеологию управляемого приложения 1С
- Узнаете, как разрабатывать управляемое приложение;
- Научитесь разрабатывать управляемые формы 1С;
- Сможете работать с основными и нужными элементами управляемых форм
- Программирование под управляемым приложением станет понятным
Эти книги, плюс книга по программированию оперативного учета имеются в едином комплекте: комплект книг по разработке в 1С.
Только для читателей моего блога,
промо-код на скидку в 300 рублей на весь комплект: blog
Если Вам понравился этот урок, был полезен или помог решить какую-нибудь проблему, то Вы можете поддержать мой проект, перечислив любую сумму.
можно оплатить вручную:
Читайте также: