Ti trovi qui:
Chiamata di Candid Charity Check da un flusso
Creare un flusso schermata che richiede all'utente un numero di identificazione del datore di lavoro (EIN), chiama l'API Candid Charity Check e visualizza il risultato. Questo flusso di esempio illustra come passare un EIN all'API, gestire sia le risposte riuscite che quelle di errore e mostrare i dati sullo stato fiscale all'utente.
Versioni (Edition) richieste
| Disponibile nelle versioni: Lightning Experience |
| Disponibile in: Nonprofit Cloud per Concessione sovvenzioni e Soluzioni per il settore pubblico. Visualizzare la disponibilità. |
| Autorizzazioni utente richieste | |
|---|---|
| Per creare un flusso: | Insieme di autorizzazioni Gestore concessione sovvenzioni |
Ecco come si presenta il flusso completato.

Creazione di un flusso schermata
- Da Imposta, nella casella Ricerca veloce, cercare e selezionare Flussi.
- Fare clic su Nuovo flusso.
- Fare clic su Flusso schermata.
- Selezionare Layout automatico.
Creazione dell'elemento schermata EIN
-
Creare la risorsa EIN.
- Nella casella degli strumenti, fare clic su Nuova risorsa.
- Tipo di risorsa: Variabile
-
Nome API:
ein - Tipo di dati: Testo
- Selezionare Disponibile per output.
- Fai clic su Chiudi.
- Dopo l'elemento iniziale, fare clic su Aggiungi a flusso e quindi selezionare Schermata.
-
Impostare queste proprietà della schermata.
- Etichetta: Schermata EIN
- Nome API: EIN_Screen
- Da Componenti, trascinare un componente Testo nell'area di disegno.
-
Impostare questi campi nel componente Testo.
- Etichetta: EIN
- Nome API: EIN_input
- Seleziona Obbligatorio.
- Valore predefinito: {!ein}
- Quando visualizzare il componente: Sempre
-
Messaggio di errore: EIN deve avere il seguente formato: ##-######.
Per immettere il messaggio di errore, espandere Convalida input.
-
Formula: Creare una risorsa formula con il tipo di dati Booleano.
Per la formula, immettere REGEX({!EIN_input}, "\d{2}-\d{7}").
-
Valori schermata rivisitati: Utilizza valori da quando l'utente ha visitato questa schermata per l'ultima volta
Per selezionare il valore, espandere Avanzate.
- Fai clic su Chiudi.
Creazione dell'elemento Assegna EIN
- Dopo l'elemento Schermata EIN, fare clic su Aggiungi a flusso e quindi selezionare Assegnazione.
-
Impostare questi campi.
- Etichetta: Assegna EIN
- Nome API: Assegna_EIN
- Variabile: {!ein}
- Operatore: Uguale a
- Valore: {!EIN_input}
Creazione dell'elemento Azione Controllo beneficenza
- Dopo l'elemento Assegna EIN, fare clic su Aggiungi a flusso e quindi selezionare Azione.
- Nella casella Azioni di ricerca, cercare e selezionare Charitycheck V 1.
-
Impostare questi campi.
- Etichetta: Azione Charity Check
- Nome API: Charity_Check_Action
- Ein: {!ein}
Creazione dell'elemento Assegna codice di risposta
-
Nella casella degli strumenti, fare clic su Nuova risorsa.
- Tipo di risorsa: Variabile
-
Nome API:
httpResponseCode - Tipo di dati: Numero
-
Cifre decimali:
0 - Selezionare Disponibile per output.
- Fai clic su Chiudi.
- Dopo l'azione Controllo beneficenza, fare clic su Aggiungi a flusso e quindi selezionare Assegnazione.
-
Impostare questi campi.
- Etichetta: Assegna codice di risposta
- Nome API: Assegna_codice_risposta
- Variabile: {!httpResponseCode}
- Operatore: Uguale a
- Valore: {!Charity_Check_Action.responseCode}
Creazione dell'elemento Decisione riuscita di È controllo beneficenza
- Dopo l'elemento Assegna codice di risposta, fare clic su Aggiungi a flusso e quindi selezionare Decisione.
-
Impostare questi campi.
- Etichetta: Il controllo della carità è riuscito?
- Nome API: Is_Charity_Check_Success
-
Per il Nuovo esito, impostare questi campi.
- Etichetta esito: Sì
- Nome API esito: Sì
- Requisiti della condizione: Tutte le condizioni sono soddisfatte (AND)
- Risorsa: {!Charity_Check_Action.responseCode}
- Operatore: Uguale a
- Valore: 200
-
Fare clic su Esito predefinito e immettere
Nocome etichetta.
Creazione dell'elemento di dati Assegna controllo beneficenza
-
Nella casella degli strumenti, fare clic su Nuova risorsa.
- Tipo di risorsa: Variabile
- Nome API: charityCheckData
- Tipo di dati: Definito da Apex
- Classe Apex: ExternalService__CandidCharityCheck_charitycheckx5fv1_OUT_200_data
- Selezionare Disponibile per output.
- Dopo Sì nel percorso decisionale, fare clic su Aggiungi a flusso e aggiungere un elemento Assegnazione.
-
Impostare questi campi.
- Etichetta: Assegnazione dei dati di Charity Check
- Nome API: Assegna_dati_di_controllo_carità
- Variabile: {!charityCheckData}
- Operatore: Uguale a
- Valore: {!Charity_Check_Action.200.data}
Creazione dell'elemento schermata Successo
- Dopo l'elemento Assegna dati controllo beneficenza, fare clic su Aggiungi a flusso e quindi selezionare Schermata.
-
Impostare queste proprietà della schermata.
- Etichetta: Schermata di esito positivo
- Nome API: Schermata_successo
- Da Componenti, trascinare un componente Testo visualizzato nell'area di disegno.
-
Per Nome API, immettere
Success_Messagee quindi questo testo nell'editor di testo RTF.Successfully performed a Candid Charity Check EIN: {!ein} Organization Name: {!charityCheckData.organizationx5fname} State: {!charityCheckData.statex5fname} Tax-Exempt Status: {!charityCheckData.subsectionx5fdescription} Foundation Code: {!charityCheckData.foundationx5fcode}
Nota Modificare il testo in base alle proprie esigenze. - Fai clic su Chiudi.
Creazione dell'elemento Assegna errore
-
Nella casella degli strumenti, fare clic su Nuova risorsa.
- Tipo di risorsa: Variabile
-
Nome API:
error - Tipo di dati: Testo
- Selezionare Disponibile per output.
- Dopo No nel percorso decisionale, fare clic su Aggiungi a flusso e quindi selezionare Assegnazione.
-
Impostare questi campi.
- Etichetta: Assegna errore
- Nome API: Assegna_errore
- Variabile: {!error}
- Operatore: Uguale a
- Valore: {!Charity_Check_Action.defaultExc}
Creazione dell'elemento schermata di errore
- Dopo l'elemento Assegna errore, fare clic su Aggiungi a flusso e quindi selezionare Schermata.
-
Impostare queste proprietà della schermata.
- Etichetta: Schermata di errore
- Nome API: Schermata di errore
- Da Componenti, trascinare un componente Testo visualizzato nell'area di disegno.
-
Per Nome API, immettere Error_Message e quindi immettere questo testo nell'editor di testo RTF.
Si è verificato un errore durante la chiamata al Candid Charity Check per EIN {!ein}. {!error}
Nota Modificare il testo in base alle proprie esigenze. - Fai clic su Chiudi.
Creazione del percorso di errore
- Nell'elemento Azione Controllo beneficenza, fare clic sul menu Azioni e selezionare Aggiungi percorso guasto.
- Dopo Errore, fare clic su Aggiungi a flusso e quindi selezionare Assegnazione.
-
Impostare questi campi.
- Etichetta: Assegna eccezione
- Nome API: Assegna_eccezione
- Variabile: {!error}
- Operatore: Uguale a
- Valore: {!$Flow.FaultMessage}
- Dopo l'elemento Assegna eccezione, fare clic su Aggiungi a flusso e quindi selezionare Connetti a elemento.
- Selezionare l'elemento Schermata di errore.
- Salva e attiva il flusso.
Questo articolo ha risolto il problema?
Facci sapere, così possiamo migliorare!
