Работа с внешними системами. Возможности интеграции - История изменений

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

2025-03-17T12:54:48Z

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

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

AZykov: /* Получение данных из параметров системы */

2025-03-13T18:50:09Z

Получение данных из параметров системы

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


	~~Пользовательские параметры:~~

	~~TODO/////~~

	Пример получения URL для исполнения запроса из параметров:<syntaxhighlight lang="typescript">		Пример получения URL для исполнения запроса из параметров:<syntaxhighlight lang="typescript">

AZykov в 10:59, 11 марта 2025

2025-03-11T10:59:20Z

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


	Следующая статья курса: [[~~Работа с универсальным источником~~ данных]]		Следующая статья курса: [[Задание 10. Обработка данных]]

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

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

2025-03-10T16:41:03Z

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

← Предыдущая версия		Версия от 16:41, 10 марта 2025
Строка 46:		Строка 46:
	</syntaxhighlight>		</syntaxhighlight>

			= Получение данных из параметров системы =
			[[Файл:Параметры системы.png\|мини\|Параметры системы]]
			Одна из частых задач - это хранение различных данных для работы интеграции в параметрах системы, для возможности быстрого редактирования. Как правило это различные URL'ы, ключи, токены доступа и т.д.
			[[Файл:Параметры проекта.png\|мини\|Параметры проекта]]
			Для хранения таких настроек, в приложении Администратор платформы существуют разделы "Параметры системы" и "Параметры проекта".

			В параметрах системы хранятся все системные настройки, их набор изменить нельзя, однако можно использовать эти параметры в своём коде.

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

			Важно понимать, что эти параметры не привязываются к какому либо пакету и при переносе пакета на другую среду, их необходимо будет создать повторно. Есть возможность создать фиксчу (фиксированые данные) пакета, которые будут автоматически добавлять необходимые параметры при активации пакета на новой среде. Функционал фиксч будет рассмотрен далее в рамках этого курса.

			Для получения значений параметров, используется утилитарный класс '''PlatformServices''', распологающийся в папке platform/core.

			В классе PlatformServices присутствует свойство settings, реализующее несколько методов для получения значений параметров:

			* getSettingByName - Позволяет получить значение любого параметра по имени
			* getProjectSettingByName - Позволяет получить значение проектного параметра по имени
			* getUserSettingByName - Позволяет получить значение пользовательского параметра по имени


			Пользовательские параметры:

			TODO/////

			Пример получения URL для исполнения запроса из параметров:<syntaxhighlight lang="typescript">
			import { GlobalUtils, Converter, EraRequest } from "./../../utils";
			import { PlatformServices, Service } from "./../../platform/core";
			import { ITicket, ITickets } from "../model";
			import { Tickets } from "../classes";
			import { IBaseEntity, IDataUpdateParams } from "../../base/model";
			import { EraEnvironment } from "../../../lowlevel";


			class Server2Service extends Service {
			private _tickets: ITickets; //свойство класса, через которое мы будем доступаться к коллекции Tickets

			constructor() {
			super("creomate_tutorial.Server2Service");

			// onCreateCode
			this._tickets = new Tickets(this.context); //инициализируем коллекцию Tickets

			this.load();
			}
			async sendPOSTRequest(id: string, status:string){

			const URL = PlatformServices.settings.getSettingByName("creomate_tutorial.integration.url");
			const result = await EraRequest.request({
			method: "POST",
			url: URL,
			contentType:"application/json",
			data: {
			objectId: id,
			statusId: status
			},
			timeout: 300
			});

			const ResultObject = result?.response


			}
			}
			export default Server2Service;
			</syntaxhighlight>

AZykov в 16:21, 10 марта 2025

2025-03-10T16:21:00Z

← Предыдущая версия		Версия от 16:21, 10 марта 2025
Строка 1:		Строка 1:
	Предыдущая статья курса: [[Работа с данными платформы. API]]		Предыдущая статья курса: [[Работа с данными платформы. API]]

			= Общая информация =
			Для работы с запросами ко внешним системам, в платформе Эра предусмотрен специализированный утилитарный класс EraRequest.

			Данный класс имеет набор методов для осуществления различных запросов (get, post, put и т.д.), а так же методом request, который позволяет тонко настроить запрос под необходимости разработчика.

			Пример выполнения запроса во внешнюю систему:<syntaxhighlight lang="typescript">
			import { GlobalUtils, Converter, EraRequest } from "./../../utils";
			import { Service } from "./../../platform/core";
			import { ITicket, ITickets } from "../model";
			import { Tickets } from "../classes";
			import { IBaseEntity, IDataUpdateParams } from "../../base/model";


			class Server2Service extends Service {
			private _tickets: ITickets; //свойство класса, через которое мы будем доступаться к коллекции Tickets

			constructor() {
			super("creomate_tutorial.Server2Service");

			// onCreateCode
			this._tickets = new Tickets(this.context); //инициализируем коллекцию Tickets

			this.load();
			}
			async sendPOSTRequest(id: string, status:string){

			const result = await EraRequest.request({
			method: "POST",
			url: "https://example.com/api/v1/request",
			contentType:"application/json",
			data: {
			objectId: id,
			statusId: status
			},
			timeout: 300
			});

			const ResultObject = result?.response


			}
			}
			export default Server2Service;
			</syntaxhighlight>

AZykov в 16:09, 10 марта 2025

2025-03-10T16:09:12Z

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

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

AZykov: Новая страница: « Предыдущая статья курса: Работа с данными платформы. API Следующая статья курса: Работа с универсальным источником данных Предыдущая статья курса: Работа с данными платформы. API»

2025-03-10T16:09:00Z

Новая страница: « Предыдущая статья курса: Работа с данными платформы. API Следующая статья курса: Работа с универсальным источником данных Предыдущая статья курса: Работа с данными платформы. API»

Новая страница

Предыдущая статья курса: [[Работа с данными платформы. API]]

Следующая статья курса: [[Работа с универсальным источником данных]]

Предыдущая статья курса: [[Работа с данными платформы. API]]