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:

• Open a specific SharinPix Form using a secure form token
• Pass additional parameters such as

  • Prefilled values
  • Enable comparative mode to make a comparative analysis
  • Relaunch an existing form / Open a form with the values of a previously submitted form

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

Universal Link Syntax

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

Component	Description
https://app.sharinpix.com/native_app/form	Entry 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)
4. Await Upload

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.

Example Universal Link with Prefill

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

Example Universal Link with Comparative View

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

Example Universal Link with Relaunch Parameter

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

4. Await Upload

A parameter used to show the upload progress of medias from different batches captured using the SharinPix mobile app after submitting a form.

To enable form await upload, you must include the await_upload=form in the universal link.

The following demonstrates how to add await upload parameter to a universal link:

https://app.sharinpix.com/native_app/form?token=<Your Form Token>&await_upload=form

Info: The await_upload parameter can also be configured at the organization level. For more information on how to perform this configuration, refer to the following article: ​Await upload in Mobile App Global Configuration

Best Practices

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