Naumen Service Management Platform (SMP) 4.19

https://www.naumen.ru/docs/sd/4.19/Content/
Admin
Naumen Service Management Platform (SMP) is a comprehensive platform for managing services,...
Tokens:1,890,134
Snippets:22,091
Trust Score:9.1
Update:3 months ago
Show doc for...
Tokens:
Raw
### Install ARR

Source: https://www.naumen.ru/docs/sd/4.19/Content/admin/win-reverse-proxy.htm

Starts the installation process for the downloaded ARR MSI package. Follow the installer prompts.

```powershell
Start-Process "d:\naumen\deploy\$(Get-Date -format "yyyy-MM-dd")\update\requestRouter_amd64.msi"
```

--------------------------------

### REST Call Examples (GET and POST)

Source: https://www.naumen.ru/docs/sd/4.19/Content/applications/JSAPI_metods.htm?TocPath=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0+SMP%7C%D0%92%D1%81%D1%82%D1%80%D0%BE%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5+%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F%7C%D0%9C%D0%B5%D1%82%D0%BE%D0%B4%D1%8B+JS%C2%A0API%7C_____1

Examples demonstrating how to make GET and POST requests using the `jsApi.restCall` method. These examples show how to construct the URL, set up options, and handle the Promise-based response.

```javascript
const subjectUuid = jsApi.extractSubjectUuid();
const contentCode = jsApi.findContentCode();

// GET Request Example
const urlGet = `exec/?func=modules.testModule.testMethod&params='${subjectUuid}', '${contentCode}'`;
jsApi.restCall(urlGet, {})
    .then(stringifiedResponse => {
        const response = JSON.parse(stringifiedResponse);
        console.log(response);
        return void 0;
    }).catch(error => {
        console.error(error);
    });

// POST Request Example
const urlPost = `exec-post/?func=modules.testModule.testMethod&params=requestContent`;
const options = {
    body: JSON.stringify({
        contentCode,
        subjectUuid
    }),
    method: 'POST'
};
jsApi.restCall(urlPost, options)
    .then(stringifiedResponse => {
        const response = JSON.parse(stringifiedResponse);
        console.log(response);
        return void 0;
    }).catch(error => {
        console.error(error);
    });
```

--------------------------------

### Install URL Rewrite Module

Source: https://www.naumen.ru/docs/sd/4.19/Content/admin/win-reverse-proxy.htm

Starts the installation process for the downloaded URL Rewrite Module MSI package. Follow the installer prompts.

```powershell
Start-Process "d:\naumen\deploy\$(Get-Date -format "yyyy-MM-dd")\update\rewrite_amd64_ru-RU.msi"
```

--------------------------------

### Install URL Rewrite Module

Source: https://www.naumen.ru/docs/sd/4.19/Content/admin/win-reverse-proxy.htm?TocPath=%D0%A1%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D0%BE%D0%B5+%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%7C%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D0%B8+%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D0%BE%D0%B3%D0%BE+%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0%7C%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0+%D0%B8+%D0%BE%D0%B1%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%7C%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D0%B8+%D0%B4%D0%BB%D1%8F+Windows%7C_____6

Starts the installation process for the downloaded URL Rewrite Module MSI package.

```powershell
Start-Process "d:\naumen\deploy\$(Get-Date -format "yyyy-MM-dd")\update\rewrite_amd64_ru-RU.msi"
```

--------------------------------

### SOAP Get Response: Aggregated Value Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of how aggregated values are returned in the Get method response.

```xml
<ns2:value>
<ns2:aggregate>
<team>team$5801</team>
<employee>employee$5601</employee>
</ns2:aggregate>
</ns2:value>
```

--------------------------------

### Unzip and Start Nginx on Windows

Source: https://www.naumen.ru/docs/sd/4.19/Content/admin_instal/nginx.htm

Steps to extract the Nginx distribution and start it as a console application on Windows. Assumes the distribution is in C:\.

```bash
cd c:\
unzip nginx-1.2.0.zip
cd nginx-1.2.0
start nginx
```

--------------------------------

### Start Import

Source: https://www.naumen.ru/docs/sd/4.19/Content/script/api.htm?TocPath=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0+SMP%7C%D0%A1%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D0%BE%D0%B2%D1%8B%D0%B5+%D1%81%D1%86%D0%B5%D0%BD%D0%B0%D1%80%D0%B8%D0%B8%7C_____3

Starts a specified import configuration with provided parameters.

