Esempio 2: associare i dati FHIR nell'app canvas utilizzando il connettore FHIRlink

Questo esempio segue Esempio 1: Configurare e connettersi al connettore FHIRlink e utilizza la stessa app FHIRlink Sample con il metodo FHIRlink ListResources. In questo esempio, viene mostrato come associare i risultati della chiamata del metodo e le voci dell'aggregazione a un controllo dell'app canvas.

Puoi anche scaricare e importare la soluzione finale come esempio di implementazione. Per ulteriori informazioni, va a Scarica esempio. Prima di iniziare o utilizzare l'esempio, vedi Presupposti per l'utilizzo dell'esempio.

Eseguire l'associazione a un controllo della raccolta

Nell'esempio precedente, hai visualizzato il valore della variabile _patientList e hai visto che conteneva un oggetto Bundle e un elenco figlio di risorse denominate entry. Questa aggregazione conteneva i risultati della seguente chiamata del metodo ListResources tramite il metodo OnSelect:

Set(_patientList, FHIRlink.ListResources("Patient", {_elements:"id,name,birthDate,telecom"}));

L'elemento chiave della risorsa dell'aggregazione che contiene le risorse dei singoli pazienti è il nodo entry. La chiamata del connettore FHIRlink.ListResources restituisce un'aggregazione FHIR come tipo di dati dell'oggetto non tipizzato. Tuttavia, puoi accedere a questo elemento nella variabile dell'elenco dei pazienti utilizzando l'istruzione _patientList.entry. Questo elemento è una matrice contenente i record di risorse FHIR da visualizzare.

Ogni risorsa entry rappresenta un record corrispondente restituito dalla chiamata ListResources, che è una risorsa FHIR Paziente. Lo schema generato include una rappresentazione della risorsa FHIR Paziente che può essere utilizzata per associare i dettagli nel controllo della raccolta. Per ulteriori informazioni sui controlli della raccolta, consulta Controllo della raccolta in Power Apps.

Prima di associare questa matrice ai controlli dell'app canvas, convertiamo innanzi tutto la matrice in un tipo di dati Tabella che puoi facilmente associare alla raccolta. Nel metodo OnSelect del pulsante Elenco risorse, aggiungi la seguente riga di codice:

ClearCollect(_patientListTable, Table(_patientList.entry));

Questo codice converte la matrice _patientList.entry in un tipo di dati Tabella e cancella la raccolta precedente. La tabella fornisce un elenco di singole righe la cui proprietà Value include la risorsa FHIR Paziente.

Per ulteriori informazioni sulle funzioni Table e ClearCollect di Power Fx, vedi:

• Funzione Table
• Funzioni Collect, Clear e ClearCollect

Dopo aver convertito la matrice entry in una tabella, associa i dettagli del modello di elemento della raccolta utilizzando i seguenti passaggi:

1. Aggiungi una raccolta verticale alla schermata principale dell'app Esempio FHIRlink ed etichettala PatientList.

2. Modificare il Layout in Titolo e sottotitolo.

3. Nella proprietà Items della raccolta, modifica il valore da CustomGallerySample a _patientList.

   

Aggiornare gli elementi della raccolta

Quando imposti la proprietà Items per la raccolta PatientList, devi impostare anche i dettagli nel modello di elemento della raccolta. Per impostazione predefinita, la raccolta si associa automaticamente alla prima proprietà disponibile nella riga della tabella, ovvero Value.

Ogni elemento rappresenta un elemento entry con un nodo resource che contiene i dettagli della risorsa FHIR Paziente. Utilizza la procedura seguente per aggiornare il modello di elemento da associare a questo nodo resource:

1. Seleziona un controllo di etichetta Title1 nella raccolta PatientList.

2. Visualizza la proprietà Text del controllo di etichetta Title1. Puoi vedere che la proprietà viene impostata automaticamente sul valore ThisItem.fullUrl

3. Modifica la proprietà Text in ThisItem.Value.resource

La proprietà resource contiene dettagli specifici della risorsa FHIR in cui il primo parametro del metodo ListResources determina il tipo di risorsa FHIR. In questo esempio, stiamo visualizzando le risorse Paziente e i valori id, name, birthDate e telecom richiesti tramite il parametro _elements.

Ogni risultato resource differisce in base al tipo di risorsa richiesto nella chiamata del metodo ListResources. Il valore ThisItem.Value.resource aggiornato è ancora un oggetto ed è necessario per eseguire l'associazione ai valori dei campi. Puoi associare le etichette ai tipi di dati semplici disponibili in resource e visualizzare i valori nella raccolta.

1. Seleziona un controllo di etichetta Title1 nella raccolta PatientList.

2. Modifica la proprietà Text in ThisItem.Value.resource.resourceType

3. Seleziona un controllo di etichetta Subtitle1 nella raccolta PatientList.

4. Modifica la proprietà Text in ThisItem.Value.resource.birthDate

5. Esegui l'app in modalità anteprima e seleziona il pulsante Elenca risorse.

   

Ora puoi visualizzare il contenuto dell'elenco entry nell'oggetto radice dell'aggregazione, visualizzando le proprietà della proprietà resource per ogni voce restituita dalla richiesta ListResources.

Visualizzare proprietà complesse

Le risorse FHIR sono in genere costituite da più livelli di proprietà e non sono limitate a tipi di dati semplici. Come la risorsa FHIR Paziente, gli elementi possono essere oggetti complessi o matrici di oggetti.

In questo esempio, le proprietà name e telecom sono entrambe matrici multilivello. Ogni elemento telecom è un tipo di dati ContactPoint complesso. Puoi combinare i seguenti esempi per la visualizzazione della raccolta:

• Selezionare in base alla posizione
• Selezionare in base a criteri
• Concatenare valori

Esempio 1: selezionare in base alla posizione

Puoi selezionare il primo elemento nell'elenco per una matrice figlio. Questo approccio può essere utilizzato per proprietà che spesso contengono un solo elemento. Illustriamo un esempio con la proprietà name.

1. Utilizza la funzione First per selezionare il primo valore name nell'elenco. Questa funzione restituisce il primo elemento di un elenco o di una matrice. Dopo che viene restituito il primo valore name, puoi combinare le proprietà family e use per la visualizzazione.

2. Seleziona un controllo di etichetta Title1 nella raccolta PatientList.

3. Modifica la proprietà Text in First(ThisItem.Value.resource.name).family & ", (" & First(ThisItem.Value.resource.name).use & ")"

Esempio 2: selezionare in base a criteri

Puoi utilizzare questa opzione per visualizzare la ricerca di un singolo elemento della matrice in base alle proprietà dell'elemento.

1. Per mostrare il numero di telefono dell'abitazione, utilizza la funzione Filter per filtrare i valori dei campi telecom in base ai valori system e use.

2. La proprietà telecom è una matrice come il nodo entry nell'aggregazione. Puoi trattarla allo stesso modo convertendola in una Tabella inline. Dopo la conversione, devi anche applicare il valore ai criteri di filtro.

3. Seleziona un controllo di etichetta Subtitle1 nella raccolta PatientList.

4. Modifica la proprietà Text in First(Filter(Table(ThisItem.Value.resource.telecom), Value.use="home", Value.system="phone")).Value.value

Esempio 3: concatenare valori

Un'altra opzione per una matrice figlio consiste nel concatenare gli elementi in una stringa delimitata. Puoi comprimere tutti i valori della proprietà family in un'unica stringa utilizzando la funzione Concat. L'aggiunta del carattere di ritorno a capo visualizza ciascun nome in una nuova riga. Questa nuova formula include anche alcuni controlli null per completezza.

Come la proprietà telecom, anche la proprietà name è una matrice che dobbiamo convertire in una Tabella inline.

1. Aggiungi un nuovo controllo di etichetta al modello di elemento della raccolta PatientList. Etichettalo FamilyNames.

2. Espandi le dimensioni per consentire due o tre righe.

3. Seleziona un nuovo controllo di etichetta FamilyNames nella raccolta PatientList.

4. Modifica la proprietà Text in Concat(Filter(Table(ThisItem.Value.resource.name), !IsBlank(Value.family)), Value.family & " (" & Value.use & ")", Char(13))

5. Esegui l'app in modalità anteprima e seleziona il pulsante Elenca risorse.

Ogni risorsa FHIR Paziente include un campo nome, che è una matrice di valori. Questo campo consente al record di un paziente di acquisire più nomi, ad esempio il cognome attuale e il cognome da nubile.

Ecco un esempio di un campo nome di paziente:

"name": [{
   "use": "official",
   "family": "Grimes165",
   "given": [
      "Alysia661"
    ],
   "prefix": [
      "Mrs."
    ]
  },
  {
   "use": "maiden",
   "family": "Bins636",
   "given": [
     "Alysia661"
   ],
   "prefix": [
     "Mrs."
   ]
}]

La formula utilizza la funzione Filter per escludere i valori name senza una proprietà family. Per ciascun elemento, le proprietà family e use vengono combinate e la funzione Concat aggiunge il nuovo delimitatore di riga.

Scarica di esempio

Puoi scaricare e importare la soluzione dell'app canvas completata da questo esempio come esempio di implementazione. L'esempio è disponibile per il download nei tre formati seguenti:

• Pacchetto zip: FHIRlink Sample2.zip
• Archivio MSAPP: FHIRlink Sample2.msapp
• Soluzione Power Platform (contiene tutti gli esempi): FHIRlinkSamples.zip

Per istruzioni su come importare ed esportare app canvas, vedi Esportare e importare pacchetti di app canvas.

Passaggi successivi

In Esempio 3: combinare metodi per visualizzare dati FHIR, scopri come utilizzare altri metodi FHIRlink e combinarli nell'app.

Altre informazioni

Per approfondire ulteriori dettagli sulle app canvas relativi a questo esempio, vedi:

• Avvio rapido:
  • Visualizzare un elenco di elementi nelle app canvas
  • Visualizzare, ordinare e filtrare i dati in una raccolta di app canvas
  • Introduzione alle formule nelle app canvas
• Riferimento: Informazioni di riferimento sulle formule in Power Apps