Loading
Concessione sovvenzioni
Chiamata di Candid Charity Check da un flusso

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.

Flusso schermata completato che si ramifica in una schermata di esito positivo o di errore in base al risultato dell'azione Controllo beneficenza

Creazione di un flusso schermata

  1. Da Imposta, nella casella Ricerca veloce, cercare e selezionare Flussi.
  2. Fare clic su Nuovo flusso.
  3. Fare clic su Flusso schermata.
  4. Selezionare Layout automatico.

Creazione dell'elemento schermata EIN

  1. Creare la risorsa EIN.
    1. Nella casella degli strumenti, fare clic su Nuova risorsa.
    2. Tipo di risorsa: Variabile
    3. Nome API: ein
    4. Tipo di dati: Testo
    5. Selezionare Disponibile per output.
    6. Fai clic su Chiudi.
  2. Dopo l'elemento iniziale, fare clic su Aggiungi a flusso e quindi selezionare Schermata.
  3. Impostare queste proprietà della schermata.
    1. Etichetta: Schermata EIN
    2. Nome API: EIN_Screen
  4. Da Componenti, trascinare un componente Testo nell'area di disegno.
  5. Impostare questi campi nel componente Testo.
    1. Etichetta: EIN
    2. Nome API: EIN_input
    3. Seleziona Obbligatorio.
    4. Valore predefinito: {!ein}
    5. Quando visualizzare il componente: Sempre
    6. Messaggio di errore: EIN deve avere il seguente formato: ##-######.
      Per immettere il messaggio di errore, espandere Convalida input.
    7. Formula: Creare una risorsa formula con il tipo di dati Booleano.
      Per la formula, immettere REGEX({!EIN_input}, "\d{2}-\d{7}").
    8. Valori schermata rivisitati: Utilizza valori da quando l'utente ha visitato questa schermata per l'ultima volta
      Per selezionare il valore, espandere Avanzate.
  6. Fai clic su Chiudi.

Creazione dell'elemento Assegna EIN

  1. Dopo l'elemento Schermata EIN, fare clic su Aggiungi a flusso e quindi selezionare Assegnazione.
  2. Impostare questi campi.
    1. Etichetta: Assegna EIN
    2. Nome API: Assegna_EIN
    3. Variabile: {!ein}
    4. Operatore: Uguale a
    5. Valore: {!EIN_input}

Creazione dell'elemento Azione Controllo beneficenza

  1. Dopo l'elemento Assegna EIN, fare clic su Aggiungi a flusso e quindi selezionare Azione.
  2. Nella casella Azioni di ricerca, cercare e selezionare Charitycheck V 1.
  3. Impostare questi campi.
    1. Etichetta: Azione Charity Check
    2. Nome API: Charity_Check_Action
    3. Ein: {!ein}

Creazione dell'elemento Assegna codice di risposta

  1. Nella casella degli strumenti, fare clic su Nuova risorsa.
    1. Tipo di risorsa: Variabile
    2. Nome API: httpResponseCode
    3. Tipo di dati: Numero
    4. Cifre decimali: 0
    5. Selezionare Disponibile per output.
    6. Fai clic su Chiudi.
  2. Dopo l'azione Controllo beneficenza, fare clic su Aggiungi a flusso e quindi selezionare Assegnazione.
  3. Impostare questi campi.
    1. Etichetta: Assegna codice di risposta
    2. Nome API: Assegna_codice_risposta
    3. Variabile: {!httpResponseCode}
    4. Operatore: Uguale a
    5. Valore: {!Charity_Check_Action.responseCode}

Creazione dell'elemento Decisione riuscita di È controllo beneficenza

  1. Dopo l'elemento Assegna codice di risposta, fare clic su Aggiungi a flusso e quindi selezionare Decisione.
  2. Impostare questi campi.
    1. Etichetta: Il controllo della carità è riuscito?
    2. Nome API: Is_Charity_Check_Success
  3. Per il Nuovo esito, impostare questi campi.
    1. Etichetta esito: Sì
    2. Nome API esito: Sì
    3. Requisiti della condizione: Tutte le condizioni sono soddisfatte (AND)
    4. Risorsa: {!Charity_Check_Action.responseCode}
    5. Operatore: Uguale a
    6. Valore: 200
  4. Fare clic su Esito predefinito e immettere No come etichetta.

Creazione dell'elemento di dati Assegna controllo beneficenza

  1. Nella casella degli strumenti, fare clic su Nuova risorsa.
    1. Tipo di risorsa: Variabile
    2. Nome API: charityCheckData
    3. Tipo di dati: Definito da Apex
    4. Classe Apex: ExternalService__CandidCharityCheck_charitycheckx5fv1_OUT_200_data
    5. Selezionare Disponibile per output.
  2. Dopo Sì nel percorso decisionale, fare clic su Aggiungi a flusso e aggiungere un elemento Assegnazione.
  3. Impostare questi campi.
    1. Etichetta: Assegnazione dei dati di Charity Check
    2. Nome API: Assegna_dati_di_controllo_carità
    3. Variabile: {!charityCheckData}
    4. Operatore: Uguale a
    5. Valore: {!Charity_Check_Action.200.data}

Creazione dell'elemento schermata Successo

  1. Dopo l'elemento Assegna dati controllo beneficenza, fare clic su Aggiungi a flusso e quindi selezionare Schermata.
  2. Impostare queste proprietà della schermata.
    1. Etichetta: Schermata di esito positivo
    2. Nome API: Schermata_successo
  3. Da Componenti, trascinare un componente Testo visualizzato nell'area di disegno.
  4. Per Nome API, immettere Success_Message e 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
    Nota Modificare il testo in base alle proprie esigenze.
  5. Fai clic su Chiudi.

Creazione dell'elemento Assegna errore

  1. Nella casella degli strumenti, fare clic su Nuova risorsa.
    1. Tipo di risorsa: Variabile
    2. Nome API: error
    3. Tipo di dati: Testo
    4. Selezionare Disponibile per output.
  2. Dopo No nel percorso decisionale, fare clic su Aggiungi a flusso e quindi selezionare Assegnazione.
  3. Impostare questi campi.
    1. Etichetta: Assegna errore
    2. Nome API: Assegna_errore
    3. Variabile: {!error}
    4. Operatore: Uguale a
    5. Valore: {!Charity_Check_Action.defaultExc}

Creazione dell'elemento schermata di errore

  1. Dopo l'elemento Assegna errore, fare clic su Aggiungi a flusso e quindi selezionare Schermata.
  2. Impostare queste proprietà della schermata.
    1. Etichetta: Schermata di errore
    2. Nome API: Schermata di errore
  3. Da Componenti, trascinare un componente Testo visualizzato nell'area di disegno.
  4. 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
    Nota Modificare il testo in base alle proprie esigenze.
  5. Fai clic su Chiudi.

Creazione del percorso di errore

  1. Nell'elemento Azione Controllo beneficenza, fare clic sul menu Azioni e selezionare Aggiungi percorso guasto.
  2. Dopo Errore, fare clic su Aggiungi a flusso e quindi selezionare Assegnazione.
  3. Impostare questi campi.
    1. Etichetta: Assegna eccezione
    2. Nome API: Assegna_eccezione
    3. Variabile: {!error}
    4. Operatore: Uguale a
    5. Valore: {!$Flow.FaultMessage}
  4. Dopo l'elemento Assegna eccezione, fare clic su Aggiungi a flusso e quindi selezionare Connetti a elemento.
  5. Selezionare l'elemento Schermata di errore.
  6. Salva e attiva il flusso.
 
Caricamento
Salesforce Help | Article