```APIDOC
## api.advimport.start(advimportConfig, parameters)

### Description
Starts a specific import configuration, allowing for the input of runtime parameters.

### Method
`api.advimport.start`

### Parameters
#### Path Parameters
* **advimportConfig** (string) - Required - The identifier of the import configuration. This ID can be found in the URL of the configuration card (e.g., `f0e05190-145d-0247-0000-00007388e0bf`).
* **parameters** (object/array) - Optional - Parameters for the import execution. These can be of type STRING, byte[], or InputStream.
  * STRING: Can be a string, a UUID for a data source file (e.g., `file$1234`), or the content of a data source file.
  * byte[] and InputStream: Used for providing the content of a data source file.

### Request Example
```javascript
// Example 1: Starting import without parameters
api.advimport.start('f0e05190-145d-0247-0000-00007388e0bf', [:]);

// Example 2: Starting import with a file UUID and a string parameter
api.advimport.start('f0e05190-145d-0247-0000-00007388e0bf', [ 'fileForProcess' : 'file$1234', 'defaultValue' : 'defaultString' ]);

// Example 3: Starting import with attachment data (byte[])
api.advimport.start('f0e05190-145d-0247-0000-00007388e0bf', [ 'fileForProcess' : message.getAttachments()[0].getData() ]);
```

### Response
* **Success**: Import configuration started.
```

--------------------------------

### REST GET Request Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/applications/JSAPI_metods.htm?TocPath=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0+SMP%7C%D0%92%D1%81%D1%82%D1%80%D0%BE%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5+%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F%7C%D0%9C%D0%B5%D1%82%D0%BE%D0%B4%D1%8B+JS%C2%A0API%7C_____1

Example of making a REST GET request using jsApi.restCallAsJson. It demonstrates fetching data by constructing a URL with function and parameters.

```APIDOC
## REST GET Request Example

### Description
This example shows how to perform a GET request to an API endpoint using the `jsApi.restCallAsJson` method. It constructs a URL to call a specific module method and retrieves the response.

### Method
GET

### Endpoint
`exec/?func=<module.method>&params='<param1>', '<param2>'`

### Parameters
#### Query Parameters
- **func** (string) - Required - The function to execute, in the format 'module.method'.
- **params** (string) - Required - A stringified array of parameters for the function.

### Request Example
```javascript
const subjectUuid = jsApi.extractSubjectUuid();
const contentCode = jsApi.findContentCode();
const url = `exec/?func=modules.testModule.testMethod&params='${subjectUuid}', '${contentCode}'`;

jsApi.restCallAsJson(url, {})
    .then(response => {
        console.log(response);
        return void 0;
    }).catch(error => {
        console.error(error);
    });
```

### Response
#### Success Response (200-299)
- **response** (Object) - The server response, parsed as JSON.

#### Response Example
```json
{
  "example": "response data"
}
```

#### Error Response
- **status** (Number) - The response status code.
- **statusText** (string) - The status text.
- **responseText** (string) - The server response text.
```

--------------------------------

### Example Interface Theme Template Configuration

Source: https://www.naumen.ru/docs/sd/4.19/Content/setting_user/interface_theme_template.htm?TocPath=%D0%98%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81+%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0%7C%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0+%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D1%8B%7C%D0%98%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81+%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D1%8B%7C_____2

This is an example of how to configure theme template parameters, specifically setting the accent color.

```properties
accentColor=#FF6720
```

--------------------------------

### GET Request with Timezone Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/RESTful/REST_API_format.htm

Example of adding a comment with a timezone-aware creation date in a GET request. The '+' sign in the timezone offset must be URL-encoded as %2B.

```http
https://192.168.225.145:8888/sd/services/rest/create/comment/{"source":"serviceCall$155611805","text":"Новый комментарий","creationDate":"2020.01.02 06:07:59 %2B0500"}?accessKey=<accessKey.UUID>
```

--------------------------------

### HttpBuilder GET Request

Source: https://www.naumen.ru/docs/sd/4.19/Content/script/api_http.htm?TocPath=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0+SMP%7C%D0%A1%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D0%BE%D0%B2%D1%8B%D0%B5+%D1%81%D1%86%D0%B5%D0%BD%D0%B0%D1%80%D0%B8%D0%B8%7C%D0%9C%D0%B5%D1%82%D0%BE%D0%B4%D1%8B+API.+SMP%7C_____19

Example of performing a GET request using an HttpBuilder instance.

