跳到主要内容

插入文档 - 文档嵌入指南

PDF4me的文档生成引擎支持在生成过程中将完整文档插入到其他文档中。这项强大的功能使您能够合并多个文档、在模板中嵌入模板,并动态创建复杂的多章节文档。


文档插入语法

使用以下方式插入完整文档 Base64编码后的文档内容:

<<doc [token]>>

doc 关键字指示模板引擎将整个文档内容插入到指定位置。


基本文档插入

简单文档嵌入

模板语法:

<<doc [document]>>

数据要求: 该文件必须以以下形式提供: Base64数据源中 - 编码的字符串。

数据示例:

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAACAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAC0lMtuwjAQRfeV+g+Rt1Vi6KKqKgKLPpYtUukHGHsCVv2Sx7z+vhMCUVUBkQpsIiUz994zVsaD0dqabAkRtXcl6xc9loGTXmk3K9nX5C1/ZBkm4ZQw3kHJNoBsNLy9GUw2ATAjtcOSzVMKT5yjnIMVWPgAjiqVj1Ykeo0zHoT8FjPg973eA5feJXApT7UHGw5eoBILk7LXNX1uSCIYZNlz01hnlUyEYLQUiep86dSflHyXUJBy24NzHfCOGhg/mFBXjgfsdB90NFEryMYipndhqYuvfFRcebmwpCxO2xzg9FWlJbT62i1ELwGRztyaoq1Yod2e/ygHpo0BvDxF49sdDymR4BoAO+dOhBVMP69G8cu8E6Si3ImYGrg8RmvdCZFoA6F59s/m2NqciqTOcfQBaaPjP8ber2ytzmngADHp039dm0jWZ88H9W2gQB3I5tv7bfgDAAD//wMAUEsDBBQABgAIAAAAIQAekRq37wAAAE4CAAALAAgCX3JlbHMvLnJlbHMgogQCKKAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACskstqwzAQRfeF/oOYfS07fVBC5GxKIdvW/QBFHj+oLAnN9OG/r0hJ69BguvByrphzz4A228/BineM1HunoMhyEOiMr3vXKnipHq/uQRBrV2vrHSoYkWBbXl5sntBqTkvU9YFEojhS0DGHtZRkOhw0ZT6gSy+Nj4PmNMZWBm1edYtyled3Mk4ZUJ4wxa5WEHf1NYhqDPgftm+a3uCDN28DOj5TIT9w/4zM6ThKWB1bZAWTMEtEkOdFVkuK0B+LYzKnUCyqwKPFqcBhnqu/XbKe0y7+th/G77CYc7hZ0qHxjiu9txOPn+goIU8+evkFAAD//wMAUEsDBBQABgAIAAAAIQC29GeY0gYAAMkgAAAVAAAAd29yZC90aGVtZS90aGVtZTEueG1s7FlLixtHEL4H8h+Euct6zehhrDXSSPJr1zbetYOPvVJrpq2eadHd2rUwhmCfcgkEnJBDDLnlEEIMMcTkkh9jsEmcH5HqHkkzLfXEj12DCbuCVT++qv66qrq6NHPh4v2YOkeYC8KSjls9V3EdnIzYmCRhx719MCy1XEdIlIwRZQnuuAss3Is7n392AZ2XEY6xA/KJOI86biTl7Hy5LEYwjMQ5NsMJzE0Yj5GELg/LY46OQW9My7VKpVGOEUlcJ0ExqL0xmZARdg6USndnpXxA4V8ihRoYUb6vVGNDQmPH06r6EgsRUO4cIdpxYZ0xOz7A96XrUCQkTHTciv5zyzsXymshKgtkc3JD/beUWwqMpzUtx8PDtaDn+V6ju9avAVRu4wbNQWPQWOvTADQawU5TLqbOZi3wltgcKG1adPeb/XrVwOf017fwXV99DLwGpU1vCz8cBpkNc6C06W/h/V671zf1a1DabGzhm5Vu32saeA2KKEmmW+iK36gHq92uIRNGL1vhbd8bNmtLeIYq56IrlU9kUazF6B7jQwBo5yJJEkcuZniCRoALECWHnDi7JIwg8GYoYQKGK7XKsFKH/+rj6Zb2KDqPUU46HRqJrSHFxxEjTmay414FrW4O8urFi5ePnr989PvLx49fPvp1ufa23GWUhHm5Nz9988/TL52/f/vxzZNv7XiRx7/+5avXf/z5X+qlQeu7Z6+fP3v1/dd//fzEAu9ydJiHH5AYC+c6PnZusRg2aFkAH/L3kziIEMlLdJNQoAQpGQt6ICMDfX2BKLLgeti04x0O6cIGvDS/ZxDej/hcEgvwWhQbwD3GaI9x656uqbXyVpgnoX1xPs/jbiF0ZFs72PDyYD6DuCc2lUGEDZo3KbgchTjB0lFzbIqxRewuIYZd98iIM8Em0rlLnB4iVpMckEMjmjKhyyQGvyxsBMHfhm327jg9Rm3q+/jIRMLZQNSmElPDjJfQXKLYyhjFNI/cRTKykdxf8JFhcCHB0yGmzBmMsRA2mRt8YdC9BmnG7vY9uohNJJdkakPuIsbyyD6bBhGKZ1bOJIny2CtiCiGKnJtMWkkw84SoPvgBJYXuvkOw4e63n+3bkIbsAaJm5tx2JDAzz+OCThC2Ke/y2EixXU6s0dGbh0Zo72JM0TEaY+zcvmLDs5lh84z01QiyymVss81VZMaq6idYQK2kihuLY4kwQnYfh6yAz95iI/EsUBIjXqT5+tQMmQFcdbE1XuloaqRSwtWhtZO4IWJjf4Vab0bICCvVF/Z4XXDDf+9yxkDm3gfI4PeWgcT+zrY5QNRYIAuYAwRVhi3dgojh/kxEHSctNrfKTcxDm7mhvFH0xCR5awW0Ufv4H6/2gQrj1Q9PLdjTqXfswJNUOkXJZLO+KcJtVjUB42Py6Rc1fTRPbmK4RyzQs5rmrKb539c0Ref5rJI5q2TOKhm7yEeoZLLiRT8CWj3o0Vriwqc+E0LpvlxQvCt02SPg7I+HMKg7Wmj9kGkWQXO5nIELOdJthzP5BZHRfoRmsExVrxCKpepQODMmoHDSw1bdaoLO4z02Tker1dVzTRBAMhuHwms1DmWaTEcbzewB3lq97oX6QeuKgJJ9HxK5xUwSdQuJ5mrwLST0zk6FRdvCoqXUF7LQX0uvwOXkIPVI3PdSRhBuENJj5adUfuXdU/d0kTHNbdcs22srrqfjaYNELtxMErkwjODy2Bw+ZV+3M5ca9JQptmk0Wx/D1yqJbOQGmpg95xjOXN0HNSM067gT+MkEzXgG+oTKVIiGSccdyaWhPySzzLiQfSSiFKan0v3HRGLuUBJDrOfdQJOMW7XWVHv8RMm1K5+e5fRX3sl4MsEjWTCSdWEuVWKdPSFYddgcSO9H42PnkM75LQSG8ptVZcAxEXJtzTHhueDOrLiRrpZH0Xjfkh1RRGcRWt4o+WSewnV7TSe3D810c1dmf7mZw1A56cS37tuF1EQuaRZcIOrWtOePj3fJ51hled9glabuzVzXXuW6olvi5BdCjlq2mEFNMbZQy0ZNaqdYEOSWW4dm0R1x2rfBZtSqC2JVV+re1ottdngPIr8P1eqcSqGpwq8WjoLVK8k0E+jRVXa5L505Jx33QcXvekHND0qVlj8oeXWvUmr53Xqp6/v16sCvVvq92kMwioziqp+uPYQf+3SxfG+vx7fe3cerUvvciMVlpuvgshbW7+6rteJ39w4Byzxo1IbtervXKLXr3WHJ6/dapXbQ6JX6jaDZH/YDv9UePnSdIw32uvXAawxapUY1CEpeo6Lot9qlplerdb1mtzXwug+Xtoadr75X5tW8dv4FAAD//wMAUEsDBBQABgAIAAAAIQASDF40HAQAANELAAARAAAAd29yZC9zZXR0aW5ncy54bWy0Vttu2zgQfV9g/8HQ8zqy5EtioU4RO/EmRdwWdRb7TImURYQ3kJQdt9h/3yElWk5TFE6LvNjknJkzw+FwRu/eP3HW2xJtqBSzKDkbRD0iComp2Myifx6W/YuoZywSGDEpyCzaExO9v/zzj3e7zBBrQc30gEKYjBezqLJWZXFsiopwZM6kIgLAUmqOLGz1JuZIP9aqX0iukKU5ZdTu43QwmEQtjZxFtRZZS9HntNDSyNI6k0yWJS1I+xcs9Cl+G5NrWdScCOs9xpowiEEKU1FlAhv/VTYAq0Cy/dkhtpwFvV0yOOG4O6nxweKU8JyB0rIgxsAFcRYCpKJzPHpBdPB9Br7bI3oqME8GfnUc+fh1BOkLgklBnl7HcdFyxGB5zEPx63gmBx7aJTaZ/FowRwQGW1y9iiUNeY2dLbKoQuZQRY6RvC6o8YFuz7scGXZK1TTQPc010s2bbEuGF9ndRkiNcgbhQOn04PZ7Pjr3C0l0f35Jnrzc5SG6hB7xVUre22WK6AIeCjSYwSCKHQDlKcu1RRYoMqMIY77jFIwg8LjLNhpx6BVB4m0wKVHN7APK11YqUNoiONh52lIWFdKosESvFSqAbSGF1ZIFPSw/SruAvqPhWbQWvgt1q3XT0cBCIA5HfdalVhITF1mt6el34gy892R87PJ7RxI6sKaYPLgUr+2ekSUEv6ZfyZXAH2pjKTD6XvUbEfwsACKc509QFA97RZYE2RrS9EbO/E0sGVUrqrXUdwJDbbyZM1qWRIMDCrW2gvKhWu58nm8JwjD43shvbci/oAxvcvgAZfk4l9ZKfrtXFeT6927S13t8XL4wvrEJiy9S2oPq4GY+md4smkgdegqyPB+n82HrpeXmmRtwn3VYuQLt8cZigXiuKeqt3AiMnUauH+dUBDwn0GfIMbKu8wD2+w1gOGJsCakKgD8mzzA16pqUfs1WSG863lZD/1AK3eLDgct1H6L/1rJWDbrTSDWFF1SS0ai1pMLeUx7kps7XwUpAZzyCaoE/bbXPU5eeXWbhIv0Dvke+ILwuEf27j23BML12l01WSKmmZvJNMosY3VQ2cddsYYfhS8lv8k3aYqnH0gbzG1S4k4F2u+hkaZAd6Q2DbNjJRkE26mTjIBt3skmQTZysgi6hoWU/QvmGpZOXkjG5I/i2w1+ImiSYCily3XR0KC/ZCNoWb3rbjDzBvCCYWvgAVRRz9OTGRzpx5q02Q3tZ22e6DnPK6jmDG63tg42fGfsS/y4WN2kKCuW43vO8GyBnTeCMGnjsCmaNlTpgf3ksGWVYFnduHI4a+XA6GqbT6XUDj/2Msr4fwL1/IeUcGYJbLJiOG9Nvk8F5Mp/eXPUHF4ur/mg+TvrT+fmyf74cj6eTxcK90f/aRxq+xS//BwAA//8DAFBLAwQUAAYACAAAACEAQ6RslocLAAAPcwAADwAAAHdvcmQvc3R5bGVzLnhtbLydW3PbuhHH3zvT78DRU/uQyFc5yRznjOMktae2j0/kNM8QCVmoQULlxZd++gIgJUFeguKCW78k1mV/APHHf4nlTb/9/pzK6JHnhVDZ6Wj//d4o4lmsEpHdn45+3n1/92EUFSXLEiZVxk9HL7wY/f75r3/57elTUb5IXkQakBWf0vh0tCjL5afxuIgXPGXFe7Xkmf5wrvKUlfplfj9OWf5QLd/FKl2yUsyEFOXL+GBvbzJqMHkfiprPRcy/qrhKeVba+HHOpSaqrFiIZbGiPfWhPak8WeYq5kWhNzqVNS9lIltj9o8AKBVxrgo1L9/rjWl6ZFE6fH/P/pXKDeAYBzgAgEnMn3GMDw1jrCNdjkhwnMmaIxKHE9YZB1AkZbJAUQ5W4zo2saxkC1YsXCLHdep4jXtJzRil8afL+0zlbCY1SaseaeEiCzb/6u03/9k/+bN932zC6LP2QqLir3zOKlkW5mV+mzcvm1f2v+8qK4vo6RMrYiHudAd1K6nQDV6cZYUY6U84K8qzQrDWDxfmj9ZP4qJ03v4iEjEamxaL/+oPH5k8HR0crN45Nz3Yek+y7H71Hs/eXd64PbFv/Zyat2aaezpi+bvpmQkcNxtW/+9s7vL1K9vwksXCtsPmJdc235/sGagUJqscHH9cvfhRmcFnVamaRiyg/n+NHYMR1+7XuWBapyT9KZ9fqfiBJ9NSf3A6sm3pN39e3uZC5TrtnI4+2jb1m1OeiguRJDxzvpgtRMJ/LXj2s+DJ5v0/v9vU0bwRqyrTfx+eTOwskEXy7TnmS5OI9KcZM5rcmABpvl2JTeM2/D8r2H6jRFv8gjOTjaP91wjbfRTiwEQUzta2M6tX226/hWro8K0aOnqrho7fqqHJWzV08lYNfXirhizm/9mQyBKd+O33YTOAuovjcSOa4zEbmuPxEprjsQqa43ECmuOZ6GiOZx6jOZ5piuCUKvbNQmeyH3pmezd39z4ijLt7lxDG3b0HCOPuTvhh3N35PYy7O52HcXdn7zDu7mSN59ZLrehS2ywrB7tsrlSZqZJHJX8eTmOZZtkSlYZndno8J9lIAkyd2Zod8WBazOzr3TPEmjR8f16aSi9S82gu7qucF4M7zrNHLtWSRyxJNI8QmPOyyj0jEjKncz7nOc9iTjmx6aCmEoyyKp0RzM0luydj8SwhHr4VkSQprCe0rp8XxiSCYFKnLM7V8K4pRpYfrkQxfKwMJPpSScmJWDc0U8yyhtcGFjO8NLCY4ZWBxQwvDBzNqIaooRGNVEMjGrCGRjRu9fykGreGRjRuDY1o3Bra8HG7E6W0Kd5ddez3P3Z3LpU5qTC4H1NxnzG9ABi+u2mOmUa3LGf3OVsuInNUuh3rbjO2nS8qeYnuKPZpaxLVut5OkXO91SKrhg/oFo3KXGsekb3WPCKDrXnDLXatl8lmgXZBU89Mq1nZalpL6mXaKZNVvaAd7jZWDp9hGwN8F3lBZoN2LMEMvjHLWSMnRebb9HJ4xzas4bZ6nZVIu9cgCXopVfxAk4YvXpY812XZw2DSdyWleuIJHXFa5qqea67lD6wkvSz/LV0uWCFsrbSF6L+rX12OEF2z5eANupVMZDS6fXuXMiEjuhXExd31VXSnlqbMNANDA/yiylKlZMzmSODffvHZ32k6eKaL4OyFaGvPiA4PWdi5INjJ1CSVEJH0MlNkgmQfann/5C8zxfKEhnab8/oKoJITEacsXdaLDgJv6bz4pPMPwWrI8v7FcmGOC1GZ6o4E5hw2LKrZv3k8PNXdqIjkyNAfVWmPP9qlro2mww1fJmzhhi8RrJp692DmL8HGbuGGb+wWjmpjzyUrCuE9hRrMo9rcFY96e4cXfw1PSZXPK0k3gCsg2QiugGRDqGSVZgXlFlse4QZbHvX2Ek4ZyyM4JGd5/8hFQiaGhVEpYWFUMlgYlQYWRirA8Ct0HNjwy3Qc2PBrdWoY0RLAgVHNM9LdP9FZHgdGNc8sjGqeWRjVPLMwqnl2+DXi87leBNPtYhwk1ZxzkHQ7mqzk6VLlLH8hQn6T/J4RHCCtabe5mptbQ1RWX8RNgDTHqCXhYrvGUYn8i8/IumZYlP0iOCLKpFSK6NjaZodjI7evXdsVZu/kGNyFW8livlAy4blnm/yxul6e1rdlvO6+7Uavw55X4n5RRtPF+mi/i5ns7YxcFexbYbsbbBvzyep+lrawa56IKl11FN5MMTnsH2xn9Fbw0e7gzUpiK/K4ZyRsc7I7crNK3oo86RkJ2/zQM9L6dCuyyw9fWf7QOhFOuubPusbzTL6Trlm0Dm5ttmsirSPbpuBJ1yzaskp0FsfmbAFUp59n/PH9zOOPx7jIT8HYyU/p7Ss/ostgP/ijMHt2TNK07a2vngB53y6ie2XOPytVH7ffOuHU/6auS71wygoetXIO+5+42soy/nHsnW78iN55x4/onYD8iF6ZyBuOSkl+Su/c5Ef0TlJ+BDpbwT0CLlvBeFy2gvEh2QpSQrLVgFWAH9F7OeBHoI0KEWijDlgp+BEoo4LwIKNCCtqoEIE2KkSgjQoXYDijwnicUWF8iFEhJcSokII2KkSgjQoRaKNCBNqoEIE2auDa3hseZFRIQRsVItBGhQi0Ue16cYBRYTzOqDA+xKiQEmJUSEEbFSLQRoUItFEhAm1UiEAbFSJQRgXhQUaFFLRRIQJtVIhAG7W+1TDcqDAeZ1QYH2JUSAkxKqSgjQoRaKNCBNqoEIE2KkSgjQoRKKOC8CCjQgraqBCBNipEoI1qTxYOMCqMxxkVxocYFVJCjAopaKNCBNqoEIE2KkSgjQoRaKNCBMqoIDzIqJCCNipEoI0KEV3zszlF6bvMfh9/1NN7xX7/U1dNp364t3K7qMP+qFWv/Kz+9yJ8Ueohar3x8NDWG/0gYiaFsoeoPafVXa69JAJ14vOP8+47fFz6wIcuNfdC2HOmAH7UNxIcUznqmvJuJCjyjrpmuhsJVp1HXdnXjQS7waOupGt9ubooRe+OQHBXmnGC9z3hXdnaCYdD3JWjnUA4wl2Z2QmEA9yVj53A48gk59fRxz3HabK+vhQQuqajQzjxE7qmJdRqlY6hMfqK5if0Vc9P6Cujn4DS04vBC+tHoRX2o8KkhjbDSh1uVD8BKzUkBEkNMOFSQ1Sw1BAVJjVMjFipIQErdXhy9hOCpAaYcKkhKlhqiAqTGu7KsFJDAlZqSMBKPXCH7MWESw1RwVJDVJjUcHGHlRoSsFJDAlZqSAiSGmDCpYaoYKkhKkxqUCWjpYYErNSQgJUaEoKkBphwqSEqWGqI6pLaHkXZkhqlsBOOW4Q5gbgdshOIS85OYEC15EQHVksOIbBaglqtNMdVS65ofkJf9fyEvjL6CSg9vRi8sH4UWmE/KkxqXLXUJnW4Uf0ErNS4askrNa5a6pQaVy11So2rlvxS46qlNqlx1VKb1OHJ2U8IkhpXLXVKjauWOqXGVUt+qXHVUpvUuGqpTWpctdQm9cAdshcTLjWuWuqUGlct+aXGVUttUuOqpTapcdVSm9S4askrNa5a6pQaVy11So2rlvxS46qlNqlx1VKb1LhqqU1qXLXklRpXLXVKjauWOqXGVUvXOkQQPAJqmrK8jOieF3fBikXJhj+c8GeW80LJR55EtJt6hdrK8dPWz18Ztv1tPv39Uo+ZeQK6c7tSUj8BtgHaL14m65+pMsGmJ1Hzg2DN27bDzenaukUbCJuKF7qtuHl2laep5hm065uo7BNoXzfseVCt7chmAq6+3QzpZrzq722NVme/SzPhO/psDdE5RrVnfB382CSBXT3U/ZnJ+ifT9B+XWaIBT83PhdU9TZ5ZjdKfn3Mpr1n9bbX0f1XyeVl/ur9nH1nw6vNZ/fQ9b3xu07QXMN7uTP2y+dk2z3jXz+Nvrh/wTkmTi1qG217MMnSkN31b/VV8/h8AAAD//wMAUEsDBBQABgAIAAAAIQDvCilOTgEAAH4DAAAUAAAAd29yZC93ZWJTZXR0aW5ncy54bWyc019rwjAQAPD3wb5DybumyhQpVmEMx17GYNsHiOnVhiW5kour7tPv2qlz+GL3kv/34y4h8+XO2eQTAhn0uRgNU5GA11gYv8nF+9tqMBMJReULZdFDLvZAYrm4vZk3WQPrV4iRT1LCiqfM6VxUMdaZlKQrcIqGWIPnzRKDU5GnYSOdCh/beqDR1SqatbEm7uU4TafiwIRrFCxLo+EB9daBj128DGBZRE+VqemoNddoDYaiDqiBiOtx9sdzyvgTM7q7gJzRAQnLOORiDhl1FIeP0m7k7C8w6QeML4Cphl0/Y3YwJEeeO6bo50xPjinOnP8lcwZQEYuqlzI+3qtsY1VUlaLqXIR+SU1O3N61d+R09rTxGNTassSvnvDDJR3ctlx/23VD2HXrbQliwR8C62ic+YIVhvuADUGQ7bKyFpuX50eeyD+/ZvENAAD//wMAUEsDBBQABgAIAAAAIQC/L9d/7wEAAHoGAAASAAAAd29yZC9mb250VGFibGUueG1s3JPBjpswEIbvlfoOyPcNhoRsipas1HYjVap6qLYP4BgD1mIbeZyQvH3HhrCRopWWHnpYDsb+x/N55sc8PJ5UGx2FBWl0QZIFJZHQ3JRS1wX587y725NIHNMla40WBTkLII/bz58e+rwy2kGE+RpyxQvSONflcQy8EYrBwnRCY7AyVjGHS1vHitmXQ3fHjeqYk3vZSneOU0rXZMTY91BMVUkuvht+UEK7kB9b0SLRaGhkBxda/x5ab2zZWcMFAPas2oGnmNQTJlndgJTk1oCp3AKbGSsKKExPaJip9hWQzQOkN4A1F6d5jM3IiDHzmiPLeZz1xJHlFeffirkCQOnKZhYlvfga+1zmWMOguSaKeUVlE+6svEeK5z9qbSzbt0jCrx7hh4sC2I/Yv3+FqTgF3bdAtuOvEPW5Zgozv7FW7q0MgY5pAyLB2JG1BcEedjSjvpeUrujSjyT2G3nDLAgPGTbSQa6Yku35okIvAYZAJx1vLvqRWemrHkIgawwcYE8L8rSiNH3a7cigJFgdRWV1/3VUUn9WeL6MynJSqFd44IRlMnB44Ex78Mx4cODGiWepBES/RB/9NorpNxxJ6RqdyNAP78xyliM2cGc54vu/ceR+k/0XR8a7Ef2UdePevCH+XnzQGzJOYPsXAAD//wMAUEsDBBQABgAIAAAAIQChA3hbdQEAAPsCAAARAAgBZG9jUHJvcHMvY29yZS54bWwgogQBKKAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACMkstuwjAQRfeV+g+R98F5SKiKkiC1FasiVYI+1J2xB3CJH7IdAn9fJ4HQqCy6m/GcuTO+dj47iio4gLFcyQLFkwgFIKliXG4L9Laahw8osI5IRioloUAnsGhW3t/lVGdUGXg1SoNxHGzglaTNqC7QzjmdYWzpDgSxE09IX9woI4jzqdliTeiebAEnUTTFAhxhxBHcCoZ6UERnSUYHSV2bqhNgFEMFAqSzOJ7E+Mo6MMLebOgqv0jB3UnDTfRSHOij5QPYNM2kSTvU7x/jz8XLsrtqyGXrFQVU5oxmjrsKyhxfQx/Zev0N1PXHQ+JjaoA4Zcp3bneyDpb12hChJCeiQy/l1vg9nBplmPUio8xjDCw1XDv/nP2I0YGnK2Ldwr/vhgN7PN2c9pdqGw0cePtLyrgjhjQ/W95vCCzwVmW9sZfKR/r0vJqjMomSJIyTMElX0TRLkiyKvtolR/1XQXFe4P+K6VjxItD7NP6u5Q8AAAD//wMAUEsDBBQABgAIAAAAIQCu50sMbwEAAMgCAAAQAAgBZG9jUHJvcHMvYXBwLnhtbCCiBAEooAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAJxSy07DMBC8I/EPUe7UKUgFoY0RKkIceElN27NlbxILx7Zst2r/nk0DIYgbPu3Mekcza8PdoTPZHkPUzpb5fFbkGVrplLZNma+rx4ubPItJWCWMs1jmR4z5HT8/g/fgPIakMWYkYWOZtyn5W8aibLETcUZtS53ahU4kgqFhrq61xAcndx3axC6LYsHwkNAqVBd+FMwHxdt9+q+ocrL3FzfV0ZMehwo7b0RC/tpPmplyqQM2slC5JEylO+RzokcA76LB2HNDAVsXFGEihgqWrQhCJlogX1wBm0C4995oKRJtlr9oGVx0dcreTnazfhzY9ApQhBXKXdDpyAtgUwjP2g4+hoJ8BdEE4dsvcyOClRQGlxSe18JEBPZDwNJ1XliSY2NFeh9x7Sv30O/ha+Q3Ocm41aldeSHJwvWvtJMGrIhFRfZHByMBT/QewfTyNGsbVN93/jb6/W2Gj8nni1lB57Swb45ijz+GfwIAAP//AwBQSwECLQAUAAYACAAAACEA36TSbFoBAAAgBQAAEwAAAAAAAAAAAAAAAAAAAAAAW0NvbnRlbnRfVHlwZXNdLnhtbFBLAQItABQABgAIAAAAIQAekRq37wAAAE4CAAALAAAAAAAAAAAAAAAAAJMDAABfcmVscy8ucmVsc1BLAQItABQABgAIAAAAIQC93+LgigMAAPUNAAARAAAAAAAAAAAAAAAAALMGAAB3b3JkL2RvY3VtZW50LnhtbFBLAQItABQABgAIAAAAIQDWZLNR9AAAADEDAAAcAAAAAAAAAAAAAAAAAGwKAAB3b3JkL19yZWxzL2RvY3VtZW50LnhtbC5yZWxzUEsBAi0AFAAGAAgAAAAhALb0Z5jSBgAAySAAABUAAAAAAAAAAAAAAAAAogwAAHdvcmQvdGhlbWUvdGhlbWUxLnhtbFBLAQItABQABgAIAAAAIQASDF40HAQAANELAAARAAAAAAAAAAAAAAAAAKcTAAB3b3JkL3NldHRpbmdzLnhtbFBLAQItABQABgAIAAAAIQBDpGyWhwsAAA9zAAAPAAAAAAAAAAAAAAAAAPIXAAB3b3JkL3N0eWxlcy54bWxQSwECLQAUAAYACAAAACEA7wopTk4BAAB+AwAAFAAAAAAAAAAAAAAAAACmIwAAd29yZC93ZWJTZXR0aW5ncy54bWxQSwECLQAUAAYACAAAACEAvy/Xf+8BAAB6BgAAEgAAAAAAAAAAAAAAAAAmJQAAd29yZC9mb250VGFibGUueG1sUEsBAi0AFAAGAAgAAAAhAKEDeFt1AQAA+wIAABEAAAAAAAAAAAAAAAAARScAAGRvY1Byb3BzL2NvcmUueG1sUEsBAi0AFAAGAAgAAAAhAK7nSwxvAQAAyAIAABAAAAAAAAAAAAAAAAAA8SkAAGRvY1Byb3BzL2FwcC54bWxQSwUGAAAAAAsACwDBAgAAliwAAAAA"
}

Base64 字符串表示一个完整的 Word 将插入到合并字段位置的文档。


文档插入控制

PDF4me 提供控制开关,用于自定义插入文档的处理和格式。

源样式保留

句法: <<doc [document] -sourceStyles>>

行为:

  • 覆盖父模板的格式
  • 保留插入文档的原始格式
  • 保留源文档中的样式、字体和颜色
  • 源文档格式优先

使用案例: 插入文档时,必须完全保留其设计样式。

例子:

Main Document Content...

<<doc [contractDocument] -sourceStyles>>

Continuation of Main Document...

递归模板构建

句法: <<doc [document] -build>>

行为:

  • 将插入的文档视为模板
  • 处理插入文档中的字段合并
  • 将数据应用于嵌套模板结构
  • 支持多级模板组合

使用案例: 当插入的文档本身包含需要填充的合并字段时。

例子:

Parent Template:
<<doc [childTemplate] -build>>

如果 childTemplate 包含 <<[employeeName]>>它将使用来自同一数据源的数据进行填充。


组合控制开关

这两个控制开关可以同时使用,以实现最大的灵活性:

句法: <<doc [document] -sourceStyles -build>>

这种组合:

  1. 保留源文档格式
  2. 处理嵌套合并字段
  3. 将数据应用于嵌入式模板

实际应用

示例 1:条款和条件插入

主模板:

Invoice #<<[invoiceNumber]>>
Date: <<[invoiceDate]:"dd.MM.yyyy">>

Items:
<<foreach [item in lineItems]>>
• <<[item.name]>> - $<<[item.price]>>
<</foreach>>

Total: $<<[total]>>

Terms and Conditions:
<<doc [termsDocument]>>

使用案例: 标准条款和条件以单独文件的形式保存,并插入到每张发票中。


示例 2:部门特定章节

主模板:

Company Report - <<[reportDate]:"MMMM yyyy">>

Executive Summary:
<<[executiveSummary]>>

Department Reports:
<<foreach [dept in departments]>>
Department: <<[dept.name]>>
<<doc [dept.reportDocument] -sourceStyles>>
<</foreach>>

使用案例: 每个部门提供自己格式化的报告文档,然后汇总成一份总报告。


示例 3:递归模板程序集

父模板:

Customer: <<[customerName]>>
Order Date: <<[orderDate]:"dd.MM.yyyy">>

Order Details:
<<doc [orderTemplate] -build>>

Shipping Information:
<<doc [shippingTemplate] -build>>

子模板: 两个都 orderTemplateshippingTemplate 包含它们自己的合并字段,这些字段将从主数据源填充数据。


多文档组装

将多个文档合并成一个生成的输出文件。

顺序文档插入

模板:

<<doc [document1]>>

<<doc [document2]>>

<<doc [document3]>>

每个文档按顺序插入,形成一个多章节组合文档。


条件文档插入

模板:

Main Content...

<<if [includeAppendixA]>>
Appendix A:
<<doc [appendixADocument]>>
<</if>>

<<if [includeAppendixB]>>
Appendix B:
<<doc [appendixBDocument]>>
<</if>>

文档格式注意事项

支持的文档格式

插入的文件应为:

  • Word 文件 (首选.docx格式)
  • 正确编码 作为 Base64 字符串
  • 有效文件 可以独立打开
  • 兼容的 使用父模板格式

将文档编码为 Base64

准备要插入的文件:

  1. 阅读文档文件 作为二进制数据
  2. 编码 Base64 使用合适的编码工具
  3. 包含在数据源中 作为字符串值
  4. 验证编码 完整且有效

数据结构示例

完整数据源

JSON 结构:

{
"contractNumber": "CNT-2024-001",
"clientName": "Acme Corporation",
"contractDate": "2024/01/15",
"mainTermsDocument": "UEsDBBQABgAIAAAAIQ...[Base64 encoded .docx]",
"appendixDocument": "UEsDBBQABgAIAAAAIQ...[Base64 encoded .docx]",
"includeAppendix": true
}

