定义应用程序的离线设置

定义所选应用程序的离线设置。离线支持使客户端应用程序无需连接就可以访问后端数据。 离线时，应用程序访问客户端离线存储中的数据。SAP Mobile Services 在后端和客户端离线存储之间移动数据。

目标设置确定 SAP Mobile Services 如何在客户端上创建初始离线存储，以及如何处理来自后端的更新请求。导入开发人员所准备的配置 (.ini) 文件，以定义应用程序的离线后端连接设置。要更新离线配置，您可以 (1) 选择编辑按钮编辑离线配置并在运行时保存，或 (2) 移除当前配置，更新配置文件，然后再次导入。在进行任何更改之前，请务必与应用程序开发人员协商，因为更改会对移动应用程序产生重大影响。

请参阅本机 OData 应用开发和 SAP Business Technology Platform SDK 文档中的以下部分：

• iOS 应用程序
• Android 应用程序
• Windows 应用程序
• 开发离线应用程序

SAP Mobile Services 离线支持后端 OData 服务（仅限版本 4）生成默认值时跳过或缺少的键值属性，包括对象条目和包含部分主键的引用约束定义。对于未由外键引用的主键，使用服务器端默认值。这使得 SAP Mobile Services 能够离线处理云应用程序编程 (CAP) 草稿实体。有关详细信息，请参阅了解键值。

要定义设置：

1. 在 SAP 移动服务主控室 中，选择移动应用程序 > 本机/MDK。

2. 选择应用程序，导航到设置标签，然后从扩展组件功能部分中选择离线访问（或先进行添加）。

3. 选择配置，查看已配置的目标列表。

4. 要导入离线配置，选择 图标，浏览并选择配置文件。

   注释

   只能导入 .ini 文件。导入设置时，离线配置的状态会更改为“已配置”。

   有关应用程序配置文件的信息，请参阅：

   • SAP Mobile Platform SDK应用 – 通过定义请求定义应用程序配置文件
   • SAP BTP SDK for iOS 应用 – 通过定义查询定义应用程序配置文件
   • SAP BTP SDK for Android 应用 – 通过定义查询定义应用程序配置文件

5. 触发初始下载和取消初始下载 - 应用程序级别。
   触发初始下载：这将触发所有注册设备从离线服务完整下载应用数据。重新下载期间会保留所有本地更改。
   要开始下载，请选择 触发初始下载。在警告弹出窗口中，选择触发初始下载。
   
   取消初始下载：此操作将停止所有注册设备从离线服务完整下载应用数据。
   要取消下载，请选择 取消初始下载。在警告弹出窗口中，选择取消初始下载。

   注释

   要在注册级别启动初始下载，请参阅管理应用用户和设备注册。

6. 选择离线策略标签，为应用程序设置传入请求限流阈值和离线存储上传策略。

   1. 在限流策略下，选择启用限流以设置限流策略。启用策略后，您可以控制应用程序的活动级别。一旦达到阈值，就设置限流活动的阈值。

      对于传入请求限流阈值，配置请求限流阈值，范围是 1 到 200 个请求。默认值为每秒 200 个请求。当离线服务达到阈值时，不会再处理其他请求。

   2. 在离线存储上传策略下，选择启用离线存储上传以设置离线存储上传策略。启用策略后，设备用户可以将本地离线存储文件上传至服务器，以供开发人员根据上传策略设置进行分析或故障排除。指定策略属性。

      离线存储上传策略属性

      属性	默认值	描述
      在此之后删除离线存储	7 天	离线存储文件自动删除之前经过的时间。此安全功能可以保护设备用户，但是应确保开发人员有足够的时间来执行故障排除或分析。最大值为 30 天。对于大于 30 的历史配置值，该值将自动更改为 30。
      最大离线存储大小	32 MB	离线存储文件允许的最大大小。

7. 选择离线存储标签，查看已上传的离线存储。

   您将看到离线设置中可用的现有离线存储的列表。还可以查看唯一标识、设备标识、创建人、文件大小、创建日期以及可为每个离线存储执行的操作。您无法修改这些值，但它们可用于查找和排序离线存储。

   离线存储

   属性	描述
   唯一标识	离线存储的唯一标识符。
   设备标识	与离线存储相关联的设备标识符。
   名称	离线存储名称。
   注释	有关离线存储的文本注释，最多 120 个字符。
   创建人	离线存储的创建人。
   文件大小 (KB)	当前离线文件大小 (KB)。
   创建日期 (UTC+0800)	UTC 格式的离线存储创建日期。
   操作	可执行的操作，例如删除离线存储。

8. 要下载现有离线存储，请单击 图标。

9. 要删除现有离线存储，请选中相应的复选框并单击 图标。

10. 选择保存。

11. 选择信息来查看功能详细信息，例如有用的 URL。

编辑应用程序配置文件

使用离线编辑器对应用程序配置文件进行更新。您可以查看所选离线应用程序的基本端点属性，并使用 SAP 移动服务主控室在应用程序配置文件中设置一些自定义参数。

自定义参数的一个示例是，使用步骤 5 中所述的 disable_fetch_csrf_token_request 属性为开发和测试环境禁用 CSRF。使用 Y 创建键值对以禁用 CSRF 令牌保护。出于安全原因，生产系统中不支持此功能，但在质量保证、开发或测试系统中很有用。

自定义参数的另一个示例是，使用步骤 5 中所述的 before_function 和 after_function 属性在端点级别定义请求之前和之后输入。离线服务基于此配置将单独的请求发送到后端服务器。您可以通过在目标 URL 中实施 '{syncType}' 参数来进一步定制，以指定初始同步和增量同步的不同操作。

1. 在 SAP 移动服务主控室 中，选择移动应用程序 > 本机/MDK。

2. 选择应用程序，导航到设置标签，然后从扩展组件功能部分中选择离线访问（或先进行添加）。

   在配置标签上，将列出所有离线数据存储目标。

   目标属性

   属性	描述
   目标	离线客户端端点目标，例如 com.<domain>edm.sampleservice.v2。
   状态	目标的当前状态，例如“无自定义设置”或“已配置”。
   操作	要执行的操作，例如创建、编辑或删除。

3. 选择 图标。

4. 指定端点属性并单击下一步。

   端点属性

   属性	描述
   目标名称	（仅显示）无法修改目标名称。
   Prepopulates 离线数据	是否提前在客户端上填充离线数据。选择是、否或仅共享。如果选择“否”，则在分析图表中，平均初始下载时间将小于平均刷新下载时间。
   数据刷新间隔	在线时客户端上数据的刷新频率（以分钟为单位）。
   服务文档格式	用于 OData 后端服务器的可接受服务文档格式。您可以以字符串形式输入定制值，例如 application/name，也可以选择 application/atomsvc+xml、application/xml 或 application/json。
   OData 通信格式	使用的格式，例如 application/json;q=1,application/atom+xml;q=0.5。
   增量通信格式	OData 通信格式的子集，例如 application/atom+xml。
   数据库归类	数据库归类的字符集，例如 UTF8BIN。
   数据库区分大小写	数据库大小写是否重要；选择启用区分大小写。
   JSON 日期时间偏移	日期时间偏移格式，如 UTC 或按偏移部分定义。
   本地数据过期	本地数据过期之前保留的时间，以小时为单位。
   允许忽略最大长度	是否限制条目的最大长度；选择不限制最大长度。如果您正在使用“检查 OData 目标质量”功能，请考虑启用此属性。有关信息，请参阅测试 OData 目标质量。
   内容标识标头位置	内容标识符标头，例如 MIME 或操作。
   最大增量Resends数量	可发送更改的最大次数，例如 5。
   批处理所有定义请求	在线时是否批处理所有请求。
   增量跟踪	是否使用 移动服务 发送增量响应至客户端，即使后端无法支持增量查询。增量跟踪可以帮助减少同步期间的数据传输量；在后续同步中，移动服务 仅发送添加/更新/删除的数据至客户端，而不是发送所有数据跟踪变更。选项包括自动、始终或从不。有关设置详细信息，请参阅下面的增量跟踪属性详细信息表。
   下载线程	使您能够使用多个线程下载离线数据。这可以加快大型数据集的下载。设置在 1-3 之间。如果该值大于 1，则启用多线程上传。如果不使用多个线程，则留空或设置为 0。有关信息，请参阅配置离线多线程同步。
   元数据变更时完全下载	指定如果元数据发生更改，是否将完整的 OData 离线模式同步下载到设备。缺省情况下，该参数处于启用状态，这意味着如果从设备同步，则会下载完整数据库。移除复选标记可禁用此功能，这意味着如果从设备同步，则只会将更改下载到设备。
   离线服务中的 URL 重写	指定是否为选定的离线应用程序启用 URL 重写。您的选择设置了 no_url_rewrite 属性。如果您选中该复选框（将属性设置为 true），则启用离线 URL 重写（默认）。如果未选中该复选框（将属性设置为 false），则禁用离线 URL 重写，并且连接性代理服务处理 URL 重写（如果已配置）。请注意，如果您在离线服务中启用 URL 重写，您还必须为连接性目标配置以下设置：(1) 将“重写模式”属性设置为“重写 URL”，以及 (2) 确保“相对重写路径”属性为空。请参阅创建目标了解关于这些属性的信息。

   增量跟踪属性详细信息

   设置	描述
   自动（默认）	指示 移动服务 应自动确定是否使用由 移动服务 提供的中间件增量跟踪，或者在以下情况下是否使用后端增量跟踪：(1) 后端服务器支持增量查询，移动服务 使用后端增量查询并且未启用中间件增量跟踪；(2) 后端服务器不支持增量查询，移动服务 启用中间件增量跟踪以支持使用 移动服务 进行增量跟踪。
   始终	指示 移动服务 应启用中间件增量跟踪，即使后端服务器支持增量查询。大多数场景不建议使用此选项。仅当后端服务器的增量查询不是非常可靠时才应使用。例如，即使收到仅跟踪变更的增量查询，后端服务器仍然返回整个数据集。
   从不	指示 移动服务 不应启用中间件增量跟踪。服务器支持增量查询时，禁用中间件增量跟踪可以帮助减少内存使用和数据库操作，并帮助改善同步性能。后端服务器不支持增量查询时不建议使用此选项。

5. 在端点定制属性中，单击 添加专用参数，然后单击下一步。

   查看键值对列表，并为参数创建或编辑键值对。

   端点定制属性

   属性	描述
   键	键，例如 disable_fetch_csrf_token_request。从列表中选择一个键或直接输入一个有效键。键按类型分类，例如字符串、整数、整数数组和布尔值。选择键后，选择帮助按钮以获取详细信息，例如 Enter Y or N to disable or enable fetching CSRF tokn for requests; if not set the default is N.
   值	键值，例如 Y。该字段提供有关预期值的提示。
   操作	要执行的操作，例如创建或删除。

   端点定制属性描述

   值	描述	类型
   before_function	输入 before_function 以在端点级别定义请求；离线服务基于此配置将单独的请求发送到后端服务器。示例格式：GetProductsByRating?rating=3 您可以选择将 '{syncType}' 作为占位符添加到目标 URL： 示例格式：before_function = OpenSyncSession?SAPProductTechName='SAP_SERVICE_ASSET_MANAGER'& SyncType='{syncType}'	字符串
   after_function	输入 after_function 以在端点级别定义请求；离线服务基于此配置将单独的请求发送到后端服务器。示例格式：GetProductsByRating?rating=4 您可以选择将 '{syncType}' 作为占位符添加到目标 URL： 示例格式：after_function = CloseSyncSession?SAPProductTechName='SAP_SERVICE_ASSET_MANAGER'& SyncType='{syncType}'	字符串
   offline_db_creation_parameters	指定客户端数据库创建选项的列表，以分号分隔。示例格式：precision=100;scale=10	字符串
   media_link_prefix	输入用于媒体链接的前缀 。示例格式：test2	字符串
   repeatable_requests_lifetime	控制可重复请求响应的保留时间（以分钟为单位）。默认值为 72000（50 天）。示例格式：36000	整数
   max_length_facet_default	指定在 OData 元数据中未提供时应由系统分配的默认 MaxLength 值（以字节为单位）。如果未指定，默认值为 1536。示例格式：2048	整数
   max_retry_times	输入介于 0 到 10 之间的整值，以建立当无法访问后端服务器时 SAP Mobile Services 应尝试连接到后端服务器的最大次数。例如，输入 5 表示重试五次。范围是 0-10，但建议使用中间范围值。示例格式：5	整数
   repeatable_exclude_status	指定不应检查可重复请求的状态代码列表。示例格式：401, 403	整数数组
   check_repeatable_requests	输入 Y、N 或 SUPPLEMENT 以启用、禁用或按条件检查可重复请求；如果未设置，则默认值为 N。设置为 Y 则启用可重复请求检查，SAP Mobile Services 不会将重复请求标头发送到后端服务器。设置为 SUPPLEMENT 时，SAP Mobile Services 将减少向后端发送重复请求的可能性；同时必须将 send_standard_repeatability 或 send_original_repeatability 之一设置为 Y，然后使用 send_standard_repeatability 或 send_original_repeatability 功能减少向后端发送重复请求的可能性。 在将 check_repeatable_requests 属性与 send_standard_repeatability 或 send_original_repeatability 属性一起使用时，请记住这些交互： 当启用 check_repeatable_requests 属性时，send_original_repeatability 和 send_standard_repeatability 属性均无效，应将其禁用。 当禁用 check_repeatable_requests 属性时，只能启用 send_original_repeatability 和 send_standard_repeatability 属性之一，并使用适用的规范。 当 check_repeatable_requests 属性为 SUPPLEMENT 时，send_original_repeatability 和 send_standard_repeatability 属性只能启用其中一个，不允许同时启用或都不启用。	布尔
   download_in_order	指示定义查询是否应按照它们在配置文件中定义的顺序下载。如果未设置，则默认值为 N。	布尔
   disable_fetch_csrf_token_request	输入 Y 或 N 以禁用或启用为请求获取 CSRF 令牌；如果未设置，则默认值为 N。	布尔
   force_medialink_absolute_url	输入 Y 或 N 以启用或禁用强制 medialink 绝对 URL；如果未设置，则默认值为 Y。	布尔
   skip_nullablerelationship_check	输入 Y 或 N 以启用或禁用跳过可为空的关系检查；如果未设置，则默认值为 Y。	布尔
   allow_defining_query_removal	输入 Y 或 N 以启用或禁用定义查询移除；如果未设置，则默认值为 N。	布尔
   generate_impicit_entity_id_in_response	输入 Y 或 N 以启用或禁用在响应中生成隐式实体标识；如果未设置，则默认值为 N。	布尔
   v4_use_post_http_method_for_patch v2_use_post_http_method_for_patch	这些选项控制服务器用于与 OData 后端交互以重播 "PATCH" 操作的 HTTP 方法。该机制类似于 OData 操作（OData 版本 2.0）中描述的机制，请参阅第 3.2 部分，通过 POST 方法进行方法隧道传输。 当该选项设置为 true 时，服务器会发送带有标头 "X-HTTP-Method: MERGE" 的 POST 请求。否则，服务器将直接发送 "PATCH"。如何设置这些选项取决于 OData 后端是否支持 PATCH 方法。如果未设置，则使用默认值。 输入 Y 或 N 以启用或禁用 OData 的 POST 隧道方法。如果未设置，则默认值为 N。	布尔
   disable_normalize_time	使 SAP Mobile Services 能够保留从后端服务器发送的 EDM.Time 类型属性的原始值，而不是对其进行标准化。输入 Y 或 N（默认值）。当设置为 N 时，SAP Mobile Services 会对值进行标准化。例如，EDM.Time 类型属性的值为 PT01D08M20S，SAP Mobile Services 将其标准化为 PT1D8M20S 并将其另存为 varchar 类型，因此它会影响列排序。设置为 Y 时，SAP Mobile Services 会保留来自后端服务器的原始值，而不进行标准化。	布尔
   add_csrf_token_header_for_get_request	支持您将 X-CSRF-Token 标头添加到 GET 请求。其值可为 Y 或 N（默认值为 N）。设置为 Y 时，SAP Mobile Services 将 X-CSRF-Token 标头添加到发送至后端服务器的 GET 请求；如果设置为 N，不会向 GET 请求添加任何 X-CSRF-Token 标头。	布尔
   early_populate_backend_generated_values	指示是否可以在上传期间从后端服务器填充缺失值（如果可用）。目前，此功能仅支持实体创建，不支持实体修补或更新。默认值为 N。	布尔
   log_request_headers_when_bad_request	指示是否记录请求标头。默认值为 N。设置为 Y 时， SAP Mobile Services 在遇到错误请求时将记录请求标头。如果未设置，则默认值为 N。	布尔
   wait_shared_cache_updated	输入 Y 以指示同步共享定义查询时，SAP Mobile Services 发现正在更新定义查询缓存，当前同步等待缓存更新，以便下载最新数据。如果未设置，则默认值为 N。	布尔
   not_populate_refconstraint	禁用向客户端发送引用约束数据。当设置为 Y 时，SAP Mobile Services 在初始下载期间不会使用引用约束数据填充客户端。好处是数据库大小减小，初始下载性能提高，但客户端上的查询处理可能需要更长的时间。如果未设置，则默认为 N。您还可以将设置从 Y 更改为 N 以暂时暂停此行为。	布尔
   ignore_stream_request_4xx_error	暂时忽略一些 4xx 错误。根据设计，当客户端将 definingQuery 设置为 automaticallyRetrievesStreams=true 并且后端服务器为某些流返回 4xx 代码时，客户端和后端服务器之间的同步将终止。当设置为 Y 时，SAP Mobile Services 忽略这些 4xx 错误并让同步继续，加载其他流而不是中断同步。当后端媒体实体不稳定并且初始下载后设备上不立即需要媒体内容时，该选项非常有用。一个限制是，忽略的媒体内容不会再次下载，直到其实体更新（某些属性更改或其 etag 更改）。如果未设置，则默认为 N。您还可以将设置从 Y 更改为 N 以暂时暂停此行为。	布尔
   send_original_repeatability	设置后，客户端将根据原始 (2013) 规范发送可重复的请求。设置为 "Y"（缺省）表示应使用 2013 规范发送可重复请求。设置为 "N" 表示不使用 2013 标准。 当启用 check_repeatable_requests 属性时，send_original_repeatability 和 send_standard_repeatability 属性均无效，应将其禁用。 当禁用 check_repeatable_requests 属性时，send_original_repeatability 和 send_standard_repeatability 属性均可以启用，并使用适用的规范。	布尔
   send_standard_repeatability	设置后，客户端将根据标准 (2020) 规范发送可重复的请求。设置为 "Y" 表示应使用 2020 规范发送可重复请求。设置为 "N"（标准）表示不使用 2020 标准。 当启用 check_repeatable_requests 属性时，send_original_repeatability 和 send_standard_repeatability 属性均无效，应将其禁用。 当禁用 check_repeatable_requests 属性时，send_original_repeatability 和 send_standard_repeatability 属性均可以启用，并使用适用的规范。	布尔
   v4_use_patch_http_method_in_batch	此选项控制服务器用来与 OData 后端（仅 OData 版本 4.0）交互以在批处理请求中重放 'PATCH' 操作的 HTTP 方法。如果设置为 'Y'，移动服务将发送 'PATCH'；否则将发送 'MERGE'。如果未设置，则默认值为 'Y'。	布尔
   fetch_and_map_entities_for_deep_insert_to_the_many_end	设置为 'Y' 时，如果 OData 后端在涉及深度插入多端的 POST 请求中未返回预期子实体，服务器将尝试获取子实体并将它们映射到其本地实体。如果服务器无法获取或映射子实体，则不会进行映射。如果未设置此选项，则默认值为 'N'，表示后端必须在 POST 请求中返回预期子实体，且子实体的顺序必须与请求匹配。 注释：如果将此选项设置为 'Y'，且服务器无法获取或映射实体，则会忽略映射。这可能导致取决于未映射子实体标识的后续请求失败，因为后端将不会识别本地实体标识。此外，客户端必须在同一请求中下载父实体和子实体，因为子实体将缺少正确的标识映射并依赖最外层的父实体。	布尔
   cache_backend_cookies	当设置为“Y”时，OData 后端 cookie 可以在 SAP Mobile Services 中重用 ，以便从同一客户端执行后续操作（上传和下载）。这种重用有助于减少在 OData 后端生成和维护的 cookie 的数量。 如果未设置任何值，则默认值为“N”，这意味着 SAP Mobile Services 不会缓存（重用）后端 cookie。这会导致 SAP Mobile Services 将始终为客户端请求新的安全会话。达到最大并发安全会话数后，后端系统将开始拒绝新请求并返回 403 错误。这非常具有挑战性，因为这不仅限于我们的移动应用，还会影响通过 SAP SAP Gateway 子系统接入的所有应用程序，包括数百个 fiori 应用程序。 如果缓存的 cookie 中存在到期属性，则达到到期时间时，SAP Mobile Services 将不会重用该 cookie。同时，SAP Mobile Services 在 1 小时后不会重用 Cookie。相反，会放弃它们。	布尔
   v4_use_patch_http_method_in_batch	此选项控制服务器在与 OData 后端交互以在批处理请求中执行更新操作时所使用的 HTTP方法。如果此选项设置为“N”，则服务器会针对批处理请求中的更新操作发送 MERGE 请求。如果不是，服务器将发送 PATCH 请求。默认值为“Y”。	布尔
   fetch_and_map_entities_for_deep_insert_to_the_many_end	如果对于深度插入到多端的请求，后端系统未按照预期返回子实体作为响应，请输入“Y”或“N”以启用或禁用获取和映射实体。如果未设置，则默认值为“N”。	布尔

6. 在客户端索引中，单击 添加客户端索引参数，然后单击下一步。

   索引参数是用于离线存储的客户端数据库。这使您能够为客户端数据库实体配置特定操作，例如按升序或降序对数据进行排序。

   客户端索引属性

   属性	描述
   实体类型名称	以 <namespace>.<EntityTypeName1> 格式输入客户端数据 EntityTypeName。例如，Sample.Customer。
   属性	输入一个或多个属性名称，为其创建 EntityTypeName 索引，格式为 Property1A[ASC|DESC][, Property1B[ASC|DESC][, ...]。如果没有输入，缺省是升序。例如，FirstName, Nick。
   操作	对索引参数行采取的操作，例如“删除”。

7. 在定义请求中，单击 添加定义请求参数，然后单击下一步。

   请求属性

   属性	描述
   名称	定义请求名称。
   刷新间隔（分钟）	共享数据下载之间的间隔时间（以分钟为单位）。
   增量跟踪	是否使用 移动服务 发送增量响应至客户端，即使后端无法支持增量查询。如步骤 4 中增量跟踪属性详细信息表的增量跟踪所述，您可以指定自动、始终或从不。请注意，如果您在步骤 4 中为端点属性指定了增量跟踪值，则该值将自动用于定义请求中的增量跟踪。您可以将此项留空以使用相同的值；或者可以为定义请求指定不同的值。
   令牌生命周期（分钟）	OData 增量令牌过期之前的时间（以分钟为单位）。该值控制最旧更改日志数据的保留时长。 有效时，仅将更改的数据下载到离线存储。增量令牌过期时，会替换整个数据集。默认值为 21600 分钟（约 15 天）。建议使用此值，以实现最佳数据库使用情况和移动服务性能。
   OData 通信格式	指定在定义查询级别用于 OData 有效负载非增量请求的格式。例如，一些后端（如 Gateway）要求您使用 XML 而不是 JSON。通过此属性，您可以使用 JSON 内容类型配置有效的定义查询。您可以选择以下预定义的查询选项之一：application/atom+xml 或 application/json。也可以自行写入。如果自行写入，请务必设置值，否则该值将会留空。如果未提供任何配置，则会使用目标级别配置。
   增量通信格式	指定在定义查询级别用于 OData 有效负载增量请求的格式。例如，一些后端（如 Gateway）要求您使用 XML 而不是 JSON。通过此属性，您可以使用 JSON 内容类型配置有效的定义查询，即使您正在使用没有增量支持的 Gateway 后端。您还可以使用 XML 配置具有增量支持的 Gateway 后端。您可以选择以下预定义的查询选项之一：application/atom+xml 或 application/json。也可以自行写入。如果自行写入，请务必设置值，否则该值将会留空。如果未提供任何配置，则会使用目标级别配置。
   共享数据	是否在不同客户端或用户之间共享数据。
   下载顺序	如果您在步骤 4 中启用了多线程下载，则可以为每个定义请求分配一个编号，以指示每个请求应被处理的顺序。较低的数字在较高的数字之前处理。例如，如果将 66 分配给一个请求，将 777 分配给另一个请求，则 66 将在 777 之前处理。有关信息，请参阅配置离线多线程同步。
   操作	要执行的操作，例如删除。

8. 在定义请求组中，单击 添加定义请求组参数，然后单击完成。

   请求组属性

   属性	描述
   请求名称	选择一个或多个定义请求。
   操作	要执行的操作，例如删除。

配置离线多线程同步

您可以在 SAP 移动服务主控室 中配置多个后端线程以进行离线同步。这使您可以更好地控制同步，从而获得更好的同步性能，尤其是对于大型数据集。应用程序必须在导入的离线配置文件 (.ini) 中支持多线程同步，并且必须为租户及其客户启用该功能。

上传离线配置文件 (.ini) 后，将应用程序配置为使用多个线程下载离线数据。首先，为应用程序启用“下载线程”，然后为每个定义请求分配“下载顺序”值。下载请求分阶段处理，从最低值到最高值。例如，值 66 在 777 之前处理。每个阶段必须在下一阶段开始之前完成。

请注意，同一下载阶段的请求并行下载，不保证阶段内请求的下载顺序。例如，下载阶段 66 中的请求都并行处理。如果下载顺序很重要，请为其指定不同的下载阶段。

1. 在 SAP 移动服务主控室 中，选择移动应用程序 > 本机/MDK。

2. 选择应用程序，导航到设置标签，然后从扩展组件功能部分中选择离线访问（或先进行添加）。

3. 在配置标签上，使用编辑应用程序配置文件中的信息为条目创建或编辑离线配置。

   在离线配置向导的端点信息页面中，在下载线程中创建条目以启用多线程同步。您可以为下载线程输入 1、2 或 3。如果该值大于 1，则启用多线程下载。如果将该字段留空或输入 1，则不会启用多线程同步。选择下一步以继续。

4. 在定义请求中，为每个定义请求在下载顺序中输入条目，以指示应处理请求的顺序。较低的数字在较高的数字之前处理。例如，如果将 66 分配给一个请求，将 777 分配给另一个请求，则 66 将在 777 之前处理。选择下一步以继续。

5. 完成这些条目后，选择完成以保存。离线配置已更新。将按照您指定的顺序处理下一个离线同步。

定义网络同步

定义在各种渠道中同步应用程序组件的策略，包括 WiFi、移动网络和漫游。在同步大量数据上传时，开发人员必须为用户在客户端应用上提供用户界面以进行配置。此功能仅适用于使用SAP BTP SDK for iOS 和SAP BTP SDK for Android 创建的应用。

此功能使管理员可通过主控室控制每个应用的同步行为，方法是指示具有大量数据的 SDK 组件何时可以进行同步。合格组件包括：

• 分析
• 客户端资源
• 日志
• 离线 OData

要定义网络同步策略：

1. 在 SAP 移动服务主控室 中，选择移动应用程序 > 本机/MDK。

2. 选择应用程序，导航到设置标签，然后选择客户端设置。

3. 在客户端配置标签上的网络同步策略部分下，选择启用网络策略。

4. 对于列表中的每个组件，选择每个要用于同步数据的网络渠道。

   网络同步策略

   策略	描述
   组件	受网络同步策略（如分析、客户端资源、日志和离线 OData）影响的组件。
   WiFi	指示是否应通过 WiFi 自动同步。
   移动网络	指示是否应通过移动网络自动同步。网络提供商可能需要收费。
   漫游	（仅限 Android）指示是否应在漫游时自动同步。网络提供商可能需要收费。

5. 选择保存。

启用共享设备

（仅适用于本机 SDK）对于员工共享设备的环境，您可以启用上传来自先前用户的待定更改。如果员工忘记或无法上传工作，这将非常有用。

必须已在 SAP Business Technology Platform 主控室建立默认和自定义信任配置。

有关建立信任的详细信息，请参阅配置安全信任和通过 UAA 使用任意 SAML 身份提供者建立信任和联合。

此功能用于共享设备的环境，例如当员工在多个班次共享工作设备时。上传可以在后端执行，下一名员工可以在第二天继续工作。此功能可确保安全性，因此用户仅接收自己的消息，而不会接收发给先前用户的消息。必须为应用程序启用该功能。

1. 在 SAP 移动服务主控室 中，选择移动应用程序 > 本机/MDK。

2. 选择应用程序，导航到设置标签，然后选择客户端设置。

3. 在客户端配置标签上的共享设备部分下，选择允许上传来自先前用户的待定更改。启用此功能后，还可以通过二维码为客户端启用多用户模式。

4. 选择保存。

---

最后更新: November 4, 2025