在实际的应用场景中，我们往往需要对查看者或者文档本身配置一些权限。 这篇文章将详细介绍如何在 WebPDF SDK 中配置这些权限。

查看者权限设置

      查看者的文档权限

我们可以在初始化PDFUI或PDFViewer时，在viewerOptions参数中配置查看器相关的权限，并通过API getDocPermissions来实现控制的权限。 您可以参考 API 参考中的 PDFViewCtrl.PDF.constant.User_Permissions 去获取具体权限的详细信息。

示例代码如下：

var pdfui = new PDFUI({

            viewerOptions: {

                ……

                customs:{

                    getDocPermissions: function () {

                        //you can operate text annotations, fill in interactive form fields and print the document.

                        return PDFViewCtrl.PDF.constant.User_Permissions.annotForm | PDFViewCtrl.PDF.constant.User_Permissions.print

                    },

                }

            },

           ……

        });

      查看者的注释权限

有两种方法可以配置注释权限。 不同的方式可以控制不同注释的相关权限，您可以根据需要选择其一。

1.       通过 API getAnnotPermissions 配置权限。 详细权限值请参考PDFViewCtrl.constants.ANNOTATION_PERMISSION。

示例代码如下：

var ANNOTATION_PERMISSION = PDFViewCtrl.constants.ANNOTATION_PERMISSION;

var pdfui = new PDFUI({

    viewerOptions: {

        ……

        customs:{

            getAnnotPermissions: function(annot) {

                if(annot.getTitle() === userName){

                    return Promise.resolve(JSON.stringify([ANNOTATION_PERMISSION.fully]))

                }else{

                    return Promise.resolve(JSON.stringify([ANNOTATION_PERMISSION.replyable]))

                }

            }

        }

    },

    ……

});

2.       通过注释标志配置权限。 注释标志是 PDF 标准中定义的与注释相关的权限。 您可以参考 PDFViewCtrl.PDF.annots.constant.Annot_Flags 获取更多详细信息。

当当前用户与注解作者一致时，将拥有所有权限，反之将被被关闭权限。示例代码如下：

var userName = "";

pdfui.addViewerEventListener(PDFViewCtrl.Events.tapAnnotation , function(annotRender){

    var annot = annotRender.getAnnot();

    pdfui.getAnnotManager(annot).then(function(annotManager) {

       var annotFlag = annotManager.getAnnotFlag(annot);

        console.log("===current annotation information：pageIndex:",annot.getPage().info.index,"type:",annot.info.type,",title:",annot.info.title,'：permissions');

        console.log('checkHidden',annotFlag.checkHidden())

        console.log('checkInvisible',annotFlag.checkInvisible())

        console.log('checkLocked',annotFlag.checkLocked())

        console.log('checkLockedContents',annotFlag.checkLockedContents())

        console.log('checkNoRotate',annotFlag.checkNoRotate())

        console.log('checkNoView',annotFlag.checkNoView())

        console.log('checkNoZoom',annotFlag.checkNoZoom())

        console.log('checkPrint',annotFlag.checkPrint())

        console.log('checkReadOnly',annotFlag.checkReadOnly())

        console.log('checkToggleNoView',annotFlag.checkToggleNoView())

        pdfui.redraw(true);

 

    })

})

 

pdfui.getUserName().then(function (name){

    userName = name;

});

 

pdfui.getAnnotManager().then(function(annotManager) {

    annotManager.setViewerAnnotFlag(function(annot) {

        if(annot.getTitle() === userName){

            return 0;

        }else{

            return PDFViewCtrl.PDF.annots.constant.Annot_Flags.locked;

        }

    });

    pdfui.redraw(true);

});

      附加权限

 

附加权限目前只支持下载权限，允许用户下载PDF文件。 有关详细信息，请参阅 PDFViewCtrl.PDF.constant.Additional_Permission。

示例代码如下：

var pdfui = new PDFUI({

            viewerOptions: {

                ……

                customs:{

                    getAdditionalPerm:function(){

                        //return 0 means no permission to download the document.

                        return 0;

                    },

                }

            },

            ……

        });

文档权限设置

      文档权限

Foxit PDF SDK for Web 可以通过设置文档密码来配置文档权限。 可以给文档设置ownerPassword，然后配置文档相关的权限。

请参阅 API 参考中的 PDFViewCtrl.PDF.constant.User_Permissions 以获取特定权限的详细信息。 示例代码如下：

//Set the password of owner to 'abc', and if non-owner open the document, he only read the document. Only when owner open the document with the right password, he can do anything with the document.

var test = {userPassword:'',ownerPassword:'abc',permission:0,cipher:'aes256',isEncryptMetaData:true,expected:true}

var pdfviewer = await pdfui.getPDFViewer();

var pdfdoc = await pdfviewer.getCurrentPDFDoc();

await pdfdoc.setPasswordAndPermission(test.userPassword,test.ownerPassword,test.permission,test.cipher,test.isEncryptMetaData);

      注释权限

和如上的查看者注解权限一样，我们可以通过注解flags来配置注解的权限。示例代码如下：

var pdfViewer = await pdfui.getPDFViewer();

var pdfDoc = await pdfViewer.getCurrentPDFDoc();

var pdfPage = await pdfDoc.getPageByIndex(0);

//Add a square annotation and set the flag to locked.

var annots = await pdfPage.addAnnot({

    type:"square",

    rect:{

        left:300,

        right:400,

        bottom:300,

        top:400

    }

})

annots[0].setFlags(PDFViewCtrl.PDF.annots.constant.Annot_Flags.locked);

 

      表单域权限

我们可以通过设置form field flag来配置Form Field的权限，详见PDFViewCtrl.PDF.form.constant.Field_Flag。示例代码如下：

var pdfViewer = await pdfui.getPDFViewer();

var pdfdoc = await pdfViewer.getCurrentPDFDoc();

 

await pdfdoc.loadPDFForm();

let form = pdfdoc.getPDFForm ();

 

var control = {pageIndex:0,fieldName:'textField1',fieldType:PDFViewCtrl.PDF.form.constant.Field_Type.Text,rect:{left: 100,right: 250,top: 430,bottom: 330}};

var ret = await form.addControl(control.pageIndex,control.fieldName,control.fieldType,control.rect);

var field = await form.getField('textField1');

await field.setValue('123');

await field.setFlags(PDFViewCtrl.PDF.form.constant.Field_Flag.ReadOnly);