The Laserfiche software development kit (SDK) includes tools that allow you to create custom applications that access Laserfiche. The SDK includes the following components:
- Programming interfaces: These take the form of various dynamic link libraries (dll's) and Java .jar files. See the bin subfolder or JRA subfolder in the SDK installation path on your development machine. By default, the root installation path is "C:\Program Files \Laserfiche\SDK 10.4."
- Distribution tools: The SDK provides merge modules for those developers who need to create custom installations. See the msm subfolder in the SDK installation path on your development machine. By default, the path is "C:\Program Files\Laserfiche\SDK 10.4\msm." There is also an all-in-one runtime installation available for those who prefer a turn-key method for distributing the Laserfiche libraries. By default, the runtime installation is located in "C:\Program Files\Laserfiche\SDK 10.4\RuntimeInstallation."
- Documentation: The SDK also includes help files and sample projects. See the Docs subfolder in the SDK installation path for the help files. See the Samples subfolder for sample Visual Studio projects in Visual Basic.NET and C# that highlight common tasks.
LaserficheServerObjects (LFSO) supports Laserfiche Server 8.0 and later.
RepositoryAccess (RA), DocumentServices (DS), and JRepositoryAccess (JRA) support Laserfiche Server 8.2.1 and later.
Laserfiche Client Automation Tools (CAT) supports Laserfiche Client 9.0 and later.
ImageEnable supports Laserfiche Client 8.0 and later.
The Laserfiche SDK components rely on Microsoft technology. Make sure the following Microsoft redistributable packages are installed as needed.
The version 10 libraries and assemblies require Microsoft Visual C++ Redistributable for Visual Studio:
The Laserfiche SDK .NET 4.0 CLR components require .NET Framework 4.6.2:
The full Laserfiche SDK 10.4 installation can be installed side-by-side with your existing Laserfiche SDK 10, Laserfiche SDK 9.x, Laserfiche SDK 8.x, and Laserfiche Toolkit 8.0 installations.
The Laserfiche SDK 10.4 runtime installation package (LaserficheSDKRuntimeInstaller.exe) upgrades the existing runtime installation.
If you are in a Laserfiche Rio environment, make sure to update your Rio Primary license for SDK 10.4 before installing the SDK.
Laserfiche SDK 10.4 installation and runtime installation do not include the OCR dependencies. If your custom program requires the OCR engine, please make sure that a Laserfiche product that includes the OCR components is installed on the computer. The exception is that the runtime installation does include x64 OCR dependencies that are otherwise not available with other Laserfiche product installations.
The runtime installation package supports unattended installation. Pass in the -iacceptlicenseagreement parameter to hide the end user license agreement step and pass in the -s parameter to hide the progress bar. For example:
LaserficheSDKRuntimeInstaller -iacceptlicenseagreement -s
- If both the 10.2 and 10.4 Laserfiche SDK are installed, the 10.2 Laserfiche Client Automation "CustomButtonManager" Visual Basic sample project will fail to build. A workaround is to set SpecificVersion to True in CustomButtonManager.vbproj.
- Laserfiche Client Automation Tools (CAT) is fully accessible through .NET only. There is no COM interface. (92062)
- PdfExporter is not automatically COM-registered for 64-bit processes. Use the 64-bit version of the Microsoft Assembly Registration tool (regasm.exe) to manually register PdfExporter.dll on 64-bit machines. (108919)
Known issues and workarounds for using NetBeans with Maven:
- If building the sample project fails due to the error message: Cannot run program "cmd" (in directory "C:\Program Files\Laserfiche\SDK 10.4\Samples\JRASamples"): Malformed argument has embedded quote: "[YourNetBeansPath]\java\maven\bin\mvn.cmd" -Dmaven.ext.class.path="[YourNetBeansPath]\java\maven-nblib\netbeans-eventspy.jar" -Dfile.encoding=UTF-8 clean install, you will need to append -J-Djdk.lang.Process.allowAmbiguousCommands=true to netbeans_default_options in your netbeans.conf file.
- If executing a sample project fails due to the error message: Exception in thread "main" java.lang.NoClassDefFoundError: com/laserfiche/repositoryaccess/[ClassName], you will need to add the JRA-10.4.0.jar to the classpath. In the project's Properties > Actions > Run file via main(), in Set Properties, replace the exec.args with the following (or what your correct path is):
exec.args=-classpath %classpath;"C:\Program Files\Laserfiche\SDK 10.4\JRA\JRA-10.4.0.jar" ${packageClassName}
1014103 List of Changes for Laserfiche SDK 10.4.