使用 SDK 创建和保存诊断日志

注意： 本文适用于适用于 Salesforce 的 Genesys 云。

您可以在托管软件包中使用我们的 SDK 在 Salesforce 中生成诊断日志。该软件开发工具包使用 Salesforce Apex 编程语言。

注意： 这篇高级自定义文章面向熟悉 Salesforce 的开发人员。

必备

通过 Purecloud.sdk.logger 命名空间下的 Logger 类访问我们的开发工具包。

记录器类

包含允许您通过 Genesys Cloud 为 Salesforce 创建和保存诊断日志的方法。

注意： 由于 Salesforce 的限制，集成将创建的日志存储在内存中，直到使用 createPendingLog 方法的事务结束为止。在事务结束时，集成会使用 savePendingLogs 方法将这些日志作为日志对象保存到 Salesforce 组织。

purecloud.sdk.logger

使用这些方法创建待处理的日志请求，然后在交易结束时通过 Genesys Cloud 为 Salesforce 保存日志。

以下方法可用于 Logger 类。

为 Salesforce 组织创建存储在内存中的待处理日志。

姓名	数据类型	描述	注释
名称	字符串	要在 Salesforce 组织中显示的日志的名称。
消息	字符串	要在日志中显示的消息。
日志级别	purecloud .log.logLevel 枚举	要创建的日志的日志级别。	有效值：错误、警告、信息、调试。此日志级别必须匹配或低于您在 Salesforce 中设置的日志级别。例如，如果您在呼叫中心设置中将日志记录设置为 WARN，则必须在 Apex 代码中将 ERROR 或 WARN 传递到 LogLevel；如果您传递 INFO 或 DEBUG，则集成将不会创建日志。有关详细信息，请参阅 Salesforce 中的诊断日志。

以下示例在内存中创建一个挂起的日志。日志请求称为 SDK，它生成一条消息，然后生成最详细的信息量 (DEBUG)。

purecloud.SDK.Logger.createPendingLog('SDK', 'I am a diagnostic log message!', purecloud.Log.LogLevels.DEBUG);

将存储在内存中的待处理日志保存到 Salesforce 组织。使用 DML 将日志插入 Genesys Cloud_log__C 记录中。

保存的日志显示在 Salesforce 的 Genesys 云日志 页面上。有关详细信息，请参阅 Salesforce 中的诊断日志。

以下示例保存使用 createPendingLogs 方法存储在内存中的待处理日志。

purecloud.SDK.Logger.savePendingLogs();