Brugerdefinerede aktiviteter

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

For at understøtte kommunikationsbehov i moderne virksomheder, f.eks. chat (IM) og sms, kan du oprette brugerdefinerede aktiviteter i Microsoft Dynamics 365. Du kan oprette en brugerdefineret aktivitet i Dynamics 365 ved at oprette et brugerdefineret objekt og angive det som en aktivitet ved hjælp af EntityMetadata.IsActivity-egenskaben.

Men i modsætning til andre brugerdefinerede objekter kan du ikke angive en primær attribut for en brugerdefineret aktivitet, fordi som standard skal alle brugerdefinerede aktiviteter have en primær attribut med navnet ”Subject”.

Når du opretter et brugerdefineret aktivitetsobjekt, bliver alle egenskaberne og rettighederne for activitypointer-objektet arvet fra den brugerdefinerede aktivitet. Desuden bliver alle aktivitetsparttyper tilgængelige for den brugerdefinerede aktivitet, og derfor arves de tilsvarende egenskaber også.

Du kan oprette 1-til-mange relationer (1:N) for en brugerdefineret aktivitet på samme måde som for andre aktiviteter. Du kan også opdatere eksisterende relationer.

Rettigheder og adgangsrettigheder

Du skal bruge det samme sæt af Dynamics 365-rettigheder og adgangsrettigheder for at kunne arbejde med brugerdefinerede aktiviteter som dem, der kræves for at arbejde med brugerdefinerede objekter. Du kan finde flere oplysninger om brugerdefinerede objekter i Tilpasse objektets metadata.

Oprettelse af en brugerdefineret aktivitet

Hvis du vil oprette et brugerdefineret aktivitetsobjekt, skal du angive værdier for de egenskaber, der er angivet i følgende tabel.

Egenskab	Værdi	Noter
EntityMetadata.IsActivity	true	Angiv det brugerdefinerede objekt som et aktivitetsobjekt.
EntityMetadata.IsAvailableOffline	true	Et brugerdefineret aktivitetsobjekt skal være tilgængeligt offline.
EntityMetadata.IsMailMergeEnabled	false	Et brugerdefineret aktivitetsobjekt kan ikke have brevfletning aktiveret.
EntityMetadata.OwnershipType	OwnershipTypes.TeamOwned eller OwnershipTypes.UserOwned	Et brugerdefineret aktivitetsobjekt kan være enten bruger- eller teamejet.
EntityMetadata.ActivityTypeMask	0 - Ingen eller 1 – Kommunikationsaktivitet	(Valgfrit) Angiv, om en brugerdefineret aktivitet skal vises i aktivitetsmenuerne i webprogrammet. Angiv 0 (ingen) for at skjule den i aktivitetsmenuerne . Den brugerdefinerede aktivitet vises kun i de tilknyttede gitre for de enheder, hvor den er tilknyttet (har relation). Angiv 1 (kommunikationsaktivitet) for at få den vist i aktivitetsmenuerne. Hvis du ikke angiver denne egenskab, oprettes den brugerdefinerede aktivitet med standardegenskabsværdien: 1. Den brugerdefinerede aktivitet er tilgængelige i aktivitetsmenuerne. Desuden kan ActivityTypeMask kun indstilles på aktivitetens oprettelsestidspunkt og kan derefter ikke ændres.
CreateEntityRequest.HasActivities	false	Et brugerdefineret aktivitetsobjekt må ikke have en relation til aktiviteter.
CreateEntityRequest.HasNotes	true	Et brugerdefineret aktivitetsobjekt skal have en relation til noter.
CreateEntityRequest.PrimaryAttribute	SchemaName er “Subject”.	Skemanavnet på PrimaryAttribute for alle aktiviteter skal være “Subject”.

Eksempel

Følgende eksempel viser, hvordan du kan oprette en brugerdefineret aktivitet ved hjælp af Microsoft Dynamics 365-SDK.

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

Se også

Aktivitetsobjekter
ActivityPointer-objekt (aktivitet)
Eksempel: Opret en kundeaktivitet
Eksempel: Opret og opdater objektmetadata

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret