SAP成都研究院C4C光明左使：SAP Cloud for Customer 使用SAP UI5的独特之处 C4CCRMSAP杨逍金庸
大家好，今天的文章来自我的同事，Yang Joey。
2017年7月，SAP成都研究院C4C开发团队刚刚建立。某个周一早晨的Scrum meeting，新出现一位眉清目秀的小伙子，向大家自我介绍：“大家好，我叫杨xiao”。
我一听，哇塞，和明教光明左使杨逍同名。对于八零后武侠爱好者来说，94版倚天屠龙记中孙兴饰演的杨左使潇洒飘逸，孤傲自负且颜值爆表。连金庸看了之后都评价“孙兴的杨逍源于原著，但胜于原著”。相信杨逍是很多少女的梦中情人。
杨逍年轻时的武功，金庸通过灭绝师太和周芷若的对话透露给我们：
“你师伯孤鸿子和魔教中的一个****少年高手****结下了梁子，约定比武，双方单打独斗，不许邀人相助。你师伯知道对手年纪甚轻，武功却极厉害，于是向我将倚天剑借了去。”只听灭绝师太续道：“那场比试，你师伯武功并不输于对手，却给那魔头连施诡计，终于胸口中了一掌，倚天剑还未出鞘，便给那魔头夺了去。”那魔头连声冷笑，说道：“****倚天剑好大的名气！在我眼中，却如废铜废铁一般！”****随手将倚天剑抛在地下，扬长而去。
明教的杨左使年轻时候就有这么高的修为，毕业才3年的SAP成都C4C团队的杨左使也不遑多让。2017年7月加入SAP成都研究院之前，Joey还未使用过JavaScript，然而在今年3月SAP C4C内部举办的以JavaScript为技术栈的编程大赛上，Joey获得了二等奖。短短几个月，Joey的学习速度惊人啊，有SAP C4C三位大佬亲笔签名的奖状为证：
由于英文名Joey的发音，C4C组内女同事更喜欢用另一个昵称：阿娇。虽然听起来有点女性化，实际上Joey也和成都C4C小李探花周帅一样，有坚持健身的习惯。块头虽然不如SAP成都体育节的传奇人物日总那么彪悍，但身上的肌肉也是错落有致。
明教杨左使的最高光时刻，无疑是作为明教三巨头之一挑战少林三渡时的表演：
杨逍却是忽柔忽刚，变化无方。这六人之中，以杨逍的武功最为好看，两枚圣火令在他手中盘旋飞舞，忽而成剑，忽而为刀，忽而作短枪刺、打、缠、拍，忽而当判官笔点、戳、捺、挑，更有时左手匕首，右手水刺，忽地又变成右手钢鞭，左手铁尺，百忙中尚自双令互击，发出哑哑之声以扰乱敌人心神。相斗未及四百招，已连变了二十二般兵刃，每般兵刃均是两套招式，一共四十四套招式。
空智于少林派七十二绝艺得其十一，范遥自负于天下武学无所不窥，但此刻见杨逍神技一至于斯，都不由得暗自叹服。
而Joey加入成都C4C团队还不满一年，相信将来会有更大的空间让Joey能够像明教杨左使一样，在C4C领域里尽情施展他的才华。
下面是Joey的正文。
大家好，我叫杨枭，英文名叫Joey，这个名字是出自于老友记里面的Joey，我非常喜欢他，所以选了这个名字，目前我在SAP成都研究院担任开发工程师。
我来SAP刚好半年多一点，之前在一家美国公司Synnex做公司系统做了2年多，主要是做Java开发工作。说起来学习Java也是一件很机缘巧合的事情，现在已经在程序员的路上走了3年多了。
个人的爱好呢其实比较广泛，比较喜欢看美剧，打羽毛球，玩桌游，玩游戏，看书等等，我喜欢一切可以带给我新鲜感的东西，对很多东西都很好奇，所以呢一直以来都比较喜欢去尝试新事物，我觉得这是一件对生活工作都很好的事情。
在Jerry的公众号文章SAP UI和Salesforce UI开发漫谈里曾经埋下一个伏笔：虽然SAP C4C也基于SAP UI5，但是其使用UI5的方式和SAP其他产品，如S/4HANA, SAP Revenue Cloud， SAP Engagement Center等相比还有所不同。
大多数基于UI5开发的Fiori应用，使用Chrome开发者工具观察，能发现每个应用的前端源代码都位于一个专属的文件夹下。
比如CRM Fiori的My Opportunity应用的前端源代码，位于文件夹crm_opprtnty下 ：
Revenue Cloud的客户主数据管理应用的前端源代码，位于文件夹customers-webapp下：
而C4C，在Chrome开发者工具里找不到这样的专属文件夹。
这就是C4C的UI5实现和SAP其他产品的不同之处。用户在浏览器里看到的UI实际上是一个巨大的模板，由若干区域组成，每个区域在UI上的位置和绘制这些区域的UI5控件如下图所示。
比如右上方粉色的一系列可以点击的标签，技术上称为NavigationBar, 其实现位于命名空间sap.ui.ux3下的NavigationBar.js文件中。
上面介绍的这些区域是用什么工具开发的？我们知道SAP UI5最常用的两种视图是XML视图和JavaScript视图。然而大部分的C4C UI并没有使用这两种视图来实现，而是使用一种通过UI Designer开发而成的视图来实现，这种视图的源代码以XML格式存储在ABAP后台的Netweaver服务器上。运行时视图内容通过HTTP请求发送给前端，通过下面即将介绍的renderer渲染，生成HTML源代码。
下图红色区域即Opportunity的明细页面在UI模板上显示的位置，及该明细页面的技术名称：
/BYD_COD/SalesOnDemand/Opportunity/UI/COD_Opportunity_TI.TI.uicomponent
通过技术名称里包含的路径即可在UI Designer里打开该UI模型。
下面是C4C UI渲染的一些技术细节和源代码剖析。
我们在UI Designer里面画出视图界面之后，C4C前端框架会根据我们画的视图页面在浏览器里将原生的HTML源代码渲染出来，那么这个渲染流程是怎样的呢？带着这样的疑问，我做了一些调查。
下面就以Account这个工作中心视图页面为例来看。
首先，我们知道在UI Designer里面画好了页面后，会生成对应的XML文件存储在ABAP后台。同时，我们在UI Designer里面也可以看到生成的XML文件：
我们可以看到上图红色区域标注的标签EmbeddedComponents，里面的targetComponentID指向一个Object Work List(OWL)。这个OWL也就是我们在Account工作视图上看到的OWL, 如下图。
那么在运行时这些XML文件是如何被渲染出来的呢?
运行时有一个JavaScript对象来打开窗口，该对象的实现位于文件MWindowManager.js。我们在这里打断点可以看出_open方法触发了整个页面的渲染。当我们点击Account工作中心视图的时候，会把视图所在路径传入此方法。
进入后续的处理逻辑，这里会根据resource path（也就是之前提到的视图所在地址）去向后台发送一个请求，取回一个JSON model，然后执行回调函数。
接下来我们去看回调里面做了什么。
观察从后台返回的HTTP响应，发现是一个JSON模型，包含了这个页面具体的组件信息。这里就可以跟前面我们看到的XML对应上了。接着程序会去取这些组件的render manager，并执行render（渲染）操作。
我的同事，SAP成都研究院小李探花周帅，在他的文章浅谈Fiori Design Guidelines里曾经提到，C4C有三套UI，Silverlight，HTML5和RUI。其中HTML5和RUI都基于SAP UI5。那么什么时候去渲染HTML5的控件，什么时候又去渲染RUI的控件呢？实际上每一个UI控件都有其对应的renderer，那具体是哪一个render来负责生成HTML5源代码，就是由下面getRendererName里面的逻辑来取出对应的renderer。
比如下图是正在渲染RUI端的Tool Bar:
比如下图所示正在渲染HTML5页面上的红框区域：
然而并不是所有的C4C UI都是通过UI Designer开发而成。C4C仍然存在部分UI5传统的XML视图。
以Visit工作中心为示例，选择某个survey打开:
打开的Survey明细页面却是通过UI5 XML视图实现的：
那么问题来了，UI Designer开发的视图里包含的超链接，如何能够指向一个UI5 XML视图？
首先找到这个超链接点击的OnClick处理函数OnSurveyPreview：
OnSurveyPreview的处理有三个分支，这不难理解。因为前面说过C4C有三套UI，SilverLight，HTML5和RUI。尽管这三套UI共享同一个UI Designer的开发视图，然而点击超链接后的跳转逻辑略微有差异，因此在OnClick处理函数OnSurveyPreview里分三个分支处理。下图中间红色区域的分支代码在RUI里点击超链接的跳转实现。
点击上图中间的红色分支，发现RUI的超链接点击跳转实现的函数为：OnOpenResponsiveSurvey
该函数最后会打开一个CustomControl：
这个CustomControl的路径，即对应JavaScript的实现，维护在UI Designer里：
在运行时，该Custom Control的JavaScript实现会使用JavaScript代码创建XML视图实例，如下图第127行，XML视图的构造函数被调用，
这就是为什么点了超链接之后，从Chrome开发者工具里能看到main.view.xml文件的加载：
希望大家看了这篇文章后，对于SAP C4C使用UI5的独特之处能有个最基本的了解。感谢阅读。
更多阅读
要获取更多Jerry的原创技术文章，请关注公众号"汪子熙"或者扫描下面二维码: