JeecgBoot

https://help.jeecg.com/
Admin
JeecgBoot is a microservices framework built on SpringBoot 2.x/3, SpringCloud, and Mybatis with...
Tokens:205,857
Snippets:1,651
Trust Score:8.7
Update:1 month ago
Show doc for...
Tokens:
Raw
### Start Microservice Module from Target Directory

Source: https://help.jeecg.com/java/springcloud/archetype

After installing the 'jeecg-boot-parent' to the local repository, navigate to the module's target directory and run this command to start the microservice module. Ensure UTF-8 encoding and use the specified random device for security.

```bash
cd  jeecg-module-{模块名}  
mvn clean install  
cd jeecg-module-{模块名}-start\target  
java -Dfile.encoding=utf-8 -Djava.security.egd=file:/dev/./urandom -jar jeecg-module-{模块名}-start.jar  
```

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

### File Write Example

Source: https://help.jeecg.com/aigc/flowNodes/nodeKnowWrite

Configuration example for writing user-uploaded files (PDF, DOCX) directly into a knowledge base using file write mode.

```text
开始 / doc_path
```

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

### Start Backend JAR Application

Source: https://help.jeecg.com/java/publish/jar

Use these commands to start the backend JAR application. The Linux command runs it in the background.

```bash
Window启动命令：  
java -jar jeecg-system-start-3.8.0.jar  
  
Linux下后台进程启动命令：  
nohup java -jar jeecg-system-start-3.8.0.jar >catalina.out 2>&1 &  
  
关掉项目：  
ps -ef|grep java  
kill 进程号   
```

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

### Text Write Example

Source: https://help.jeecg.com/aigc/flowNodes/nodeKnowWrite

Example of writing dynamic text content to a knowledge base using input variables for placeholders.

```text
以下是用户咨询的问题摘要：  
问题：{{question}}  
回答：{{answer}}  
记录时间：{{timestamp}}  

```

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

### Dialogue Summary Write Example

Source: https://help.jeecg.com/aigc/flowNodes/nodeKnowWrite

Configuration example for writing a dialogue summary to a knowledge base using text write mode.

```text
{{summary}}  

```

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

### Kotlin Script Example (Not Supported)

Source: https://help.jeecg.com/aigc/flowNodes/nodeCode

Example of a Kotlin script. Note that Kotlin scripting is currently not supported in this node.

```kotlin
fun main(params: MutableMap<String, Any?>): Map<String, Any?> {
  if (params["llmRes"] is String) {
    val llmRes = params["llmRes"] as String
    val resLength = llmRes.length
    params["llmRes"] = "$llmRes\n字数1：$resLength"
  }
  return mapOf("result" to params["llmRes"])
}
```

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

### ImgPreview Multi-Image Preview Example

Source: https://help.jeecg.com/uniapp3/ui/imgPreview

This example demonstrates how to use the ImgPreview component to display multiple images. It includes a wd-img component for triggering the preview and the ImgPreview component itself, which is conditionally rendered. The close event is handled to hide the preview.

```vue
<template>
	<wd-img
		custom-class="imgView"
		:width="220"
		:height="120"
		src="https://jeecgos.oss-cn-beijing.aliyuncs.com/files/site/projectCase/mini/banner/10bdc1.jpg"
		@click="() => (imgPreview.show = true)"
	></wd-img>
	<ImgPreview v-if="imgPreview.show" :urls="imgPreview.urls" @close="() => (imgPreview.show = false)"></ImgPreview>
</template>

<script>
import { ref } from 'vue';
// 图片预览
const imgPreview = ref({
	show: false,
	urls: [
		'https://jeecgos.oss-cn-beijing.aliyuncs.com/files/site/projectCase/mini/banner/10bdc1.jpg',
		'https://static.jeecg.com/files/app_logo.png'
	]
});
</script>

```

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

### Install Nginx on CentOS/RHEL

Source: https://help.jeecg.com/java/chatgpt

Installs the Nginx web server on CentOS or RHEL-based systems using yum. This is a prerequisite for setting up a proxy server.

```bash
# yum install -y nginx  
```

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

### SuperQuery Component - Query All Fields Example

Source: https://help.jeecg.com/ui/2dev/jingyan/use_superquery

Example demonstrating how to configure the SuperQuery component to query all fields, typically after obtaining field information from an API. The 'handleSuperQuery' function processes the search parameters and updates the query.

```html
<super-query :config="superQueryConfig" @search="handleSuperQuery" />
```

```javascript
const superQueryConfig = reactive({
    name: { title: '名称', view: 'text', type: 'string', order: 1 },
    keyWord: { title: '关键词', view: 'text', type: 'string', order: 2 },
    punchTime: { title: '打卡时间', view: 'datetime', type: 'string', order: 3 },
    keyWord: { title: '工资', view: 'text', type: 'number', order: 4 },
    salaryMoney: { title: '奖金', view: 'text', type: 'number', order: 5 },
    sex: { title: '性别', view: 'list', type: 'string', dictCode: 'sex', order: 6 },
    birthday: { title: '生日', view: 'date', type: 'string', order: 7 },
    email: { title: '邮箱', view: 'text', type: 'string', order: 8 },
    content: { title: '个人简介', view: 'text', type: 'string', order: 9 },
  });

  function handleSuperQuery(params) {
    Object.keys(params).map((k) => {
      // 得到高级查询组件的条件，拼接到接口
      queryParam[k] = params[k];
    });
    // 调用接口重新刷新表格数据
    searchQuery();
  }
```

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

### Access Java API Documentation

Source: https://help.jeecg.com/java/setup/idea/startup

After starting the backend, access the API documentation via this URL in your browser.

```http
http://localhost:8080/jeecg-boot/doc.html

```

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

### Flowable Database and Command Initialization

Source: https://help.jeecg.com/java/jeecgboot3.5Kingbase

This code handles database connection initialization, schema management, and command executor setup for Flowable.

```java
                    throw var53;  
                } finally {  
                    if (preparedStatement != null) {  
                        if (var5 != null) {  
                            try {  
                                preparedStatement.close();  
                            } catch (Throwable var49) {  
                                var5.addSuppressed(var49);  
                            }  
                        } else {  
                            preparedStatement.close();  
                        }  
                    }  
  
                }  
            }  
  
            this.databaseType = this.databaseTypeMappings.getProperty(databaseProductName);  
            if (this.databaseType == null) {  
                throw new FlowableException("couldn't deduct database type from database product name '" + databaseProductName + "'");  
            }  
  
            this.logger.debug("using database type: {}", this.databaseType);  
        } catch (SQLException var55) {  
            throw new RuntimeException("Exception while initializing Database connection", var55);  
        } finally {  
            try {  
                if (connection != null) {  
                    connection.close();  
                }  
            } catch (SQLException var48) {  
                this.logger.error("Exception while closing the Database connection", var48);  
            }  
  
        }  
  
        if ("mssql".equals(this.databaseType)) {  
            this.maxNrOfStatementsInBulkInsert = this.DEFAULT_MAX_NR_OF_STATEMENTS_BULK_INSERT_SQL_SERVER;  
        }  
  
    }  
  
    public void initSchemaManager() {  
        if (this.commonSchemaManager == null) {  
            this.commonSchemaManager = new CommonDbSchemaManager();  
        }  
  
    }  
  
    public void addSessionFactory(SessionFactory sessionFactory) {  
        this.sessionFactories.put(sessionFactory.getSessionType(), sessionFactory);  
    }  
  
    public void initCommandContextFactory() {  
        if (this.commandContextFactory == null) {  
            this.commandContextFactory = new CommandContextFactory();  
        }  
  
    }  
  
    public void initTransactionContextFactory() {  
        if (this.transactionContextFactory == null) {  
            this.transactionContextFactory = new StandaloneMybatisTransactionContextFactory();  
        }  
  
    }  
  
    public void initCommandExecutors() {  
        this.initDefaultCommandConfig();  
        this.initSchemaCommandConfig();  
        this.initCommandInvoker();  
        this.initCommandInterceptors();  
        this.initCommandExecutor();  
    }  
  
    public void initDefaultCommandConfig() {  
        if (this.defaultCommandConfig == null) {  
            this.defaultCommandConfig = new CommandConfig();  
        }  
  
    }  
  
    public void initSchemaCommandConfig() {  
        if (this.schemaCommandConfig == null) {  
            this.schemaCommandConfig = new CommandConfig();  
        }  
  
    }  
  
    public void initCommandInvoker() {  
        if (this.commandInvoker == null) {  
            this.commandInvoker = new DefaultCommandInvoker();  
        }  
  
    }  
  
    public void initCommandInterceptors() {  
        if (this.commandInterceptors == null) {  
            this.commandInterceptors = new ArrayList();  
            if (this.customPreCommandInterceptors != null) {  
                this.commandInterceptors.addAll(this.customPreCommandInterceptors);  
            }  
  
            this.commandInterceptors.addAll(this.getDefaultCommandInterceptors());  
            if (this.customPostCommandInterceptors != null) {  
                this.commandInterceptors.addAll(this.customPostCommandInterceptors);  
            }  
  
            this.commandInterceptors.add(this.commandInvoker);  
        }  
  
    }  
  
    public Collection<? extends CommandInterceptor> getDefaultCommandInterceptors() {  
        if (this.defaultCommandInterceptors == null) {  
            List<CommandInterceptor> interceptors = new ArrayList();  
            interceptors.add(new LogInterceptor());  
            if ("cockroachdb".equals(this.databaseType)) {  
                interceptors.add(new CrDbRetryInterceptor());  
            }  
  
            CommandInterceptor transactionInterceptor = this.createTransactionInterceptor();  
            if (transactionInterceptor != null) {  
                interceptors.add(transactionInterceptor);  
            }  
  
            if (this.commandContextFactory != null) {  
                String engineCfgKey = this.getEngineCfgKey();  
                CommandContextInterceptor commandContextInterceptor = new CommandContextInterceptor(this.commandContextFactory, this.classLoader, this.useClassForNameClassLoading, this.clock, this.objectMapper);  
                this.engineConfigurations.put(engineCfgKey, this);
```

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

### Install MongoDB with Docker

Source: https://help.jeecg.com/java/mongodb_config

Use this command to run a MongoDB instance in a Docker container. The container is exposed on port 27017.

```bash
docker run -d -p 27017:27017 --name jeecg-mongo registry.cn-hangzhou.aliyuncs.com/jeecgdocker/mongo  

```

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

### BasicDrawer with Native Form

Source: https://help.jeecg.com/ui/2dev/naviteForm

Integrate a native Ant Design Vue form within a BasicDrawer component. This example shows form item setup and submission handling.

```vue
<BasicDrawer v-bind="$attrs" @register="registerDrawer" title="添加用户" width="500px" @ok="handleSubmit" destroyOnClose showFooter>
        <a-form ref="formRef"  :model="formModel">
            <a-form-item label="用户名" name="routerId">
                <a-input v-model:value="router.routerId" placeholder="请输入用户名"/>
            </a-form-item>
        </a-form>
</BasicDrawer>

<script lang="ts" setup>
    const formRef = ref();
    let formModel= reactive({});

    const [registerDrawer, { setDrawerProps, closeDrawer }] = useDrawerInner(async (data) => {
      isUpdate.value = !!data?.isUpdate;
      setDrawerProps({ confirmLoading: false });
      if (unref(isUpdate)) {
        formModel= Object.assign(formModel, data.record);
      }
    });
    /**
     * 提交表单
     */
    async function handleSubmit() {
      await formRef.value.validate().then(() => {
        try {
           setDrawerProps({ confirmLoading: true })；
           //提交表单
          saveOrUpdateRoute({ formModel: formModel}).then(() => {
               //刷新列表
               emit('success');
               closeDrawer();
          });
        } finally {
            setDrawerProps({ confirmLoading: false });
        }
      });
    }
</script>
```

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

### List Button JS Enhancement

Source: https://help.jeecg.com/java/online/enhanceJs/button

For list buttons, ensure the button's code matches the JavaScript function name. This example shows how to get the ID of a selected row.

```javascript
function one(row) {
    console.log('Selected row ID:', row.id);
}
```

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

### Create Dashboard with Components

Source: https://help.jeecg.com/java/ai/skills/skill-dashboard

This example demonstrates how to initialize the API, create a dashboard page, add different types of components (number cards, line charts, pie charts), and save the dashboard.

```APIDOC
## Create Dashboard with Components

### Description
This example demonstrates how to initialize the API, create a dashboard page, add different types of components (number cards, line charts, pie charts), and save the dashboard.

### Method
Python SDK (bi_utils)

### Endpoint
N/A (SDK usage)

### Parameters
N/A (SDK usage)

### Request Example
```python
from bi_utils import *

init_api('https://api3.boot.jeecg.com', 'your-token')

# Create dashboard (style='default', grid coordinates)
page_id = create_page('运营数据看板', style='default', theme='default')

# First row: 4 number cards (w=6x4=24, h=17)
add_number(page_id, '总用户数', x=0, y=0, w=6, h=17, value=15890, suffix='人')
add_number(page_id, '今日活跃', x=6, y=0, w=6, h=17, value=3256, suffix='人')
add_number(page_id, '今日收入', x=12, y=0, w=6, h=17, value=89600, prefix='¥')
add_number(page_id, '转化率', x=18, y=0, w=6, h=17, value=23.5, suffix='%')

# Second row: Line chart + Pie chart
add_chart(page_id, 'JLine', '用户增长趋势', x=0, y=17, w=14, h=35,
          categories=['周一','周二','周三','周四','周五','周六','周日'],
          series=[{'name':'新增用户', 'data':[120,200,150,80,70,110,130]}])

add_chart(page_id, 'JPie', '用户来源', x=14, y=17, w=10, h=35,
          pie_data=[
              {'name':'微信','value':40},
              {'name':'APP','value':30},
              {'name':'网页','value':20},
              {'name':'其他','value':10},
          ])

save_page(page_id)
print(f'仪表盘创建成功！ID: {page_id}')
```

### Response
#### Success Response
Prints a success message with the created dashboard ID.

#### Response Example
```
仪表盘创建成功！ID: <page_id>
```
```

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

### Registering and Opening a Drawer from a Page

Source: https://help.jeecg.com/ui/component/Drawer

This example demonstrates how to use the useDrawer hook in a parent component to register and control a Drawer component. It shows the basic setup for integrating a drawer into a page.

```html
<template>
  <div>
    <Drawer @register="register" />
  </div>
</template>
<script lang="ts">
  import { defineComponent } from 'vue';
  import { Alert } from 'ant-design-vue';
  import { useDrawer } from '/@/components/Drawer';
  import Drawer from './Drawer.vue';

  export default defineComponent({
    components: { Drawer },
    setup() {
      const [register, { openDrawer }] = useDrawer();
      return {
        register,
        openDrawer,
      };
    },
  });
</script>
```

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

### Quick Start: Cloning and Running JeecgBoot Skills

Source: https://help.jeecg.com/java/lowcode-v2

These commands allow you to quickly set up and run the JeecgBoot Skills locally. After cloning the repository and copying the skills, you can interact with the Claude Code interface to generate systems using natural language.

```bash
git clone https://github.com/jeecgboot/skills.git  
cp -r skills/* ~/.claude/skills/  
claude  
```

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

### Create Big Screen and Add Components using bi_utils

Source: https://help.jeecg.com/java/ai/skills/skill-bigscreen

Initializes the API, creates a big screen page with specified parameters, and adds various components such as text, number indicators, line charts, bar charts, pie charts, and decorative elements. Finally, it saves the page and prints its ID. Ensure you have the correct API endpoint and token.

