Teilen über


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