Skip to content

Commit a1f5536

Browse files
authored
Merge pull request #48 from ZennoLab/dev
docs: refactor ZennoPoster ProjectMaker documentation (marketing edits - part 2)
2 parents 19b1eb2 + 22b7bc2 commit a1f5536

87 files changed

Lines changed: 1570 additions & 2696 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/ZennoPoster/ProjectMaker/Project-editor/Actions-in-ProjectMaker-Actions-Blocks/Data/Content_Creation.mdx

Lines changed: 110 additions & 48 deletions
Large diffs are not rendered by default.

docs/ZennoPoster/ProjectMaker/Project-editor/Actions-in-ProjectMaker-Actions-Blocks/Data/Databases.mdx

Lines changed: 68 additions & 136 deletions
Original file line numberDiff line numberDiff line change
@@ -14,171 +14,103 @@ import DisclaimerNotice from '@site/src/components/DisclaimerNotice';
1414
> 🔗 **[Оригинальная страница](https://zennolab.atlassian.net/wiki/spaces/RU/pages/486473806)** — Источник данного материала
1515
1616
_______________________________________________
17-
1817
## Описание
18+
В ZennoPoster вы можете работать с различными типами баз данных. Например, с Microsoft SQL, MySql, PostgreSQL, SQLite и др. Вы можете подключаться к ним с локального компьютера или на удаленном сервере, а затем загружать туда нужные данные.
1919

20-
ZennoPoster позволяет работать с различными типами баз данных, такими как Microsoft SQL, MySql, PostgreSQL, SQLite и др. Вы сможете подключаться к базам на локальном компьютере или удаленном сервере и загружать нужные данные для Ваших веб-задач.
21-
22-
## Как добавить действие в проект?
23-
24-
Через контекстное меню **Добавить действие****Название раздела****Название действия**
25-
26-
![image-20200817-174134](./assets/Databases/Databases_pic1.png)
27-
28-
29-
30-
Либо воспользуйтесь [❗→ умным поиском](https://zennolab.atlassian.net/wiki/spaces/RU/pages/506200090/ProjectMaker+7#%D0%A3%D0%BC%D0%BD%D1%8B%D0%B9-%D0%BF%D0%BE%D0%B8%D1%81%D0%BA-%D0%B4%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B9 "https://zennolab.atlassian.net/wiki/spaces/RU/pages/506200090/ProjectMaker+7#%D0%A3%D0%BC%D0%BD%D1%8B%D0%B9-%D0%BF%D0%BE%D0%B8%D1%81%D0%BA-%D0%B4%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D0%B9").
31-
32-
## Как работать с экшеном?
33-
34-
![image-20200817-180023](./assets/Databases/Databases_pic2.png)
35-
36-
37-
38-
39-
40-
### Источник данных
41-
42-
![image-20210524-080146](./assets/Databases/Databases_pic3.png)
43-
44-
45-
46-
Для того чтобы подключится к базе данных, необходимо правильно настроить подключение. Оно будет отличаться в зависимости от СУБД.
47-
48-
#### Конструктор подключений
49-
50-
Чтобы облегчить задачу создания строки подключения можно использовать *Конструктор подключений. На основе указанных в нём данных будет сформирована *Строка подключения.
51-
52-
<details>
53-
<summary>Скриншоты</summary>
54-
55-
![image-20200817-175634](./assets/Databases/Databases_pic4.png)
56-
57-
58-
59-
![image-20200817-175728](./assets/Databases/Databases_pic5.png)
60-
61-
62-
63-
</details>
64-
65-
:::warning Внимание
66-
В Конструкторе нельзя использовать макросы переменных.
67-
:::
68-
69-
#### Провайдер данных
70-
71-
Имеется несколько провайдеров данных:
20+
### Как добавить в проект?
21+
Через контекстное меню: **Добавить действие → Данные → Директории**.
7222

73-
- **SqlClient** – провайдер для нативного подключения к SQLServer;
74-
- **MySqlClient** – провайдер для нативного подключения к MySQL;
75-
- **OleDb** – один из стандартов позволяющий подключаться к различным СУБД (в том числе и к SQLServer);
76-
- **Odbc** – ещё один стандарт для подключения к СУБД.
23+
![Добавить в проект](./assets/Databases/Databases_pic1.png)
7724

78-
#### Строка подключения
25+
### Внешний вид экшена.
26+
![Внешний вид экшена](./assets/Databases/Databases_pic2.png)
27+
_______________________________________________
28+
## Источник данных.
29+
Для того чтобы корректно работать с базой данных, необходимо правильно настроить подключение. Требуемые параметры будут зависеть от конкретной ***СУБД** (Системы Управления Базами Данных)*.
7930

80-
В строке подключения указываются различные параметры входа (будь то логин и пароль). Примеры строк подключения для разных СУБД можно посмотреть по [этой ссылке](https://www.connectionstrings.com/ "https://www.connectionstrings.com/").
81-
Чтоб не составлять эту строку вручную, можно воспользоваться *Конструктором подключений (описан выше).
31+
### Конструктор подключений.
32+
![Конструктор подключений](./assets/Databases/Databases_pic3.png)
8233

83-
<details>
84-
<summary>Как подключиться к PostgreSQL?</summary>
34+
Он предназначен для облегчения создания *Строки подключения*. Она будет сформирована после заполнения основных данных. Сначала нужно обозначить источник данных, а затем выбрать файл с базой.
35+
36+
| ![расширенные настройки](./assets/Databases/Databases_pic4.png) |
37+
| :----------------: |
38+
| *Доступны также расширенные настройки* |
8539

86-
Наш пользователь **Lord\_Alfred** написал подробный гайд по подключению ZennoPoster к PostgreSQL через ODBC. Рекомендуем к ознакомлению:
40+
:::warning **В *Конструкторе* недоступны макросы переменных.**
41+
:::
8742

88-
[PostgreSQL (СУБД) и ZennoPoster - подключение через ODBC](https://zennolab.com/discussion/threads/postgresql-subd-i-zennoposter-podkljuchenie-cherez-odbc.43320/)
43+
### Провайдер данных.
44+
Доступно несколько провайдеров данных:
45+
- **SqlClient**.
46+
Провайдер для нативного подключения к Microsoft SQL Server;
47+
- **MySqlClient**.
48+
Провайдер для нативного подключения к MySQL от Oracle;
49+
- **OleDb** *(Object Linking and Embedding Database)*.
50+
Это технология для доступа к различным источникам данных через единый интерфейс (в том числе к SQL Server);
51+
- **Odbc** *(Open Database Connectivity)*.
52+
Это единый интерфейс для выполнения SQL-запросов, работающий независимо от используемой СУБД;
8953

90-
</details>
91-
54+
### Строка подключения.
55+
В ней указываются различные параметры входа (например, логин и пароль). Чтобы не составлять эту строку вручную, можно использовать Конструктор подключений, который описан выше.
9256

93-
### Запрос
57+
[**Примеры строк подключения для разных СУБД.**](https://www.connectionstrings.com/)
58+
_______________________________________________
59+
## Запрос.
60+
![Запрос](./assets/Databases/Databases_pic5.png)
9461

95-
![image-20210524-081317](./assets/Databases/Databases_pic6.png)
62+
### Тип запроса.
63+
#### Запрос без ответа.
64+
Применяется для операций, которые не возвращают данные из БД (например **INSERT** или **DELETE**). В качестве ответа такие операции передают число задействованных в запросе записей.
9665

66+
#### Скалярный запрос.
67+
Позволяет получить единственное значение. Например, если нужно выполнить агрегатную функцию: `select sum(price) from fruit`.
9768

69+
#### Обычный запрос.
70+
Возвращает таблицу с данными.
9871

99-
#### Тип запроса
72+
### Текст запроса.
73+
Поле для ввода SQL запроса.
10074

101-
Существует несколько типов запроса
75+
### Использовать параметры в запросе.
76+
Параметры используются, чтобы упростить создание запроса, так как они подставляются в заданные места текста.
10277

103-
##### **Запрос без ответа**
78+
Существуют именованные и неименованные параметры. Для первых важно имя, а для вторых порядок переменных. Какой тип параметров использоваться зависит от конкретной СУБД.
10479

105-
Применяется для операций не возвращающих данных из БД (например INSERT или DELETE). В качестве ответа такой операции является число задействованных в запросе записей.
80+
:::info **Текст автоматически экранируется внутри параметров.**
81+
:::
10682

107-
##### **Скалярный запрос**
83+
| ![Именованные](./assets/Databases/Databases_pic6.png) | ![Неименованные](./assets/Databases/Databases_pic7.png) |
84+
| :--------: | :-------: |
85+
| Именованные параметры | Неименованные параметры |
86+
_______________________________________________
87+
## Обработка результатов.
88+
В этом разделе мы выбираем, куда сохранить результат запроса.
10889

109-
Позволяет получить единственное значение. Например, если нужно выполнить агрегатную функцию (select sum(price) from fruit).
90+
![Обработка результатов](./assets/Databases/Databases_pic8.png)
11091

111-
##### **Обычный запрос**
92+
### Положить результат в:
93+
#### Переменную.
94+
Все строки и колонки, которые будут получены в результате запроса, сохранятся в одну переменную.
11295

113-
Возвращает таблицу данных.
96+
Так же необходимо выбрать разделители для отделения строк и колонок друг от друга.
11497

115-
#### Текст запроса
98+
#### Список.
99+
Сохраняет результат работы в список. Важно указать разделить для столбцов. В итоге каждая строчка из базы будет занесена в новый элемент списка, а между столбцами вставлен соответствующий разделитель.
116100

117-
Поле ввода SQL запроса.
101+
#### Таблицу.
102+
При записи данных в таблицу ячейки заполнятся в соответствии с запросом.
118103

119-
#### Использовать параметры в запросе
104+
#### Переменные.
105+
Этот вариант позволяет сохранить результат сразу в несколько переменных.
120106

121-
Чтобы упростить создание запроса, используются параметры. Они будут подставляться в нужные места текста запроса. Существует именованные и неименованные параметры. В первом случае важно имя, во втором - порядок переменных.
122-
Какой тип параметров использовать зависит от СУБД.
107+
![Переменные](./assets/Databases/Databases_pic9.png)
123108

124-
:::note На заметку
125-
При использовании параметров текст внутри них автоматически экранируется
126-
:::
127-
128-
##### **Именованные параметры**
129-
130-
Пример запроса с именованными параметрами:
131-
132-
![image-20200817-180056](./assets/Databases/Databases_pic7.png)
133-
134-
135-
136-
##### **Неименованные параметры**
137-
138-
Пример запроса с неименованными параметрами:
139-
140-
![image-20200817-180211](./assets/Databases/Databases_pic8.png)
141-
142-
143-
144-
145-
146-
### Обработка результатов
147-
148-
![image-20210524-082152](./assets/Databases/Databases_pic9.png)
149-
150-
151-
152-
В этом разделе необходимо выбрать куда сохранить результат запроса.
153-
154-
#### Положить результат в
155-
156-
##### **Переменную**
157-
158-
Все строки и колонки, которые вернуться в результате запроса будут сохранены в одну [❗→ переменную](/wiki/spaces/RU/pages/486309922 "/wiki/spaces/RU/pages/486309922").
159-
160-
Так же необходимо выбрать разделители с помощью которых будут отделены друг от друга строки и колонки.
161-
162-
##### **Список**
163-
164-
Для того чтобы сохранить результаты в [❗→ список](/wiki/spaces/RU/pages/534053375 "/wiki/spaces/RU/pages/534053375"), важно указать какой разделитель использовать для столбцов. В итоге каждая строчка из базы будет занесена в новый элемент списка, а между столбцами вставлен соответствующий разделитель.
165-
166-
##### **Таблицу**
167-
168-
При записи данных в таблицу, ячейки будут заполнены в соответствии с запросом.
169-
170-
##### **Переменные**
171-
172-
![image-20210524-084018](./assets/Databases/Databases_pic10.png)
173-
174-
175-
176-
*Номер строки **-** в результате запроса может вернуться несколько строк, поэтому необходимо указать номер той, которую будем разбирать (нумерация с нуля!).
109+
**Номер строки**. В результате запроса может вернуться несколько строк, поэтому необходимо указать номер той, которую будем разбирать (нумерация с нуля).
177110

178111
В таблице ниже выбирается номер ячейки в строке и переменная, в которую эта ячейка будет сохранена (нумерация с нуля!).
179112

180-
![image-20210524-084504](./assets/Databases/Databases_pic11.png)
181-
113+
![Номер строки](./assets/Databases/Databases_pic10.png)
182114

183115

184116
## Полезные ссылки

0 commit comments

Comments
 (0)