Benutzerdefinierte Aktivitäten

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

In Microsoft Dynamics 365 können Sie benutzerdefinierte Aktivitäten erstellen, um den Kommunikationsbedarf eines modernen Unternehmens zu unterstützen, wie z. B. Instant Messaging (IM) und Short Message Service (SMS). Um eine benutzerdefinierte Aktivität in Dynamics 365 zu erstellen, erstellen Sie eine benutzerdefinierte Entität, und legen diese als Aktivitätsentität mithilfe der EntityMetadata.IsActivity-Eigenschaft fest.

Im Unterschied zu anderen benutzerdefinierten Entitäten können Sie kein primäres Attribut für eine benutzerdefinierte Aktivität angeben, da standardmäßig jede benutzerdefinierte Aktivität über ein primäres Attribut mit dem Namen ”Subject”. verfügen muss.

Wenn Sie eine benutzdefinierte Aktivitätsentität erstellen, werden alle Rechte der activitypointer-Entität von der benutzerdefinierten Aktivität vererbt. Außerdem werden alle Aktivitätsparteitypen für die benutzerdefinierte Aktivität verfügbar, und als Ergebnis werden auch die entsprechenden Eigenschaften vererbt.

1:n-Beziehungen für eine benutzerdefinierte Aktivität können auf die gleiche Weise erstellt werden wie bei anderen Aktivitäten, und auch vorhandene Beziehungen können aktualisiert werden.

Rechte und Zugriffsrechte

Sie benötigen denselben Satz von Dynamics 365-Rechten und -Zugriffsrechten , um benutzerdefinierten Aktivitäten zu verwenden wie die, die nötig sind, um benutzerdefinierte Entitäten zu verwenden. Weitere Informationen zu bentzerdefinierten Entitäten finden Sie unter Anpassen von Entitätsmetadaten.

Erstellen einer benutzerdefinierten Aktivität

Um eine beutzerdefinierte Aktivitätsentität zu erstellen, legen Sie die Werte der Eigenschaften fest, die in der folgenden Tabelle aufgeführt sind.

Eigenschaftenname	Wert	Notizen
EntityMetadata.IsActivity	true	Geben Sie die benutzerdefinierte Entität als Aktivitätsentität an.
EntityMetadata.IsAvailableOffline	true	Eine benutzerdefinierte Aktivitätsentität muss eine Offlineverfügbarkeit besitzen.
EntityMetadata.IsMailMergeEnabled	false	Für eine benutzerdefinierte Aktivitätsentität kann Seriendruck nicht aktiviert werden.
EntityMetadata.OwnershipType	OwnershipTypes.TeamOwned oder OwnershipTypes.UserOwned	Eine benutzerdefinierte Entität kann sich entweder im Besitz Teams oder eines Benutzers befinden.
EntityMetadata.ActivityTypeMask	0 - None oder 1 – Kommunikationsaktivität	(Optional) Geben Sie an, dass eine benutzerdefinierte Aktivität während der Aktivitätsmenüs in der Webanwendung angezeigt werden soll. Geben Sie 0 (None) an, um sie in den Aktivitätsmenüs auszublenden. Die benutzerdefinierte Aktivität wird in den zugeordneten Rastern nur derjenigen Entitäten angezeigt, denen sie zugeordnet ist (Beziehung enthält). Geben Sie 1 (Kommunikations-Aktivität) an, um sie in den Aktivitätsmenüs anzuzeigen. Wenn Sie nicht diese Eigenschaft nicht angeben, wird die benutzerdefinierte Aktivität mit dem Standard-Eigenschaftswert erstellt: 1. Das bedeutet, dass die benutzerdefinierte Aktivität in den Aktivitätsmenüs verfügbar ist. Außerdem kann ActivityTypeMask nur während der Aktivitätserstellung festgelegt werden, und kann nach Festlegung nicht mehr geändert werden.
CreateEntityRequest.HasActivities	false	Eine benutzerdefinierte Aktivitätsentität darf keine Beziehung zu Aktivitäten haben.
CreateEntityRequest.HasNotes	true	Eine benutzerdefinierte Aktivitätsentität muss Beziehung zu Hinweisen haben.
CreateEntityRequest.PrimaryAttribute	SchemaName ist “Subject”.	Der Schemaname des PrimaryAttribute muss für alle Aktivitäten “Subject”. sein.

Beispiel

Das folgende Beispiel zeigt, wie Sie eine benutzerdefinierte Aktivität erstellen können, indem Sie Microsoft Dynamics 365 SDK verwenden.

String prefix = "new_";

String customEntityName = prefix + "instantmessage";

// Create the custom activity entity.
CreateEntityRequest request = new CreateEntityRequest
{
    HasNotes = true,
    HasActivities = false,
    PrimaryAttribute = new StringAttributeMetadata
    {
        SchemaName = "Subject",
        RequiredLevel = new AttributeRequiredLevelManagedProperty(AttributeRequiredLevel.None),
        MaxLength = 100,
        DisplayName = new Label("Subject", 1033)
    },
    Entity = new EntityMetadata
    {
        IsActivity = true,
        SchemaName = customEntityName,
        DisplayName = new Label("Instant Message", 1033),
        DisplayCollectionName = new Label("Instant Messages", 1033),
        OwnershipType = OwnershipTypes.UserOwned,
        IsAvailableOffline = true,

    }
};

_serviceProxy.Execute(request);

//Entity must be published

Siehe auch

Aktivitätsentitäten
ActivityPointer (Aktivität) Entität
Beispiel: Erstellen einer benutzerdefinierten Aktivität
Beispiel: Erstellen und Aktualisieren von Entitäts-Metadaten

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright