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

Elena в 12:53, 17 марта 2025

2025-03-17T12:53:39Z

← Предыдущая версия		Версия от 12:53, 17 марта 2025
Строка 156:		Строка 156:

	Предыдущая статья курса: [[Задание 9. Пользовательские действия в карточке]]		Предыдущая статья курса: [[Задание 9. Пользовательские действия в карточке]]
	[[Категория:Курс "Разработка приложений"]]		[[Категория:Курс Разработка приложений]]

AZykov: /* Вызов сервисов */

2025-03-13T18:52:30Z

Вызов сервисов

← Предыдущая версия		Версия от 18:52, 13 марта 2025
Строка 138:		Строка 138:


	Пример вызова сервиса ~~из канала интеграции~~:		Пример вызова сервиса через REST API:<syntaxhighlight lang="http">
			POST /rest/v1/domain/nservices/demo01.ServerService
			{
			"method":"Demo_getUsers"
			}
			</syntaxhighlight>domain - имя домена Эра, в котором размещен сервис

	~~TODO//////~~		nservices - неизменяемый служебный путь для обращений к сервисам приложений.

	~~Пример вызова сервиса через REST API:~~

	~~TODO///~~

	~~Пример вызова сервиса из сценария:~~

	~~TODO////~~

	= Мониторинг сервисов =		= Мониторинг сервисов =

AZykov: /* Вызов сервисов */

2025-03-13T13:25:51Z

Вызов сервисов

← Предыдущая версия		Версия от 13:25, 13 марта 2025
Строка 135:		Строка 135:
	});		});
	</syntaxhighlight>		</syntaxhighlight>



Строка 141:		Строка 142:
	TODO//////		TODO//////

	Пример вызова сервиса ~~без использования Invoke~~:		Пример вызова сервиса через REST API:

			TODO///

			Пример вызова сервиса из сценария:

	TODO//////		TODO////

	= Мониторинг сервисов =		= Мониторинг сервисов =

AZykov: /* Работа в файловой системе */

2025-03-10T13:34:12Z

Работа в файловой системе

← Предыдущая версия		Версия от 13:34, 10 марта 2025
Строка 96:		Строка 96:
	Перенос изменений исходного кода сервиса в пакет на платформе Эра осуществляется полной заменой его исходного кода в редакторе сервиса в приложении Builder. Таким образом, после разработки и отладки сервиса на локальной машине, его код необходимо скопировать и вставить в редакторе сервиса на вкладке Code.		Перенос изменений исходного кода сервиса в пакет на платформе Эра осуществляется полной заменой его исходного кода в редакторе сервиса в приложении Builder. Таким образом, после разработки и отладки сервиса на локальной машине, его код необходимо скопировать и вставить в редакторе сервиса на вкладке Code.

	После повторной активации пакета, новый исходный код сервиса заместит предыдущий и логика работы сервиса будет обновлена.		После повторной активации пакета, новый исходный код сервиса заместит предыдущий и логика работы сервиса будет обновлена. <blockquote>'''Важно''': При модификации структуры классов, или других сервисов, необходимо заново загрузить обновленный архив из раздела сервисы для исключения ошибок при дальнейшей разработки. Рекомендуется регулярно обновлять исходные коды исключения ситуаций, когда версия какого либо класса-обёртки на локальном компьютере отличается от аналогичного класса в инстансе платформы. </blockquote>

	=== Работа в редакторе ===		=== Работа в редакторе ===

AZykov: /* Вызов сервисов */

2025-03-10T13:12:31Z

Вызов сервисов

← Предыдущая версия		Версия от 13:12, 10 марта 2025
Строка 115:		Строка 115:
	Главный механизм вызова сервисов в рамках платформы - это Invocations.		Главный механизм вызова сервисов в рамках платформы - это Invocations.

	Механизм Invocations представляет собой единую точку вызова любых сервисов платформы. Все вызовы, выполненные через Invoke буферизуются средствами платформы, а сервисы получают эти вызовы ~~при помощи~~ протокола websocket. Таким образом, если некий сервис не обработал вызов, то запрос на этот вызов будет продолжать находиться в буфере до тех пор, пока сервис не примет его и не обработает, либо до тех пор как специализированный микросервис системы '''''watchdog''''' не исключит запрос из буфера по таймауту.		Механизм Invocations представляет собой единую точку вызова любых сервисов платформы. Все вызовы, выполненные через Invoke буферизуются средствами платформы, а сервисы получают эти вызовы с помощью протокола websocket. Таким образом, если некий сервис не обработал вызов, то запрос на этот вызов будет продолжать находиться в буфере до тех пор, пока сервис не примет его и не обработает, либо до тех пор как специализированный микросервис системы '''''watchdog''''' не исключит запрос из буфера по таймауту.

	Пример вызова микросервиса из серверного контекста: <syntaxhighlight lang="typescript">		Пример вызова микросервиса из серверного контекста: <syntaxhighlight lang="typescript">

AZykov: /* Мониторинг сервисов */

2025-03-10T13:10:39Z

Мониторинг сервисов

← Предыдущая версия		Версия от 13:10, 10 марта 2025
Строка 146:		Строка 146:

	= Мониторинг сервисов =		= Мониторинг сервисов =
			[[Файл:Мониторинг ServiceInstances.png\|мини\|Мониторинг ServiceInstances]]
			Мониторинг запущенных сервисов платформы можно проводить в приложении Builder, в разделе Monitoring.

			В данном разделе можно увидеть список всех запущенных сервисов, время их запуска и обновления, ноды на которых они запущенны, а также аргументы которые использовались платформой для запуска NodeJS-приложения.

	Следующая статья курса: [[Отладка и логирование]]		Следующая статья курса: [[Отладка и логирование]]

	Предыдущая статья курса: [[Задание 9. Пользовательские действия в карточке]]		Предыдущая статья курса: [[Задание 9. Пользовательские действия в карточке]]
	[[Категория:Курс "Разработка приложений"]]		[[Категория:Курс "Разработка приложений"]]

AZykov: /* Вызов сервисов */

2025-03-10T13:08:17Z

Вызов сервисов

@@ Строка 113: / Строка 113: @@
 = Вызов сервисов =
-Главный механизм вызова сервисов
+Главный механизм вызова сервисов в рамках платформы - это Invocations.
 = Мониторинг сервисов =

AZykov: /* Вызов сервисов */

2025-03-10T12:59:48Z

Вызов сервисов

← Предыдущая версия		Версия от 12:59, 10 марта 2025
Строка 113:		Строка 113:

	= Вызов сервисов =		= Вызов сервисов =
			Главный механизм вызова сервисов

	= Мониторинг сервисов =		= Мониторинг сервисов =

AZykov: /* Работа в редакторе */

2025-03-10T12:58:38Z

Работа в редакторе

← Предыдущая версия		Версия от 12:58, 10 марта 2025
Строка 96:		Строка 96:
	Перенос изменений исходного кода сервиса в пакет на платформе Эра осуществляется полной заменой его исходного кода в редакторе сервиса в приложении Builder. Таким образом, после разработки и отладки сервиса на локальной машине, его код необходимо скопировать и вставить в редакторе сервиса на вкладке Code.		Перенос изменений исходного кода сервиса в пакет на платформе Эра осуществляется полной заменой его исходного кода в редакторе сервиса в приложении Builder. Таким образом, после разработки и отладки сервиса на локальной машине, его код необходимо скопировать и вставить в редакторе сервиса на вкладке Code.

	После повторной активации пакета, новый исходный код сервиса заместит предыдущий и логика работы сервиса будет обновлена.		После повторной активации пакета, новый исходный код сервиса заместит предыдущий и логика работы сервиса будет обновлена.

	=== Работа в редакторе ===		=== Работа в редакторе ===
			[[Файл:Определение методов в редакторе сервиса.png\|мини\|Определение методов в редакторе сервиса]]
			В платформе присутствует возможность разрабатывать сервисы без применения файловой системы, из редактора сервиса. Такой подход является менее предпочтительным, так как не предлагает базовых удобств при работе с кодом, таких как подсветка и проверка синтаксиса, autocompletion, автоматический импорт зависимостей и т.д.

			Однако иногда такая возможность бывает полезной, например при необходимости быстро создать сервис, реализующий какую-то простейшую логику.

			Платформа предлагает '''два подхода''' к разработке такого простого сервиса.

			'''Первый подход''' - определение тела методов на вкладке Common, в этом случае система автоматически перенесет код из свойства в соответствующий ему метод (onInitCode -> onInit, onTimerCode -> onTimer и т.д.). Так же, присутствует возможность задать произвольные методы сервиса с помощью свойства functionsCode.
			[[Файл:Редактор кода сервиса в Builder'е.png\|мини\|Редактор кода на вкладке Code]]
			'''Второй подход''' - редактирование исходного кода всего сервиса на вкладке Code. В этом случае разработчику доступен весь код сервиса, с возможностью изменения и создания любого метода, включая конструктор.

			В любом случае, разработка в файловой системе с использованием современной IDE предоставляет несравнимо большее количество плюсов. К разработке сервисов в интерфейсе платформы следует прибегать только в крайних случаях, когда иной подход невозможен.

	= Вызов сервисов =		= Вызов сервисов =

AZykov: /* Общая информация */

2025-03-10T12:50:23Z

Общая информация

← Предыдущая версия		Версия от 12:50, 10 марта 2025
Строка 20:		Строка 20:
	Сервисы, исполняемые на сервере, фактически являются NodeJS-микросервисами, за работоспособность которых отвечает роль MSVC. Такие сервисы могут реализовывать любую backend-логику, работать с любыми данными из хранилища.		Сервисы, исполняемые на сервере, фактически являются NodeJS-микросервисами, за работоспособность которых отвечает роль MSVC. Такие сервисы могут реализовывать любую backend-логику, работать с любыми данными из хранилища.

	Клиентский сервис может иметь признак '''Mandatory''', если этот признак установлен то клиентский сервис будет автоматически запускаться во всех приложениях ~~на платформе Эра~~.		Клиентский сервис может иметь признак '''Mandatory''', если этот признак установлен то клиентский сервис будет автоматически запускаться во всех приложениях платформы.

	Сервисы, исполняемые на клиенте, работают в браузере пользователя и могут, например, при запросе открывать пользователю определенную карточку с данными (пример - базовый микросервис callcenter.ShowCardService, который открывает карточку звонка при поступлении входящего вызова из очереди).		Сервисы, исполняемые на клиенте, работают в браузере пользователя и могут, например, при запросе открывать пользователю определенную карточку с данными (пример - базовый микросервис callcenter.ShowCardService, который открывает карточку звонка при поступлении входящего вызова из очереди).