```APIDOC
## GET Request Example

### Description
This example demonstrates how to perform a GET request to a specified resource using the HttpBuilder.

### Method
GET

### Endpoint
(Implicitly defined by the URL provided to createHttpBuilderClient)

### Parameters
#### Query Parameters
- **contentType** (string) - Required - '*/*' (example value)
```

--------------------------------

### Example Theme Template Configuration

Source: https://www.naumen.ru/docs/sd/4.19/Content/setting_user/interface_theme_template.htm

This is an example of how to configure theme parameters in a template format. It shows a key-value pair for setting the accent color.

```properties
accentColor=#FF6720  

```

--------------------------------

### SOAP Get Response: Text Value Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of a text attribute value.

```xml
<ns2:value>
<ns2:string>Описание задач отдела</ns2:string>
</ns2:value>
```

--------------------------------

### SOAP Get Response: Timer Value Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of a timer attribute value.

```xml
<ns2:value>
<ns2:string>Timer [status=ACTIVE, elapsed=139981]</ns2:string>
</ns2:value>
```

--------------------------------

### Full Kanboard Task by Status Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/applications/kanboard_castom_mod_21.htm?TocPath=%D0%92%D1%81%D1%82%D1%80%D0%BE%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5+%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F%7C%D0%92%D0%9F+%22%D0%98%D0%BD%D1%82%D0%B5%D1%80%D0%B0%D0%BA%D1%82%D0%B8%D0%B2%D0%BD%D0%B0%D1%8F+%D0%B4%D0%BE%D1%81%D0%BA%D0%B0%22%7C%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0%7C%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0+%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D0%BE%D0%B2%D0%BE%D0%B3%D0%BE+%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F+1.0+%E2%80%94+2.3%7C_____3

A comprehensive example demonstrating the configuration of a Kanboard board for tasks by status. It includes board function definition, content code, item retrieval, property mapping, and column setup.

```groovy
final KanboardParams taskByStatus = new KanboardParams( // функция для построения доски  
  
            contentCode: 'statusBoard', // код контента, для которого строится доска   
  
            items: { String subjectUuid ->   
  
            return utils.find('serviceCall', ['responsibleTeam':subjectUuid, 'state': op.in('registered', 'inwork', 'wait', 'closed')])}, // получаем объекты, которые будут отображаться на доске   
  
                    title: { String subjectUuid, ISDtObject item ->   
                    item.hasProperty('title') ? item.title : null},   
                    description: { String subjectUuid, ISDtObject item ->item.hasProperty('descriptionInRTF') ? api.string.htmlToText(item.descriptionInRTF) : null},   
                    categoryIconUrl: {String subjectUuid, ISDtObject item ->item.hasProperty('system_icon') ? item.system_icon.icon[0].UUID : null},   
                    categoryTitle: {String subjectUuid, ISDtObject item -> item.system_icon?.title},   
                    deadline: {String subjectUuid, ISDtObject item -> item.hasProperty('deadLineDate') ? item.deadLineDate.deadLineTime :null}, // определяем соответствие параметров объекта доски и элементов плашки на доске   
  
            columnParams: { String subjectUuid ->  
  
                        return   
  
                                        new ColumnParam('Новые', ['registered']),   
                                        new ColumnParam('В работе', ['inwork'], '#E08A85'),   
                                        new ColumnParam('Отложен', ['wait'], '#DDC688'),   
                                        new ColumnParam('DONE', ['closed'], '#008000') // определяем колонки и их содержимое для доски   
  
                                ]   
  
            }   
  
            )

```

--------------------------------

### SOAP Get Response: Reverse Link Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of a reverse link attribute value.

```xml
<ns2:value>
<ns2:objects ns2:title="Отдел1" ns2:uuid="ou$10402"/>
<ns2:objects ns2:title="Отдел2" ns2:uuid="ou$10411"/>
<ns2:objects ns2:title="Отдел3" ns2:uuid="ou$10412"/>
</ns2:value>
```

--------------------------------

### Example Configuration for Multiple Service Showcases

Source: https://www.naumen.ru/docs/sd/4.19/Content/services2/services20_params_pr.htm

Demonstrates how to define multiple ShowcaseParams instances for different service showcases. Each instance is configured with specific content codes.

```dart
final ShowcaseParams VitrinaUslugParams = new ShowcaseParams()  
            .setContentCodes(['VitrinaUslug'])  
            …  
   final ShowcaseParams integrationSettingsShowcaseParams = new ShowcaseParams()  
            .setContentCodes(['integrationSettings'])  
            …  
/**  
 * Набор параметров витрин для разных контентов  
*/  
   final List<ShowcaseParams> contentParams = [  
            this.VitrinaUslugParams,  
            this.integrationSettingsShowcaseParams,  
   ]  
…
```

