Linee guida per la creazione di app

Per le app web, la lettura e la scrittura sono consentite solo sui file che si trovano nella stessa cartella dell'app o in una sottocartella, ovvero qualsiasi cartella all'interno di quella che contiene l'app (non necessariamente inferiore di un solo livello). Questa regola vale anche per le macro che desideri utilizzare per l'app, a meno che non si tratti di una macro standard inclusa nel programma di installazione di Alteryx o di un programma di installazione dei dati.

Quando utilizzi lo strumento Azione per aggiornare/modificare il valore, a meno che non sia effettivamente necessario, non usare l'opzione Sostituisci una stringa specifica: . La modifica della configurazione dello strumento nel flusso di lavoro a causa del continuo sviluppo può interrompere lo strumento Azione poiché la stringa specifica potrebbe non esistere più. Ovviamente, in alcuni casi è necessario ricorrere a questa opzione, ma tieni presente che se modifichi questa stringa nello strumento, potresti dover aggiornare anche lo strumento Azione.

Se utilizzi uno strumento Azione per aggiornare uno strumento Deviazione , cerca di completare l'operazione aggiornando la deviazione a sinistra e a destra. Se ti limiti ad aggiornare solo una condizione e modifichi il flusso di lavoro in fase di sviluppo, non terrai conto di quando dovrà deviare nella direzione opposta.

Tutte le deviazioni devono terminare, soprattutto prima di unire qualsiasi flusso di dati da una deviazione a qualsiasi altro punto del flusso di lavoro. Lo strumento Fine deviazione è facile da usare poiché non richiede alcuna configurazione. Assicurati di utilizzarlo o di terminare la deviazione con uno strumento Output.

Quando scrivi le domande, tieni conto dell'utente prevedendo gli errori comuni. Puoi inviare messaggi di errore utilizzando uno strumento Messaggio di errore . Ad esempio, se l'utente deve selezionare un'opzione, genera un errore quando non seleziona nulla. In questo modo eviterai che l'engine produca errori non abbastanza chiari da permettere all'utente di capire come correggerli. Idealmente, dovresti generare un errore per ogni domanda che l'utente deve compilare. Puoi anche applicare condizioni più complesse per assicurarti che le informazioni siano state inserite correttamente. Ad esempio, se è necessario compilare una casella di testo con un massimo di 5 aree di commercio separate da virgole (ad esempio 1, 2, 3, 4, 5), puoi utilizzare una condizione regex per assicurarti che non vi siano più di 4 virgole nella casella di testo.

Seguendo lo stesso criterio, cerca di anticipare i casi in cui l'app potrebbe non funzionare pur essendo configurata correttamente. Ad esempio, l'utente potrebbe immettere un indirizzo che non viene geocodificato e non produce alcun risultato. Puoi gestire facilmente la messaggistica nell'app filtrando le codifiche geografiche errate e utilizzando lo strumento Messaggio per restituire all'utente il messaggio: "L'indirizzo fornito non è stato geocodificato. Verifica che sia valido e apporta le modifiche necessarie oppure immetti un indirizzo diverso e ripeti l'esecuzione."

Se stai aggiornando Raw XML per uno strumento o stai utilizzano caratteri speciali nelle app, potresti riscontrare comportamenti imprevisti sul web. Ad esempio, la selezione dello strumento A discesa o dello strumento Casella di riepilogo sull'engine potrebbe contenere testo come: Age By Sex Summary Report:<Report Type=”summary”>Age By Sex Summary Report</Report>

Tuttavia, sul web la domanda non è visualizzata correttamente e quando viene usata in un'azione è probabile che non ha l'effetto desiderato. Una soluzione è quella di modificare il testo in: Age By Sex Summary Report:<Report Type="summary">Age By Sex Summary Report</Report>

Quindi, se utilizzi la risposta alla domanda in un'azione, devi aggiornarla in: EscapeXMLMetacharacters([AllocateSummaryReport])

La funzione Escape XML Metacharacters è stata aggiunta alla libreria Formula nella versione 8.0 ed è accessibile dalla categoria Specializzata. Questa funzione sostituisce tutti i metacaratteri XML con le versioni con escape.

Ti consigliamo di avere uno strumento Unione configurato manualmente per ogni app perché nella maggior parte dei casi il flusso di lavoro cambia in fase di esecuzione. Invece di configurare lo strumento Unione in modalità manuale, inserisci gli strumenti Seleziona in ogni collegamento inserito nello strumento Unione. Durante la configurazione dello strumento Seleziona, rinomina e riordina i campi secondo necessità, facendo attenzione a non includere i campi Dinamico/Sconosciuto. Configura lo strumento Unione utilizzando Configurazione automatica per nome o Configurazione automatica per posizione.

L'organizzazione delle app viene eseguita in parte tramite contenitori di strumenti per le varie sezioni delle app. Ad esempio, gli strumenti di reporting in genere rappresentano l'ultima sezione di un'app e possono essere collocati in un contenitore denominato "Reporting".

Uno strumento Contenitore strumenti può essere colorato in base alla funzione che evidenzia. La codifica a colori dei contenitori degli strumenti semplifica la comprensione dell'attività svolta da un'app, specialmente in caso di visualizzazione con dimensioni ridotte. Questo aspetto è utile durante la risoluzione dei problemi o il debug di un'app creata da un altro utente.

Gli strumenti di interfaccia devono essere collocati nei rispettivi contenitori con la codifica a colori appropriata. Per le app con più schede, è utile collocare gli strumenti di ogni scheda nel proprio contenitore.

Le annotazioni sono caselle di testo collegate a uno strumento specifico e possono essere molto utili per descrivere il ruolo dei singoli strumenti. Uno dei vantaggi principali consiste nel fatto che l'annotazione si sposta insieme allo strumento. In Configurazione flusso di lavoro , imposta la visualizzazione delle Annotazioni .

Se necessario, puoi anche impostare il posizionamento delle singole annotazioni nella parte superiore o inferiore di uno strumento. Per modificare l' annotazione , fai clic sullo strumento, seleziona la scheda Annotazione , quindi seleziona o deseleziona Posiziona annotazione in alto .

Uno strumento Input macro deve includere dati. L'inclusione dei dati semplifica notevolmente la risoluzione dei problemi o il debug in caso di anomalie. All'interno dello strumento Input macro è presente un input di testo. Questo è il metodo preferito per gli input macro. Se è necessario un file più grande da utilizzare come input di dati, dovrebbe essere incluso nella macro, ove possibile. Le dipendenze dei file di dati per una macro devono essere denominate seguendo il seguente pattern:

NameOfMacro.NameOfDataFile.yxdb

I nomi di input e di output non devono essere associati a un numero di strumento. Nella scheda Proprietà input macro, verifica che il nome sia abbastanza descrittivo. Il nome specificato qui è visibile agli utenti durante la configurazione dello strumento Macro.

Se sono presenti più input e output, l'aggiunta di un' abbreviazione del connettore aiuta l'utente a configurare lo strumento associando un'etichetta al relativo ancoraggio quando lo strumento viene posizionato sull'area di disegno. Vai a Strumento Input Macro Input o Strumento Output Macro per ulteriori informazioni.

I nomi delle schede devono essere descrittivi per garantire una maggiore facilità d'uso durante la configurazione dello strumento Macro. Le schede sono visibili all'utente al momento della configurazione. Il nome predefinito della scheda è "Domande", che non è molto descrittivo e di solito viene assegnato per errore durante lo sviluppo di una macro (o di un'app) con un'unica scheda. Consulta Finestra Interfaccia di Designer .

Le macro di supporto utilizzate in un flusso di lavoro padre devono essere presenti insieme alla macro padre o in una directory di supporto e denominate: NameOfParent.NameOfSupporting.yxmc