?2013重慶軟航科技有限公司【保密】?2013重慶軟航科技有限公司【保密】在移動終端中使用Office文檔！V2.0版開發接口重慶軟航科技有限公司日期：2015.11TOC\o"1-3"\h\z第一章 軟件最終用戶許可協議 頁軟件最終用戶許可協議重要須知━請認真閱讀：本《最終用戶許可協議》（以下稱《協議》）是您（個人或單一實體）與我們之間有關NTKOOffice文檔控件移動版軟件產品的法律協議。本“軟件產品”包括計算機軟件，并可能包括相關媒體、印刷材料，和“聯機”或電子文檔（“軟件產品”）。本“軟件產品”還包括對我們提供給您的原“軟件產品”的任何更新和補充資料。任何與本“軟件產品”一同提供給您的并與單獨一份最終用戶許可證相關的軟件產品是根據那份許可協議中的條款而授予您。您一旦安裝、復制、下載、訪問或以其它方式使用“軟件產品”，即表示您同意接受本《協議》各項條款的約束。如您不同意本《協議》中的條款，請不要安裝或使用“軟件產品”。NTKOOffice文檔控件移動版是受版權保護的。如果您得到的是未注冊版本，您還沒有獲得運行授權。請在測試完成之后從您的機器中刪除。如果您得到的是注冊版本，您可以在授權協議許可的范圍內使用本軟件。您不能分發，銷售，以及非法破解本軟件。也不能超出協議許可的范圍使用本軟件。否則，將被視為侵犯了我們的知識產權。對反向工程(ReverseEngineering)、反向編譯(Decompilation)、反匯編(Disassembly)的限制。您不得對本“軟件產品”進行反向工程、反向編譯(decompile)或反匯編(disassemble)，但盡管有這項限制，如適用法律明示允許上述活動，則不在此限。另外，我們不對您在使用此軟件的過程中對您的機器或者數據造成的損失負責。功能介紹（Features）功能簡介NTKOOffice文檔控件移動版實現了在移動端和PC端以格式一致的展現方式來閱讀編輯OFFICE文檔。通過調用移動編輯中間件提供的相關接口，可以非常容易的實現在移動平臺上對辦公文檔的閱讀和編輯。我們同時提供一套便利方法，可以打開OA及其它文檔管理系統服務器上的文檔，控制文檔的審閱，對文檔進行簽批，并保存文檔到遠程服務器上，用戶可以方便的集成到自己的移動OA系統中，和自己現有的移動產品集成在一起。可以運行在Android4.1以上移動平臺之中，支持常用OFFICE文檔的編輯如WORD、EXCEL、PDF、POWERPOINT文件等。使用NTKOOFFICE文檔控件移動版后，移動終端除安裝我司提供的必要組件外，無須再安裝其它移動OFFICE軟件。我們提供了一套非常簡潔的集成最佳實踐，輕松搞定集成，使業務移動化，技術保障完備，提供原生、混合模式集成等多套解決方案，功能接口快速增長，涵蓋多種使用場景。V3.0版本的新功能新增支持打開XPS及圖片文件；新增參數控制PDF簽批筆款及顏色；新增查看同一PDF文件時記憶上次查看到的頁數。詳細功能列表打開服務器上文檔打開服務器上文檔，支持Word、Excel、PPT、PDF、XPS、TIFF、圖片等文檔打開移動終端設備上文檔支持打開移動終端上的Word、Excel、PPT等文檔保存文檔到服務器支持將打開的文件保存到服務器痕跡保留可以通過編程，控制在線打開的文件默認進入留痕狀態。修訂用戶設置支持設置修訂用戶名只讀方式打開支持打開Word、Excel、PDF以只讀方式打開廣泛的操作系統，Web服務器，數據庫支持Web端支持Windows,Linux,Unix等各種操作系統；支持IIS，Domino，Websphere，Apache等所有后臺WEB服務器類型，支持Db2，Oracle，MySQL，SQLServer等各種常用數據庫。支持在提交編輯文檔的同時，提交表單的其它數據采用我們獨創的“智能提交”技術，讓您在提交編輯文檔的同時，提交表單的其它數據。這可以讓您更加快速的集成現有的應用程序，或者創建新的應用程序。支持簡潔高效的編程接口可使用Javascript及java代碼對組件進行編程。使用NTKOOffice文檔控件移動版，可以大大縮短整個系統的開發時間，降低系統的開發成本，提高產品的質量和用戶體驗。

