Loading
Subventionnement
Appel de Candid Charity Check à partir d'un flux

Vous êtes ici :

  1. Aide de Salesforce
  2. Documents
  3. Subventionnement

Appel de Candid Charity Check à partir d'un flux

Élaborez un flux d'écran qui invite un utilisateur à saisir un numéro d'identification d'employeur (EIN), appelle l'API Candid Charity Check et affiche le résultat. Cet exemple de flux montre comment transmettre un code EIN à l'API, gérer les réponses réussies et les réponses d'erreur, et afficher les données de statut fiscal pour l'utilisateur.

Éditions requises

Disponible avec : Lightning Experience
Disponible avec : Nonprofit Cloud pour Subventionnement et Solutions Secteur public. Afficher la disponibilité
Autorisations utilisateur requises
Pour créer un flux : Ensemble d'autorisations Gestionnaire du subventionnement

Le flux terminé se présente comme suit.

Flux d'écran terminé qui s'oriente vers un écran de réussite ou d'erreur basé sur le résultat Action de contrôle de bienfaisance

Créer un flux d'écran

  1. dans Configuration, recherchez Flux dans la case Recherche rapide, puis sélectionnez l’entrée.
  2. Cliquez sur Nouveau flux.
  3. Cliquez sur Flux d'écran.
  4. Sélectionnez Présentation automatique.

Création de l'élément d'écran EIN

  1. Créez la ressource EIN.
    1. Dans la boîte à outils, cliquez sur Nouvelle ressource.
    2. Type de ressource : Variable
    3. Nom d'API : ein
    4. Type de données : Texte
    5. Sélectionnez Disponible pour sortie.
    6. Cliquez sur Terminé.
  2. Après l'élément de départ, cliquez sur Ajouter au flux, puis sélectionnez Écran.
  3. Définissez les propriétés d'écran ci-dessous.
    1. Étiquette : Écran EIN
    2. Nom d'API : EIN_Screen
  4. Dans Composants, faites glisser un composant Texte vers la zone de dessin.
  5. Définissez ces champs dans le composant Texte.
    1. Étiquette : EIN
    2. Nom d'API : EIN_input
    3. Sélectionnez Obligatoire.
    4. Valeur par défaut : {!ein}
    5. Quand afficher le composant : Toujours
    6. Message d'erreur : Le NIE doit se présenter sous le format suivant : ##-#######.
      Pour saisir le message d'erreur, agrandissez Valider l'entrée.
    7. Formule : Créez une ressource de formule de type booléen.
      Dans la formule, saisissez REGEX({!EIN_input}, "\d{2}-\d{7}").
    8. Valeurs d'écran revisitées : Utiliser les valeurs conservées depuis la dernière visite de cet écran par l'utilisateur
      Pour sélectionner la valeur, agrandissez Avancé.
  6. Cliquez sur Terminé.

Création de l'élément Attribuer EIN

  1. Après l'élément Écran EIN, cliquez sur Ajouter au flux, puis sélectionnez Attribution.
  2. Définissez ces champs.
    1. Étiquette : Attribuer EIN
    2. Nom d'API : Assign_EIN
    3. Variable: {!ein}
    4. Opérateur Égal à
    5. Valeur: {!EIN_input}

Création de l'élément d'action Contrôle de bienfaisance

  1. Après l'élément Attribuer EIN, cliquez sur Ajouter au flux, puis sélectionnez Action.
  2. Dans la case Actions de recherche, recherchez et sélectionnez Charitycheck V 1.
  3. Définissez ces champs.
    1. Étiquette : Action Contrôle de bienfaisance
    2. Nom d'API : Charity_Check_Action
    3. Ein : {!ein}

Création de l'élément Attribuer un code de réponse

  1. Dans la boîte à outils, cliquez sur Nouvelle ressource.
    1. Type de ressource : Variable
    2. Nom d'API : httpResponseCode
    3. Type de données : Numérique
    4. Décimales: 0
    5. Sélectionnez Disponible pour sortie.
    6. Cliquez sur Terminé.
  2. Après Action de contrôle de bienfaisance, cliquez sur Ajouter au flux, puis sélectionnez Attribution.
  3. Définissez ces champs.
    1. Étiquette : Attribuer un code de réponse
    2. Nom d'API : Code Attribu_Response
    3. Variable: {!httpResponseCode}
    4. Opérateur Égal à
    5. Valeur: {!Charity_Check_Action.responseCode}

Création de l'élément Décision réussie du contrôle de bienfaisance

  1. Après l'élément Attribuer un code de réponse, cliquez sur Ajouter au flux, puis sélectionnez Décision.
  2. Définissez ces champs.
    1. Étiquette : Le contrôle de bienfaisance réussit-il ?
    2. Nom d'API : Is_Charity_Check_Successful
  3. Pour le Nouveau résultat, définissez les champs ci-dessous.
    1. Étiquette du résultat : Oui
    2. Nom d'API du résultat : Oui
    3. Exigences de condition : Toutes les conditions sont remplies (AND)
    4. Ressource : {!Charity_Check_Action.responseCode}
    5. Opérateur Égal à
    6. Valeur : 200
  4. Cliquez sur Résultat par défaut, puis saisissez No comme étiquette.

Création de l'élément de données Attribuer un contrôle de bienfaisance

  1. Dans la boîte à outils, cliquez sur Nouvelle ressource.
    1. Type de ressource : Variable
    2. Nom d'API : charityCheckData
    3. Type de données : Défini par Apex
    4. Classe Apex : ServiceExterne__CandidCharityCheck_charitycheckx5fv1_OUT_200_data
    5. Sélectionnez Disponible pour sortie.
  2. Après Oui dans le chemin de décision, cliquez sur Ajouter au flux, puis ajoutez un élément Attribution.
  3. Définissez ces champs.
    1. Étiquette : Attribution de données de contrôle de bienfaisance
    2. Nom d'API : Assign_Charity_Check_Data
    3. Variable: {!charityCheckData}
    4. Opérateur Égal à
    5. Valeur: {!Charity_Check_Action.200.data}

Création de l'élément d'écran Success

  1. Après l'élément Attribuer des données de contrôle de bienfaisance, cliquez sur Ajouter au flux, puis sélectionnez Écran.
  2. Définissez les propriétés d'écran ci-dessous.
    1. Étiquette : Écran de réussite
    2. Nom d'API : Success_Screen
  3. Dans Composants, faites glisser un composant Texte d'affichage vers la zone de dessin.
  4. Dans Nom d'API, saisissez Success_Message, puis saisissez ce texte dans l'éditeur de texte enrichi. 
    Successfully performed a Candid Charity Check
EIN: {!ein}
Organization Name: {!charityCheckData.organizationx5fname}
State: {!charityCheckData.statex5fname}
Tax-Exempt Status: {!charityCheckData.subsectionx5fdescription}
Foundation Code: {!charityCheckData.foundationx5fcode}
    Remarque
    Remarque Changez le texte pour l'adapter à vos besoins.
  5. Cliquez sur Terminé.

Création de l'élément Attribuer une erreur

  1. Dans la boîte à outils, cliquez sur Nouvelle ressource.
    1. Type de ressource : Variable
    2. Nom d'API : error
    3. Type de données : Texte
    4. Sélectionnez Disponible pour sortie.
  2. Après Non dans le chemin de décision, cliquez sur Ajouter au flux, puis sélectionnez Attribution.
  3. Définissez ces champs.
    1. Étiquette : Attribuer une erreur
    2. Nom d'API : Attribu_Error
    3. Variable: {!error}
    4. Opérateur Égal à
    5. Valeur: {!Charity_Check_Action.defaultExc}

Création de l'élément d'écran Erreur

  1. Après l'élément Attribuer une erreur, cliquez sur Ajouter au flux, puis sélectionnez Écran.
  2. Définissez les propriétés d'écran ci-dessous.
    1. Étiquette : Écran d'erreur
    2. Nom d'API : Ecran_erreur
  3. Dans Composants, faites glisser un composant Texte d'affichage vers la zone de dessin.
  4. Dans Nom d'API, saisissez Error_Message, puis saisissez ce texte dans l'éditeur de texte enrichi.
    Une erreur s'est produite lors de l'appel du Contrôle de charité candide pour le {!ein} EIN. {!error}
    Remarque
    Remarque Modifiez le texte pour l'adapter à vos besoins.
  5. Cliquez sur Terminé.

Création du parcours de défaut

  1. Dans l'élément Action de contrôle de bienfaisance, cliquez sur le menu Actions, puis sélectionnez Ajouter un parcours de défaut.
  2. Après Défaut, cliquez sur Ajouter au flux, puis sélectionnez Attribution.
  3. Définissez ces champs.
    1. Étiquette : Attribuer une exception
    2. Nom d'API : Attribu_Exception
    3. Variable: {!error}
    4. Opérateur Égal à
    5. Valeur: {!$Flow.FaultMessage}
  4. Après l'élément Attribuer une exception, cliquez sur Ajouter au flux, puis sélectionnez Se connecter à l'élément.
  5. Sélectionnez l'élément Écran d'erreur.
  6. Enregistrez et activez le flux.
 
Chargement
Salesforce Help | Article