I feel like there’s likely some useful functions that maybe aren’t mentioned in the Fibery markdown page that could be helpful.
The seemingly simple one I’m looking for at the moment is just getting the URL of an entity! I know I can get the UUID with {id} but experimenting with {url} didn’t seem to work and I can’t seem to figure out what’s needed to get it.
Am I missing something obvious or does it require some complicated custom script?
I don’t think you’re missing something obvious - I don’t think there is a simple markdown syntax for the entity view url.
I think this should turn into a feature request, but I’m curious to know the use case.
Thanks, for clarifying it’s not as simple as I had hoped.
Our use case:
When an “iteration” is done, our production team changes its state to “complete” which triggers a summary email to our finance team that tells them which client needs to be billed, how much, etc.
We would like this summary email to include a link to the entity that triggered it, because in some cases the finance team might need extra info or context that isn’t already in the email and we want that process to be as quick/easy as possible for them since they’re not fibery power users.
Example of our desired email:
Email Subject:
A new iteration is complete and ready to be billed.Email Body:
Client: Bob’s Burgers
Initiative: New Menu Marketing Campaign
Release: 1.0
Iteration: 3
Billing Amount: $10,000
Fibery Link: {url}
To get a clickable URL, you would have to hardcode the bulk of it, and then append the public id, e.g.
Fibery Link: [Click here](https://wowser.fibery.io/SpaceName/Iteration/{{Public Id}})
Or if you need it to be totally generic, you would have to use scripting, perhaps taking advantage of the getEntityUrl(type: string, publicId: string) function.
Ok thanks, I’ve got it working in my email now with the following script from this thread:
{!Public-id!}
<% const utils = context.getService(`utils`); %>
<%= utils.getEntityUrl(Entity.Type, Entity["Public-id"]) %>
@Chr1sG do you know if getEntityUrl can also be used for entities that are related to the entity? If so, could you help me with the required syntax?
I was hoping I could do something like:
{!Client/Public-id!}
<% const utils = context.getService(`utils`); %>
<%= utils.getEntityUrl(Entity.Type, Entity["Client/Public-id"]) %>
to get the url of the “Client” entity that is related to the “Iteration” entity but it just comes back as “undefined”.
You were close!
Try this:
{!Client.Public Id!}
<% const utils = context.getService('utils'); %>
<%= utils.getEntityUrl(****, Entity['Client.Public Id']) %>
where you replace **** with the qualified name of the Client type, e.g. 'CRM/Client'
Of course, if the triggering entity is also a Client, then Entity.Type will work fine
Could you clarify what you mean by “qualified name”? I thought you were referring to the space/database of the entity I wanted the URL for, but it doesn’t seem to work (getting a “Sprints is not defined” error)
In my case, the automation is being triggered by an “Iteration” that is related to a “Client”, “Order”, “Initiative” & “Release”
Their spaces/databases are:
Sprints/Iteration
Sprints/Release
Clients/Initiative
Clients/Order
Clients/Client
My code:
{!Client.Public-id!}
{!Order.Public-id!}
{!Initiative.Public-id!}
{!Release.Public-id!}
{!Public-id!}
<% const utils = context.getService(`utils`); %>
**Client:** <a href="<%= utils.getEntityUrl(Clients/Client, Entity['Client.Public Id']) %>">{{Client.Name}}</a><br>
**Order:** <a href="<%= utils.getEntityUrl(Clients/Order, Entity['Order.Public Id']) %>">{{Order.Name}}</a><br>
**Initiative:** <a href="<%= utils.getEntityUrl(Clients/Initiative, Entity['Initiative.Public Id']) %>">{{Initiative.Name}}</a><br>
**Release:** <a href="<%= utils.getEntityUrl(Sprints/Release, Entity['Release.Public-id']) %>">{{Release.Name}}</a><br>
**Iteration:** <a href="<%= utils.getEntityUrl(Entity.Type, Entity['Public-id']) %>">{{Name}}</a>
I was.
You need quotes around your space/database name, e.g.
'Clients/Client'
Aha! Thank you so much for your help!