The Open PDF action allows PDF files on the device to be opened through the app. Users can access PDF documents quickly and easily. For example, a user manual, invoice or contract can be presented to the user as a PDF. Action is compatible on both web and mobile platforms.
Technical Specifications
PDF Viewing: Opens PDF files with the device's default PDF viewer.
Page Setup Selection: PDF can be opened on the current page (Current Page) or in a new tab (New Tab).
Dynamic Data Usage: The PDF file URL can be fixed or dynamic.
Web and Mobile Compatibility: Compatible on all platforms.
Open PDF Implementation Steps
Adding Open PDF Action to the Project
Log in to the Kuika platform and open the project you are working on.
Open the Properties panel on the right panel in the UI Design module.
Select an appropriate trigger action (event) from the+ ADD ACTION drop-down menu, such as Initial Actions, OnClick, OnBlur → Device → Open PDF.
Configuring Open PDF Parameters
You can open the PDF file by configuring the following fields in the drop-down menu:
PDF URL
Tip: String
Necessity: Yes
Description: Specify the URL of the PDF file to open.
Input: For example, dynamic or fixed values can be used to specify the URL. Data can be imported into this field primarily from data sources such as Action Result. Other sources such as Method Input, Current, Screen Input, Fixed or Component can also be used. These categories can be defined by selecting them via Symbol Picker.
Open As
Type: Enum
Necessity: Yes
Description: Select in which page structure the PDF file will be displayed.
Options:
Current Page: PDF opens on the current page.
New Tab: PDF opens in a new tab.
Input: By selecting this parameter, the user can specify the way the PDF file is opened. Data can be imported into this field primarily from data sources such as Action Result. Other sources such as Method Input, Current, Screen Input, Fixed or Component can also be used. These categories can be defined by selecting them via Symbol Picker.
Completing the Registration Process
After configuring your parameters, click on the SAVE button to save your changes. This step ensures that the Open PDF action is successfully added.
Usage Scenario: User Viewing Manual in PDF Format
A user wants to access a document presented in PDF format by clicking on the “User Manual” button in the application. In this scenario, the user is shown a PDF file integrated into the app in a quick and convenient way. The file is opened with the device's default PDF viewer application and the user can review the document in detail.
Add Open PDF Action to PDF Display Area
Log in to the Kuika platform.
Open the project you are working on from the Apps screen.
Switch to the UI Design module.
Add a Button (for example “Open Manual”) component from the Elements panel on the left side.
Select the button and click the + ADD ACTION menu from the Properties panel on the right.
Select the OnClick → Device → Open PDF action.
Configuring the Open PDF Action
In the window that opens, fill in the following fields:
PDF URL: “https://example.com/kullanimkilavuzu.pdf”
Open As: “Current Page” (or “New Tab” - depending on user experience)
Complete the configuration by clicking the SAVE button.
User Experience after PDF Opening
When the user presses the “Open Manual” button:
The app opens the PDF file you specified with the device's default PDF viewer.
The user can read the document in full screen, zoom in or switch between pages.
If the file was opened in a new tab, the user can return to the application after reviewing the document.
Open PDF Action Advanced Customizations
Dynamic PDF Redirection: By making the PDF URL parameter dynamic, you can open different files. It is useful for situations where the user selects the PDF file they want to see.
Page Structure Selection: With the Open As parameter, you can decide in which page structure the PDF file will be opened. For example, with the Current Page option you can make it load on the current page, with the New Tab option you can make it open in a new tab.
Technical Risks and Controls
Invalid PDF URL: Make sure that the PDF URL parameter points to a valid file path. Invalid URLs can lead to error messages.
Incompatible PDF Formats: Check that the PDF file is in the format supported on the device. Incompatible formats may not open.
Performance Issues: Pay attention to the size of PDF files. Loading PDF files that are too large can negatively affect the performance of the application.
The Open PDF action is an efficient and user-friendly way to present PDF documents directly to the user within the application. Dynamic URL support and different opening options make it suitable for flexible usage scenarios. It improves the user experience with fast opening of documents.