模板:

Contract #<<[contractNumber]>>
Client: <<[clientName]:caps>>
Date: <<[contractDate]:"MMMM dd, yyyy">>

Main Terms:
<<doc [mainTermsDocument] -sourceStyles>>

<<if [includeAppendix]>>
Appendix:
<<doc [appendixDocument] -sourceStyles>>
<</if>>

最佳实践

文档插入指南

  1. 验证文件 - 请确保插入的文档有效后再进行编码。
  2. 独立测试 - 插入前请确认每个文档都能正确打开。
  3. 合适的尺寸 - 保持插入文件大小合理。
  4. 统一的格式 - 保持文档格式一致
  5. 版本控制 - 跟踪插入文档的版本

性能优化

  1. 限制插入次数 - 尽量减少每个模板的文档插入次数
  2. 文件大小 - 尽量保持插入的文件体积小巧。
  3. 避免深度嵌套 - 限制递归模板深度
  4. 尽可能进行预处理 如果可行,请在模板处理前合并文档。

数据管理

  1. 安全编码 - 确保 Base64 编码安全准确
  2. 存储效率 - 考虑存储方面的影响 Base64 字符串
  3. 缓存 - 缓存常用文档以减少编码开销
  4. 错误处理 - 针对缺失或无效的文档实施备用方案

