首页 > 其他分享 >界面组件DevExpress Office File API - 如何用OpenAI增强文档可访问性(二)

界面组件DevExpress Office File API - 如何用OpenAI增强文档可访问性(二)

时间:2024-06-14 10:12:11浏览次数:20  
标签:Office hyperlink DevExpress API 文档 超链接 new

DevExpress Office File API是一个专为C#, VB.NET 和 ASP.NET等开发人员提供的非可视化.NET库。有了这个库,不用安装Microsoft Office,就可以完全自动处理Excel、Word等文档。开发人员使用一个非常易于操作的API就可以生成XLS, XLSx, DOC, DOCx, RTF, CSV 和 Snap Report等企业级文件。

在我们上一篇与AI相关的文章中(点击这里回顾>>),描述了如何使用DevExpress Office File API库和Azure AI OpenAI服务的可访问性)为图像和图表生成AltText(有意义的描述)。在这篇文章中,我们将解释如何为Word和Excel文件生成超链接描述。

当您生成可访问的Word或Excel文档时,创建带有有意义的屏幕提示的超链接是必不可少的,有意义的屏幕提示可以帮助有视觉障碍的人或使用屏幕阅读器的人理解超链接的目的,增加清晰度,并增强文档导航。此外,当您将文档导出为可访问的PDF格式(与可访问性标准(WCAG)保持一致)时,超链接屏幕提示非常重要。在DevExpress Word Processing Document API 和 Spreadsheet Document API库的帮助下,您可以定位不提供可访问描述的文档超链接,并使用OpenAI模型生成这些描述。

获取DevExpress Office File API正式版下载

DevExpress技术交流群10:532598169      欢迎一起进群讨论

我们在GitHub上的示例项目中为该功能添加了两个新的端点:Office File API – Integrate AI to Generate Accessible Descriptions,接下来将在下面详细介绍实现步骤……

实现OpenAI模型API

注意:在您将此解决方案纳入应用程序之前,请务必阅读并理解OpenAI的许可协议和使用条款。

这一步类似于我们在之前的AI相关文章中演示过得步骤,在您的项目中安装Azure.AI.OpenAI NuGet包,并使用OpenAI api发送请求。

这个代码片段发送一个请求来描述一个超链接URI,并获得一个带有响应的字符串。

public class OpenAIClientHyperlinkHelper
{
OpenAIClient client;
internal OpenAIClientHyperlinkHelper(string openAIApiKey)
{
client = new OpenAIClient(openAIApiKey, new OpenAIClientOptions());
}
internal async Task<string> DescribeHyperlinkAsync(string link)
{
ChatCompletionsOptions chatCompletionsOptions = new()
{
DeploymentName = "gpt-4-vision-preview",
Messages =
{
new ChatRequestSystemMessage("You are a helpful assistant that describes hyperlinks."),
new ChatRequestUserMessage(
new ChatMessageTextContentItem("Give a description for this hyperlink URI in 10-20 words"),
new ChatMessageTextContentItem(link))
},
MaxTokens = 300
};

Response<ChatCompletions> chatResponse = await client.GetChatCompletionsAsync(chatCompletionsOptions);
ChatChoice choice = chatResponse.Value.Choices[0];
return choice.Message.Content;
}
}
Word Processing Document API端点

要在DevExpress支持的Word Processing Document API应用程序中使用上述API,请访问Document.Hyperlinks集合来检索文档超链接。检查文档超链接是否包含提示(Hyperlink.ToolTip 属性值不应为空或等于Hyperlink.NavigateUri值),否则调用OpenAIClientHyperlinkHelper.DescribeHyperlinkAsync方法生成超链接描述信息。

public async Task<IActionResult> GenerateHyperlinkDescriptionForWord(IFormFile documentWithHyperlinks, [FromQuery] RichEditFormat outputFormat)
{
try
{
var hyperlinkHelper = new OpenAIClientHyperlinkHelper(openAIApiKey);
using (var wordProcessor = new RichEditDocumentServer())
{
await RichEditHelper.LoadFile(wordProcessor, documentWithHyperlinks);

wordProcessor.IterateSubDocuments(async (document) =>
{
foreach (var hyperlink in document.Hyperlinks)
{
if (string.IsNullOrEmpty(hyperlink.ToolTip) || hyperlink.ToolTip == hyperlink.NavigateUri)
{
hyperlink.ToolTip = hyperlinkHelper.DescribeHyperlinkAsync(hyperlink.NavigateUri).Result;
}
}
});
Stream result = RichEditHelper.SaveDocument(wordProcessor, outputFormat);
string contentType = RichEditHelper.GetContentType(outputFormat);
string outputStringFormat = outputFormat.ToString().ToLower();
return File(result, contentType, $"result.{outputStringFormat}");
}
}
catch (Exception e)
{
return StatusCode(500, e.Message + Environment.NewLine + e.StackTrace);
}
}

下图显示了使用此代码生成的超链接描述。

界面组件DevExpress Office File API - 如何用OpenAI增强文档可访问性(二)
Spreadsheet Document API端点

对于DevExpress支持的Spreadsheet Document API应用程序,迭代文档工作表并使用Worksheet.Hyperlinks集合访问工作表超链接,完成后,必须确定Hyperlink.TooltipText 属性是否满足条件,并调用OpenAIClientHyperlinkHelper. DescribeHyperlinkAsync方法,在需要时生成超链接描述。

public async Task<IActionResult> GenerateHyperlinkDescriptionForSpreadsheet(IFormFile documentWithHyperlinks, [FromQuery] SpreadsheetFormat outputFormat)
{
try
{
var hyperlinkHelper = new OpenAIClientHyperlinkHelper(openAIApiKey);
using (var workbook = new Workbook())
{
await SpreadsheetHelper.LoadWorkbook(workbook, documentWithHyperlinks);

foreach (var worksheet in workbook.Worksheets)
{
foreach (var hyperlink in worksheet.Hyperlinks)
{
if(hyperlink.IsExternal && (string.IsNullOrEmpty(hyperlink.TooltipText) || hyperlink.TooltipText == hyperlink.Uri))
hyperlink.TooltipText = hyperlinkHelper.DescribeHyperlinkAsync(hyperlink.Uri).Result;
}
}

Stream result = SpreadsheetHelper.SaveDocument(workbook, outputFormat);
string contentType = SpreadsheetHelper.GetContentType(outputFormat);
string outputStringFormat = outputFormat.ToString().ToLower();
return File(result, contentType, $"result.{outputStringFormat}");
}
}
catch (Exception e)
{
return StatusCode(500, e.Message + Environment.NewLine + e.StackTrace);
}
}

更多DevExpress线上公开课、中文教程资讯请上中文网获取

 

标签:Office,hyperlink,DevExpress,API,文档,超链接,new
From: https://www.cnblogs.com/AABBbaby/p/18247248

相关文章

  • 华为OD API集群负载统计
    题目描述:某个产品的RESTfulAPI集合部署在服务器集群的多个节点上,近期对客户端访问日志进行了采集,需要统计各个API的访问频次,根据热点信息在服务器节点之间做负载均衡,现在需要实现热点信息统计查询功能。RESTfulAPI的由多个层级构成,层级之间使用/连接,如/A/B/C/D这个地址......
  • FastAPI快速入门1 Hello World
    1HelloWorld1.1HelloWorldch01/main.pyfromfastapiimportFastAPI,APIRouter#1app=FastAPI(title="RecipeAPI",openapi_url="/openapi.json")#2api_router=APIRouter()#3@api_router.get("/",status_code......
  • ArcGIS JSAPI 高级教程 - ArcGIS Maps SDK for JavaScript - 添加自定义(GLSL)数据
    ArcGISJSAPI高级教程-ArcGISMapsSDKforJavaScript-添加自定义(GLSL)数据核心代码完整代码在线示例ArcGISMapsSDKforJavaScript从4.29开始增加RenderNode类,可以添加数据以及操作FBO(ManagedFBO);通过操作FBO,可以通过后处理实现很多效果,官方提供了几......
  • select()API
    编写TCP客户端和服务端程序,客户端通过多路IO复用同时处理标准输入(文件描述符为0)和套接字。当输入为quit时程序结束;当通过套接字收到对方消息时把收到的消息再次转发给对方,服务器端需通过select()监控listenfd和accept()后建立的新的套接字newfd,可只写select()相关的主要代码。  ......
  • FastAPI-9 服务层
    9服务层本章阐述了服务层,即中间层。9.1定义服务服务层是网站的核心,它接收来自多个来源的请求,访问作为网站DNA的数据,并返回响应。常见的服务模式包括以下组合:创建/检索/更改(部分或全部)/删除一件事/多件事在RESTful路由器层,名词是资源。在本书中,我们的资源最初将包括隐......
  • 6.13API接口服务类漏洞探针
    ip地址解析:www.x.x.x.com,对应网站目录为d:/wwwroot/xiaodi/而127.x.x.x,对应网站目录为d:/wwwroot/,可能存在网站备份文件zip,所以ip网址端口都的扫描;协议端弱口令爆破:超级弱口令检查工具;端口服务安全问题(用于无思路时)思路:利用探针对端口探测后,对口令安全、Web漏洞、中间......
  • 【第5章】Vue之API风格
    文章目录前言一、选项式API(OptionsAPI)1.代码2.效果二、组合式API(CompositionAPI)1.代码2.效果三、两者之间的区别总结前言Vue.js提供了两种主要的API风格来组织组件的代码:选项式API(OptionsAPI)和组合式API(CompositionAPI)。这两种API风格在Vue3......
  • FastAPI-7:框架比较(Flask、Django及FastAPI)
    7框架比较(Flask、Django及FastAPI)关于一个新的Web框架,您可能想知道的第一件事就是如何入门,而一种自上而下的方法就是定义路由(从URL和HTTP方法到函数的映射)。7.1FlaskFlask自称是微框架。它提供基本功能,你可以根据需要下载第三方软件包进行补充。它比Django小,入门时学习......
  • 1688跨境是淘系对抗拼多多Temu的一把尖刀吗?|1688开放API接口接入|1688跨境代采系统搭
    1688跨境是淘系对抗拼多多Temu的一把尖刀,这一观点在电商领域内有一定的支持。1688作为阿里巴巴集团旗下的重要电商平台,长期以来专注于B2B业务,连接着大量的制造商和采购商。随着电商平台竞争的加剧,1688也在不断地进行战略调整和业务升级,尤其是在跨境电商领域的动作频频,显示出其......
  • 智能小程序 Ray 开发设备信息 API 集合(一)
    getDeviceNumWithDpCode根据dpCode获取群组下具备此dpCode的设备数量。如果是一个分享的群组,请通过接口获取。引入import{device}from'@ray-js/ray';const{getDeviceNumWithDpCode}=device;需引入DeviceKit,且在>=2.4.0版本才可使用请求参数Objectobjec......