Attachment on GiftTransaction & GiftCommitment

The RaiseNowNPOKit ships with a custom field RaiseNowNPOKit__Attachment__c on both the GiftTransaction and the GiftCommitment. The purpose of these fields is to provide a vehicle for meta information that needs to be passed from a touchpoint to Salesforce. Some examples of possible use cases:

• As a fundraiser, I want to add relationships between the campaign and donor when a GiftTransaction was received from a community fundraising page.
• As a fundraiser, I want to assign GiftTransactions to child campaigns in Salesforce when they originate in a specific community fundraising page.
• As a fundraiser, I want to distribute soft credits to face-to-face marketers collection GiftCommitments on the street.

The concept behind this is for client applications using the RaiseNow API to pass the required information specific to the particular use case to Salesforce without RaiseNow having to implement custom field mappings for every specific use case. So while RaiseNow implements the basic NPC data model and ensure data transport is safe and stable, customers and their SIs can use that information to build extended use cases inside Salesforce, using tools such as Salesforce Flow or custom Apex implementations.

Our RaiseNowNPOKit provides public Apex methods that can be used in Flow or Apex code within Salesforce to facilitate this. Currently, these methods support only processing of string values passed in the attachment JSON.

• Validate JSON For Flow Map (use this to ensure the client application provided a valid JSON object)
• Get Value From JSON (use this to retrieve specific values from the JSON object.)

We recommend for client applications making use of this feature to refrain from building nested JSON objects to not overcomplicate variable extraction. You can add RaiseNow custom fields in you page layouts in Salesforce to make them visible to your users in Salesforce.