Aggiornare un appuntamento ricorrente
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
È possibile aggiornare l'intera serie o aggiornare un'istanza di un appuntamento ricorrente.
Aggiornare una serie di appuntamento ricorrente
È possibile aggiornare una serie di appuntamento ricorrente utilizzando il metodo IOrganizationService.Update o il messaggio UpdateRequest nell'entità RecurringAppointmentMaster. È possibile aggiornare le informazioni di base o ricorrenza.
Aggiornare le informazioni di base
Quando si aggiornano le informazioni di base di una serie di appuntamento ricorrente, ad esempio argomento, posizione o partecipanti, tutte le istanze della serie di appuntamento ricorrente vengono aggiornate con l'eccezione di quelle che hanno eccezioni sullo stesso attributo.
Aggiornare le informazioni sulla ricorrenza
Quando si aggiornano le informazioni ricorrenti di una serie di appuntamento ricorrente, come criterio e intervallo, si verifica quanto segue:
Una nuova serie con un nuovo RecurringAppointmentMaster.ActivityId viene creato con le stesse informazioni della serie originale e la data nell'attributo RecurringAppointmentMaster.EffectiveEndDate della nuova serie è impostata sull'ultima istanza passata della serie originale che si è verificata. Tutte le istanze future della serie originale vengono eliminate. In questo modo, la serie originale viene terminata e la cronologia delle istanze passate viene mantenuta nel sistema archiviandola in una nuova serie.
Le nuove informazioni verranno utilizzate per creare le istanze future di nuova serie dalla data di inizio effettiva (RecurringAppointmentMaster.EffectiveStartDate).
Inoltre, l'attributo RecurringAppointmentMaster.GroupId sia per la serie originale che per la nuova viene popolato con lo stesso valore. Questo implica che quando si aggiornano le informazioni di ricorrenza in una serie di appuntamento ricorrente, qualsiasi nuova serie creata ha lo stesso valore dell'attributo RecurringAppointmentMaster.GroupId come la serie di appuntamento ricorrente che viene aggiornata, anche se ogni serie dispone di un ID serie univoco.
Nota
Quando si aggiornano le informazioni di ricorrenza di una serie di appuntamento ricorrente che ha tutte le istanze che si verificheranno nel futuro, tutte le istanze vengono eliminate e le nuove informazioni di ricorrenza vengono utilizzate per creare o espandere le nuove istanze.
Per visualizzare il codice di esempio per aggiornare una serie di appuntamento ricorrente, vedere Esempio: ripianificare e annullare un appuntamento ricorrente.
Aggiornare un'istanza di appuntamento ricorrente
Poiché i record di appuntamento ricorrente vengono memorizzati come oggetti appuntamento, è possibile utilizzare il metodo IOrganizationService.Update nell'entità Appointment per aggiornare un'istanza di appuntamento ricorrente. Quando si aggiorna un'istanza di appuntamento ricorrente, l'istanza verrà contrassegnata come eccezione alla serie di appuntamento ricorrente.Ulteriori informazioni:Creare un'eccezione appuntamento ricorrente
È inoltre possibile utilizzare la classe CreateExceptionRequest nell'entità Appointment per aggiornare un'istanza di appuntamento ricorrente.
Suggerimento
Le istanze di appuntamento ricorrente possono essere identificate utilizzando l'attributo Appointment.InstanceTypeCode che avrà un valore di "2" (istanza ricorrente).Ulteriori informazioni:Metodi e messaggi dell'entità Appointment
Vedere anche
Entità appuntamento ricorrente
Elimina o termina un'istanza o serie di appuntamenti ricorrenti
Esempio: creare, recuperare, aggiornare ed eliminare un appuntamento ricorrente
Esempio: ripianificare e annullare un appuntamento ricorrente
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright