Difference between revisions of "Object URL Syntax"

From SmartWiki
Jump to: navigation, search
m (→‎Usage Examples)
(→‎Usage Examples)
 
(31 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
=Overview=
 
=Overview=
−
We’ve introduced the following new syntax to dynamically resolve URLs for various system objects and actions: <code>@ssurl(objecttype,action,identifier)@</code>. This syntax allows configuration settings to reference system objects through variables.
+
Designed for internal staff and partners, we’ve introduced a syntax that dynamically resolves URLs for various system objects and actions. This allows configuration teams to reference system objects using variables, streamlining setup when cloning new systems. Previously, configuration teams had to manually adjust URLs due to unique attributes like IDs which differ in cloned systems. Now, with this new syntax, links to assets such as login and signup pages, report charts, submit buttons, and portal sections will automatically point to the correct system asset after cloning without requiring manual intervention.
  
 
=Syntax=
 
=Syntax=
Line 7: Line 7:
 
<code>@ssurl(objecttype,action,identifier)@</code>
 
<code>@ssurl(objecttype,action,identifier)@</code>
  
−
The "identifier" parameter may consist of more than 1 object. Multiple objects can be separated by using double semicolons ( ;; ) as a delimiter.
+
* The "objecttype" is the type of object being referenced, example "Signup" for a registration page
−
 
+
* The "Action" is the thing being done or opened, example “View” or "Creatlevelone"
−
For some objects, the system enforces unique naming. For example, if you create an autoloader named "MyAutoloader", it is possible to create another autoloader also named "MyAutoloader". In these situations, we will simply return the object with lower ID.
+
* The "identifier" is the name of the thing being referenced, example the name you have given a sign-up page or an autoloader. If there are multiple identifier objects, separate them using double semicolons ( ;; ) as a delimiter. Note configuration teams should ensure all objects should have a unique identifier (name). if you create two autoloaders with the same name the system will only return the autoloader with the lower ID.
−
 
 
−
Configuration should avoid these scenarios to begin with.
 
  
 
==Usage Examples==
 
==Usage Examples==
−
See table below: 
+
See the table below for supported variable syntax.
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 22: Line 20:
 
!|<code>action</code>
 
!|<code>action</code>
 
!|<code>identifier</code>
 
!|<code>identifier</code>
−
!|Example w/ resolved result
+
!|Examples with Resolved Results
−
!|Notes
 
 
|-
 
|-
−
||Row 1, Cell 1
+
||Signup Page
−
||Row 1, Cell 2
+
||signup
−
||Row 1, Cell 3
+
||view
−
||Row 1, Cell 4
+
||Signup Page Name
−
||Row 1, Cell 5
+
 
−
||Row 1, Cell 6
+
||'''User Signup Page Example: '''<code>@ssurl(signup,view,pagename)@</code>
 +
'''Result:''' /s_signup.jsp?token=XVtQC1oGZlBfRxddXxdSQUlSZ1R9Ew%3D%3D
 +
 
 +
 
 +
'''Organization Signup Page Example:''' <code>@ssurl(signup,view,pagename)@</code>
 +
 
 +
'''Result:''' /s_csignup.jsp?token=XVtQHUUGZV1YShBFQhdQXlZSZVxy
 +
 
 +
 
 +
'''Single User + Organization Page Example:''' <code>@ssurl(signup,view,pagename)@</code>
 +
 
 +
'''Result:''' /s_csignup.jsptoken=XVtQHUUGbFxRQhFaXxdSQUlSZ1R9HQ%3D%3D&ptoken=XVtQC1oGZlBeQBNZXxdSQUlTYFZzEg%3D%3D
 +
 
 +
'''Multiple Users + Organization Page Example: '''<code>@ssurl(signup,view,pagename)@</code>
 +
 
 +
'''Result:''' /s_csignup.jsp?token=XVtQHUUGbFxcRhRRXxdSQUlSZ1R9Eg%3D%3D
 +
 
 
|-
 
|-
−
||Row 2, Cell 1
+
||
−
||Row 2, Cell 2
+
UTA - Main List View
−
||Row 2, Cell 3
+
 
−
||Row 2, Cell 4
+
||uta
−
||Row 2, Cell 5
+
||listview
−
||Row 2, Cell 6
+
||UTA Name
 +
||
 +
<code>@ssurl(uta,listview,utaname)@</code>
 +
 
 +
'''Result:'''  /iface/uta/uta_list.jsp?appid=102161
 +
 
 
|-
 
|-
−
||Row 3, Cell 1
+
||
−
||Row 3, Cell 2
+
UTA - Create Level One
−
||Row 3, Cell 3
+
 
−
||Row 3, Cell 4
+
||uta
−
||Row 3, Cell 5
+
||createlevelone
−
||Row 3, Cell 6
+
||UTA Name
 +
||
 +
<code>@ssurl(uta,createlevelone,utaname)@</code>
 +
 
 +
'''Result:''' /Apps/app_editopportunity.jsp?appid=102161&opportunityid=0
 +
 
 
|-
 
|-
−
||Row 4, Cell 1
+
||UTA - Template Page
−
||Row 4, Cell 2
+
||uta
−
||Row 4, Cell 3
+
||templatepage
−
||Row 4, Cell 4
+
||UTA Name, Type Name
−
||Row 4, Cell 5
+
||
−
||Row 4, Cell 6
+
<code>@ssurl(uta,templatepage,utaname;;typename)@</code>
 +
 
 +
'''Result:''' /ex/ex_Apppage.jsp?token=HwwPRhMGZVla
 +
 
 
|-
 
|-
−
||Row 5, Cell 1
+
||UTA - Impact Quadrant
−
||Row 5, Cell 2
+
||uta
−
||Row 5, Cell 3
+
||impactquadrant
−
||Row 5, Cell 4
+
||UTA Name, Quadrant Name
−
||Row 5, Cell 5
+
||
−
||Row 5, Cell 6
+
<code>@ssurl(uta,impactquadrant,utaname;;quadrantname)@</code>
 +
 
 +
'''Result:''' /Apps/db/db_impact.jsp?impactid=@Hw0ERBkfbV5bQRRQRh8~
 +
 
 
|-
 
|-
−
||Row 6, Cell 1
+
||Report
−
||Row 6, Cell 2
+
||report
−
||Row 6, Cell 3
+
||view
−
||Row 6, Cell 4
+
||Report Name
−
||Row 6, Cell 5
+
||
−
||Row 6, Cell 6
+
<code>@ssurl(report,view,reportname)@</code>
 +
 
 +
'''Result:'''  /userreport/ur_openreport.jsp?reportid=44372
 +
 
 
|-
 
|-
−
||Row 7, Cell 1
+
||Report Chart
−
||Row 7, Cell 2
+
||reportchart
−
||Row 7, Cell 3
+
||view
−
||Row 7, Cell 4
+
||Report Name, Chart Name
−
||Row 7, Cell 5
+
||
−
||Row 7, Cell 6
+
'''Client-Side Chart Example: '''<code>@ssurl(reportchart,view,reportname;;chartname)@</code>
 +
 
 +
'''Result:''' /ex/ex_highchart.jspenc=1&chartid=H3ZfFAVpLgcxAVQ8GFAMERALMTY1QRYeH2JdUEJB&reportid=f1oJDE4bexInFm8TRRYqIxEmPA8rbTAKH2dZUkVG&rootcompany=GGZzFn0FZhk8JRocHGdIBBI7EzUSYAcDH2JcUg~~
 +
 
 +
 
 +
'''Server-Side Chart Example:'''
 +
<code>@ssurl(reportchart,view,reportname;;chartname)@</code> 
 +
 
 +
'''Result:''' /servlet/wChart?width=300&height=200&codedid=YnoRF35kEjwDHm0DMUQMNQ0kZwcdHTgRH2JdUEJC
 +
 
 
|-
 
|-
−
||Row 8, Cell 1
+
||Report Dashboard
−
||Row 8, Cell 2
+
||dashboard
−
||Row 8, Cell 3
+
||view
−
||Row 8, Cell 4
+
||Dashboard Name
−
||Row 8, Cell 5
+
||
−
||Row 8, Cell 6
+
<code>@ssurl(dashboard,view,dashboardname)@</code>
 +
 
 +
'''Result:''' /userreport/ur_viewdb.jsp?dashbid=2348
 +
 
 
|-
 
|-
−
||Row 9, Cell 1
+
||SmartFolder (View)
−
||Row 9, Cell 2
+
||smartfolder
−
||Row 9, Cell 3
+
||view
−
||Row 9, Cell 4
+
||SmartFolder Name
−
||Row 9, Cell 5
+
||
−
||Row 9, Cell 6
+
<code>@ssurl(smartfolder,view,foldername)@</code>
 +
 
 +
'''Result:''' /s_editresource.jsp?display=1&resourceid=68826
 +
 
 
|-
 
|-
−
||Row 10, Cell 1
+
||SmartFolder - View (Internet Enabled)
−
||Row 10, Cell 2
+
||smartfolder
−
||Row 10, Cell 3
+
||viewinet
−
||Row 10, Cell 4
+
||SmartFolder Name
−
||Row 10, Cell 5
+
||
−
||Row 10, Cell 6
+
<code>@ssurl(smartfolder,viewinet,foldername)@</code>
 +
 
 +
'''Result:''' /files/113/68827/169542folderinet/
 +
 
 
|-
 
|-
−
||Row 11, Cell 1
+
||Autoloader - Dropbox
−
||Row 11, Cell 2
+
||autoloader
−
||Row 11, Cell 3
+
||dropbox
−
||Row 11, Cell 4
+
||Autoloader Name
−
||Row 11, Cell 5
+
||
−
||Row 11, Cell 6
+
<code>@ssurl(autoloader,dropbox,autoloadername)@</code>
 +
 
 +
'''Result:''' /Archive/al_upload.jsp? loaderid=BEUFe2sDA1d7aV1cQUYBRWUDdgVhe2tRCwUDBg~~
 +
 
 
|-
 
|-
−
||Row 12, Cell 1
+
||AI Insight
−
||Row 12, Cell 2
+
||aiinsight
−
||Row 12, Cell 3
+
||view
−
||Row 12, Cell 4
+
||Name
−
||Row 12, Cell 5
+
||
−
||Row 12, Cell 6
+
<code>@ssurl(aiinsight,view,name)@</code>
−
|-
+
 
−
||Row 13, Cell 1
+
'''Result:''' /AI/ai_workingwithai.jsp?token=%40HwwMTxwbeFhFQhFFQRxZQVVTZFV1G3BhHQ~~
−
||Row 13, Cell 2
+
 
−
||Row 13, Cell 3
 
−
||Row 13, Cell 4
 
−
||Row 13, Cell 5
 
−
||Row 13, Cell 6
 
 
|}
 
|}
 +
 +
[[Category: Process Drivers]]

Latest revision as of 15:12, 26 March 2025

Overview

Designed for internal staff and partners, we’ve introduced a syntax that dynamically resolves URLs for various system objects and actions. This allows configuration teams to reference system objects using variables, streamlining setup when cloning new systems. Previously, configuration teams had to manually adjust URLs due to unique attributes like IDs which differ in cloned systems. Now, with this new syntax, links to assets such as login and signup pages, report charts, submit buttons, and portal sections will automatically point to the correct system asset after cloning without requiring manual intervention.

Syntax

The general format of the syntax is the following:

@ssurl(objecttype,action,identifier)@

  • The "objecttype" is the type of object being referenced, example "Signup" for a registration page
  • The "Action" is the thing being done or opened, example “View” or "Creatlevelone"
  • The "identifier" is the name of the thing being referenced, example the name you have given a sign-up page or an autoloader. If there are multiple identifier objects, separate them using double semicolons ( ;; ) as a delimiter. Note configuration teams should ensure all objects should have a unique identifier (name). if you create two autoloaders with the same name the system will only return the autoloader with the lower ID.

Usage Examples

See the table below for supported variable syntax.

Description objecttype action identifier Examples with Resolved Results
Signup Page signup view Signup Page Name User Signup Page Example: @ssurl(signup,view,pagename)@