--------------------------------

### Monitor Application Startup with PowerShell

Source: https://www.naumen.ru/docs/sd/4.19/Content/admin/ops_win_app_tomcat.htm?TocPath=%D0%A1%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D0%BE%D0%B5+%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%7C%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D0%B8+%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D0%BE%D0%B3%D0%BE+%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0%7C%D0%AD%D0%BA%D1%81%D0%BF%D0%BB%D1%83%D0%B0%D1%82%D0%B0%D1%86%D0%B8%D1%8F+%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D1%8B%7C%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D0%B8+%D0%B4%D0%BB%D1%8F+Windows%7C_____2

Use this command to monitor the application's startup process in real-time by tailing the log file and filtering for 'main' entries. Ensure the log file path is correct.

```powershell
Get-Content d:\naumen\nausd4\logs\sdng.log -Wait -tail 10 | Select-String 'main'
```

--------------------------------

### SOAP Get Response: Hyperlink Value Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of hyperlink attribute value structure.

```xml
<ns2:value>
<ns2:hyperlink text="" url=""/>
</ns2:value>
```

--------------------------------

### SOAP Get Response: Date Value Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of a date value returned for an attribute.

```xml
<ns2:value>
<ns2:string>2014.10.14 00:00:00</ns2:string>
</ns2:value>
```

--------------------------------

### Start Import Without Parameters

Source: https://www.naumen.ru/docs/sd/4.19/Content/script/api.htm?TocPath=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0+SMP%7C%D0%A1%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D0%BE%D0%B2%D1%8B%D0%B5+%D1%81%D1%86%D0%B5%D0%BD%D0%B0%D1%80%D0%B8%D0%B8%7C_____3

Starts a specified import configuration without any additional parameters. The `[:]` denotes empty launch parameters.

```javascript
api.advimport.start('f0e05190-145d-0247-0000-00007388e0bf', [:]);
```

--------------------------------

### SOAP Get Response: Integer Value Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of an integer attribute value returned as a string.

```xml
<ns2:value>
<ns2:string>7</ns2:string>
</ns2:value>
```

--------------------------------

### Monitor SMP Application Startup

Source: https://www.naumen.ru/docs/sd/4.19/Content/admin/ops_nix_app_tomcat.htm

Use this command to monitor the application startup process in real-time by tailing the log file and filtering for 'main' entries. This helps in early detection of startup errors.

```bash
tail -f /opt/naumen/nausd4/logs/sdng.log | grep 'main'
```

--------------------------------

### SOAP Get Response: Catalog Item Value Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of a catalog item attribute value.

```xml
<ns2:value>
<ns2:catalog-item ns2:code="Europe/Moscow" ns2:title="Msk" ns2:uuid="timezone$2101"/>
</ns2:value>
```

--------------------------------

### Create Application Directories

Source: https://www.naumen.ru/docs/sd/4.19/Content/admin/win-app-tomcat.htm

Sets up the necessary directory structure for the application, including 'conf', 'logs', and 'data'.

```powershell
"conf","logs","data" | %{New-Item -ItemType Directory -Path "d:\naumen\nausd4\$_"} 
```

--------------------------------

### Basic <config> Tag Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/import/config_file_config.htm

This snippet shows a basic example of the <config> tag with common parameters like description, schema location, save-log, threads-number, and skip-workflow.

```xml
<config description="Example"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="../../../../../../target/classes/advimport/schema1.xsd"
        save-log="true"
        threads-number="1"
        skip-workflow="false" >  
  
</config>
```

--------------------------------

### SOAP Get Response: Object Type Value Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of an object type attribute value.

```xml
<ns2:value>
<ns2:string>ou$OUType</ns2:string>
</ns2:value>
```

--------------------------------

### SOAP Get Response: Reverse Timer Value Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of a reverse timer attribute value.

```xml
<ns2:value>
<ns2:string>BackTimerDto [getStatus()=ACTIVE, deadLineTime=Tue Oct 21 11:29:14 CEST 2014, allowance=518260018]</ns2:string>
</ns2:value>
```

--------------------------------

### Configure Tomcat Autostart (Red Hat)

Source: https://www.naumen.ru/docs/sd/4.19/Content/admin_instal/instal_SD_Linux.htm

Commands to make the Tomcat init script executable, add it to chkconfig, and enable it to start on system boot for Red Hat-based distributions.

```bash
chmod +x /etc/init.d/tomcat
chkconfig --add tomcat
chkconfig tomcat on
```

