Creazione guidata Integration Pack

Articolo
11/06/2024

La Creazione guidata Integration Pack (Procedura guidata IP) consente di creare un nuovo Integration Pack da un assembly di integrazione esistente. Gli assembly di integrazione possono essere creati usando l'Activity Wizard della riga di comando (CLIActivityWizard) o Orchestrator SDK. La Procedura guidata IP (IPWizard) crea un pacchetto degli assembly, dei file dipendenti e dei metadati necessari in un .OIP file che può essere distribuito tramite Orchestrator Deployment Manager. È possibile creare Integration Pack dall'aspetto professionale con icone personalizzate e personalizzate complete o semplicemente creare un pacchetto di attività della riga di comando in modo che possano essere distribuite più facilmente tramite la Procedura guidata IP.

Decidere quando creare un Integration Pack

È importante decidere se è opportuno usare le attività singolarmente con le attività di .NET Integration Pack del Toolkit o se è preferibile creare e distribuire tutte le attività in un Integration Pack.

Quando si hanno poche attività o quando ci si trova nella fase di sviluppo e si creano molte modifiche in un'attività, è sufficiente usare gli assembly con le attività del Toolkit .NET Integration Pack per eseguire tali attività nei Runbook. La creazione di pacchetti, la registrazione, la distribuzione, la disinstallazione e l'aggiornamento di Integration Pack comportano un sovraccarico elevato nel processo di sviluppo.

Se si dispone di un gruppo di attività da testare o si è più avanti nel ciclo di sviluppo e si vuole testare l'intero processo end-to-end di installazione o aggiornamento, la creazione di un Integration Pack è l'approccio migliore. Integration Pack offre un'esperienza più intuitiva e un'esperienza di installazione completa. I Integration Pack consentono anche la distribuzione delle attività a più server Runbook o Runbook Designer nell'organizzazione o a clienti esterni.

Creare un nuovo Integration Pack

La Creazione guidata Integration Pack consente di creare Integration Pack dagli assembly compatibili con Orchestrator esistenti e dai file dipendenti. Se non è ancora stato creato un assembly compatibile con Orchestrator, vedere l'Activity Wizard della riga di comando.

Nota

Integration Toolkit non include più i file binari per il set di strumenti XML (WiX) di Windows Installer, usato dalla Procedura guidata IP per la creazione di Integration Pack personalizzati. Installare la versione più recente (v3.11) del set di strumenti WiX prima di usare la Procedura guidata IP.

Per creare un nuovo Integration Pack, seguire questa procedura:

Avviare la Creazione guidata Integration Pack. Selezionare Avvia > Creazione guidata Integration Pack di Orchestrator. Viene visualizzata la pagina iniziale.
Se si vuole aggiornare un Integration Pack esistente, selezionare Importa Integration Pack. Per altre informazioni, vedere Aggiornamento di un Integration Pack esistente. Per creare un nuovo Integration Pack, selezionare Avanti.

Importante

Se si vuole aggiornare un indirizzo IP esistente, è necessario selezionare Importa Integration Pack. Se si seleziona Avanti, l'INDIRIZZO IP creato avrà un nuovo ID prodotto univoco e nuovi ID univoci per tutte le attività, anche se si rieseme un assembly precedente e si usano gli stessi prodotti e nomi file.

Nella pagina Dettagli prodotto immettere o modificare le informazioni necessarie per personalizzare le informazioni sul Integration Pack. La tabella seguente descrive i campi e le relative descrizioni:

Nome campo	Descrizione
Nome prodotto	Nome dell'indirizzo IP visualizzato in Deployment Manager
Nome categoria	Testo visualizzato come titolo della categoria per l'INDIRIZZO IP nel riquadro Attività di Runbook Designer
Company	Nome della società. Queste informazioni vengono visualizzate in Installazione applicazioni in "Publisher"
File EULA	Un file di testo in formato RTF con estensione `.EULA` . Il contratto di licenza viene visualizzato all'utente durante la registrazione tramite Deployment Manager e richiede l'accettazione prima della registrazione.
File di risorse	Assembly contenente icone e altre risorse usate per fornire le icone di categoria e attività. Per impostazione predefinita, viene usato il file di risorse toolkit standard (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll)
Versione	Numero di versione del Integration Pack, che verrà visualizzato in Deployment Manager e usato per determinare se l'INDIRIZZO IP è un aggiornamento.
Abilitare l'aggiornamento	Se è stato importato un Integration Pack esistente, questa casella di controllo è selezionata per impostazione predefinita, consentendo a questo Integration Pack di aggiornare una versione installata esistente. Se si deseleziona questa casella di controllo, verranno creati nuovi ID prodotto e attività per l'INDIRIZZO IP (non aggiornerà una versione esistente). Se si vuole abilitare l'installazione side-by-side di più versioni dell'INDIRIZZO IP, deselezionare questa casella di controllo.
Descrizione	Descrizione dettagliata del Integration Pack
Icona categoria	Viene visualizzata l'icona della categoria predefinita. Se si desidera scegliere un'altra icona, selezionare il pulsante Modifica e selezionare una nuova icona, quindi selezionare OK.

Al termine dell'immissione delle informazioni sul prodotto, selezionare Avanti. Viene visualizzata la pagina Attività. La pagina Attività consente di fare riferimento all'assembly o agli assembly che contengono le attività definite tramite l'Activity Wizard della riga di comando o create con Orchestrator SDK.
Per aggiungere una nuova attività all'INDIRIZZO IP, selezionare Aggiungi.
Per aprire e aggiungere il file di assembly, selezionare il pulsante con i puntini di sospensione (...) a destra di Libreria. Passare al file di assembly desiderato, selezionarlo e selezionare Apri. Il nome e il percorso del file vengono visualizzati nel campo Libreria.
Per selezionare un'attività dall'assembly, selezionare la freccia a discesa Classe e selezionare il nome dell'attività appropriato dall'elenco. Il nome e la descrizione definiti nell'attività vengono visualizzati nei campi Nome visualizzato e Descrizione .
Se necessario, modificare il nome visualizzato e la descrizione dell'attività.
L'icona dell'attività predefinita viene visualizzata per l'attività. Se si desidera un'icona diversa, selezionare Modifica, selezionare un'altra icona dal browser e selezionare OK.
Selezionare OK per salvare la definizione dell'attività. Il nome e la descrizione dell'attività vengono ora visualizzati nell'elenco Attività.
Continuare ad aggiungere attività all'elenco in base alle esigenze. Al termine dell'aggiunta di attività, selezionare Avanti. Viene visualizzata la pagina Dipendenze e File inclusi.
In questa pagina è possibile definire un elenco di file aggiuntivi che si desidera inserire in un pacchetto con il Integration Pack. Questi file possono essere assembly aggiuntivi richiesti dalle attività, dagli script, dalla documentazione o da altri file distribuiti nei server Runbook e nelle finestre di progettazione runbook insieme alle attività. Selezionare Aggiungi, selezionare i file necessari e quindi selezionare OK per aggiungere file all'elenco.
Al termine dell'aggiunta di file all'elenco, selezionare Avanti. Viene visualizzata la pagina File di Orchestrator Integration Pack.
Nella casella di testo specificata immettere il percorso e il nome file del Integration Pack da creare. Se si immette un nome file già esistente, verrà sovrascritto. Assicurarsi di avere accesso sufficiente per la scrittura nel percorso specificato o che il processo avrà esito negativo. Se non viene specificato alcun percorso, il file OIP verrà creato nella cartella Documenti (C:\users\<your username>\Documents). Selezionare Avanti per iniziare a compilare l'INDIRIZZO IP.

Importante

I caratteri nel nome file devono essere validi per la lingua installata nel sistema operativo.

Importante

Specificare un nome per Integration Pack che non è comune per assicurarsi che non corrisponda al nome di un altro Integration Pack. Orchestrator non può installare due Integration Pack con lo stesso nome.
Quando l'INDIRIZZO IP è stato compilato correttamente, la pagina finale della procedura guidata visualizzerà il percorso e il nome file del nuovo file OIP. Selezionare Fine per uscire dalla procedura guidata. Se si verifica un errore, è possibile selezionare Indietro e riprovare il processo di compilazione.

Per informazioni sulla distribuzione di Integration Pack, vedere l'articolo Come aggiungere un Integration Pack.

Aggiornare un Integration Pack esistente

La Creazione guidata Integration Pack di Orchestrator consente di importare un Integration Pack esistente in modo che sia possibile apportare modifiche e riconfezionarlo come nuova versione. Assicurarsi di selezionare la casella di controllo Abilita aggiornamento . In caso contrario, verrà creato un nuovo INDIRIZZO IP invece di sostituire o aggiornare la versione installata precedente.

Suggerimenti utili per l'aggiornamento IP

Aggiornare gli assembly sottostanti

Quando si crea un Integration Pack, i metadati relativi all'IP vengono archiviati nel pacchetto in modo che possano essere letti dalla procedura guidata durante gli aggiornamenti successivi. Quando si aggiornano determinati elementi, ad esempio attività o assembly sottostanti per tali attività, è necessario ricompilare l'INDIRIZZO IP. Tuttavia, se si modificano le impostazioni dell'attività e si seleziona un nuovo file di assembly, i campi verranno reimpostati nella pagina Informazioni attività, richiedendo di immettere di nuovo le informazioni.

È possibile mantenere le impostazioni di configurazione IP durante la modifica solo dell'assembly. Salvare il nuovo assembly nello stesso percorso e nello stesso nome file dell'assembly precedente, visualizzato nel campo Libreria della finestra di dialogo Informazioni attività.

Migrazione del Pacchetto di integrazione QIK

Se è stato creato un Integration Pack usando la Procedura guidata opalis QIK, sarà necessario convertirlo in modo che sia compatibile con Orchestrator prima di poterlo importare e usare da Orchestrator.

Prima di convertire un INDIRIZZO IP, è necessario completare i passaggi seguenti:

Se le attività nell'INDIRIZZO IP sono state create usando la procedura guidata dell'interfaccia della riga di comando di QIK, è necessario seguire la procedura descritta in Migrazione attività dell'interfaccia della riga di comando di QIK per renderle compatibili con Orchestrator. Se non si dispone di una copia separata dell'assembly contenente le attività, è necessario installare prima l'INDIRIZZO IP in un server Opalis 6.3 e quindi individuare l'assembly nella directory seguente: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3.
Se le attività nell'INDIRIZZO IP sono state sviluppate in C# usando l'API Opalis, è necessario seguire i passaggi descritti in Migrazione delle attività personalizzate dell'API QIK per renderle compatibili con Orchestrator.

Nota

Le attività basate su Java che usano l'API Opalis per Java non sono più supportate da Integration Toolkit o da Orchestrator.
Se l'INDIRIZZO IP contiene file dipendenti o altri file inclusi, questi file devono essere disponibili per ripacchetto nel nuovo INDIRIZZO IP. Se non si dispone di una copia separata di questi file, è necessario installare prima l'indirizzo IP in un server Opalis 6.3 e quindi individuare i file nella directory seguente: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Bin.
Se l'INDIRIZZO IP contiene un file di risorse personalizzato usato per le icone di attività e categorie, tale file deve essere disponibile per il nuovo INDIRIZZO IP. Se non si dispone di una copia separata di questo file, è necessario installare prima l'indirizzo IP in un server Opalis 6.3 e quindi individuare il file nella directory seguente: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.
Se l'INDIRIZZO IP ha usato le icone standard fornite da QIK per le icone di categoria o attività e si desidera continuare a usare tali icone anziché usare le nuove icone fornite in Orchestrator, sarà necessario ottenere il Opalis.QIK.Wizard.Images.dll file e usarlo come file di risorse personalizzato. Se non si dispone di una copia separata di questo file, è necessario installare prima l'indirizzo IP in un server Opalis 6.3 e quindi individuare il file nella directory seguente: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.

Nota

Per il processo di conversione più semplice, è consigliabile inserire tutti questi file nei percorsi in cui si trovavano quando l'IP è stato originariamente incluso nel pacchetto prima di avviare la Procedura guidata IP. La procedura guidata IP fa riferimento a questi file in base ai percorsi originali. La selezione di un nuovo percorso è possibile per tutti i file, ma la selezione di un nuovo percorso per gli assembly contenenti le attività comporterà la reimpostazione di alcuni dettagli dell'attività, richiedendo di immettere di nuovo le informazioni. Usando i percorsi originali per i file, le informazioni esistenti vengono semplicemente riutilizzate senza dover immetterla nuovamente.

Convertire un Integration Pack compatibile con Opalis

Avviare la Creazione guidata Integration Pack
Selezionare Import Integration Pack (Importa Integration Pack).
Selezionare il file OIP esistente e selezionare Apri.
Verrà visualizzato un messaggio di avviso che indica che l'indirizzo IP non è compatibile con Orchestrator. Seleziona OK.
Modificare i dettagli del prodotto in base alle esigenze per riflettere eventuali modifiche. Il numero di versione dell'IP viene incrementato automaticamente e la casella di controllo "Aggiorna" è selezionata. Selezionare Avanti.
Nella pagina Attività esaminare ogni attività e assicurarsi che le informazioni siano completate correttamente. Se l'assembly per l'attività non è stato migrato o non si trova nella stessa posizione in cui si trovava al momento della creazione dell'indirizzo IP, il campo Classe sarà vuoto. Per evitare la necessità di digitare nuovamente informazioni, è necessario sostituire l'assembly prima di avviare la procedura guidata.
Al termine della modifica delle attività, selezionare Avanti.
Verificare che i file dipendenti siano ancora nella stessa posizione visualizzata o rimuoverli e aggiungere nuovi file dipendenti. Selezionare Avanti.
Immettere un percorso e un nome file per il nuovo file IP. Non usare lo stesso nome dell'INDIRIZZO IP precedente in modo che sia possibile assicurarsi di conservare una copia dell'INDIRIZZO IP precedente. Selezionare Avanti per compilare l'INDIRIZZO IP.

È ora disponibile un indirizzo IP compatibile con Orchestrator e può essere registrato e distribuito tramite Orchestrator Deployment Manager.

Integration Pack : problemi noti

Limitazione della lunghezza del nome file

Quando si includono assembly nel Integration Pack, questi vengono aggiunti automaticamente al Registro di sistema dal programma di installazione. A causa della limitazione nella lunghezza del nome della chiave del Registro di sistema, il percorso combinato e il nome file di un assembly non possono superare i 234 caratteri. Dato il percorso predefinito in cui vengono posizionati gli assembly all'interno di un IP, la lunghezza massima del nome file di un file di assembly incluso non può superare 80 caratteri. Se un assembly con un nome di file superiore a 80 caratteri viene incluso nell'installazione, l'installazione avrà esito negativo.

Risorse di Orchestrator

Oltre a questo riferimento online fornito per System Center Orchestrator, sono disponibili molte risorse che possono fornire informazioni aggiuntive sulla compilazione di runbook, sull'uso di Integration Toolkit e sulle procedure consigliate.

Condividi tramite