Verhalten und Format des Datums- und Uhrzeitattributes

Wenn Sie Über Benutzer und Büros auf der ganzen Welt verfügen, ist es wichtig, Datums- und Uhrzeitwerte in mehreren Zeitzonen ordnungsgemäß darzustellen. Die DateTimeAttributeMetadata (DateTimeAttributeMetadata EntityType oder DateTimeAttributeMetadata Klasse) wird verwendet, um Attribute vom Typ DateTime in Dynamics 365 Customer Engagement (lokal) zu definieren und zu verwalten. Verwenden Sie die Eigenschaft (Für den DateTimeBehavior Organisationsdienst siehe .DateTimeAttributeMetadata), um zu definieren, DateTimeBehaviorob Datums- und Uhrzeitwerte mit oder ohne Zeitzoneninformationen gespeichert werden sollen, und verwenden Sie die DateTimeAttributeMetadata.Format Eigenschaft, um das Anzeigeformat dieser Attribute anzugeben.

Sie können auch den Anpassungsbereich in Customer Engagement verwenden, um das Verhalten und Format der Datums- und Uhrzeitattribute zu definieren. Weitere Informationen: Verhalten und Format des Datums- und Uhrzeitfelds

Angeben des Verhaltens eines Datums- und Uhrzeitattributes

Sie können den DateTimeBehavior (DateTimeBehavior ComplexType oder DateTimeBehavior die Klasse) verwenden, um einen Wert für den DateTimeAttributeMetadata EntityType anzugeben. DateTimeBehavior-Eigenschaft. Enthält DateTimeBehavior die folgenden Elemente; jedes Element gibt eine Zeichenfolge mit demselben Wert wie der Membername zurück:

Der folgende Beispielcode veranschaulicht, wie ein UserLocal Verhalten für ein neues Datum-Uhrzeit-Attribut festgelegt wird:

// Create a date time attribute for the Account entity
// with the UserLocal behavior
dtAttribute = new DateTimeAttributeMetadata
{                             
    SchemaName = "new_SampleDateTimeAttribute",
    DisplayName = new Label("Sample Date Time Attribute", _languageCode),
    RequiredLevel = new AttributeRequiredLevelManagedProperty(AttributeRequiredLevel.None),                
    Description = new Label("Created by SDK Sample", _languageCode),                
    DateTimeBehavior = DateTimeBehavior.UserLocal,
    Format = DateTimeFormat.DateAndTime,
    ImeMode = ImeMode.Disabled
};

CreateAttributeRequest createAttributeRequest = new CreateAttributeRequest
{
    EntityName = Account.EntityLogicalName,
    Attribute = dtAttribute
};
_serviceProxy.Execute(createAttributeRequest);
Console.WriteLine("Created attribute '{0}' with UserLocal behavior\nfor the Account entity.\n", 
                            dtAttribute.SchemaName);

Im Beispielcode können Sie auch den Wert der DateTimeBehavior Eigenschaft festlegen, indem Sie den Zeichenfolgenwert direkt angeben: DateTimeBehavior = "UserLocal"

Wenn Sie das Verhalten beim Erstellen eines Datums- und Uhrzeitattributes nicht angeben, wird das Attribut standardmäßig mit dem UserLocal Verhalten erstellt. Den vollständigen Beispielcode finden Sie unter "Beispiel: Konvertieren von Datums- und Uhrzeitwerten".

Angeben des Formats des Datums- und Uhrzeitattributes

Verwenden Sie die Format Eigenschaft, um das Datums-/Uhrzeitanzeigeformat des Attributs unabhängig davon anzugeben, wie es im System gespeichert wird. Sie können die DateTimeFormat Enumeration (DateTimeFormat EnumType oder DateTimeFormat Enumeration) verwenden, um das Anzeigeformat anzugeben: DateAndTime oder DateOnly.

Wenn die DateTimeAttributeMetadata.DateTimeBehavior Eigenschaft auf DateOnly"Festgelegt" festgelegt ist, können Sie den Wert der DateTimeAttributeMetadata.Format Eigenschaft nicht festlegen oder ändern in DateAndTime.

Datums- und Uhrzeitabfrageoperatoren, die für das DateOnly-Verhalten nicht unterstützt werden

Zeitbezogene Abfrageoperatoren werden für das DateOnly Verhalten nicht unterstützt. Abgesehen von den hier aufgelisteten zeitspezifischen Abfrageoperatoren werden alle anderen Abfrageoperatoren unterstützt.

• Älter als X Minuten

• Älter als X Stunden

• Letzte X Stunden

• Nächste x Stunden

  Weitere Informationen: Datums- und Uhrzeitabfrageoperatoren in FetchXML

Ändern des Verhaltens eines Datums- und Uhrzeitattributes

Sie können ein Datums- und Uhrzeit-Attribut aktualisieren, um sein Verhalten zu ändern, wenn die System Customizer-Rolle in Ihrer Dynamics 365 Customer Engagement (lokalen) Instanz und die DateTimeAttributeMetadata.CanChangeDateTimeBehavior verwaltete Eigenschaft für das Datums- und Uhrzeit-Attribut auf festgelegt Trueist.

• Das Verhalten und die CreatedOnModifiedOn Attribute für die vordefinierten und benutzerdefinierten Entitäten sind standardmäßig festgelegt UserLocal , und die DateTimeAttributeMetadata.CanChangeDateTimeBehavior verwaltete Eigenschaft ist auf festgelegt False, was bedeutet, dass Sie das Verhalten dieser Attribute nicht ändern können. Obwohl Benutzer den Wert der DateTimeAttributeMetadata.CanChangeDateTimeBehavior verwalteten Eigenschaft dieser Attribute für benutzerdefinierte Entitäten ändern können, können sie das Verhalten der Attribute dennoch nicht ändern.

• Für neue benutzerdefinierte Datums- und Uhrzeitattribute wird die DateTimeAttributeMetadata.CanChangeDateTimeBehavior verwaltete Eigenschaft auf .True Dies bedeutet, dass Sie das Verhalten eines benutzerdefinierten Datums- und Uhrzeitattributes von UserLocal einem oder zu einem DateOnly anderen TimeZoneIndependentVerhalten ändern können. Es sind keine anderen Verhaltensübergänge zulässig.

  Für benutzerdefinierte Datums- und Uhrzeitattribute, die Teil einer Dynamics 365 Customer Engagement -Organisation (lokal) sind, die auf CRM Online 2016 Update oder Dynamics 365 (online), Version 8.2 (lokal) aktualisiert wird, wird die DateTimeAttributeMetadata.CanChangeDateTimeBehavior verwaltete Eigenschaft so festgelegt True , dass das Attribut oder die übergeordnete Entität nicht anpassbar ist.

  Hinweis

  Wenn Sie DateTimeAttributeMetadata.DateTimeBehavior die Eigenschaft eines Attributs von UserLocal auf DateOnlyaktualisieren, stellen Sie sicher, dass Sie auch dieDateTimeAttributeMetadata.Format Eigenschaft von "DateAndTimeinDateOnly" ändern. Andernfalls tritt eine Ausnahme auf.

• Die folgenden vordefinierten Datums- und Uhrzeitattribute in CRM Online 2015 Update 1 und Dynamics 365 (online), Version 8.2 (lokal) sind standardmäßig auf diese Attribute festgelegt, und die DateOnly verwaltete Eigenschaft ist auf DateTimeAttributeMetadata.CanChangeDateTimeBehavior diese Attribute festgelegtFalse, was bedeutet, dass Sie das Verhalten für diese Attribute nicht ändern können:

  Datums- und Uhrzeit-Attribut	Übergeordnete Entität
  Jahrestag	Kontakt
  Geburtsdatum	Kontakt
  Fälligkeitsdatum	Rechnung
  estimatedclosedate	Blei
  actualclosedate	Gelegenheit
  estimatedclosedate	Gelegenheit
  endgültige Entscheidungstermin	Gelegenheit
  validfromdate	Produkt
  validtodate	Produkt
  geschlossen am	Angebot
  expireson	Angebot

  Wenn diese vordefinierten Datums- und Uhrzeitattribute jedoch zu einer Organisation gehören, die auf Dynamics CRM Online 2016 Update oder Dynamics 365 (online), Version 8.2 (lokal) aktualisiert wird, wird das Verhalten dieser Attribute auf und die UserLocal verwaltete Eigenschaft DateTimeAttributeMetadata.CanChangeDateTimeBehavior in der aktualisierten Organisation festgelegtTrue, und Sie können das Verhalten dieser Attribute nur auf diese Attribute DateOnly ändern. Es sind keine anderen Verhaltensübergänge zulässig.

  Nach dem Aktualisieren des Verhaltens eines Attributs müssen Sie die Anpassungen veröffentlichen, damit die Änderung wirksam wird. Durch das Aktualisieren des Verhaltens eines Datums- und Uhrzeitattributes wird sichergestellt, dass alle eingegebenen/aktualisierten Werte nach änderung des Attributverhaltens im System gemäß dem neuen Verhalten gespeichert werden. Dies wirkt sich nicht auf die Werte aus, die bereits in der Datenbank gespeichert sind, und sie werden weiterhin als UTC-Werte gespeichert. Wenn Sie jedoch die vorhandenen Werte mithilfe des SDK abrufen oder in der Benutzeroberfläche anzeigen, werden die vorhandenen Werte gemäß dem neuen Verhalten des Attributs angezeigt. Wenn Sie z. B. das Verhalten eines benutzerdefinierten Attributs für eine Kontoentität geändert UserLocalDateOnly und einen vorhandenen Kontodatensatz mithilfe des SDK abgerufen haben, wird das Datum und die Uhrzeit als <Datum> gefolgt von der Uhrzeit 12:00 (00:00:00) angezeigt. Ebenso wird für die Verhaltensänderung von UserLocal zu TimeZoneIndependent" der tatsächliche Wert in der Datenbank wie ohne Zeitzonenkonvertierungen angezeigt.

  Der folgende Beispielcode veranschaulicht, wie das Verhalten eines Datums- und Uhrzeitattributes aktualisiert wird:

  
  
  // Retrieve the attribute to update its behavior and format
  RetrieveAttributeRequest attributeRequest = new RetrieveAttributeRequest
  {
      EntityLogicalName = Account.EntityLogicalName,
      LogicalName = "new_sampledatetimeattribute",
      RetrieveAsIfPublished = false
  };
  // Execute the request
  RetrieveAttributeResponse attributeResponse =
                  (RetrieveAttributeResponse)_serviceProxy.Execute(attributeRequest);
  
  Console.WriteLine("Retrieved the attribute '{0}'.",
                  attributeResponse.AttributeMetadata.SchemaName);
  
  // Modify the values of the retrieved attribute
  DateTimeAttributeMetadata retrievedAttributeMetadata =
                  (DateTimeAttributeMetadata)attributeResponse.AttributeMetadata;
  retrievedAttributeMetadata.DateTimeBehavior = DateTimeBehavior.DateOnly;
  retrievedAttributeMetadata.Format = DateTimeFormat.DateOnly;
  
  // Update the attribute with the modified value
  UpdateAttributeRequest updateRequest = new UpdateAttributeRequest
  {
      Attribute = retrievedAttributeMetadata,
      EntityName = Account.EntityLogicalName,
      MergeLabels = false
  };
  _serviceProxy.Execute(updateRequest);
  Console.WriteLine("Updated the behavior and format of '{0}' to DateOnly.",
      retrievedAttributeMetadata.SchemaName);
  
  // Publish customizations to the account entity
  PublishXmlRequest pxReq = new PublishXmlRequest
  {
      ParameterXml = String.Format("<importexportxml><entities><entity>account</entity></entities></importexportxml>")
  };
  _serviceProxy.Execute(pxReq);
  Console.WriteLine("Published customizations to the Account entity.\n");
  
  

  Den vollständigen Beispielcode finden Sie unter "Beispiel: Konvertieren von Datums- und Uhrzeitwerten".

Konvertieren des Verhaltens vorhandener Datums- und Uhrzeitwerte in der Datenbank

Wenn Sie ein Datums- und Uhrzeit-Attribut aktualisieren, um sein Verhalten von UserLocal zu DateOnly oder TimeZoneIndependentzu ändern, werden die vorhandenen Attributwerte in der Datenbank nicht automatisch konvertiert. Die Verhaltensänderung wirkt sich nur auf die Werte aus, die in das Attribut eingegeben oder aktualisiert werden, nachdem das Verhalten geändert wurde. Die vorhandenen Datums- und Uhrzeitwerte im System befinden sich weiterhin in UTC und werden von Dynamics 365 Customer Engagement (lokal) entsprechend dem neuen Verhalten angezeigt, wenn sie über DAS SDK oder in der Benutzeroberfläche abgerufen werden, wie im vorherigen Abschnitt erläutert. Bei Attributen, deren Verhalten sich von "UserLocalInDateOnly" geändert hat, können Sie die vorhandenen UTC-Werte in der Datenbank in einen geeigneten DateOnly Wert konvertieren, um Datenanomalien mithilfe der ConvertDateAndTimeBehavior Nachricht zu vermeiden.

