跳转到内容

统一工作台 workspace 配置

统一工作台作为项目交付中整合呈现的平台,平台本身不承载任何业务,提供标准接口供外部服务接入。

image-20210527212517873

功能:

  • 顶栏/侧栏:

    用户可以自行调整选择顶栏还是侧栏,始终悬浮于页面顶栏或左侧栏,承载全局功能的快速入口。

  • 导航结构:

    应用导航展示该用户拥有的该应用的所有权限。

    导航分全局导航与应用导航,全局导航在应用左上角的应用商店中,用于应用间切换**。应用导航**在应用中显示,用于应用内功能间切换。

  • 工作台(应用功能区):

    便于用户快速浏览平台概况,进行快捷操作。用户主要在此使用统一工作台的各个应用,提升日常维护工作效率。

  • 搜索:

    方便用户能快速的定位到目标信息,减少寻找路径。实时匹配搜索,用户输入过程中实时展示搜索结果,方便用户使用。

  • 辅助功能

    • debug
    • 语言切换
    • 个人中心
    • 更多功能在开发。。。

配置的环境变量部分可以在交付控制台配置,若交付控制台不支持配置的则须手动修改镜像的环境变量

1.在交付控制台进行配置

统一工作台具备许多可被配置的信息, 通常这些信息可能是系统管理员或者业务人员进行调整的, 并且配置调整后, 会立即生效, 无需重启服务。 配置中心支持配置信息如下

1.1基础配置

**全局搜索:**开启后统一工作台将提供全局搜索功能。

**切换语言:**开启后可在统一工作台对全局的系统语言进行语种的切换。

**通知中心:**开启后可在统一工作台开启通知中心模块,汇总展示所有通知消息。

**全局水印行为:**点击后弹窗选择上传水印内容,配置完成后所有页面将会展示所选择的水印样式。

**系统icon:**点击后可选择上传一张3.0MB以内的图片作为系统icon展示

前端配置:可通过json类型的配置,修改统一工作台容器的属性。举例:{Form:{spaceNum:3, columnNum: 4},Table: { useOrignalTable: true }}

img

1.2首屏配置

配置Homepage、Dashboard、以及内嵌页面

1.3拓展配置

拓展配置支持自定义配置模型上未被抽象的功能属性(例如全局搜索),点击添加行后输入配置的标识和配置值可生成一条功能属性的配置(支持多条)。点击删除可删除对应的已添加的功能属性。

img

2.通过环境变量配置

2.1功能显示隐藏

  • WEBNEST_FEATURE:

注意,以 ENABLE 开头的环境变量均是新版 workspace 的新特性,所以均放到 WEBNEST_FEATURE 变量中

// 例如:
WEBNEST_FEATURE=ENABLE_LOG,ENANLE_DASHBORD,ENABLE_HORIZONTAL,ENABLE_TABBAR
  1. ENABLE_LOG 开启日志
  2. ENANLE_DASHBORD 开启 dashboard
  3. ENABLE_HORIZONTAL 默认为竖直方向,当开启时侧导航变为顶导航
  4. ENABLE_TABBAR 开启多页签
  5. ENABLE_GLOBAL_THEME_NORMAL 全局导航的主题改为 NORMAL(深色)
  6. ENABLE_SIDE_OPENKEYS_ALL Side 打开支持默认全部展开 (Ubras需求)
  7. DISABLE_LOG_DETAIL_BUTTON 开启日志后隐藏日志详情 (Ubras需求)
  • FRONT_DEBUG

    开启 DEBUG 模式

    // 例如:
    FRONT_DEBUG=false

2.2 自定义

  • WEBNEST_FAVICON

    为更方便自定义,favicon 以 base64 的形式加载

    WEBNEST_FAVICON=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAMAAABEpIrGAAAA7VBMVEUAAABKYKBJXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5KXp9JXp5JXp5JXZ5JXZ9JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5JXZ5KXZ9KXZ9KXZ9LYKBJXZ7///9HW51NYKGqs9Lx8vXKz+Nqeq/29/rz9fhufrJfcKbq6+/S09jO0NdxgLNabKVTZqNPYqHo6Ore4Ofd3uHIzt/U1922vdfIytGlr8+XosiTn8WNmcB2hrVmdqtFWpz6+/zj5erS1+fO1OW0u9W/wsu2ucO0t8EMLlQoAAAAJnRSTlMAA/z56jfmPNnO29TKvZiNimsqHRtDLMO3rq2bloOAeHboMjEtBA+L0UkAAAFfSURBVDjLfZPneoIwFIZPGAKKDFfd2hW1FBB3l9Y6unv/l9MgKQakvL+S57zhI8/JgZDrSqemCDwvKPVuAUEcJGlZDlM4uSnFlKJ+jiNkjBIwSGf4hLwIIWUZJ5Arh+dJPdEQaT79fkJKEQhID3b9A38rfKCF/IAM9pnbtr3beZ438+zhcEbvQkKQFpx/sUb3T6uvn+/Jm+U6n4PA0BFcZQPhuWfdPYxXE6vn87gIhGwFOhwrjN1eROBMqGEa4ZKIycivvjrOkkbgBih0NZ9Oh/bGIfX3zXbrYYoKAsbhNfdrUreme/+aFAF4fKR/Q4SPBWbgT4XbQVQQ0gUBlHRBhXq6oEGXSxM4EwpymiAXADUZYe26zhIzGIi2mzIPO31sNyCD/U0Cs22DTymP/6FK76YS64rF0ApJxqKBCFiQkr1MjJ6rUxs9NoliIBEnR1eQ0yY74rZUP3xVzWTGf9fJlp5lRZezJEAAAAASUVORK5CYII=

    可直接去:https://www.favicon-generator.org/https://www.base64-image.de/ 生成想要的 base64 图片

  • DOCUMENT_TITLE

    字符串

    标题(后期可能有规则)端点科技-${page.title}

    // 例如:
    DOCUMENT_TITLE=端点科技
  • 自定义主题

    主要是统一原有主题风格来对 Trantor UI 的一种扩展,(并非动态切换主题)

    注意:Trantor前端当前没有存储静态资源的位置,如果主题打包完成需要自己上传OSS使用连接去配置环境变量

  • INJECT_HEADERINJECT_FOOTER

    脚本注入,主要使用场景是处理一些Trantor无法满足的需求。注入一段JS脚本来实现特殊的功能需求,例如三方客服等等。

    让用户在应用的 <head> 标签中 or </body> 标签前插入自定义脚本

    在环境变量中配置,INJECT_FOOTER=<script src="xxxxxxxx" /> INJECT_HEADER=<script src="xxxxxx"/>

    例子:

    1. 新增元信息

      (function() {
      var _Meta = document.createElement('meta');
      _Meta.content = 'width=device-width, initial-scale=1.0, maximum-scale=1.0,minimum-scale=1.0, user-scalable=0';
      _Meta.name = 'viewport';
      document.getElementsByTagName('head')[0].appendChild(_Meta);
      })()
    2. 把 T-Console 嵌入到云灯系统内:

      (function(){
      const currentScript = document.currentScript;
      if( !currentScript ) return;
      const domain = currentScript.getAttribute('domain') || '';
      const link = `<link rel="stylesheet" href="${domain}/header/umi.css?_randomfix=${Math.random()}"></link>`;
      const script = `<script src="${domain}/header/umi.js?_randomfix=${Math.random()}"></script>`;
      const element = `<div id="yundeng_header"></div>`
      const style = `
      <style>
      * {
      margin: 0;
      padding: 0;
      }
      html body {
      height: 100vh;
      }
      #yundeng_header{
      height: 48px;
      }
      </style>
      `
      document.head.appendChild(document.createRange().createContextualFragment(link) );
      document.head.appendChild(document.createRange().createContextualFragment(style));
      document.body.prepend(document.createRange().createContextualFragment(element));
      document.body.appendChild(document.createRange().createContextualFragment(script));
      document.getElementById('app').style.height = 'calc(100% - 48px)';
      try{
      document.title = '云灯控制台'
      window.originalTitle = document.title;
      Object.defineProperty(document, 'title', {
      get: function() { return window.originalTitle },
      set: function() {}
      });
      }catch(err){}
      })()
  • COOKIE_DOMAIN

    COOKIE_DOMAIN=helloworld.terminus.io

    设置Cookie domain 位置

  • WEBNEST_CDN_LOOKUP

    主要用来配置Trantor静态CDN回源,配置完毕后静态资源加载将走CDN地址

    环境变量配置:TRANTOR_HTTP_CDN_PATH=https://cdn.terminus.io/

    注:此配置不对 T-Console 有效

  • WELCOME_TITLE

    用来配置欢迎文案 WELCOME_TITLE=欢迎回来

  • WELCOME_IMAGE

    用来配置欢迎图片 WELCOME_IMAGE=https://www.duandian.com/static/images/logo.png

  • CSRF_TOKEN_NAME

    用来配置CSRF名称,对应erda 鉴别cookietoken名称,两个相同。
    1,设置即启用,不设置不启用。
    2,对应erda相关 文档
    3,CSRF_TOKEN_NAME 对应设置值最好 x-csrf-token