```python
from bi_utils import *

init_api('https://api3.boot.jeecg.com', 'your-token')

# 创建大屏（style='bigScreen'，像素坐标）
page_id = create_page('销售数据大屏', style='bigScreen', theme='dark',
                       background_image='/img/bg/bg4.png')

# 页面主标题
add_text(page_id, 'CRM 数据大屏', x=560, y=15, w=800, h=60,
         font_size=42, color='#ffffff', font_weight='bold',
         text_align='center', letter_spacing=5)

# 数字指标
add_number(page_id, '今日销售额', x=50, y=100, w=400, h=200,
           value=128560, prefix='¥', suffix='元')

# 折线图
add_chart(page_id, 'JLine', '销售趋势', x=50, y=320, w=860, h=380,
          categories=['1月','2月','3月','4月','5月','6月'],
          series=[{'name':'销售额', 'data':[820,932,901,934,1290,1330]}])

# 柱状图
add_chart(page_id, 'JBar', '部门业绩', x=950, y=320, w=860, h=380,
          categories=['研发部','销售部','市场部','运营部'],
          series=[{'name':'业绩', 'data':[320,302,341,374]}])

# 饼图
add_chart(page_id, 'JPie', '客户来源', x=50, y=700, w=500, h=350,
          pie_data=[
              {'name':'直接访问', 'value':335},
              {'name':'邮件营销', 'value':310},
              {'name':'联盟广告', 'value':234},
          ])

# 装饰元素
add_border(page_id, x=30, y=80, w=440, h=240, border_type=1, color='#00BAFF')
add_decoration(page_id, x=660, y=20, w=600, h=60, deco_type=5, color='#00BAFF')

save_page(page_id)
print(f'大屏创建成功！ID: {page_id}')

```

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

### JimuReport Row and Cell Structure

Source: https://help.jeecg.com/java/ai/skills/skill-jimureport

Defines the structure for rows and cells within the 'jsonStr' for report layout. Rows and cells are indexed starting from 1. This example shows a header row with 'ID' and '名称' and a data row binding to '#{ds.id}' and '#{ds.name}'.

```json
{
    "rows": {
        "1": {
            "cells": {
                "1": { "text": "ID", "style": 4 },
                "2": { "text": "名称", "style": 4 }
            },
            "height": 34
        },
        "2": {
            "cells": {
                "1": { "text": "#{ds.id}", "style": 2 },
                "2": { "text": "#{ds.name}", "style": 2 }
            }
        },
        "len": 200
    }
}

```

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

### Jython Installation Command

Source: https://help.jeecg.com/aigc/flowNodes/nodeCode

Command to install Jython using its installer JAR. Replace 'jython-installer-2.7.4.jar' with the actual downloaded file name.

```bash
java -jar jython-installer-2.7.4.jar
```

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

### Configure python.home via Java Command

Source: https://help.jeecg.com/aigc/flowNodes/nodeCode

Alternative method to configure the Jython home directory by adding the -D parameter to the Java startup command.

```bash
java -Dpython.home=/jython安装目录 -jar jeecg-system-start-x.x.x.jar
```

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

### Commit Message Example

Source: https://help.jeecg.com/ui/config/guifan

An example of a correctly formatted commit message following the specified conventions.

```git
git commit -m 'feat(home): add home page'
```

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

### Java Project Startup Class

Source: https://help.jeecg.com/java/setup/idea/startup

Locate and run this main application class within IDEA to start the jeecg-boot backend project.

```java
jeecg-system-start/src/main/java/org/jeecg/JeecgSystemApplication.java

```

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

### GET /airag/flow/run/<flowId>

Source: https://help.jeecg.com/aigc/api

Executes an AI workflow using a GET request with blocking mode.

```APIDOC
## GET /airag/flow/run/<flowId>

### Description
Executes an AI workflow via GET. All parameters are passed as inputParams and responseMode is fixed to blocking.

### Method
GET

### Endpoint
http://<domain>/[contextPath]/airag/flow/run/<flowId>

### Parameters
#### Path Parameters
- **flowId** (string) - Required - The ID of the workflow to run
```

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

