Host Code

Reuben Schmitz
Reuben Schmitz
Fourth Anniversary Kudos 2 Name Dropper Participant
in SKY Developer General Discussions

Is there a list of the “Add In Hosts” that are avaialble for use?

i.e., for Adaptive Cards it is: https://app.blackbaud.com/addin-adaptivecard-host…….

for Power BI it is: https://app.blckbaud.com/addin-powerbi-host……

What would this command be to display a gift list on a Constituent record?

Is there an index or reference source for these code snippets?

Comments

  • Tim McVicker
    Tim McVicker Blackbaud Employee
    Sixth Anniversary Kudos 1 Name Dropper Participant

    Hey @Reuben Schmitz!

    Each of those hosts serves to enable developers to embed experiences within Blackbaud solutions, specifically using one of the add-in capabilities documented in these two places:

    For example, the Power BI Host allows you to embed a Power BI report as a tile within a Blackbaud solution.

    There's not an index or list of them, since they aren't intended for general purpose; they are meant to be used specifically with one of those capabilities that's documented there. I would expect anyone that needed to use them to first identify what capability they were trying to use (like Adaptive Cards).

    Can you tell me more about what you are trying to do?

  • Reuben Schmitz
    Reuben Schmitz
    Fourth Anniversary Kudos 2 Name Dropper Participant

    @Tim McVicker I am looking to create a tile that displays only a list of Planned Gifts for that donor


  • Ben Lambert
    Ben Lambert
    Ninth Anniversary Kudos 5 Name Dropper Participant

    @Reuben Schmitz Some ideas:

    You could build a Power BI report of gifts, where the report supports a filter parameter to scope the list to planned gifts for a single constituent. Then you could use the Power BI Host SPA to host that report as a tile add-in on the constituent page. At runtime, the context object will contain the current constituent's system record ID, which will flow into the report as the filter parameter (via the configuration options described in the docs).

    Another option - similar to the Power BI Report scenario, you could build a Power App that accepts the constituent ID as an input. The Power App could leverage the ListGifts endpoint in the Gifts connector to fetch the planned gifts for the constituent and then render those gifts as a list.

    Note that, in both of those scenarios your end-users will need a license for (and be prompted to login to) Power BI/Power Apps.

    As another option, you could define a tile add-in for the constituent page that uses the Adaptive Card Host SPA. The cardServiceUrl could be to a Power Automate flow, and in the flow you'd pick off the context.record_id from the trigger and use that to call the ListGifts endpoint (filtering the results to only Planned Gifts for the constituent). You'd then build an adaptive card that shows the planned gifts in a list (and you might take inspiration from the Expense report adaptive card sample for showing the list of gifts similar to the list of expenses).

    In that approach, end-users won't need any additional licenses and won't be prompted for any logins. They'll just see the adaptive card in a tile.

    (it would be nice if you could leverage the existing "gifts list" that you see on the "Work with gifts" page in NXT - maybe Blackbaud would consider implementing a new type of host SPA like a "Gift List Host SPA" where you could just pre-configure the filters you want when registering your add-in)

    Hope this helps!

Categories