如何使用代码获得 CRM 系统一个 Attachment 实例的 url

在实际项目中，我们经常需要通过 Webclient UI 组件中的代码获取一个附件的完整 url。
假设我们需要获取下图第一个名为“jerry text”的附件的完整 url：

我们可以使用下面的代码来完成这项工作：

    DATA: lv_host TYPE string.
    DATA(lo_runtime) = cl_bsp_runtime=>get_runtime_instance( ).
    DATA(lo_url) = NEW cl_url( server = lo_runtime->server ).
    " now the <hostname>:<port number> is stored in lv_host
    lo_url->host( CHANGING url = lv_host ).
    the class and logical object id could be got via the code.
    DATA(ls_object) = VALUE SDOKOBJECT( class = 'BDS_POC22' objid = '00163EA720041EE39FCBA3AE92BAC92D' ).
    DATA(lv_att_url) = cl_sdc_bsp_utilities=>phio_get_url_for_get( request = lo_runtime->server->request object_id = ls_object ).
  
    lv_att_url = lv_host && lv_att_url.

the full url looks like below and could directly be entered in IE to view the attachment content.

解释一下这段代码的作用。

此代码段主要用于在 系统中构建一个 URL，通常用于网络服务或与浏览器相关的操作。具体来说，代码执行了以下几个步骤：

1. 声明变量：

   • lv_host：用于存储主机名和端口号。
   • lo_runtime：代表当前 BSP 运行时实例。
   • lo_url：用于处理 URL 相关操作的对象。
   • ls_object：存储文档对象的信息。
   • lv_att_url：用于存储最终构建的 URL。

2. 获取运行时实例：

   • 通过 cl_bsp_runtime=>get_runtime_instance() 获取当前 BSP 应用的运行时实例。

3. 创建 URL 对象：

   • 使用 cl_url 类创建一个新的 URL 对象，设置服务器信息。

4. 获取主机信息：

   • 通过 lo_url->host( CHANGING url = lv_host ) 方法获取主机名和端口号，并存储在 lv_host 变量中。

5. 设置文档对象信息：

   • 通过 SDOKOBJECT 结构设置文档的类别和对象 ID。

6. 获取附件 URL：

   • 使用 cl_sdc_bsp_utilities=>phio_get_url_for_get 方法构建用于获取文档的 URL。

7. 拼接最终 URL：

   • 将 lv_host 和 lv_att_url 拼接，构成最终的完整 URL。

详细解释

URL 构建过程的重要性

在 系统中，特别是在与网络应用和服务交互时，正确构建 URL 是至关重要的。它允许系统内部的不同组件和外部世界进行交互。在这个特定的例子中，我们可以看到 URL 是如何一步步构建的，从获取服务器信息到构建用于访问特定文档的 URL。

cl_bsp_runtime 和 cl_url 的作用

cl_bsp_runtime 类提供了对当前 BSP 应用的运行时环境的访问。这在构建 URL 时非常有用，因为不同的运行时环境可能会有不同的服务器设置和配置。cl_url 类则专门用于处理与 URL 相关的操作，如解析和构建 URL。

处理文档对象

此代码中的 SDOKOBJECT 结构和 cl_sdc_bsp_utilities=>phio_get_url_for_get 方法表明，此操作涉及到处理存储在 文档管理系统中的特定文档。这可能是获取文档附件的 URL，以便用户可以通过浏览器下载或查看这些附件。

实际应用场景

想象一个场景，其中一个用户需要从 系统中的文档管理系统下载一个附件。系统需要构建一个指向该附件的 URL，用户可以通过这个 URL 访问和下载附件。此代码正是实现这一功能的关键部分。它首先确定运行该应用的服务器信息，然后获取指向特定文档附件的 URL，并将这些信息组合成一个完整的 URL。

代码的通用性和重要性

这段代码示例展示了 ABAP 编程在处理与互联网相关的任务时的灵活性和强大功能。虽然这只是一个简单的 URL 构建过程，但它揭示了 系统与外界交互的一种方式，特别是在处理网络服务和文档管理方面。