Software Content Management > Package > Creare un package > Package basati su istruzioni > Specificare il contenuto di un package basato su istruzioni
Specificare il contenuto di un package basato su istruzioni
Dopo aver completato i prerequisiti per la creazione di un package basato su istruzioni e i passi da 1 a 6 di, eseguire le operazioni descritte di seguito per specificare il contenuto di Creare un package, attenersi alla procedura descritta di seguito per specificare il contenuto per un package basato su istruzioni.
1. Nella pagina Crea package selezionare la scheda Package basato su istruzioni.
2. Selezionare il tipo di istruzione che si desidera consegnare all'asset e fare clic su Aggiungi istruzione.
3. Nell'elenco Tipo di istruzione selezionare una delle istruzioni seguenti, quindi completare i passi associati. Nelle sezioni che seguono questa procedura vengono forniti dettagli su ciascun tipo di istruzione.
◦ Esegui
◦ Carica
4. Se si desidera aggiungere ulteriori istruzioni, ripetere il passo 3. È possibile aggiungere più istruzioni a un package basato su istruzioni.
5. Esaminare le istruzioni disponibili nell'elenco di istruzioni, che fornisce i seguenti dettagli:
◦ Ordine - Specifica l'ordine di esecuzione delle istruzioni sull'agente.
◦ Tipo- Specifica il tipo di istruzione.
◦ Dettagli - Specifica i dettagli indicati durante la creazione dell'istruzione.
Selezionare un'istruzione dall'elenco e utilizzare una delle opzioni riportate di seguito per modificare l'istruzione.
◦ Per modificare un'istruzione, fare clic su Icona Modifica.
◦ Per riordinare un'istruzione, fare clic su Icona Sposta istruzione su oppure su Icona Sposta istruzione giù.
* 
Assicurarsi che nell'elenco sia presente una sola istruzione Riavvia e che l'ultima istruzione sia Riavvia.
◦ Per eliminare un'istruzione, fare clic su Icona Elimina istruzione.
6. Per salvare il package, fare clic su Salva.
7. Prosegui con il passaggio 8 di Creare un package.
Nelle sezioni riportate di seguito vengono fornite informazioni dettagliate per definire ciascun tipo di istruzione.
Scarica
Per selezionare un file dal repository ThingWorx che si desidera scaricare nell'agente, attenersi alla procedura descritta di seguito.
1. Il campo Repository di destinazione visualizza il repository di destinazione configurato per il download. Per modificare il repository di download di destinazione, fare clic su Icona X, quindi su Icona della bacchetta magica.
Per ulteriori informazioni sulla configurazione del repository di destinazione download, vedere le impostazioni relative alla Distribuzione.
2. Nei riquadri Struttura directory e Contenuto directory è visualizzato il contenuto del repository selezionato. In questi riquadri selezionare il file script che si desidera scaricare nell'asset.
Per ciascun file nel riquadro Contenuto directory sono disponibili le informazioni riportate di seguito.
◦ Nome - Specifica il nome del file con la relativa estensione. Se il file è stato caricato nel repository, al nome del file vengono aggiunte data e ora (in tempo Epoch). Grazie a data e ora è possibile differenziare due file con lo stesso nome.
◦ Data di caricamento - Specifica la data e l'ora in cui il file è stato aggiunto al repository ThingWorx.
◦ Dimensione - Specifica la dimensione del file in byte.
◦ Percorso - Specifica il percorso assoluto del file nel repository ThingWorx.
3. Nel riquadro Contenuto directory selezionare il file script per visualizzarne il nome nel campo Nome file di dati selezionato.
Nella sezione Contenuto directory è possibile eseguire le azioni riportate di seguito.
◦ Se il file da consegnare all'asset non è disponibile nel repository selezionato, fare clic su Icona Carica file per caricare il file nel repository ThingWorx.
◦ Per eliminare il file dal repository, fare clic su Icona Elimina file.
4. Nel campo Directory di destinazione specificare la posizione nell'asset in cui scaricare il file.
5. Se è stato immesso un percorso assoluto nel campo Directory di destinazione, selezionare la casella di controllo La directory di destinazione è assoluta.
6. Se si desidera che l'asset estragga il file dopo il download, selezionare la casella di controllo facoltativa L'agente deve decomprimere il file dopo il download.
* 
L'agente eMessage può estrarre solo i file in formato tar.gz.
Per estrarre un file in qualsiasi altro formato, aggiungere un'istruzione Esegui al package con un eseguibile di estrazione.
7. Se si desidera che i file esistenti vengano sovrascritti quando i file vengono scaricati nella directory specificata, selezionare la casella di controllo Sovrascrivere i file esistenti quando il file viene scaricato nella directory specificata.
8. Per aggiungere l'istruzione all'elenco, fare clic su Aggiungi.
Esegui
Per definire un'istruzione Esegui, che esegue un comando sull'oggetto remoto, attenersi alla procedura descritta di seguito.
1. Nel campo Eseguibile immettere il comando da eseguire.
2. Nel campo Argomenti specificare gli argomenti del comando definito nel campo Eseguibile. Questo campo è facoltativo.
* 
Il comando eseguito è la combinazione dei valori dei campi Eseguibile e Argomenti.
3. Se il percorso dell'eseguibile è assoluto, selezionare la casella di controllo Il percorso eseguibile è assoluto.
4. Se si desidera che i comandi siano asincroni o indipendenti l'uno dall'altro durante l'esecuzione, selezionare la casella di controllo Eseguire questo comando in modo asincrono. Le esecuzioni sono sincrone per default.
5. Per aggiungere l'istruzione all'elenco delle istruzioni, fare clic su Aggiungi.
Registra script
Per aggiungere istruzioni sotto forma di script da distribuire in uno o più asset per un agente Axeda, attenersi alla procedura descritta di seguito. Dopo aver registrato uno script, è possibile eseguire le operazioni descritte di seguito.
• Convalidare l'istruzione che si desidera eseguire per uno o più asset.
• Eseguire lo script più volte sugli stessi asset utilizzando il nome dello script registrato.
1. Nel campo File script immettere il percorso assoluto del file che si desidera registrare.
* 
Se vengono rilevati errori di convalida, verificare la presenza di spazi immessi come prefisso o suffisso nel percorso del file.
2. Nel campo Nome script immettere il nome dello script che si desidera aggiungere come istruzione.
3. Per aggiungere l'istruzione all'elenco, fare clic su Aggiungi.
Riavvia
Per definire un'istruzione per il riavvio dell'agente, attenersi alla procedura descritta di seguito.
1. Per terminare il processo corrente dell'agente e avviare un nuovo processo, selezionare la casella di controllo Riavvio a freddo. Deselezionare per un riavvio a caldo.
Se non si desidera terminare il processo corrente dell'agente ma reinizializzare tutti i componenti e ricaricare i dati dal disco, assicurarsi di deselezionare la casella di controllo Riavvio a freddo. Deselezionare per un riavvio a caldo.
2. Per aggiungere l'istruzione all'elenco, fare clic su Aggiungi.
* 
Assicurarsi che l'istruzione Riavvia sia l'ultima istruzione nell'elenco di istruzioni.
Esegui script
Per definire un'istruzione per l'esecuzione di uno script registrato che può essere distribuito per uno o più asset per un agente Axeda, attenersi alla procedura descritta di seguito.
1. Nel campo Nome script immettere il nome dello script che si desidera eseguire.
2. Per aggiungere l'istruzione all'elenco, fare clic su Aggiungi.
Imposta proprietà
Per definire un'istruzione per l'impostazione di un valore di proprietà specificato sull'asset remoto, attenersi alla procedura descritta di seguito.
1. Nei campi Nome proprietà e Valore proprietà specificare il nome e il valore della proprietà.
* 
Il nome della proprietà è il nome della proprietà dell'oggetto, come visualizzato in ThingWorx Composer. Il nome della proprietà dell'oggetto deve essere mappato correttamente al nome della proprietà remota per poter utilizzare l'istruzione Imposta proprietà. Il nome della proprietà remota viene inviato all'asset.
Se la proprietà dell'oggetto non è configurata come remota o se la proprietà dell'oggetto specificata non è presente, la distribuzione viene contrassegnata come non valida.
2. Per aggiungere l'istruzione all'elenco, fare clic su Aggiungi.
Annullare la registrazione di uno script
Per definire un'istruzione per annullare la registrazione di uno script per uno o più asset per un agente Axeda, attenersi alla procedura descritta di seguito.
1. Nel campo Nome script immettere il nome dello script di cui si desidera annullare la registrazione.
2. Per aggiungere l'istruzione all'elenco, fare clic su Aggiungi.
Carica
Per definire un'istruzione che consenta agli agenti Axeda eMessage di caricare uno o più file su ThingWorx Platform, attenersi alla procedura descritta di seguito.
1. Nel campo Repository di destinazione fare clic su Icona della bacchetta magica per selezionare il repository in cui si desidera caricare i file.
È possibile creare un repository di file specifico per i file da caricare, ad esempio UploadRepository.
2. Nel campo Percorso di destinazione specificare la posizione nel repository in cui si desidera salvare i file caricati.
Ad esempio, immettendo /UploadFiles, i file vengono salvati nella directory /UploadRepository/UploadFiles.
Se si immette /, i file caricati vengono salvati nel repository definito nel passo 1.
* 
I file vengono salvati in una directory che prende il nome dell'oggetto che ha caricato i file. Questa directory si trova sotto il valore del campo Repository di destinazione o Percorso di destinazione.
Ad esempio, se il package viene distribuito nell'oggetto MyThing e il valore del campo Repository di destinazione e Percorso di destinazione è /UploadRepository/UploadFiles, il file viene caricato nella directory /UploadRepository/UploadFiles/MyThing.
* 
Se il percorso specificato nel campo Percorso di destinazione non esiste, il percorso viene creato in Repository di destinazione durante la distribuzione.
3. Nel campo File da caricare immettere il nome del file che si desidera caricare e fare clic su Icona Aggiungi file. Assicurarsi che il file esista nel percorso relativo del dispositivo in uso.
Se si desidera eliminare il file dal repository al termine della distribuzione del package, selezionare la casella di controllo Elimina file dopo caricamento prima di fare clic su Icona Aggiungi file
È possibile includere caratteri jolly come * o ? nei nomi dei file. Utilizzare * per rappresentare più caratteri e ? per rappresentare un solo carattere. Per gli agenti in esecuzione in Windows, il carattere ? Restituisce lo stesso risultato del carattere *.
4. La tabella nel campo File da caricare visualizza l'elenco dei file da caricare in ThingWorx Platform insieme al relativo stato Elimina file dopo caricamento. Da questa tabella è possibile effettuare le operazioni elencate di seguito.
◦ Se si desidera rimuovere un file dall'elenco, selezionarlo e fare clic su Rimuovi. Per selezionare tutti i file, selezionare la casella di controllo sulla barra degli strumenti accanto a Nome file.
◦ Se si desidera modificare lo stato Elimina file dopo caricamento per un file, fare clic su Icona Modifica e selezionare o deselezionare la casella di controllo Elimina file dopo caricamento in base alle esigenze.
5. Per aggiungere l'istruzione all'elenco, fare clic su Aggiungi.
È stato utile?