Author: MiaZhong
Updated: 2018-12-19
URL
功能介绍
模版管理
统一管理物业模版，可多家门店共用。
门店管理
门店唯一，一家门店对应一个门店管理记录。
同步情况
监测每日门店物业同步情况。
物业模版配置
字段配置
将HEX平台参数与物业平台XML中的元素一一映射，XML根元素与子元素之间以“.”分隔。
配置参数介绍
| 名称 | 描述 | 可否为空 |
|---|---|---|
| 字段名称 | 字段名称 | 否 |
| 原字段数据 | HEX系统中字段名 | 否 |
| 字段定位 | 传输给物业方的对应报文字段 | 否 |
配置步骤
- 单击“添加字段配置”；
- 输入“字段名称”；
- 参照《物业平台物业模版配置参数表》找到相应字段名，填入“原字段数据”；
- 定位到物业方接收报文格式中的字段。（注：遇节点以“.”分隔；遇元素为list类型，在字段名后添加“[]”）
- 示例
| 字段名称 | 原数据字段 | 字段定位 | 适用传输方式 |
|---|---|---|---|
| 用户名称 | ptmUsername | postsalescreate.astr_request.header.username | webservice |
| 商品数量 | goodsNum | postsalescreate.astr_request.salesitems.salesitem[].qty | webservice |
值转换配置
部分需要特殊转换的元素一一对应，进行转换。
配置参数介绍
| 名称 | 描述 | 可否为空 |
|---|---|---|
| 字段定位 | 传输给物业方的对应报文字段，与字段配置中的字段定位一致 | 否 |
| 转换类型 | 值转换类型 | 否 |
| 转换名称 | 转换名称 | 否 |
| 转换前的值 | 需要转换的内容 | 否 |
| 转换后的值 | 需要转换成的结果 | 否 |
值转换类型介绍
| 名称 | 描述 | 转换前的值 | 转换后的值 | 适用情况举例 |
|---|---|---|---|---|
| 固定值 | 元素值为固定值 | 转换后的结果 | 转换后的结果 | version=V332M |
| 一对一转换 | 元素值为x时恒转换成y | x | y | 支付方式CH转换成01 |
| 多对一转换 | 当元素值为不同值均转换成同一个值 | 某节点名 | 需转换成的结果 | 支付方式payMode均转换成OT |
| 字段补位 | 按需给字段进行补位 | 元素名 | 补位字段+元素名 | [YYMMdd]FILENO |
| 字符替换 | 格式部分转换 | 转换前字符 | 转换后字符 | hh:mm:ss->hh-mm-ss |
| 字符串截取 | 按位数截取过长字符串 | 所需位数 | 所需位数 | 100000000000->100000 |
| 拼接节点 | 拼接节点 | 拼接节点标记 | 拼接节点标记 | 南京禄口，xml套string |
| 日期格式化 | 日期格式转换 | 转换前格式 | 转换后格式 | yyyy-MM-dd HH:mm:ss -> yyyyMMddHHmmss |
配置步骤
- 单击“添加值转换”；
- 输入“字段定位”；
- 根据需求选择相应的“转换类型”；
- 输入“转换名称”、“转换前的值”、“转换后的值”。
根据同步类型分类示例
- Webservice
传输内容为xml格式
-
特殊情况
部分模版类型不支持自主配置，列举如下：
上铁高铁站模版
e.g: 苏州昆山南站
- 字段配置
| 字段名称 | 原数据字段 | 字段定位 |
|---|---|---|
| testXmlJson | testXmlJson | testXmlJson |
- 值转换
| 字段定位 | 转换类型 | 转换名称 | 转换前的值 | 转换后的值 |
|---|---|---|---|---|
| Save.TradeChange | 内容 | |||
| Save.valikey | 固定值 | valikey |
- Http
1. HTTP GET
2. HTTP POST
3. Json
传输内容为json格式
将HEX平台参数与物业平台Json中元素一一映射，Json节点元素与子节点元素之间以“.”分隔。
- FTP
传输内容为txt格式
物业平台目前只支持部分格式的配置，列举如下，如超出以下介绍范畴，需要联系IT进行评估开发。
格式列举
- 汇总类
- 汇总+明细类
- 明细类
- 上铁集团
门店管理
门店信息参数介绍
| 名称 | 描述 | 可否为空 |
|---|---|---|
| 系统门店编码 | HEX平台global_id | 否 |
| 门店名称 | 门店名称 | 否 |
| 商户门店编码 | 星巴克门店编码store_code | 否 |
| 门店地址 | 门店地址 | 是 |
| 门店联系方式 | 门店联系方式 | 是 |
| 传输方式 | 物业方同步类型 | 否 |
| 传输地址 | 物业方接收地址 | 否 |
| 传输端口 | 物业方接收地址端口 | 由同步方式决定 |
| 传输开始小时 | 传输开始时间 | 否 |
| 传输结束小时 | 传输结束时间 | 否 |
| 传输频率 | 传输频率 | 否 |
| 接口生效时间 | 接口生效时间 | 是 |
| 验证账号 | 传输地址授权认证账户 | 是 |
| 密码 | 传输地址授权认证账号密码 | 是 |
| 路径地址 | 路径地址 | 由同步方式决定 |
| 子程序地址 | webservice:xmnls参数；FTP：服务器目录地址 | 由同步方式决定 |
| 传输文件编码 | webservice：text/xml;charset=utf-8;FTP:utf-8 | 由同步方式决定 |
| WebService Action | webservice soap值 | webservice方式不可为空 |
模版管理参数介绍
| 名称 | 描述 |
|---|---|
| 选择配置 | 适用于该门店的物业模版 |
