Launching a Form on the mobile app (link syntax)

Overview

The SharinPix Form supports universal links that allow you to launch a form directly inside the SharinPix Mobile App from any external application—such as the Salesforce Mobile App, Field Service Lightning App, or any custom mobile or web application.

Universal links provide a simple, URL-based way to:

This document explains how the universal link works, its syntax, and all the optional parameters supported.

All SharinPix Forms opened in the mobile app use the following base URL:

https://app.sharinpix.com/native_app/form?token=<sharinpix-form-token>&<parameter1>=<value1>&<parameter2>=<value2>&....

Components

ComponentDescription
https://app.sharinpix.com/native_app/formEntry point used by the SharinPix Mobile App to recognize and open a form
token=<sharinpix-form-token>Required. A secure token to identify the form instance
&form=<formURL>Only required when using generic tokens
&<parameter>=<value>Optional additional parameters

Understanding the SharinPix Form Token

A token is a secure identifier used by SharinPix to authenticate and open forms through a universal link.
Without a valid token, the universal link cannot launch a form in the SharinPix Mobile App.

You can generate a token that is linked to one specific form.

  • This type of token is intended for one-to-one usage
  • The universal link will always open the exact form

You can generate this token using the link below: Generate Token for a Form

Example of universal Link:

https://app.sharinpix.com/native_app/form?token=<sharinpix-form-token>

Note: Generic Token (Advanced / Flexible Use Case)

In addition to single-form tokens, SharinPix also supports generic tokens.

What is a Generic Token?

A generic token is a reusable token that can open multiple different forms.

Instead of being tied to a specific form, the form is defined dynamically using an additional URL parameter:

&form=<formTemplateURL>

Example: One Token, Multiple Forms

https://app.sharinpix.com/native_app/form?token=<sharinpix-form-token>&form=formTemplateURL1
https://app.sharinpix.com/native_app/form?token=<sharinpix-form-token>&form=formTemplateURL2

Each link opens a different form, even though the same token is used.

Parameters

Additional parameters can be used to access additional features when using the SharinPix Form. The features that can be used are:

  1. Prefilled values

  2. Comparative

  3. Re-launch (Refill)

1. Prefilled Values

SharinPix Form can automatically retrieve and display values from related Salesforce records. This feature, known as prefill functionality, allows form fields to be dynamically populated with data from the record where the form is launched. 

Configuration Steps

  1. Set up in Form Builder
    The prefill configuration must first be defined within the SharinPix Form Builder.

  2. Construct the Deeplink
    Once configured, you must construct the deeplink (SharinPix Form URL) with the values to prefill.

Prefill Parameter

To enable the prefill option, you must use the pv parameter followed by the API name of the form element.
     Syntax:  pv<ElementApiName>=<Encoded Prefill Value>

The value must be URL-encoded before being passed.

The following example shows a universal link that pre-fills the Name field with John Doe:
https://app.sharinpix.com/native_app/form?token=<Your Form Token>&pvName=John%20Doe

In this case:

  • pvName = API name of the form element

  • John%20Doe = URL-encoded value for “John Doe”

Multiple Prefills Using Formula Fields

If you need to prefill multiple fields in the same form, you can concatenate the parameters in a Salesforce Formula field.
     Formula Example:  "pvName=" & TEXT(Name) & "&pvAddress=" & TEXT(Address)

Note:

When constructing deeplinks, ensure that all values are properly URL-encoded before being passed. This prevents unexpected behavior and guarantees that special characters are interpreted correctly.

To encode a field value in Salesforce, you can use the following formula:
SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(FieldName__c, '%', '%25'), '+', '%2B'), '&', '%26'), '#', '%23'), '?', '%3F'), ' ', '%20'), '_', '%5F'), '-', '%2D'))

     Universal Link Example with Formula Field:
     https://app.sharinpix.com/native_app/form?token=<Your Form Token>&sp_params={!Formula_Field__c} 

This way, you can dynamically pass several prefill values at once using a single formula field.

Info: 
For more information on the Prefill Feature, please follow the article below: Default or Prefill Values

2. Comparative Mode

The comparative mode enables comparison of previous and current form states. This is especially valuable for follow-up forms, recurring inspections, or progress tracking, where referencing past inputs helps provide updated or more accurate information.

Comparative Parameter

To enable the comparative option, you must include the ref_response_url parameter in the universal link.
     Syntax:  ref_response_url=latestFormResponse 

The following universal link demonstrates how to add the comparative parameter to a universal link:
https://app.sharinpix.com/native_app/form?token=<Your Form Token > &ref_response_url=latestFormResponse 

Info:
For more information on the Comparative Feature, please follow the article below: Initial/Follow-up Form Responses (Comparative)

3. Relaunch (Refill)

Reopens an existing submitted form with previous answers preloaded.

Relaunch Parameter

To enable the relaunch option, you must include the form_response_url parameter in the universal link.
     Syntax:  form_response_url=latestFormResponse 

The following universal link demonstrates how to add the relaunch parameter to a universal link:
https://app.sharinpix.com/native_app/form?token=<Your Form Token > &form_response_url=latestFormResponse

Info:
For more information on the Relaunch Feature, please follow the article below: Reopen A Previously Submitted SharinPix Form Using URL Parameters

Best Practices 

  • Always URL-encode parameter values
  • Use generic tokens when managing multiple forms

0 Comments

Add your comment

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.