### JSelectInput Usage Example

Source: https://help.jeecg.com/ui/component/JSelectInput

Example of defining a JSelectInput component within a FormSchema array, including custom options.

```javascript
const schemas: FormSchema[] = [  
  {  
    field: 'JSelectInput',  
    label: 'JSelectInput',  
    component: 'JSelectInput',  
    componentProps: {  
      options: [  
        { label: 'Default', value: 'default' },  
        { label: 'IFrame', value: 'iframe' },  
      ],  
    },  
  },  
]  
```

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

### Compile Frontend Project (pnpm)

Source: https://help.jeecg.com/java/docker/quickcloud

Navigate to the frontend project directory, install dependencies, and build the project for Docker Cloud deployment using pnpm. Required for manual deployment.

```bash
cd JeecgBoot/jeecgboot-vue3  


pnpm i  
pnpm run build:dockercloud  
```

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

### Get All Datasets API

Source: https://help.jeecg.com/java/ai/skills/skill-jimureport

Use this GET request to retrieve a tree of all datasets associated with a specific report ID.

```http
GET /jmreport/field/tree/{reportId}
```

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

### Groovy Script Example

Source: https://help.jeecg.com/aigc/flowNodes/nodeCode

Example of a Groovy script for the node. Similar to JavaScript, it appends the length of 'llmRes' to itself and returns it as 'result'.

```groovy
def main(params) {
  if (params.llmRes) {
    def resLength = params.llmRes.length()
    params.llmRes += "\n字数：" + resLength
  }
  return [result: params.llmRes]
}
```

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

### Add Database Driver and Connection Pool Dependencies

Source: https://help.jeecg.com/minidao/pre/MinidaoSpringboot3

Optionally, add your database driver and a connection pool like Druid. The starter package includes JDBC and MiniDao core but marks drivers and pools as optional.

```xml
<!-- Database driver (choose as needed) -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
</dependency>

<!-- Connection pool (Druid recommended) -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-3-starter</artifactId>
    <version>1.2.22</version>
</dependency>
```

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

### Create Form with Partitioned Layout

Source: https://help.jeecg.com/java/ai/skills/skill-desform

This example demonstrates creating a form with distinct sections using divider controls for better organization. AI uses 'divider' controls to partition form areas.

```text
创建员工信息表单：  
--- 基本信息 ---  
- 姓名、性别、手机号  
--- 工作信息 ---  
- 部门（选部门）、岗位、入职日期  
--- 其他 ---  
- 备注、附件  

```

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

### Configure Host File for Docker

Source: https://help.jeecg.com/java/docker/quickcloud

Manually configure the host file with necessary IP-to-hostname mappings for microservices to communicate correctly. Essential for manual Docker startup.

```bash
#必要项  
127.0.0.1 jeecg-boot-gateway  
  
  
#可选项  
127.0.0.1 jeecg-boot-mysql  
127.0.0.1 jeecg-boot-redis  
127.0.0.1 jeecg-boot-nacos  
127.0.0.1 jeecg-boot-system  
127.0.0.1 jeecg-boot-sentinel  
127.0.0.1 jeecg-boot-xxljob  
127.0.0.1 jeecg-boot-rabbitmq  
```

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

### Package AI Knowledge Base as ZIP

Source: https://help.jeecg.com/java/ai/aiKnow

Command to package the 'docs' and 'static' directories into a zip file for uploading as an AI knowledge base.

```bash
zip -r jeecgboot-ai-knowledge.zip docs/ static/
```

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

### JSelectDeptPost in BaseForm Example

Source: https://help.jeecg.com/ui/component/JSelectDeptPost

Example of integrating JSelectDeptPost within a BaseForm component. Configure `showButton` to false to hide the selection button.

```javascript
{
    field: 'depart4',
    component: 'JSelectDepartPost',
    label: '选择岗位',
    componentProps: { showButton: false },
    colProps: {
      span: 12,
    },
}

```

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

### Example URL with Parameter

Source: https://help.jeecg.com/java/online/report/config

Access a configured online report by appending parameter values to the report URL. Replace `${parameterName}` with the actual value you wish to filter by.

```url
/online/cgreport/1468488189599100930?sex=`${sex}`
```

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

### 查看目录结构

Source: https://help.jeecg.com/java/springboot4/JeecgBoot-use-TongWeb-springboot4

查看解压后的目录结构。

```bash
/opt/TongWeb/  
├── bin/                    # 启动脚本  
├── domains/                # 域配置  
├── lib/                    # 依赖库  
└── version8.0.9.13.zip     # 版本包  

```

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

### Basic Tree Usage Example

Source: https://help.jeecg.com/ui/component/Tree

Demonstrates how to use the BasicTree component with sample tree data. Ensure the treeData is correctly formatted according to the TreeItem interface.

```vue
<template>
  <BasicTree :treeData="treeData" />
</template>
<script lang="ts">
  import { defineComponent } from 'vue';
  import { BasicTree } from '/@/components/Tree/index';
  import { treeData } from './data';
  import { CollapseContainer } from '/@/components/Container/index';
  import { TreeItem } from '/@/components/Tree/index';

  export const treeData: TreeItem[] = [
    {
      title: 'parent 1',
      key: '0-0',
      icon: 'home|svg',
      children: [
        { title: 'leaf', key: '0-0-0' },
        {
          title: 'leaf',
          key: '0-0-1',
          children: [
            { title: 'leaf', key: '0-0-0-0' },
            { title: 'leaf', key: '0-0-0-1' },
          ],
        },
      ],
    },
    {
      title: 'parent 2',
      key: '1-1',
      icon: 'home|svg',
      children: [
        { title: 'leaf', key: '1-1-0' },
        { title: 'leaf', key: '1-1-1' },
      ],
    },
    {
      title: 'parent 3',
      key: '2-2',
      icon: 'home|svg',
      children: [
        { title: 'leaf', key: '2-2-0' },
        { title: 'leaf', key: '2-2-1' },
      ],
    },
  ];
  export default defineComponent({
    components: { BasicTree, CollapseContainer },
    setup() {
      return { treeData };
    },
  });
</script>
```

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

### Python Script Example

Source: https://help.jeecg.com/aigc/flowNodes/nodeCode

Example of a Python script. It checks if 'llmRes' is a string, appends its length, and returns the result. Requires Jython environment for execution.

```python
if isinstance(params.get("llmRes"), basestring):
    llm_res = params["llmRes"]
    res_length = len(llm_res)
    params["llmRes"] = u"{}\n字数1：{}".format(llm_res, res_length)
  
resp = {"result": params["llmRes"]}
```

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

### Add Minidao Starter Dependency

Source: https://help.jeecg.com/minidao/pre/MinidaoSpringboot2

Include this dependency in your project's pom.xml to enable Minidao integration.

```xml
<dependency>
  <groupId>org.jeecgframework</groupId>
  <artifactId>minidao-spring-boot-starter</artifactId>
  <version>1.8.5</version>
</dependency>
```

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

### Aviator Script Example

Source: https://help.jeecg.com/aigc/flowNodes/nodeCode

Example of an Aviator script. It calculates the length of 'llmRes', concatenates it, and stores the result in a map named 'resp' under the key 'result'.

```aviator
let llmRes = params.llmRes;
let resLength = length(llmRes);
let res = llmRes + "\n字数1：" + resLength;
let resp = seq.map("result", res);
```

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

### Create Jeecg BI Dashboard with Charts

Source: https://help.jeecg.com/java/ai/skills/skill-dashboard

This Python script demonstrates how to initialize the API, create a new dashboard page, add various components like number cards and charts (line and pie), and save the dashboard. Ensure you replace 'your-token' with your actual API token.