故障排除

常见问题

问题: 插入的文档未显示
解决方案: 核实 Base64 编码完整且有效

问题: 插入文档的格式丢失
解决方案: 使用 -sourceStyles 切换到保留格式模式

问题: 插入文档中的合并字段未填充。
解决方案: 使用 -build 切换到处理嵌套模板

问题: 生成的文档文件过大
解决方案: 在编码前优化插入的文档

问题: 插入内容位置不正确
解决方案: 检查模板结构和放置位置 <<doc>> 语法


高级场景

场景一:多语言文档

根据用户偏好插入特定语言的文档章节:

模板:

<<if [language == "English"]>>
<<doc [termsEnglish] -sourceStyles>>
<<elseif [language == "Spanish"]>>
<<doc [termsSpanish] -sourceStyles>>
<<else>>
<<doc [termsDefault] -sourceStyles>>
<</if>>

场景 2:模块化文档组装

由更小、可重用的组件构建复杂文档:

模板:

<<doc [headerDocument]>>

<<foreach [section in sections]>>
<<doc [section.documentContent] -sourceStyles -build>>
<</foreach>>

<<doc [footerDocument]>>

场景 3:模板继承

创建包含插入专用部分的基础模板:

基础模板:

Company Letterhead
<<[date]:"MMMM dd, yyyy">>

<<doc [bodyContent] -build>>

Standard Footer
<<doc [disclaimerDocument]>>

:::提示 文档准备

在编码之前,请彻底准备并测试插入的文档。 Base64请确保它们在单独打开时显示正常,然后再将其合并到模板中。

:::

:::警告:性能影响

插入多个大型文档可能会显著影响生成性能。请谨慎使用文档插入功能,并考虑对非常大或数量众多的文档采用其他方法。

:::