Promozione dei design REST nei propri ambienti di produzione

Quando si progettano nuove parti del proprio sistema, raccomandiamo sempre di progettare queste nuove parti in un'istanza di sviluppo, testarle accuratamente e poi trasferire questi progetti alla produzione, piuttosto che applicare qualsiasi nuovo contenuto direttamente all'ambiente di produzione.Ciò è particolarmente importante quando si progettano funzioni che utilizzano il comportamento REST.

Per informazioni sulla progettazione e l'uso del comportamento del Servizio Web REST, vedere Collegamento di oggetti ai Servizi Web REST. Per maggiori dettagli sulla promozione dei design REST ai propri ambienti di produzione, vedere la Community Ivanti.

La creazione di un progetto utilizzando il servizio Web REST crea un insieme di nuovi oggetti quando si aggiunge il comportamento a un oggetto. Sarà quindi necessario trasferire tali oggetti nei propri ambienti di produzione. Questa sezione delinea i passi necessari per promuovere il progetto da un ambiente non di produzione a un ambiente di produzione. È possibile utilizzare Test to Live o Trasferimento progettazione.

Test to Live

Test-to-Live consente di promuovere l'intero progetto, inclusi oggetti, finestre, le impostazioni della connessione REST e le definizioni di Corpo richiesta usando l'applicazione Test to Live.

Il corpo del payload REST è memorizzato in un elenco di riferimento nell'oggetto elenco di riferimento CorpoOggetto. Test to Live effettua la migrazione dei soli elenchi di riferimento NUOVI, pertanto se si aggiorna o si elimina uno qualsiasi di questi elementi, sarà necessario aggiornarli nel sistema di produzione manualmente. Per ulteriori informazioni sull'utilizzo di Test to Live, vedere Test to Live.

Trasferimento progettazione

Questa sezione descrive come utilizzare Trasferimento progettazione per promuovere un progetto REST in un ambiente di produzione. Per ulteriori informazioni su Trasferimento progettazione, vedere Esportazione di progettazioni dal proprio database con Trasferimento progettazione e Importazione di elementi nel database.

Trasferimento progettazione non trasferisce le credenziali Servizio Web REST o le definizioni del contenuto corpo, pertanto le seguenti informazioni devono essere pronte a essere inserite dopo il completamento dell'importazione Trasferimento progettazione:

  • URI end point
  • I dettagli di autenticazione se si sceglie Base o Chiave API (Provider)
  • I dettagli Mapping risposta, se necessari
  • Il contenuto Corpo richiesta

Non aggiungere la progettazione oggetti o finestre per l'oggetto Corpo richiesta al file di Trasferimento progettazione.Ciò causerà un errore quando si cerca di eseguire l'importazione.

Sarà necessario creare due file di esportazione: uno per la progettazione Oggetto e uno per i dati di Finestra e Corpo REST.

Per creare il file di esportazione 1, il file Progettazione oggetto:

  1. Avviare il componente Trasferimento progettazione sul proprio sistema di origine, quindi navigare fino alla cartella Oggetti business.
  2. Espandere la cartella modulo in cui si è creato l'oggetto REST.
  3. Espandere la cartella Attributi dell'oggetto di livello superiore.
  4. Selezionare la raccolta associata all'oggetto REST e includere gli oggetti dipendenti.
    Ciò seleziona anche l'oggetto REST per l'inclusione.
  5. Espandere la cartella Attributi dell'oggetto REST e assicurarsi che tutti gli attributi rimanenti siano selezionati.
  6. Sull'elenco Azioni, fare clic su Esporta elementi selezionati quindi salvare il file.

Per creare il file di esportazione 2, i dati Finestra e Corpo REST:

  1. Riavviare il componente Trasferimento progettazione e navigare nella cartella Riferimento.
  2. Espandere l'Elenco di riferimento, quindi la cartella modulo contenente l'oggetto REST.
  3. Fare clic con il pulsante destro del mouse sulla cartella oggetto, quindi fare clic su Seleziona.
    Tutte le definizioni di Corpo richiesta risultano selezionate. In alternativa, espandere la cartella e selezionare le definizioni richieste.

    4. Saranno trasferiti solo i nomi delle definizioni corpo richiesta. È necessario aggiungere le definizioni corpo richiesta dopo aver importato i file Trasferimento progettazione.

  4. Navigare nella cartella Windows ed espandere la cartella modulo contenente l'oggetto REST.
  5. Espandere la cartella oggetto REST e selezionare la finestra richiesta. Non includere oggetti dipendenti.
  6. Sull'elenco Azioni, fare clic su Esporta elementi selezionati quindi salvare il file.

Ora che si sono creati i due file di Trasferimento progettazione, è possibile importare la progettazione nel sistema di destinazione.

Per importare la progettazione nel sistema di destinazione:

  1. Nel sistema di destinazione, aprire il componente Trasferimento progettazione e selezionare l'opzione Importa.
  2. Sull'elenco Azioni, fare clic su Apri file di importazione e selezionare il file 1 creato sopra.
  3. Per l'avviso Oggetto indicato mancante, selezionare Lasciare il valore non impostato, quindi fare clic su Importa.
    Il file si carica e l'oggetto Corpo REST viene creato.
  4. Fare clic su OK.
  5. Sull'elenco Azioni, fare clic su Apri file di importazione e selezionare il file 2 creato sopra.
    Una volta caricato, apparirà una serie di avvisi.
  6. Per tutti gli avvisi Conflitto oggetto nel sistema, selezionare l'opzione Non creare nuovo….
  7. Per l'avviso Oggetto indicato mancante, selezionare Lasciare il valore non impostato.
  8. Fare clic su Importa.
    La finestra selezionata per l'oggetto principale REST viene creata e le voci dell'elenco di riferimento del corpo REST selezionato vengono popolate.
  9. Fare clic su OK.

La parte basata su file dell'importazione è completa. Ora è necessario completare gli aggiornamenti manuali al sistema di destinazione.

Per completare gli aggiornamenti manuali per il trasferimento della progettazione:

  1. In Progettazione oggetti, aprire l'oggetto REST.
  2. Visualizzare le impostazioni Servizi Web REST sull'oggetto e aggiungere i dettagli di connessione, quindi salvare le modifiche.
  3. In Gestione finestre, navigare nel modulo, quindi nell'oggetto REST e fare clic con il pulsante destro del mouse sulla finestra e selezionare Rendi disponibile in Web Access.
  4. Fare clic con il pulsante destro del mouse sull'oggetto Corpo richiesta e creare una finestra adatta per l'elenco di riferimento.
  5. Nel componente Amministrazione, espandere l'albero Elenchi di riferimento:
  6. Espandere il modulo contenente l'oggetto REST e aggiornare le definizioni Corpo richiesto in base alle proprie esigenze.Ora è possibile aggiungerne altri qui.
    L'oggetto REST e i dati associati sono pronti per l'uso.