Creare un'eccezione, istanza o serie di appuntamenti ricorrente
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Quando si crea un master appuntamento ricorrente (serie), Microsoft Dynamics 365 crea singole istanze di appuntamento basate sulle informazioni ricorrenti specificate. È inoltre possibile creare e istanze di appuntamento ricorrente ed eccezioni a tali istanze ed è possibile convertire un appuntamento in un appuntamento ricorrente.
In questo argomento
Creare una serie di appuntamenti ricorrenti
Creare un'istanza di appuntamento ricorrente
Creare un'eccezione appuntamento ricorrente
Convertire un appuntamento in un appuntamento ricorrente
Creare una serie di appuntamenti ricorrenti
Per creare una serie di appuntamenti ricorrenti (un record RecurringAppointmentMaster), è possibile utilizzare il messaggio BookRequest, il messaggio CreateRequest o il metodo IOrganizationService.Create.
Quando si crea una serie di appuntamenti ricorrenti, si verificano le operazioni seguenti:
Viene creato un record RecurringAppointmentMaster (serie si appuntamenti ricorrenti) contenente le informazioni di base e relative alla ricorrenza della serie appuntamenti ricorrenti. È possibile identificare ciascun record in modo univoco utilizzando la proprietà RecurringAppointmentMaster.ActivityId. Inoltre, questa serie di appuntamenti ricorrenti viene creata e archiviata anche come record dell'attività (ActivityPointer). È possibile identificare ciascun record dell'attività in modo univoco utilizzando la proprietà ActivityPointer.ActivityId.
Le istanze di appuntamento ricorrente singole vengono create in base alle informazioni di ricorrenza e sono memorizzate come record Appointment. Questi oggetti appuntamento sono associati alla serie di appuntamenti ricorrenti padre utilizzando la proprietà Appointment.SeriesId e hanno lo stesso valore dell'ID della serie di appuntamenti ricorrenti padre (ActivityPointer.SeriesId).
Il valore della proprietà Appointment.InstanceTypeCode è impostato su Istanza ricorrente (valore dell'elenco a discesa 2) per questi oggetti appuntamento.
Nota
Le istanze appuntamento ricorrente vengono create in base al modello di espansione e dei parametri che lo definiscono.Ulteriori informazioni:Modello di espansione parziale appuntamento ricorrente.
Per il codice di esempio che illustra come creare una serie di appuntamenti ricorrenti, vedere Esempio: creare, recuperare, aggiornare ed eliminare un appuntamento ricorrente.
Creare un'istanza di appuntamento ricorrente
Per creare un'istanza di appuntamento ricorrente (un record RecurringAppointmentMaster ), è possibile utilizzare CreateInstanceRequest. Questo messaggio accetta due parametri: il numero di istanze da creare e la serie di appuntamenti ricorrenti per cui le istanze devono essere create.
Le istanze vengono create dopo l'ultima istanza nella serie di appuntamenti ricorrenti. Inoltre, le istanze vengono create solo fino alla data limite dell'istanza futura, indipendentemente dal numero di istanze specificato per la creazione.
Creare un'eccezione appuntamento ricorrente
Un eccezione viene creata quando si aggiorna o si elimina un'istanza di un appuntamento ricorrente. Le istanze di appuntamento ricorrente sono memorizzate come record di appuntamento come gli altri appuntamenti ed è possibile identificare un'istanza di appuntamento ricorrente utilizzando l'attributo Appointment.InstanceTypeCode di un record di appuntamento, che avrà un valore di Istanza ricorrente (valore dell'elenco a discesa 2).
È possibile creare eccezioni in uno dei modi seguenti:
Utilizzare la classe UpdateRequest nell'entità Appointment per aggiornare un'istanza appuntamento ricorrente e impostare il valore dell'attributo Appointment.InstanceTypeCode su Eccezione ricorrente (valore dell'elenco a discesa 3).
Utilizzare la classe DeleteRequest nell'entità Appointment per eliminare un'istanza di appuntamento ricorrente. Eliminare un'istanza di appuntamento lo contrassegna come eccezione creando una voce per l'istanza nell'attributo RecurringAppointmentMaster.DeletedExceptionsList per l'oggetto serie appuntamento padre.
Utilizzare la classe CreateExceptionRequest nell'entità Appointment.
Convertire un appuntamento in un appuntamento ricorrente
Un appuntamento ricorrente è un appuntamento con informazioni di ricorrenza. È possibile convertire un appuntamento esistente in Microsoft Dynamics 365 in appuntamento ricorrente utilizzando AddRecurrenceRequest. Quando si converte un appuntamento esistente in un appuntamento ricorrente, i dati dall'appuntamento esistente vengono copiati in una nuova istanza master di appuntamento ricorrente e l'appuntamento esistente viene eliminato.
Vedere anche
Entità appuntamento ricorrente
Aggiornare un appuntamento ricorrente
Esempio: creare, recuperare, aggiornare ed eliminare un appuntamento ricorrente
Esempio: convertire un appuntamento in un appuntamento ricorrente
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright