DocuSign API：如何强制签名适配SignHere标签的边界框？

我们通过自有应用生成带有签名专用框的PDF文件，需要借助DocuSign API将这些框通过锚点关联至DocuSign签名组件，且要求签名严格适配给定的尺寸范围。

尝试使用SignHere类中的scale_value属性后发现，这并非最佳方案——该属性会将包括"Signed by"标签在内的整个区域一并缩小，最终呈现效果不理想。

正确解决方案：精准控制签名组件的位置与尺寸 #

不要依赖scale_value进行缩放，而是直接通过坐标和尺寸参数限定签名组件的有效范围，避开标签区域：

1. 获取签名框精确坐标
   先用PDF解析工具（如iTextSharp、PyPDF2）提取PDF中签名专用框的精确坐标（X、Y、宽、高），注意DocuSign的坐标原点为页面左下角，需做好坐标转换。

2. 直接设置组件参数（无锚点场景）
   如果签名框位置固定，创建SignHere组件时直接指定位置和尺寸，完全匹配PDF签名框：

   // C# SDK示例
   var signHere = new SignHere
   {
       XPosition = "200", // 对应PDF签名框的X坐标（转换后）
       YPosition = "300", // 对应PDF签名框的Y坐标（转换后）
       Width = "140",     // 匹配签名框宽度
       Height = "45",     // 匹配签名框高度
       DocumentId = "1",
       PageNumber = "1"
   };
   

3. 锚点+偏移量控制（位置不固定场景）
   若签名框位置不固定，可在PDF签名框内添加隐藏锚点文本（如[[SIGNATURE_BOX]]），再通过锚点偏移量和尺寸限制组件范围：

   // REST API请求示例
   {
       "signHereTabs": [
           {
               "anchorString": "[[SIGNATURE_BOX]]",
               "anchorUnits": "pixels",
               "anchorXOffset": "0",
               "anchorYOffset": "0",
               "width": 140,
               "height": 45,
               "documentId": "1"
           }
       ]
   }
   

这种方式能让签名组件严格贴合PDF的签名专用框，不会影响到"Signed by"标签区域，完美满足尺寸适配要求。

内容的提问来源于stack exchange，提问作者Rick31