```python
from bi_utils import *

init_api('https://api3.boot.jeecg.com', 'your-token')

# 创建仪表盘（style='default'，栅格坐标）
page_id = create_page('运营数据看板', style='default', theme='default')

# 第一行：4 个数字卡片（w=6×4=24，h=17）
add_number(page_id, '总用户数', x=0, y=0, w=6, h=17, value=15890, suffix='人')
add_number(page_id, '今日活跃', x=6, y=0, w=6, h=17, value=3256, suffix='人')
add_number(page_id, '今日收入', x=12, y=0, w=6, h=17, value=89600, prefix='¥')
add_number(page_id, '转化率', x=18, y=0, w=6, h=17, value=23.5, suffix='%')

# 第二行：折线图 + 饼图
add_chart(page_id, 'JLine', '用户增长趋势', x=0, y=17, w=14, h=35, 
          categories=['周一','周二','周三','周四','周五','周六','周日'],
          series=[{'name':'新增用户', 'data':[120,200,150,80,70,110,130]}])

add_chart(page_id, 'JPie', '用户来源', x=14, y=17, w=10, h=35, 
          pie_data=[
              {'name':'微信','value':40},
              {'name':'APP','value':30},
              {'name':'网页','value':20},
              {'name':'其他','value':10},
          ])

save_page(page_id)
print(f'仪表盘创建成功！ID: {page_id}')

```

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

### Add ChatGPT Dependency

Source: https://help.jeecg.com/java/ai/aiSupport

Include the jeecg-boot-starter-chatgpt dependency in your project's pom.xml to enable ChatGPT integration.

```xml
<!-- 引入chatGpt依赖 -->  
<dependency>  
   <groupId>org.jeecgframework.boot</groupId>  
   <artifactId>jeecg-boot-starter-chatgpt</artifactId>  
   <version>3.7.3</version>  
</dependency>  

```

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

### Install Specific Sass Version

Source: https://help.jeecg.com/uniapp3/qa

To avoid compatibility issues with Dart Sass 3.0.0 and later, install a compatible version (e.g., 1.77.6) using pnpm.

```bash
pnpm add sass@1.77.6 -D

```

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

### MiniDao DAO Interface Example

Source: https://help.jeecg.com/minidao/pre/MinidaoSpringboot3

Example of a DAO interface using MiniDao annotations like @Sql, @Param, and @ResultType. DAO interfaces should be annotated with @Repository.

```java
@Repository
public interface EmployeeDao {

    @Sql("select * from employee where id = :id")
    Employee get(@Param("id") String id);

    void insert(@Param("employee") Employee employee);

    int update(@Param("employee") Employee employee);

    @ResultType(Employee.class)
    MiniDaoPage<Employee> getAll(@Param("employee") Employee employee,
                                 @Param("page") int page,
                                 @Param("rows") int rows);

    @Sql("select * from employee where id in ( ${DaoFormat.getInStrs(ids)} )")
    List<Map<String, Object>> getEmployeeByIds(@Param("ids") String[] ids);
}
```

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

### Example API Response Data Structure

Source: https://help.jeecg.com/java/online/chat/chartSingleDatasourceConfig

This is an example of the expected data structure returned by an API for chart configuration. The data should be enclosed within a 'data' key.

```json
{"data": [
      {"sex":0,"cnt":10},
      {"sex":1,"cnt":1},
      {"sex":2,"cnt":4}
]}

```

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

### JavaScript Script Example

Source: https://help.jeecg.com/aigc/flowNodes/nodeCode

Example of a JavaScript script for the node. It processes an input variable 'llmRes', appends its length, and returns the modified value under the 'result' key.

```javascript
function main(params) {
  if (params.llmRes) {
    let resLength = params.llmRes.length;
    params.llmRes = params.llmRes + '\n字数：' + resLength;
  }
  return {
    result: params.llmRes,
  };
}
```

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

### Compile Backend Project (Maven)

Source: https://help.jeecg.com/java/docker/quickcloud

Navigate to the backend project directory and compile the project using Maven with specific profiles for development and Spring Cloud. Required for manual deployment.

```bash
cd JeecgBoot/jeecg-boot  


mvn clean install -Pdev,SpringCloud  
```
Tokens:
Raw