Поля - Loymax

Витрины данных (data marts) — это пользовательские структуры данных (объекты) с произвольным набором полей. Витрину можно наполнять данными Партнёра или выходными данными модуля [[Loymax AI>>doc:Main.General_information.Loymax_AI.WebHome]]. Данные из витрин можно использовать в [[кампаниях>>doc:Main.Using.Smart_Communications.Campaign_list.WebHome]] и в [[Построителе сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]].

28

29

Витрина может содержать один набор данных (один к одному) или несколько (один к многим, мультивитрина).

30

31

Чтобы создать витрину, нажмите на иконку плюса ([[image:attach:Plus.png]]), отмеченную на изображении выше. Откроется модальное окно, где нужно указать:

32

33

* **Наименование витрины**;

34

* **Код витрины**;

35

* **Тип витрины:**

36

** Один к одному — для уникального клиента в витрине будет только одна связанная с ним запись;

37

** Один к многим — для уникального клиента в витрине может быть сколько угодно связанных с ним записей.

38

)))|(% style="border-color:white; width:526px" %){{lightbox image="Data_mart.png" width="400"/}}

=== Список полей ===

В разделе **Поля **выводится список полей, используемых в Системе.

43

44

Некоторые объекты подразделяются на **группы**. Например, поля объекта **Клиенты** разбиты на группы:

* Клиент;

* Контакты;

* Бонусы;

* Скоринг.

Для каждого поля выводятся:

52

53

* **Наименование** — название поля, которое видят пользователи;

54

* **Код поля** (системное имя) – имя поля, которое используется для обращения к нему через REST API;

55

* **Тип поля **(строка, дата, целое, и т. д.);

56

* Вид поля** **— **системное** или **пользовательское**:

57

** **Системные** поля изначально присутствуют в Системе;

58

** **Пользовательские **поля — созданы пользователем.

59

60

(% class="box infomessage" %)

61

(((

62

**Примечание: **пользовательские поля можно редактировать, удалять. Для системных полей доступен ограниченный функционал редактирования, удалить такие поля нельзя.

63

)))

64

65

=== Порядок полей ===

66

67

* Порядок полей и групп объекта можно менять с помощью перетаскивания.

68

* Поля в [[построителе сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]] выводятся в том же порядке, что и в списке полей.

69

* Порядок полей в [[профиле клиента>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="Profile"]] задаётся через настройку представления профиля клиента. Подробнее об этом читайте в статье [[Управление представлениями>>doc:.Views_management.WebHome]].

70

71

=== Фильтрация по названию полей ===

72

73

При необходимости список полей можно отфильтровать через **Поиск** по названию. Например, можно найти все поля, которые содержат слово "чек".

74

75

|(% style="border-color:#ffffff; text-align:center" %) {{lightbox image="Search_bar.png" width="1000"/}}

76

77

=== Видимость объектов в профиле клиента ===

78

79

Объекты** Чеки **и **Строки чеков** можно скрыть в профиле клиента. Для этого отметьте чекбокс **Скрыть чеки**/**Скрыть строки чеков** в соответствующих вкладках.

80

81

|(% style="border-color:#ffffff; text-align:center" %){{lightbox image="Hide_checkbox.png" width="1200"/}}

82

83

(% class="table-bordered" %)

84

(% class="info" %)|(% style="width:626px" %)Пример вкладки **Чеки **в** Профиле клиента**, когда чеки видимы.|(% style="width:812px" %)Когда **строки чеков** активны, они выводятся** **при нажатии на значение идентификатора в столбце **Идентификатор **во вкладке** Чеки **в профиле клиента. Открывается окно **Содержимое**.

85

|(% style="width:626px" %)[[image:attach:Receipt_visible.png]]|(% style="width:812px" %)[[image:attach:Receipt_lines_visible.png]]

86

(% class="info" %)|(% style="width:626px" %)Если чеки скрыты, вкладка **Чеки** не отображается в профиле клиента.|(% style="width:812px" %)Пример окна** Содержимое**, когда **строки чеков** скрыты.

87

|(% style="width:626px" %)[[image:attach:Receipt_hidden.png]]|(% style="width:812px" %)[[image:attach:Content.png]]

88

89

=== Добавление полей ===

90

91

**~1. Добавление группы полей**

92

93

Добавление новой группы полей осуществляется по кнопке **Добавить группу **в верхнем правом углу. В открывшемся окне **Свойства группы** необходимо указать **Наименование группы**.

94

95

|(% style="border-color:#ffffff; text-align:center" %)[[image:attach:Add_group.png]]

96

97

**{{id name="Add_field"/}}2. Добавление поля**

98

99

Чтобы добавить новое поле, нажмите кнопку **Добавить поле**. Откроется окно, в котором нужно заполнить **свойства поля**.

100

101

|(% style="border-color:white; width:870px" %)(((

102

У полей могут быть различные свойства в зависимости от типа полей. Необходимо заполнить **общие свойства поля** и свойства, присущие его **типу**.

103

104

==== **Общие свойства** ====

105

106

* **Наименование группы **— к какой группе относится поле;

107

* **Наименование поля** — название поля, которое видят пользователи;

108

* **Код поля **— системное имя поля, которое используется для обращения к нему через [[REST API>>doc:Main.Integration.Integration_of_SC.Data_communiction.SmC_API.WebHome]];

* **Описание**;

* **Тип данных:**

** целое//,//

** дробное,

** строка,

** дата,

** логическое.

* **Операнды **(операторы). Для некоторых полей актуальны не все операторы. Например, для поля **Пол **будут актуальны только: **равно**,** не равно**, **пусто**, **не пусто**. Именно эти операторы будут выводиться в [[построителе сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]] при формировании условий для этого поля:

118

119

[[image:attach:Gender.png]]

120

121

* **Показывать поле**. Видимое поле будет отображаться:** **

122

** в построителе сегментов;

123

** в списках и профиле клиента.

124

125

Невидимые поля будут отображаться светло-серым цветом в списке полей.

126

127

[[image:attach:Invisible1.png||height="215" width="759"]]

128

129

* **Тип**: поле/метрика.

130

)))|(% style="border-color:white; width:568px" %)[[image:attach:Field_properties_2.png]]

131

132

==== **Свойства полей в зависимости от типа данных** ====

133

134

* [[Свойства поля с типом "целое">>doc:||anchor="01"]];

135

* [[Свойства поля с типом "дробное">>doc:||anchor="02"]];

136

* [[Свойства поля с типом "строка">>doc:||anchor="03"]];

137

* [[Свойства поля с типом "дата">>doc:||anchor="04"]];

138

* [[Свойства логических полей>>doc:||anchor="05"]].

139

140

===== **{{id name="01"/}}Свойства целых полей** =====

141

142

Помимо общих свойств для целых полей доступно свойство **Элемент управления **со следующими параметрами:

* поле ввода;

* значение.

Для каждого элемента управления есть свой набор дополнительных свойств.

148

149

(% class="table-bordered" %)

150

(% class="info" %)|(% style="width:440px" %)**Поле ввода**|(% style="width:412px" %)**Значение**

151

|(% style="width:440px" %)(((

152

Для полей ввода доступны следующие дополнительные свойства:

153

154

* **Минимальное значение**;

155

* **Максимальное значение**;

156

* **Инкремент **— на этот параметр может увеличиваться значение поля;

157

* **Значение по умолчанию** — это значение будет автоматически выводиться в [[построителе сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]].

158

159

[[image:attach:Entry_field.png]]

160

161

162

)))|(% style="width:412px" %)(((

163

Доступны дополнительные поля:

164

165

* **Представление**:

166

** **выпадающий список**;

167

** **автодополнение** — при вводе значения предлагаются все подходящие варианты;

168

** **радио** — радиокнопки.

169

* **Набор вариантов**:

170

** **список опций **— позволяет указать возможные значения поля прямо в настройках поля,

171

** **данные из БД** — позволяет выбирать в поле значение из базы данных. Например, [[построитель сегментов >>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]]построит список всех уникальных значений, которые хранятся в БД в этом поле, и отобразит их.

172

173

Доступны также функции **Добавить опцию** и **Удалить все опции**.

174

175

[[image:attach:Value.png]]

)))

===== **{{id name="02"/}}Свойства дробных полей** =====

181

182

|(% style="border-color:white; width:742px" %)(((

183

Для дробных полей доступны дополнительные свойства:

184

185

* **Минимальное значение**;

186

* **Максимальное значение**;

187

* **Инкремент **—** **на этот параметр может увеличиваться значение поля. Например, при минимальном значении поля "1", максимальном – "2" и инкременте "0.5" поле может принимать значения: "1", "1.5", "2";

188

* **Значение по умолчанию **— это значение будет автоматически выводиться при формировании запроса в [[построителе сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]].

189

)))|(% style="border-color:white; width:696px" %)[[image:attach:Fractions.png]]

190

191

===== **{{id name="03"/}}Свойства полей с типом "строка"** =====

192

193

Для полей с типом **Строка** доступно свойство **Элемент управления **со следующими параметрами:

* **поле ввода**;

* **значение**;

* **справочник**.

Для каждого** элемента управления** есть свой набор дополнительных свойств.

200

201

(% class="table-bordered" %)

202

(% class="info" %)|(% style="width:440px" %)**Поле ввода**|(% style="width:412px" %)**Значение**|(% style="width:412px" %)**Справочник**

203

|(% style="width:440px" %)(((

204

Для полей ввода доступны следующие дополнительные свойства:

205

206

* **Максимальная длина **— ограничение на длину значения поля;

207

* **Значение по умолчанию**.

208

209

210

)))|(% style="width:412px" %)(((

211

Доступны дополнительные поля:

212

213

* **Представление**:

214

** **выпадающий список**;

215

** **автодополнение** — при вводе значения предлагаются все подходящие варианты;

216

** **радио** — радиокнопки.

217

* **Набор вариантов**:

218

** **список опций **— позволяет указать возможные значения поля прямо в настройках поля,

219

** **данные из БД** — позволяет выбирать в поле значение из базы данных. Например, [[построитель сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]] построит список всех уникальных значений, которые хранятся в БД в этом поле, и отобразит их.

220

221

Доступны также функции **Добавить опцию** и **Удалить все опции**.

222

223

224

)))|(% style="width:412px" %)(((

225

Доступны дополнительные поля:

226

227

* **Представление**:

228

** **выпадающий список**;

229

** **автодополнение** — при вводе значения предлагаются все подходящие варианты;

230

** **радио **— радиокнопки.

231

* **Справочник**:

232

** **новый** — если в Системе нет нужного справочника, следует создать новый справочник, указать его **наименование** и **код**.

233

** **существующий **— если в Системе существует нужный справочник, необходимо указать его наименование в поле **Наименование справочника**.

234

* **Наименование справочника;**

235

* **Код справочника **— используется для обращения к справочнику по API.

236

237

Наполнение и редактирование справочника осуществляется в разделе **Настройки > Справочники**.

238

239

Подробнее** **о справочниках можно прочитать в разделе** **[[Справочники>>doc:Main.Using.Smart_Communications.Settings_SC.Directories.WebHome]]**.**

240

)))

241

|(% style="width:440px" %)[[image:attach:String.png]]|(% style="width:412px" %)[[image:attach:Value.png]]|(% style="width:412px" %)[[image:attach:Guidebook1.png]]

242

243

===== **{{id name="04"/}}Свойства полей с типом "дата"** =====

244

245

|(% style="border-color:white; width:898px" %)(((

246

Для полей с типом дата доступно свойство** Добавить поле с расстоянием до даты**, которое позволяет рассчитать сколько времени прошло с конкретной даты.

247

248

* Поле будет выводиться в [[профиле клиента>>doc:Main.Using.Smart_Communications.Customers.All_clients.WebHome||anchor="Profile"]];

249

* Поле можно использовать при построении запросов в [[построителе сегментов>>doc:Main.Using.Smart_Communications.Customers.User_segments.Segment_builder.WebHome]].

250

251

Например, есть поле **Дата свадьбы**. Добавим дополнительное поле — **Дней с даты свадьбы**. Новое поле можно использовать в построителе сегментов:

252

253

[[image:attach:segment_date.png]]

254

)))|(% style="border-color:white; text-align:center; vertical-align:middle; width:540px" %)[[image:attach:Date1.png]]

255

256

===== {{id name="05"/}}Свойства логических полей =====

257

258

|(% style="border-color:white; width:559px" %)(((

259

У полей с типом "логическое" нет дополнительных свойств.

260

261

Для полей этого типа доступны только пять операторов:

* равно,

* пусто,

* не пусто,

* из указанных,

* не из указанных.

)))|(% style="border-color:white; width:879px" %)[[image:attach:Logical.png]]

269

270

=== Редактирование полей ===

271

272

**~1. Редактирование группы полей**

273

274

Для редактирования группы полей нажмите на иконку редактирования справа от названия группы. Отредактировать можно только **наименование группы**.

275

276

|(% style="border-color:#ffffff; text-align:center" %){{lightbox image="Group_edit1.png" width="1000"/}}

277

278

(% class="wikigeneratedid" id="H42043543443043A44243844043E43243043D43843543F43E43B44F" %)

279

**2. Редактирование поля**

280

281

Редактирование поля осуществляется по кнопке редактирования справа от названия поля. В пользовательском поле доступны для редактирования **все** свойства, описанные в разделе [[Добавление поля>>doc:||anchor="Add_field"]]. В системном поле лишь часть свойств доступна для редактирования:

282

283

|(% style="border-color:#ffffff; text-align:center" %)[[image:attach:Field_edit1.png]]

284

285

=== Удаление полей ===

286

287

**~1. Удаление группы полей**

288

289

Удаление группы полей осуществляется при нажатии на иконку корзины справа от названия группы.