……需要的軟件正確運行本軟件需要移動終端為4.1以上操作系統，安裝我司提供的客戶端組件。支持的Web服務器支持所有的支持HTTP/1.1標準的Web服務器。集成步驟導入aar歸檔庫（AndroidStudio）AndroidStudio自帶了可以導入arr歸檔庫的功能，這里以AS開發平臺為例，該歸檔庫需要在jdk1.7或1.7以上版本運行，SDK的最小版本號為16，集成測試時應用包名最好是com.ntko.app.office。為了適配不同CPU構架的移動設備，除了主要的歸檔庫library.support.v3-release.aar外，對于PDF文件的閱讀，提供了支持不同CPU構架的歸檔庫，可根據用戶不同CPU構架制作不同的app，當然也可以全部引入。在項目中，點擊項目結構->SDK，點擊+號，如下圖所示：然后選擇“Import.JAR/.ARRPackage”->下一步->選擇arr歸檔庫的路徑，如下圖所示：點擊完成，按照以上步驟將需要的其余aar庫導入到項目中后，為主項目添加Moduledependency，選中導入的歸檔庫即可，如下圖所示：然后為主項目添加所需依賴庫，這些依賴庫也可通過下載后直接引用添加，如下圖所示：到這里所需的依賴就導入配置好了。注意：async的jar包必須要用1.4.9或以上版本。連接文檔服務在安卓應用程序需要調用打開操作文檔的Activity中的onCreate方法里調用DocumentsAgent類的連接方法連接文檔服務。protectedvoidonCreate(BundlesavedInstanceState){super.onCreate(savedInstanceState);setContentView(R.layout.main);DocumentsAgent.connect(this,"產品序列號");}構建JavascriptInterface類可在安卓應用程序中自建一個類調用類庫提供的相應接口并設置參數，以下類中的如打開服務器文檔方法openDocFromUrl可自定，也可自定義參數數量，打開文件的相關變量如文件名、打開文件地址、保存文件地址都是通過Params類中的相關方法和屬性設置：publicclassMobileOfficeWebInterface{@JavascriptInterfacepublicvoidopenDocFromUrl(Stringfilename,StringdownUrl,StringuploadUrl){Paramsparams=newParams(Params.SourceType.REMOTE); params.setDocType(Params.DOC_TYPE_MSO);//設置臨時文件后綴params.setDocumentRemoteAddress(downUrl);//設置文件下載地址params.setDocumentUploadAddress(uploadUrl);//設置文件保存地址params.setDocumentTitle(filename);//設置打開文檔后顯示文件窗口上的文件名及保存后的文件名//read閱讀模式>Params.MSO_DOC_MODE_READ//edit編輯模式>Params.MSO_DOC_MODE_NORMAL//handwrite手寫模式>Params.MSO_DOC_MODE_SIGNATUREparams.setDocMode(Params.MSO_DOC_MODE_NORMAL);//設置文件讀寫模式Params.MSO_REVISE_MODE=true;//設置是否啟用修訂params.setReviseUser("ntkouser");//設置修訂用戶//CustomFieldsfields=newCustomFields();//自定義表單參數//fields.fieldsList.add(newCustomFieldKeyPair("%%Detach",filename));//添加表單參數key，value//fields.fieldsList.add(newCustomFieldKeyPair("__Click","0"));//params.setCustomFormFields(fields);//設置自定義表單參數DocumentsAgent.editWord(params);//調用類庫提供的打開word文件方法}}重寫安卓onDestroy方法，銷毀文檔鏈接@OverrideprotectedvoidonDestroy(){super.onDestroy();DocumentsAgent.destroy(this);}WEB端獲取的文件域標識上傳文件到后臺的處理程序中，移動端提交的文件的文件域標識為fileUpload。if(item.getFieldName().equals("fileUpload")){Filefile=newFile(request.getRealPath("/files"),filename);FileOutputStreamfos=newFileOutputStream(file);longfileSize=Streams.copy(stream,fos,true);System.out.println("文檔大小"+fileSize+"");out.write("FileName:"+filename+"\nFileSize:"+fileSize+"bytes\nServerPath："+file.getPath());msg="保存成功!";}主要屬性參考NTKOOFFICE文檔控件移動版所有屬性調用的類為Params，直接通過該類調用，在打開方法前設置。常用屬性MSO_REVISE_MODE（已過時）說明：布爾型；是否進入修訂模式。語法：設置：Params.MSO_REVISE_MODE={true|false};DO_NOT_UPLOAD_IF_READONLY說明：布爾型；設置文件以只讀打開時，是否也需要上傳到服務器。語法：設置：Params.DO_NOT_UPLOAD_IF_READONLY=false;false：文件以只讀打開時，也會上傳到服務器上；true：文件以只讀打開時不上傳到服務器。SourceType說明：實例化參數對象時需要設置該屬性，標識新建、打開遠程服務器或打開本地文件。語法：設置：Params.SourceType.LOCAL打開本地文件；Params.SourceType.REMOTE打開遠程服務器文件；Params.SourceType.NEW新建文件。主要方法參考NTKOOFFICE文檔控件移動版設置相關參數調用的類為Params，實例化該類獲取對象調用設置相關屬性。與文檔打開、新建或保存一起使用，在打開、新建或保存方法前調用在打開方法中設置相關屬性，調用前需實例化該類獲取對象，該對象中需要傳參數根據調用的資源操作方式不同，傳不同參數。打開移動終端本地文件實例化代碼如下：Paramsparams=newParams(Params.SourceType.LOCAL);打開遠程服務器上文件實例化代碼如下：Paramsparams=newParams(Params.SourceType.REMOTE);新建文件實例化代碼如下：Paramsparams=newParams(Params.SourceType.NEW);連接文檔服務Connect語法：DocumentsAgent.connect(啟動文檔服務的Activity,產品序列號);例：DocumentsAgent.connect(this,"12345678912345678");功能：設置文件打開后臨時文件的后綴。返回值：無返回值啟動文檔服務的Activity設置為OFFICE文件類型產品序列號String類型這里需要天雪的產品序列號為17位的。參數設置相關方法setDocType語法：params.setDocType(Params.DOC_TYPE_MSO);功能：設置文件打開后臨時文件的后綴。返回值：無返回值Params.DOC_TYPE_MSO設置為OFFICE文件類型Params.DOC_TYPE_PDF設置為PDF文件類型Params.DOC_TYPE_IMG設置為圖片文件類型Params.DOC_TYPE_XPS設置為XPS文件類型setDocumentTitle語法：params.setDocumentTitle("新建Word文檔");功能：設置打開文件窗口中顯示的文件名及保存文件名。返回值：無返回值setDocumentRemoteAddress語法：params.setDocumentRemoteAddress(REMOTE_MSO_PATH);功能：設置打開文件的URL返回值：無返回值注意：若為新建或打開本地文件不需要設置該參數。setDocumentUploadAddress語法：params.setDocumentUploadAddress(REMOTE_UPLOAD_PATH);功能：設置上傳文件URL。返回值：無返回值注意：如果不需要保存文件，該參數設置為空。setDocumentLocalAddress語法：params.setDocumentLocalAddress(Environment.getExternalStorageDirectory()+File.separator+"ntko.pdf");功能：設置打開本地文件的文件路徑。返回值：無返回值注意：此方法僅適用于設置打開本地文件的路徑。setUploadOptions語法：setUploadOptions(newUploadOptions(UploadOptions.Activation.ON_DOCUMENT_CLOSED,true))功能：當禁用了工具欄的保存及另存為按鈕后，調用該方法并設置為true后，才能觸發保存操作并保存文件到服務器。setReviseUser語法：params.setReviseUser("ntkouser");功能：設置打開word后的痕跡用戶名。返回值：無返回值注意：此方法需結合MSO_REVISE_MODE該屬性使用，設置痕跡模式后才有作用，屬性設置見HYPERLINKMSO_REVISE_MODE。setDocMode語法：params.setDocMode(Params.MSO_DOC_MODE_NORMAL);功能：設置文件打開后默認的讀寫模式。返回值：無返回值Params.MSO_DOC_MODE_NORMAL缺省編輯模式Params.MSO_DOC_MODE_READONLY只讀模式Params.MSO_DOC_MODE_SIGNATURE簽批模式注意：簽批功能只支持Word及PDF文檔。setOfficeVersion語法：params.setOfficeVersion(Params.OfficeVersion.LATEST);功能：設置打開文件后文件的后綴版本，03、07及以上版本office，設置成相應版本后綴后，文件上傳到服務器上時，服務器接受到的文件就是設置的相應后綴的文件。返回值：無返回值Params.OfficeVersion.LATEST設置文件后綴版本為2007及以上版本Params.OfficeVersion.COMPATIBLE缺省設置文件后綴版本為2003版本setPdfReviseToolsVisibility語法：params.setPdfReviseToolsVisibility(0);功能：設置是否顯示PDF文件閱讀窗口工具欄。返回值：無返回值0不顯示非0缺省顯示注意：該功能只PDF文檔。setDocumentUploadFailedRetryTimes語法：params.setDocumentUploadFailedRetryTimes(3);功能：設置文檔上傳失敗重試次數。fieldsList.add語法：CustomFieldsfields=newCustomFields();fields.fieldsList.add(newCustomFieldKeyPair("sendFileTime",“2015.4.22”));key,value鍵值對應。功能：設置自定義表單數據。返回值：無返回值setCustomFormFields語法：params.setCustomFormFields(fields)功能：設置自定義表單參數。返回值：無返回值注意：該方法中的fields設置方法參考HYPERLINKfieldsList.add打開OFFICE文件窗口UI設置相關方法NTKOOFFICE文檔控件移動版設置打開OFFICE文件窗口相關方法調用的類為EditTable，實例化該類獲取對象調用設置相關屬性。在調用打開文檔方法前調用。EditTabletable=newEditTable();……………………DocumentsAgent.sendUIParams(table);getSave語法：table.getSave().setEnable(false);功能：啟用或禁用保存按鈕。true為啟用，false為禁用。getSaveAs語法：table.getSaveAs().setEnable(false);功能：啟用或禁用工具欄另存為到本地的按鈕。true為啟用，false為禁用。getPrint語法：table.getPrint().setEnable(false);功能：啟用或禁用工具欄打印按鈕。true為啟用，false為禁用。getShare語法：table.getShare().setEnable(false);功能：啟用或禁用工具欄分享按鈕。true為啟用，false為禁用新建、打開和保存文檔相關方法createWord語法：DocumentsAgent.createWord(params);功能：創建一個新word文檔。返回值：無返回值createExcel語法：DocumentsAgent.createExcel(params);功能：創建一個新Excle表格返回值：無返回值。createPresentation語法：DocumentsAgent.createPresentation(params);功能：創建一個演示文稿editWord語法：DocumentsAgent.editWord(params);功能：查看或編輯word文件。editExcel語法：DocumentsAgent.editExcel(params);功能：查看或編輯Excel文件。editPDFDocument語法：DocumentsAgent.editPDFDocument(params);功能：查看PDF文件。editPresentation語法：DocumentsAgent.editPresentation(params);功能：編輯PowerPoint演示文稿。openImageFile語法：DocumentsAgent.openImageFile(fileurl,filename,filetype);功