Esecuzione dell'ultima versione semantica

Quando viene richiesta l'ultima versione semantica di un servizio di decisione da eseguire, viene selezionato il servizio di decisione con un identificativo del servizio di decisione specificato e l'ultima versione di distribuzione in ordine di versione semantica.

Versione semantica per i servizi di decisione

Il controllo delle versioni semantico è un formato di controllo delle versioni utilizzato in diversi progetti open source. Questo formato è una convenzione formale per determinare il numero di versione di una nuova release del software e la gravità delle modifiche in ogni nuova release. Per maggiori informazioni sul versioning semantico, vedere https://semver.org/ Il link esterno apre una nuova finestra o scheda.

È possibile utilizzare il formato della versione semantica per creare la versione dei servizi di decisione per il runtime delle decisioni. Specificare le versioni per i propri servizi di decisione prima che vengano distribuiti. Per ulteriori informazioni, consultare Creazione di versioni.

Consultare il formato della versione semantica:
[major].[minor].[patch]-[pre-release]+[build metadata]
Decision Runtime supporta solo un sottoinsieme del formato della versione semantica e non supporta metadati di build:
Tabella 1. Formato della versione semantica supportato nel runtime di decisione
Versione Supportato nel runtime di decisione Obbligatorio o facoltativo Tipo supportato Descrizione
Maggiore Vero Obbligatorio

Numero

Indica che si apportano modifiche API incompatibili.

Minore Vero Obbligatorio

Numero

Indica che si apportano modifiche compatibili con una versione precedente.

Patch Vero Obbligatorio

Numero

Indica che si rendono le correzioni di bug compatibili con una versione precedente.

Pre-release Vero Facoltativo

La stringa

Se si tenta di distribuire un servizio di decisione con un valore per release numerico e non una stringa, si dispone di unHTTP Bad Requeste il servizio di decisione non può essere distribuito.

Indica lo stato di una release.

Ad esempio, è possibile impostare una stringa rc.2 come secondo candidato di release. Decision Runtime supporta solo il formato stringa per la versione pre - release.

Una versione semantica con un valore di rilascio viene ordinata dopo una versione che non ha una versione pre - release. Ad esempio, la versione 2.0.1 è successiva alla versione 2.0.1-rc.2.

Crea metadati N - -

Se il servizio di decisione ha una versione con metadati di build, le informazioni sui metadati di build non vengono prese in considerazione. Il servizio di decisione viene distribuito senza alcun errore o avvertenza.

Il controllo della versione semantica consente di tenere traccia delle modifiche e delle evoluzioni dei propri servizi di decisione; pertanto, è possibile creare diverse release di un servizio di decisione.

Quando si tenta di distribuire un servizio di decisione che non dispone di una versione in formato di versione semantica, il servizio di decisione viene distribuito ma viene restituita un'avvertenza dopo la sua distribuzione.

Quando si utilizza l'API REST di runtime delle decisioni per eseguire un servizio di decisione che contiene qualsiasi versione in formato di versione non semantica, viene restituita un'avvertenza per la prima versione non semantica di questo servizio di decisione.

Utilizzo della versione semantica per l'esecuzione

La versione di distribuzione più aggiornata viene determinata in base al valore nei metadati decisionServiceVersion.

Per ulteriori informazioni relative all'endpoint per eseguire l'ultima versione semantica di un servizio di decisione, consultare la sezione Ultima esecuzione della versione semantica nel riferimento API REST di Decision Runtime in Riferimento.

Il selettore della versione semantica seleziona l'ultima versione semantica di uno specifico servizio di distribuzione per le richieste API REST. I numeri maggiore, minore e patch vengono confrontati numericamente.

Ad esempio:
  • La versione 2.2.1 è successiva alla versione 2.2.0
  • La versione 2.3.0 è successiva alla versione 2.2.1
  • La versione 3.0.0 è successiva alla versione 2.3.0

È anche possibile indicare i numeri principali e secondari per selezionare una versione specifica di un servizio di decisione nelle operazioni API REST.

Ad esempio, se si dispone dello stesso servizio di decisione distribuito con cinque diverse versioni: 4.0.0, 3.0.0, 2.2.1, 2.2.0e 2.1.0:
  • Se si imposta il numero maggiore su 2 e il numero minore su 2, il selettore della versione semantica seleziona la versione 2.2.1.
  • Se si imposta solo il numero principale su 3, la versione 3.0.0 viene selezionata per il servizio di decisione.
  • Se non si impostano né i numeri principali né quelli secondari, viene selezionata l'ultima versione semantica, ovvero la versione 4.0.0.