Result: /s_signup.jsp?token=XVtQC1oGZlBfRxddXxdSQUlSZ1R9Ew%3D%3D


Organization Signup Page Example: @ssurl(signup,view,pagename)@

Result: /s_csignup.jsp?token=XVtQHUUGZV1YShBFQhdQXlZSZVxy


Single User + Organization Page Example: @ssurl(signup,view,pagename)@

Result: /s_csignup.jsptoken=XVtQHUUGbFxRQhFaXxdSQUlSZ1R9HQ%3D%3D&ptoken=XVtQC1oGZlBeQBNZXxdSQUlTYFZzEg%3D%3D

Multiple Users + Organization Page Example: @ssurl(signup,view,pagename)@

Result: /s_csignup.jsp?token=XVtQHUUGbFxcRhRRXxdSQUlSZ1R9Eg%3D%3D

UTA - Main List View

uta listview UTA Name

@ssurl(uta,listview,utaname)@

Result:  /iface/uta/uta_list.jsp?appid=102161

UTA - Create Level One

uta createlevelone UTA Name

@ssurl(uta,createlevelone,utaname)@

Result: /Apps/app_editopportunity.jsp?appid=102161&opportunityid=0

UTA - Template Page uta templatepage UTA Name, Type Name

@ssurl(uta,templatepage,utaname;;typename)@

Result: /ex/ex_Apppage.jsp?token=HwwPRhMGZVla

UTA - Impact Quadrant uta impactquadrant UTA Name, Quadrant Name

@ssurl(uta,impactquadrant,utaname;;quadrantname)@

Result: /Apps/db/db_impact.jsp?impactid=@Hw0ERBkfbV5bQRRQRh8~

Report report view Report Name

@ssurl(report,view,reportname)@

Result:  /userreport/ur_openreport.jsp?reportid=44372

Report Chart reportchart view Report Name, Chart Name

Client-Side Chart Example: @ssurl(reportchart,view,reportname;;chartname)@

Result: /ex/ex_highchart.jspenc=1&chartid=H3ZfFAVpLgcxAVQ8GFAMERALMTY1QRYeH2JdUEJB&reportid=f1oJDE4bexInFm8TRRYqIxEmPA8rbTAKH2dZUkVG&rootcompany=GGZzFn0FZhk8JRocHGdIBBI7EzUSYAcDH2JcUg~~


Server-Side Chart Example: @ssurl(reportchart,view,reportname;;chartname)@ 

Result: /servlet/wChart?width=300&height=200&codedid=YnoRF35kEjwDHm0DMUQMNQ0kZwcdHTgRH2JdUEJC

Report Dashboard dashboard view Dashboard Name

@ssurl(dashboard,view,dashboardname)@

Result: /userreport/ur_viewdb.jsp?dashbid=2348

SmartFolder (View) smartfolder view SmartFolder Name

@ssurl(smartfolder,view,foldername)@

Result: /s_editresource.jsp?display=1&resourceid=68826

SmartFolder - View (Internet Enabled) smartfolder viewinet SmartFolder Name

@ssurl(smartfolder,viewinet,foldername)@

Result: /files/113/68827/169542folderinet/

Autoloader - Dropbox autoloader dropbox Autoloader Name

@ssurl(autoloader,dropbox,autoloadername)@

Result: /Archive/al_upload.jsp? loaderid=BEUFe2sDA1d7aV1cQUYBRWUDdgVhe2tRCwUDBg~~

AI Insight aiinsight view Name

@ssurl(aiinsight,view,name)@

Result: /AI/ai_workingwithai.jsp?token=%40HwwMTxwbeFhFQhFFQRxZQVVTZFV1G3BhHQ~~

Retrieved from ‘https://wiki.smartsimple.com/index.php?title=Object_URL_Syntax&oldid=43609’