应用程序正规化
GitHub 仓库 | npmjs 软件包 | Upkg CDN (英语) | 将套装正规化
通过外部系统创建的表格条目的管理.
先决条件
地方发展
# get the source
git clone [email protected]:digital-blueprint/formalize-app.git
cd formalize-app
git submodule update --init
# install dependencies
npm install
# constantly build dist/bundle.js and run a local web-server on port 8001
npm run watch
# constantly build dist/bundle.js and run a local web-server on port 8001 using a custom assets directory assets_local/
npm run watch-local
# run tests
npm test
跳转到 https://localhost:8001 (英语),您应该有一个登录页上的单一标记.
使用此应用程序作为预建软件包
安装应用
如果您要在新文件夹中安装 dbp 正规化应用程序 formalize-app 你可以打电话:
npx @digital-blueprint/cli install-app formalize formalize-app /
警告: 当您作为 root 用户运行这些命令时, 可能会有问题, 如 www-data。 。 。 .
要做到这一点, 例如您可以打开外壳 runuser -u www-data -- bash。 。 。 .
之后您可以将您的 Apache 网络服务器指向 formalize-app/public。 。 。 .
确保你允许 .htaccess 在您的 Apache 配置中的文件.
同时确保将您使用的所有资源( 如您的 API 和 Keycloak 服务器) 添加到
Content-Security-Policy 在你身边 formalize-app/public/.htaccess因此,浏览器允许访问这些网站.
您也可以直接使用此应用程序 Upkg CDN (英语) 比如说: dbp-正规化/index.html
请注意, 您将需要一个 Keycloak 服务器以及您运行的 html 域名的客户端 ID .
更新应用程序
如果您想要更新当前文件夹中的 dbp 正规化应用程序, 您可以调用 :
npx @digital-blueprint/cli update-app formalize
警告: 当您作为 root 用户运行这些命令时, 可能会有问题, 如 www-data。 。 。 .
要做到这一点, 例如您可以打开外壳 runuser -u www-data -- bash。 。 。 .
活 动
此应用程序有以下活动:
dbp-formalize-manage-formsdbp-formalize-manage-submissionsdbp-formalize-render-from
您可以在 正式确定活动文件。 。 。 .
适应应用程序
职能
您可以添加多个属性到 <dbp-formalize> 标签.
| 属性名称 | 价值 | 说明 |
|---|---|---|
provider-root | 布尔 | 应用壳 |
lang | 字符串 | 语言选择 |
entry-point-url | 字符串 | 应用壳 |
keycloak-config | 对象 | 应用壳 |
base-path | 字符串 | 应用壳 |
src | 字符串 | 应用壳 |
html-overrides | 字符串 | 常见 |
themes | 阵列 | 主题切换器 |
darkModeThemeOverride | 字符串 | 主题切换器 |
强制属性
如果你没有使用 provider-root 属性到“ 终止” 所有提供者属性
您需要手动添加这些属性,以使主题能够正常工作:
<dbp-formalize auth requested-login-status analytics-event></dbp-formalize>
设计
对于前端设计定制,如标志,颜色,字体,favicon等,请查看 主题文档。 。 。 .
"dbp-正规化"插槽
这些是应用壳的常见插槽. 您可以在 app- shell 文档。 。 。 . 对于应用程序的特定插槽,请查看 正式活动。 。 。 .
通知
我们正在使用自动生成的表格头来创建提交表格.
A 类 获取查询 用于 dbp 中继. 这回是一个json。 这份json载有上一份提交材料的各种数据.
将表格贴入 Api , 请查看 : 行动 - 建立-建立。 。 。 . 本文收录了表单"形式"和表单"dataFeedElement"的数据. 数据必须是一个有效的json作为字符串,即引用标记必须用". 同样"形式"名称的表格的数据密钥必须一致,否则新密钥不显示,旧密钥表头中也不会显示数据.