--------------------------------

### SOAP Get Response: Status Value Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of a status attribute value returned as a string.

```xml
<ns2:value>
<ns2:string>registered</ns2:string>
</ns2:value>
```

--------------------------------

### Start PostgreSQL Service on Ubuntu

Source: https://www.naumen.ru/docs/sd/4.19/Content/admin/ops_nix_rdbms.htm?TocPath=%D0%A1%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D0%BE%D0%B5+%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%7C%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D0%B8+%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D0%BE%D0%B3%D0%BE+%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0%7C%D0%AD%D0%BA%D1%81%D0%BF%D0%BB%D1%83%D0%B0%D1%82%D0%B0%D1%86%D0%B8%D1%8F+%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D1%8B%7C%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D0%B8+%D0%B4%D0%BB%D1%8F+Linux%7C_____4

Use this command to start the PostgreSQL service on Ubuntu systems.

```bash
sudo systemctl start postgresql
```

--------------------------------

### SOAP Get Response: Business Object Link Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of a single link to a business object.

```xml
<ns2:value>
<ns2:entity ns2:title="Департамент управления" ns2:uuid="ou$5501"/>
</ns2:value>
```

--------------------------------

### Start Tomcat Service on Linux (init.d)

Source: https://www.naumen.ru/docs/sd/4.19/Content/admin_sd/on_off_sd.htm

Use this command on Linux systems using /sbin/init scripts to start the Tomcat service.

```bash
# /etc/init.d/tomcat start
```

--------------------------------

### SOAP Get Response: Boolean Value Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of a boolean attribute value returned as a string.

```xml
<ns2:value>
<ns2:string>false</ns2:string>
</ns2:value>
```

--------------------------------

### Start Import

Source: https://www.naumen.ru/docs/sd/4.19/Content/script/api_import.htm?TocPath=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0+SMP%7C%D0%A1%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D0%BE%D0%B2%D1%8B%D0%B5+%D1%81%D1%86%D0%B5%D0%BD%D0%B0%D1%80%D0%B8%D0%B8%7C%D0%9C%D0%B5%D1%82%D0%BE%D0%B4%D1%8B+API.+SMP%7C_____3

Starts a specified import configuration with provided parameters. Parameters can include strings, UUIDs for data source files, or the data source content itself.

```APIDOC
## api.advimport.start(advimportConfig, parameters)

### Description
Starts a specified import configuration with provided parameters.

### Method
`api.advimport.start`

### Parameters
#### Path Parameters
- **advimportConfig** (string) - Required - The identifier of the import configuration to start.
- **parameters** (Map) - Optional - Parameters for the import. Can be an empty map `[:]`.

### Request Example
```javascript
// Example 1: Starting without parameters
api.advimport.start('f0e05190-145d-0247-0000-00007388e0bf', [:]);

// Example 2: Starting with a file UUID and a string parameter
api.advimport.start('f0e05190-145d-0247-0000-00007388e0bf', [ 'fileForProcess' : 'file$1234', 'defaultValue' : 'defaultString' ]);

// Example 3: Starting with attachment data (byte[])
api.advimport.start('advImportConfig:f9157637-14c7-0d65-0000-00005e6f5b10', [ 'fileForProcess' : attachment.getData() ]);
```

### Response
- **Success**: Import configuration started.
```

--------------------------------

### SOAP Get Response: License Value Example

Source: https://www.naumen.ru/docs/sd/4.19/Content/integration/SOAP_decription.htm

Example of a license type value returned as a string.

```xml
<ns2:value>
<ns2:string>concurrent</ns2:string>
</ns2:value>
```

--------------------------------

### Install PostgreSQL on Ubuntu

Source: https://www.naumen.ru/docs/sd/4.19/Content/admin/nix-rdbms.htm

Installs PostgreSQL on Ubuntu by adding the official PostgreSQL repository and then installing the specified version. Ensure the locale is set to 'ru_RU.UTF-8' before proceeding.

```bash
pg_version=18
```

```bash
sudo apt install curl ca-certificates
```

```bash
sudo install -d /usr/share/postgresql-common/pgdg
```

```bash
sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc
```

```bash
. /etc/os-release
```

```bash
sudo sh -c "echo 'deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] https://apt.postgresql.org/pub/repos/apt $VERSION_CODENAME-pgdg main' > /etc/apt/sources.list.d/pgdg.list"
```

```bash
sudo apt update
```

```bash
sudo apt install postgresql-${pg_version}
```
Tokens:
Raw