Visualizzazione e gestione dei parametri in un task REST
I parametri possono essere inclusi in diverse parti di un task REST.
Le parti di un task REST che possono essere parametrizzate sono le seguenti:
- Una o più sezioni dell'URL di esecuzione REST, dell'URL di polling o dell'URL di interruzione. In Data Integration, le sezioni variabili parametrizzate dell'URL sono note come parametri URL. Vedere Configurazione dei parametri del metodo HTTP, dell'URL e dell'URL.
- Il valore di un'intestazione nella richiesta. Vedere Parametrizzazione di un valore di intestazione.
- L'intero corpo della richiesta in una richiesta POST o PUT. Vedere Parametrizzazione del corpo della richiesta.
- Condizione di operazione riuscita che determina i criteri per il completamento riuscito della chiamata REST. Vedere Parametrizzazione della condizione di operazione riuscita.
- Condizione di polling (scritta sulla risposta restituita dalla richiesta di polling) che determina se il polling si interrompe o continua. Vedere Parametrizzazione della condizione di polling.
Quando una parte di un task REST viene parametrizzata, il parametro viene definito e utilizzato solo nell'ambito di tale task.
Visualizza e gestisce tutti i parametri aggiunti nell'ambito di un task REST, inclusi quelli aggiunti ma non utilizzati nel task.
Aprire il task REST per visualizzare un elenco dei parametri creati e assegnati nel task. Nell'elenco sono disponibili anche parametri non assegnati.
-
Nell'elenco dei task, selezionare Visualizza dettagli dal menu Azioni (
) di un task.
È possibile aggiungere parametri scalari, JSON ed espressione nell'ambito di un task REST per fare riferimento a elementi con parametri nello stesso task REST.
- Aprire il progetto o la cartella contenente il task che si desidera modificare.
- Nella pagina dei dettagli del progetto o della cartella, fare clic su Task.
-
Nell'elenco dei task, selezionare Visualizza dettagli dal menu Azioni () di un task.
- Nella sezione Parametri della pagina Task REST, fare clic su Configura.
- Nella pagina Parametri task REST, fare clic su Aggiungi parametro e selezionare il tipo di parametro da aggiungere.
-
Nel pannello Aggiungi parametro è possibile definire i tipi di parametro riportati di seguito.
- Scalare: aggiungere un parametro di coppia nome-valore convenzionale. Specificare un identificativo univoco, il tipo di dati e il valore predefinito.
- JSON: aggiungere un parametro del tipo di dati JSON. Specificare un identificativo univoco e un JSON valido come valore.
- Espressione: aggiungere un parametro del tipo di espressione. Specificare un identificativo univoco, quindi utilizzare la Costruzione guidata condizione per scrivere l'espressione.
- Fare clic su Aggiungi.
- Fare clic su Fine nella pagina Parametri task REST.
È possibile modificare la descrizione, il tipo di dati e il valore di un parametro.
-
Nell'elenco dei task, selezionare Visualizza dettagli dal menu Azioni () di un task.
-
Nella pagina Parametri task REST selezionare Modifica dal menu Azioni () del parametro che si desidera modificare.
È possibile eliminare un parametro solo se non è in uso nel task REST.
La colonna Utilizzato in nella pagina Parametri task REST indica dove viene utilizzato un parametro nel task.
-
Nell'elenco dei task, selezionare Visualizza dettagli dal menu Azioni () di un task.
-
Nella pagina Parametri task REST, selezionare Elimina dal menu Azioni () del parametro da eliminare.
Se il parametro è in uso nel task REST, l'azione di eliminazione non è disponibile.