SAP CRM 复用视图
在设计任何视图或组件的时候,我们需要以可复用的方式来设计它。UI组件设计的主要目标即可复用。
例如:几乎每个事务都要处理合作伙伴(客户)。如果我们想要在Web UI显示那些合作伙伴,需要设计一个视图。我们将不会为服务合同设计一个单独的合作伙伴视图、为服务订单设计一个、为服务确认设计一个、再为机会设计一个。
相反,我们应该做的是,设计一个视图,并且在不同的事务中复用它。
为了使视图可复用,我们需要做一些步骤。
首先,我们需要把视图设计为可以从外部获取数据的形式。
第二,我们需要把视图分配给一个窗口。
第三,窗口应当暴露在运行时资源库中的接口视图(InterfaceView)部分。
第四,需要的组件控制器的上下文节点应暴露在ComponentInterface->InterfaceController->Context。
之后我们可以通过创建组件用法(Component Usages)在任意组件复用这个视图。
让我们通过一个练习例子一一地在细节上讨论所有要点。在本文的最后一节,我们将尝试复用组件BTPARTNER中的一个视图 ‘PARTNER’。
1,视图必须可以从外部获取数据
通常的外部数据(从另一个UI组件中而来的),提供给组件控制器的上下文节点。因此,应当在组件控制器的上下文节点和视图的上下文节点之间创建绑定。并不需要直接地绑定,我们只需要确保从组件控制器上下文节点到我们希望复用的视图的上下文节点的数据流。
可以看到视图PARTNER中的BTPARTNERSET上下文节点被绑定给了组件控制器的上下文节点。
2,将视图分配给窗口
视图应该被分配给一个窗口。之后,窗口会在运行时资源库中被暴露为一个组件的接口视图。
前往运行时资源库。
Partner视图被分配给了窗口。我们可以在这里添加其它窗口,并让每个窗口都有一个分配给它的视图,让每一个视图都成为可复用的单元。
3,窗口应当暴露为接口视图
前往运行时资源库->ComponentInterface。添加窗口PartnerList,使之成为一个接口视图。
4,组件控制器节点
需要的组件控制器的上下文节点应暴露在ComponentInterface->InterfaceController->Context。
上下文节点BTPARTNERSET已经暴露在这个项。将一个上下文节点暴露在这个项会使其可以被不同的UI组件的其它上下文节点所绑定。我们可以使用一个特殊的组件控制器方法WD USAGE INITIALIZ来绑定不同UI组件的上下文节点。
可以开始在我们自己的组件中复用这个视图了。接下来是在其它组件的操作。
在另一个组件中复用视图
前往组件->运行时资源库并且创建一个组件用法。点击编辑按钮,右击ComponentUsage,选择选项Add Component Usage.
在出现的对话框中,为组件用法(Component Usage)和我们希望复用的接口视图(InterfaceView)命名。
内容输入后,选择继续。现在这个接口视图会在你自己的组件中作为视图存在。
把这个视图添加给OverviewPage概览页.
保存运行时资源库。前往OverviewPage的配置标签页,添加新的视图以显示分配对象展示区(Assignment block)。
现在我们需要注意数据。在先前的操作中,我们知道组件BTPARTNER中有一个上下文节点BTPARTNERSET。因此我们将在我们自己的组件控制器中创建一个新的、相同的上下文节点。
前往组件控制器并且创建使用基本实体(base entity)BTPartnerSet创建一个上下文节点。
为基本实体命名,完成向导。
我们已经创建了上下文节点。接下来我们需要把数据交给这个上下文节点。
无法通过配置来实现,让我们用代码来做它。
如我们所知,在结果视图的事件处理器(用户点击超链接时触发),我们获取了BTAdminh实体。我们将从它获取相关的BTPARTNER SET并且将其提供给组件控制器的上下文节点。
按照下图修改事件处理器。保存并激活之。
(这只是针对以上情景进行代码修改的部分,前面的代码保留原样。)
一旦我们获取了BTAdminh的头实体,我们使用关系获取它的相关实体BTPARTBERSET。获取相关记录后我们将其添加到集合(collection)中,这个集合会被提供给组件控制器的上下文节点。
向组件控制器提供数据完成。一件更重要的事是将你的组件控制器的上下文节点和BTPARTNER组件的上下文节点绑定。像上面说过的那样,我们将使用方法WD USAGE INITIALIZE来做这件工作。
前往组件控制器并且重新定义上面提到的方法。
重定义后,双击方法打开它,写下如下代码并激活。
在不同的组件的上下文节点间分析数据的工作就这样完成了。
测试该应用,如果服务合同有任何合作伙伴,数据将显示在合作伙伴的分配对象展示区中。
本文链接:http://www.cnblogs.com/hhelibeb/p/6000833.html
原文链接:WHAT IT TAKES TO REUSE A VIEW
SAP CRM 自定义控制器与数据绑定
当用户从视图离开时,视图将失去它的数据。解决这个问题,需要引入自定义控制器(Custom Controller)(译者注:SAP CRM自定义端中,不同地方的Custom Controller会翻译为“自定义控制器”、“自定义控制器”、“海关控制器”三种结果。这当中显然存在问题。下文如提到“自定义控制器”、“海关控制器”云云,均是按SAP GUI自定义端中相应位置的汉化为准,读者可视为同一词)。
我们将相同类型的上下文节点添加给自定义控制器,并且对自定义控制器上下文节点和需要的视图的上下文节点进行数据绑定。
在我们的例子中,我们将遵循以下逻辑,来让数据在不同的视图的上下文节点之间流动。
- 在搜索事件处理器中获取数据。
- 获取自定义控制器的实例,并且把我们获得的数据交给它的上下文节点。
- 在结果视图上下文节点。
让我们首先创建自定义控制器。
前往用户界面组件控制台-组件结构浏览器。右击自定义控制器,选择“创建”选项。
为它赋一个前缀“Cuco”的名字,比如CuCoSearch. Cuco代表Custom Controller.
下一步,将上下文节点命名为result,实体名填入BTQRSrvCon,因为我们将会把这个节点和结果视图上下文节点绑定。
绑定的上下文节点,应有相同的实体。
点击继续按钮,完成向导,并且保存实体。我们已经成功地创建了自定义控制器。
下一步,我们将绑定两个节点。前往result视图,右击result上下文节点,并且选择“创建绑定”选项。
在出现的弹出框中,选择组件类型为“自定义控制器”(当然,还是Custom Controller)作为我们要将数据绑定给result视图的控制器。
选择CuCosearch填入自定义控制器项中,接着选择result上下文节点,并且点击对号。就这样,我们完成了绑定。
一旦上面的步骤完成,我们就可以在这里观察绑定:
圈出部分说明自定义控制器的结果上下文节点绑定了result视图的结果上下文节点。
下一步我们将为search事件处理器添加一小部分代码,以获取自定义控制器实例,并且把已获取的数据交给它。
前往搜索视图的search事件处理器,添加如下代码。
在第16行,我们使用了方法get_custom_controller,通过名字获取自定义控制器的实例。
我们把返回数据lr_data交给自定义控制器的上下文节点result.
测试应用,点击搜索按钮,会展现出某些服务合同。我们的搜索页现在可以工作了。
SAP CRM 显示消息/在消息中进行导航
向用户展示消息,在任何软件中都是十分重要的。
在SAP CRM WEB UI中展示消息,不是一项很难的任务,只需要创建消息并在之后调用方法来显示它
消息类和消息号:
我在SE91中创建了如下的消息类和消息号。
我们需要在合适的地方写代码以在Web UI中显示消息。这里我就在DO PREPARE OUTPUT方法放置代码了。
cl_bsp_wd_message_service用于在Web UI中显示消息。在上面的代码中,我们获取了一个消息服务的实例,接着调用它的ADD_MESSAGE方法并传入消息号id 消息号和消息类型。
消息类型指出了消息的种类:E是错误,S是成功,W是警告,I则是信息。
所有的E类型会显示为红色,所有的W类型会显示为黄色。
这是我运行应用后获取的输出结果。
长文本:
有时,我们也许想要随着错误提示展示更多的信息。在这种情况下,需要为消息类中的消息维护长文本。
在消息的长文本得到维护后,框架会自动地在消息后面显示一个名为“DETAILS”的链接条。如果用户点击,他会被得到一个带有详细信息的弹出框。
前往消息类,维护长文本。别忘记关闭弹出框的自我解释。
保存,运行应用。
可导航的消息:
在上面的部分,我们已经创建了简单的消息。有些时候,我们不得不执行某些特定的行为,来处理错误消息。
比如,点击错误消息,用户会被导航到某些其它屏幕上面,或者触发某些特定的代码。
在下面这个例子中我将展示如何在点击消息栏中的消息导航到另一个视图中。
我已经创建了两个视图,制作了一个从源视图到目标视图的导航链接,并且把两个视图都分配给了窗口。源视图为默认视图,因此在显示窗口时,源视图会首先显示。请看下面的截图:
第一步,我们需要添加一个接口“IF_BSP_WD_MESSAGE_HANDLER”在你的视图实现类里面,如果它不是可用的。
添加后,激活类。
接下来,我们需要把消息订阅到全局消息服务。我在DO PREPARE OUTPUT中写下了如下代码:
首先使用subscribe message方法来订阅消息,之后让消息在Web UI中可见。保存并激活方法。
如果你现在测试应用,可以看到消息将显示为超链接。
无论何时,当用户点击超链接,IF_BSP_WD_MESSAGE_HANDLER~HANDLE_MESSAGE会触发。我们需要在该方法中写代码。
前往视图实现类,添加如下代码。
在这个方法中,我简单地触发了导航,把导航链接的值作为参数传递给外向插件。
测试应用。
点击消息,你就可以导航到目标视图了。
本文链接:http://www.cnblogs.com/hhelibeb/p/6019699.html
原文链接:DISPLAYING MESSAGES
SAP CRM 树视图(TREE VIEW)
树视图可以用于表示数据的层次。
例如:SAP CRM中的组织结构数据可以表示为树视图。
在SAP CRM Web UI的术语当中,没有像表视图(table view)或者表单视图(form view)那种专门的树视图类型。我们可以认为树视图是表视图的一种特例。因此,没有可以用于创建树视图的向导,需要按以下特定的步骤手动改造已存在的视图。
首先,这个看起来挺难的,但是随着实践次数的增多,你会很容易理解它。在本文,我将创建一个如下模样的树视图。
如你所见,它有两级结构。第一级展示线索ID,下一级展示客户。我使用了这样一个简化过的例子。
为了学习这个教程,我们需要创建一个表视图。这里不描述创建表视图的步骤,因为在先前的文章中已经讲过了。
在本文中,我创建了一个使用了基本实体“BTQLeadDoc”的表视图。
在组件控制器中创建了一个具有相同类型的上下文节点,并在其方法DO_INIT_CONTEXT中写入代码以获取数据。
接着绑定表视图上下文节点和组件控制器上下文节点,因此表视图可以获取到数据。DO_INIT_CONTEXT中写入的代码如下。
这段代码做了什么?
我简单地获取了前10条线索记录,把它们交给上下文节点LEAD。在表视图和组件控制器上下文节点间进行了数据绑定,数据就会同样地流到表视图。
我们做好了准备,开始主要环节吧。
首先,前往表视图上下文节点实现类并且把它的父类从“CL_BSP_WD_CONTEXT_NODE_TV”改为 “CL_BSP_WD_CONTEXT_NODE_TREE”。如果有询问特定方法重定义的对话框,选择“是”。
该类提供了两个重要方法。
GET_TABLE_LINE_SAMPLE 和 REFRESH.
第一个方法将返回基于视图列的结构。
REFRESH方法通常用于生成节点第一级或者根节点。
我现在仅仅使用了两列来展示信息。因此前往GET_TABLE_LINE_SAMPLE按需要增加两列。
方法激活后,使用事务BSP_WD_CMPWB代码重新打开整个组件。现在你可以在“配置”标签看到视图配置中的两列。将这两列从可用区域移动到展示区域,修改相应的标题,保存配置。
我们将在后面使用REFRESH方法。
现在有一个重要的步骤要做,就是修改htm文件中的标签。使用chtmlb标签:configTreeto来显示树视图。前往htm页面,移除已存在的CONFIGCELLERATOR或者CONFIGTABLE标签,填入如下的标签,并激活。
标签中的“LEAD”是一个上下文节点。
nodeTextColumn属性用于选择树的根节点或者第一列的属性。这里我按照需求选择ID列。
在使用了需要的节点填充节点表属性后,我们将它传递给LEAD->NODE_TAB。指定用于折叠树的事件处理器“collapse”和用于展开树的事件处理器“expand”:OnCollapseNode 和OnExpandNode.
下一步,我们需要在SE24中创建一个有父类的类。
CL_BSP_WD_TREE_NODE_PROXY,这个类会提供一个叫作GET_CHILDREN的方法,用于创建子节点。
在激活类之前,重定义GET_CHILDREN 方法并激活。让我们回到REFRESH方法,写下如下代码并激活。
只不过是循环上下文节点中的每条记录——换言之,LEAD记录——并且使用NODE_FACTORY的方法GET_PROXY为每条记录创建节点。接着我们使用方法ADD_ROOT_NODE为树添加根节点。在该场景中,因为我获取了10条记录,因而会创建10个根节点。
传入刚刚在SE24中创建的类的名字给proxy type参数。我们已经创建好了根节点,但是还没显示它,需要手动地添加GETTER方法给代理类,以显示树中的属性。
前往代理类“ZCL_TREE_PROXY_MAIN”复制方法IF_BSP_MODEL_SETTER_GETTER~_GET_XYZ点击过滤复选框,并且将其复制到空行。这样做将会复制方法所需要的所有导入导出参数。接着修改名字为GET_ID。我们只复制GETTER方法模板,并且根据属性名对它重命名。
写下如下代码,以获取线索的ID。
第一级节点的创建和显示已经完成,下一步要关注子节点(客户节点)。为创建第二级节点,需要在代理类的get_children方法中写代码。我们将为子节点创建一个代理类。前往SE24并且按上面的方法创建一个新的类。
我们也需要展示客户。按照相同的程序添加一个GETTER方法GET_PROSPECT,写下如下代码。
需要记住的关键点是,我们在代理类中创建GETTER方法,他们不是上下文节点类的一部分。
子节点的显示完成了,但我们没有创建它。现在前往创建的第一个类“ZCL_TREE_PROXY_MAIN”,在GET CHILDREN方法中写入代码。
这些代码做了什么?
这里我们使用了一些BOL编程,来获取线索对应的客户,因此需要通过某些关系来到达目标实体BTPARTNER。我读取了线索的所有合作伙伴。
获取所有合作伙伴之后,循环每个合作伙伴,使用NODE FACTORY方法和上面创建的“ZCL_TREE_PROXY_CUSTOME”来创建子节点。
创建子节点后,设置IS_LEAF属性为TRUE,因为在该场景中,CUSTOMER是最后一级,在这之后不显示任何客户下的子节点。因此,子节点的文件夹图标的相邻处不会有任何箭头显示。
接下来在视图实现类中创建两个事件处理器,名为collapse和expand,并写下如下代码。
如名所示,在你折叠或展开节点时会触发它们。
我们需要做的最后一件事是在DO PREPARE OUTPUT方法中添加一点代码,来调用REFRESH方法。
现在,你可以运行应用,观察输出。
当你第一次看这篇教程时,看起来会有很多步骤,但实际上,它不是那么难。
如果想要将“地址”显示为“客户”的子节点,需要创建一个新的代理类,在CUSTOMER代理类的GET CHILDREN方法中通过客户和地址间的BOL关系写入代码,并且需要一个在那个代理类添加GETTER方法以显示地址。别忘记在GET_TABLE_LINE_SAMPLE中添加一个新的“地址”列。
你可以自己试试。希望本文能帮助你,也希望你能把这个站点推荐给你的同事,如果你觉得它值得的话。
本文链接:http://www.cnblogs.com/hhelibeb/p/6035059.html
原文链接:TREE VIEW
更多信息请参考:Tree view change and save
如何写一封正式的电子邮件
最近偶尔要写一些英文邮件给顾问看,发现和之前写中文邮件时的常用格式有点不一样,不过,在内容的组织上,也有很多相通之处。为了学习,现翻译一篇教程,贴在这里。
1,中立的邮件地址
你的邮件地址应当是你真实姓名的变体,而不是用户名或者昵称。尽可能使用句号、连字符、下划线来保证你的邮件地址只是你的姓名,没有多余的数字或字母。
- 永远不要使用一个不专业的邮件地址。如果你的名字是一个笑话,或者不合适的名字,没有人会认真对待你。
2,短而精确的标题
避免在标题说太多,但是要确保它在发给一个陌生人看的时候也能反映出邮件的内容。如果可能,包含一个可以让邮件内容易于记忆和/或查找的关键词,即便是在对方的收件箱有很多邮件的情况下。例如,“关于3月12日受损自动扶梯的会议”就足够明确,这个邮件主题不会误认为其它任何描述得不是很明确的事情,(比如:“3月12日的日程表/客人名单/午餐请求/会议概览”)。记住,专业人士也许每天会收到上百封的电子邮件,甚至更多,越是明确且吸引人的主题越容易和自己的个人工作联系起来。
3,合适的称呼
以姓名称呼收件人是首选方案。使用对方的称呼(Mr. Mrs. Ms. or Dr.)和姓氏,接上逗号或者冒号。作为一种选择,你可以在称呼之前写上“Dear....”(不过“Hello...”也可以接受)。通常应该使用姓氏,会比使用名字更加正式。除非你和收件人很熟。如果你不知道你的收件人的名字(你应该尽力找到)使用“Dear Sir/Madam”或者“Dear Sir or Madam”并加上冒号。
4,在第一行介绍你自己(如果需要)
介绍自己,并包括你写信的目的、找到对方邮件地址的方式,或者你写信的缘由。例如:
- My name is Earl Rivers. I'm contacting you to apply for the administrative assistant position listed on CareerXYZ.com.
- My name is Arlene Rivers. I am writing about the traffic citation I received on December 31, 2009. I obtained your Email address from the Westchester County Clerk website.
5,写实际的消息
确保你的观点不杂乱;如果很乱的话,读者可能会忽略重要的细节。尝试把消息按话题拆分为段落,使你的消息更有逻辑、易懂。
- 邮件不应长于5段,每段不应长于5句。
- 在每段之间插入分隔行;无需缩进,因为缩进有可能在邮件转换过程中丢失。
- 避免非正式的书面语。
6,使用正确的告别格式
这取决于你和收件人的亲密程度。例如:
- Yours sincerely,
- Yours cordially,
- Respectfully,
- Best,
- Your student,
7,以全名签名
如果你有一个工作称呼,写在你的名字的下一行,并且在这之后的一行写下公司名或者网站名。如果你没有工作称呼,但是有和邮件内容相关的你自己的博客或者网站,在名字下面写上链接。如果邮件和工作有关,只包含职业相关的网站/博客,不要附上兴趣爱好类型的。
8,校对邮件内容
确保你没有遗漏掉任何关键点。大声读出你的邮件,或者请其他人校对你的邮件,是换个视角审视自己写的内容的好办法。
9,校对邮件拼写和语法
如果你的邮件提供者还没有提供拼写和语法校对选项,把它粘贴到文本处理器当中,如有必要,对其进行修正,然后粘贴回你的邮件里。