Mit der Meldung können Sie eine Konvertierungsregel (wenn Sie mit dem Organisationsdienst arbeiten) angeben, um die Zeitzone auszuwählen, ConversionRuledie für die Konvertierung der Werte von UTC in DateOnly verwendet werden soll. Sie können eine der folgenden Konvertierungsregeln angeben:

• SpecificTimeZone: Wandelt den UTC-Wert gemäß dem angegebenen Dynamics 365 Customer Engagement -Code (lokal) in einen DateOnly-Wert um. In diesem Fall müssen Sie auch einen Wert für den TimeZoneCode Parameter angeben.

• CreatedByTimeZone: Wandelt UTC-Wert in einen DateOnly-Wert um, den der Benutzer, der den Datensatz erstellt hat, in der Benutzeroberfläche sehen würde.

• OwnerTimeZone: Wandelt UTC-Wert in einen DateOnly-Wert um, den der Benutzer, der den Datensatz besitzt, in der Benutzeroberfläche sehen würde.

• LastUpdatedByTimeZone: Wandelt UTC-Wert in einen DateOnly-Wert um, den der Benutzer, der den Datensatz zuletzt aktualisiert hat, in der Benutzeroberfläche angezeigt würde.

  Sie können eines der vier Member der DateTimeBehaviorConversionRule Klasse verwenden, um einen gültigen Wert für den ConversionRule Parameter anzugeben.

Wenn Sie den ConvertDateAndTimeBehavior (siehe Organisationsdienst) ausführen, wird ein Systemauftrag (asynchroner Vorgang) erstellt, ConvertDateAndTimeBehaviorRequest um die Konvertierungsanforderung auszuführen. Das ConvertDateAndTimeBehaviorResponse.JobId Attribut in der Nachrichtenantwort zeigt die ID des Systemauftrags an, der als Ergebnis der Konvertierungsanforderung erstellt wird. Überprüfen Sie nach Abschluss des Systemauftrags die Auftragsdetails (AsyncOperation.Message), um ggf. Konvertierungsdetails oder Fehler anzuzeigen.

Einige wichtige Punkte, die bei der Verwendung der ConvertDateAndTimeBehavior Nachricht berücksichtigt werden müssen:

• Während der Ausführung der Nachricht, z. B. das Importieren einer Lösung oder das Löschen eines Attributs oder einer übergeordneten Entität, sollten Sie keine wesentlichen Änderungen an den Lösungen in Customer Engagement vermeiden. Dies kann zu unerwartetem Verhalten führen; es treten jedoch keine Datenverluste auf.

• Durch die Ausführung der Nachricht werden keine Workflows und Plug-Ins ausgeführt, die im System vorgenommen wurden.

• Durch die Ausführung der Nachricht werden im System vorgenommene Aktualisierungen nicht den Wert "Zuletzt geändert am" für die Attribute geändert, sondern überwacht, um den Administratoren zu helfen, den Zeitpunkt der Konvertierung und die ursprünglichen/geänderten Werte für ein Attribut zu ermitteln.

  Der folgende Beispielcode zeigt, wie die Nachricht verwendet wird:

  
  
  ConvertDateAndTimeBehaviorRequest request = new ConvertDateAndTimeBehaviorRequest()
  {
      Attributes = new EntityAttributeCollection() 
              { 
                  new KeyValuePair<string, StringCollection>("account", new StringCollection() 
                  { "new_sampledatetimeattribute" }) 
              },
      ConversionRule = DateTimeBehaviorConversionRule.SpecificTimeZone.Value,
      TimeZoneCode = 190, // Time zone code for India Standard Time (IST) in CRM
      AutoConvert = false // Conversion must be done using ConversionRule
  };
  
  // Execute the request
  ConvertDateAndTimeBehaviorResponse response = (ConvertDateAndTimeBehaviorResponse)_serviceProxy.Execute(request);
  
  

  Den vollständigen Beispielcode finden Sie unter Beispiel: Konvertieren von Datums- und Uhrzeitwerten

Siehe auch

Beispiel: Konvertieren von Datums- und Uhrzeitwerten
Funktionsweise und Format des Datums- und Uhrzeitfelds
Anpassen von Entitätsattributmetadaten
ConvertDateAndTimeBehaviorRequest
DateTimeAttributeMetadata