Automatische Nummerierungsattribute erstellen

Seit der Version 9 Dynamics 365 Customer Engagement (on-premises) können Sie ein automatisches Nummerierungsattribut für eine beliebige Entität hinzufügen. Im Moment können Sie das Attribut auch programmgesteuert hinzufügen. Es gibt keine Benutzerschnittstelle, um dieses Typ des Attributs hinzuzufügen. Dieser Artikel erläutert, wie Sie ein automatisches Nummerierungsattribut programmgesteuert erstellen und einen Startwert für sequenzielle Elemente festlegen können. Außerdem wird in diesem Artikel gezeigt, wie die Sequenznummer für den nächsten Datensatz festgelegt wird, wenn Sie später den Startwert jederzeit zurücksetzen müssen.

Notiz

Die Einstellung des Startwerts ist optional. Es ist nicht erforderlich, den Startwert anzurufen, wenn Sie den Startwert nicht erneut festlegen müssen.

Sie können ein automatisches Nummerierungsattribut in derselben Weise, wie Sie ein Zeichenfolgenattribut mithilfe der StringAttributeMetadata-Klasse erstellen, außer Verwendung der neuen AutoNumberFormat-Eigenschaft. Verwenden Sie die AutoNumberFormat-Eigenschaft, um ein Muster zu definieren, das Sequenznummern und zufällige Zeichenfolgen beim Zusammenstellen der Platzhalter enthält und die Länge und den Typ der generierten Werte angibt. Die zufälligen Zeichenfolgen helfen Ihnen, Duplikate oder Konflikte zu vermeiden, insbesondere, wenn die Offline-Clients versuchen, die automatische Nummerierung zu erstellen.

Beim Erstellen eines automatischen Nummerierungsattributs muss die Werte der StringAttributeMetadata.FormatName-Eigenschaft oder der StringAttributeMetadata.Format-Eigenschaft Text sein. Da dies die Standardwerte sind, legen Sie in der Regel diese Eigenschaft nicht fest. Sie können ein automatisches Nummerierungsattribut nicht erstellen, das jedes andere Format besonderer Art wie E-Mail, Phone, Textbereich, URL oder jedes andere der vorhandenen Formate verwendet.

Die Autonummernfolge wird durch SQL verwaltet und ist garantiert eindeutig.

Notiz

AutoWert-Werte werden von der Datenbank beim Starten des Datensatzes vorab ausgewählt. Wenn ein Datensatz gestartet, dann aber storniert wird, wird die zugewiesene Zahl nicht verwendet. Wenn während dieser Zeit ein weiterer Datensatz mit der folgenden sequenziellen Zahl fertiggestellt wird, können Lücken in der automatischen Nummerierung von Datensätzen auftreten.

Notiz

Sie können ein vorhandenes Formattextattribut in ein automatisches Nummerierungsformat umwandeln.

Wenn im alten Webclient einem Formular ein Steuerelement hinzugefügt wird, das an ein automatisches Nummerierungsattribut gebunden ist, wird das Steuerelement automatisch deaktiviert und verhält sich in dem Formular, in dem Endnutzer das Steuerelement nicht bearbeiten können, schreibgeschützt. In Einheitliche Oberfläche müssen Steuerelemente, die an ein automatisches Nummerierungsattribut gebunden sind, explizit als deaktiviert festgelegt werden. Wenn Sie den anfänglichen Attributwert im Formular nicht festlegen, wird der Wert erst festgelegt, wenn Sie die Entität gespeichert haben. Die automatische Nummerierung kann auf Attributfeldwerte in Ansichten, Rastern etc. angewendet werden.

Beispiele

Die folgenden Beispiele zeigen, wie Sie ein neues Auto-Nummern-Attribut mit dem Namen Neue_Seriennummer für eine angepasste Entität mit dem Namen Neues_Widget erstellen, das einen Wert hat, der wie folgt aussieht: WID-00001-AB7LSFG-20170913070240. Verwenden des Organisationsdientes mit SDK-Assemblys-CreateAttributeRequest- und StringAttributeMetadata-Klassen:

CreateAttributeRequest widgetSerialNumberAttributeRequest = new CreateAttributeRequest
            {
                EntityName = "newWidget",
                Attribute = new StringAttributeMetadata
                {
                    //Define the format of the attribute
                    AutoNumberFormat = "WID-{SEQNUM:5}-{RANDSTRING:6}-{DATETIMEUTC:yyyyMMddhhmmss}",
                    LogicalName = "new_serialnumber",
                    SchemaName = "new_SerialNumber",
                    RequiredLevel = new AttributeRequiredLevelManagedProperty(AttributeRequiredLevel.None),
                    MaxLength = 100, // The MaxLength defined for the string attribute must be greater than the length of the AutoNumberFormat value, that is, it should be able to fit in the generated value.
                    DisplayName = new Label("Serial Number", 1033),
                    Description = new Label("Serial Number of the widget.", 1033)
                }
            };
            _serviceProxy.Execute(widgetSerialNumberAttributeRequest);

Verwendung der Web-API

Sie können die Entitätsdefinitionen mit der Web-API erstellen und aktualisieren.

Weitere Informationen: Erstellen und Aktualisieren von Entitätsdefinitionen mit der Web-API > Attribute erstellen.

Anfordern

POST [Organization URI]/api/data/v9.1/EntityDefinitions(LogicalName='new_widget')/Attributes HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
 "AttributeType": "String",
 "AttributeTypeName": {
  "Value": "StringType"
 },
 "Description": {
  "@odata.type": "Microsoft.Dynamics.CRM.Label",
  "LocalizedLabels": [
   {
    "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
    "Label": "Serial Number of the widget.",
    "LanguageCode": 1033
   }
  ]
 },
 "DisplayName": {
  "@odata.type": "Microsoft.Dynamics.CRM.Label",
  "LocalizedLabels": [
   {
    "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
    "Label": "Serial Number",
    "LanguageCode": 1033
   }
  ]
 },
 "RequiredLevel": {
  "Value": "None",
  "CanBeChanged": true,
  "ManagedPropertyLogicalName": "canmodifyrequirementlevelsettings"
 },
 "SchemaName": "new_SerialNumber",
 "AutoNumberFormat": "WID-{SEQNUM:5}-{RANDSTRING:6}-{DATETIMEUTC:yyyyMMddhhmmss}",
 "@odata.type": "Microsoft.Dynamics.CRM.StringAttributeMetadata",
 "FormatName": {
  "Value": "Text"
 },
 "MaxLength": 100
}

Antworten

HTTP/1.1 204 No Content
OData-Version: 4.0
OData-EntityId: [Organization URI]/api/data/v9.1/EntityDefinitions(402fa40f-287c-e511-80d2-00155d2a68d2)/Attributes(f01bef16-287c-e511-80d2-00155d2a68d2)

AutoNumberFormat-Optionen

Diese Beispiele zeigen, wie Sie die AutoNumberFormat-Eigenschaft konfigurieren können, um verschiedene Ergebnisse zu erhalten:

AutoNumberFormat-Wert	Beispielswert
CAR-{SEQNUM:3}-{RANDSTRING:6}	CAR-123-AB7LSF
CNR-{RANDSTRING:4}-{SEQNUM:4}	CNR-WXYZ-1000
{SEQNUM:6}-#-{RANDSTRING:3}	123456-#-R3V
KA-{SEQNUM:4}	KA-0001
{SEQNUM:10}	1234567890
QUO-{SEQNUM:3}#{RANDSTRING:3}#{RANDSTRING:5}	QUO-123#ABC#PQ2ST
QUO-{SEQNUM:7}{RANDSTRING:5}	QUO-0001000P9G3R
CAS-{SEQNUM:6}-{RANDSTRING:6}-{DATETIMEUTC:yyyyMMddhhmmss}	CAS-002000-S1P0H0-20170913091544
CAS-{SEQNUM:6}-{DATETIMEUTC:yyyyMMddhh}-{RANDSTRING:6}	CAS-002002-2017091309-HTZOUR
CAS-{SEQNUM:6}-{DATETIMEUTC:yyyyMM}-{RANDSTRING:6}-{DATETIMEUTC:hhmmss}	CAS-002000-201709-Z8M2Z6-110901

Die Platzhalter für zufällige Zeichenfolgen sind optional. Sie können mehr als einen Platzhalter für zufällige Zeichenfolgen einfügen. Verwenden Sie einen beliebigen Formatwert für Datum-Zeit-Platzhalter von Standardzeichenfolgen für Datums- und Uhrzeitformat.

Zeichenfolgenlänge

Die Tabelle stellt den Zeichenfolgenlängenwert für die zufälligen und sequenziellen Platzhalter dar.

Platzhalter	Zeichenfolgenlänge	Ausgangsszenario
{RANDSTRING:MIN_LENGTH}	Der Wert von MIN_LENGTH liegt zwischen 1 und 6.	Wenn Sie die Entität speichern, wird das automatische Nummerierungsattribut die zufällige Zeichenfolge mit der bestimmten Länge generieren, wenn der Wert zwischen 1 und 6 liegt. Wenn Sie den MIN_LENGTH-Wert von 7 oder höher verwenden, werden Sie einen Fehler des falschen Arguments sehen.
{SEQNUM:MIN_LENGTH}	Der Minimalwert Wert der MIN_LENGTH ist 1. Die Nummer wächst, um über die minimale Länge hinaus zu inkrementieren.	Wenn Sie die Entität speichern, funktioniert das automatische Nummerierungsattribut perfekt und wird weiter bei höheren Werten von MIN_LENGTH perfekt funktionieren.

Für sequenzielle Wertplatzhalter ist die MIN_LENGTH eine minimale Länge. Wenn Sie den Wert auf 2 setzen, wird der Anfangswert 01 sein und der Wert der 100. Entität wird 100 sein. Die Nummer wird weiter über die minimale Länge hinaus inkrementieren. Das Festlegen der Länge für sequenzielle Werte dient dazu, eine konsistente Länge für den automatisch generierten Wert festzulegen, indem zusätzliche 0s zum Anfangswert hinzugefügt werden. Er wird den absoluten Wert nicht einschränken. Zufallwertplatzhalter werden immer der gleichen Länge sein.

Da die sequenziellen Werte höher als minimale Länge, die dafür eingeräumt ist, werden können, sollen Sie die StringAttributeMetadata.MaxLength-Eigenschaft nicht anpassen, damit die Länge Ihrem formatierten Wert entspricht. Dabei gibt es einen geringen Wert, und er könnte zu einem Fehler in der Zukunft führen, wenn der Wert den MaxLength-Wert überschreitet. Stellen Sie sicher, dass Sie genug Raum für einen realistischen Bereich von sequenziellen Werten gelassen haben.

Notiz

Es gibt keine Überprüfung der Platzhalterwerte, wenn Sie das Attribut erstellen. Dieser Fehler wird nur dann angezeigt, wenn Sie versuchen, eine Entitätsinstanz zu speichern, die einen falsch konfigurierten AutoNumberFormat-Wert verwendet. Beispielweise, wenn Sie die Länge der zufälligen Zeichenfolge mehr als 6 festlegen, wird die erste Person, die eine neue Entitätsinstanz erstellt, einen Fehler mit dem falschen Argument haben, wenn Sie zuvor versucht hat, die Entität zu speichern, die das neue automatische Nummerierungsattribut enthält.

Automatische Nummerierungsattribute aktualisieren

Wenn Sie ein automatisches Nummerierungsattribut für eine fehlerhafte Konfiguration erstellen, oder wenn Sie ein vorhandenes automatisches Nummerierungsattribut ändern möchten, können Sie den Wert des AutoNumberFormat-Attributs aktualisieren.

Der folgende Codeausschnitt hilft Ihnen das automatische Nummerierungsattribut abzurufen, zu ändern und zu aktualisieren.

Zur Bearbeitung eines vorhandenen automatischen Nummerierungsattributs müssen Sie das Attribut mithilfe der RetrieveAttributeRequest-Klasse abrufen.

// Create the retrieve request
RetrieveAttributeRequest attributeRequest = new RetrieveAttributeRequest
            {
                EntityLogicalName = entityName.ToLower(),
                LogicalName = "new_serialnumber",
                RetrieveAsIfPublished = true
            };
// Retrieve attribute response
RetrieveAttributeResponse attributeResponse = (RetrieveAttributeResponse)_serviceProxy.Execute(attributeRequest);

Nachdem Sie das automatische Nummerierungsattribut abgerufen haben, müssen Sie das Attribut ändern und aktualisieren.

//Modify the retrieved auto-number attribute
AttributeMetadata retrievedAttributeMetadata = attributeResponse.AttributeMetadata;
retrievedAttributeMetadata.AutoNumberFormat = "CAR-{RANDSTRING:5}{SEQNUM:6}"; //Modify the existing attribute by writing the format as per your requirement 

// Update the auto-number attribute            
UpdateAttributeRequest updateRequest = new UpdateAttributeRequest
                        {
                            Attribute = retrievedAttributeMetadata,
                            EntityName = "newWidget",
                        };
// Execute the request
_serviceProxy.Execute(updateRequest);

Einen Startwert festlegen

Standardmäßig beginnen alle automatisch nummerierten sequenziellen Werte ab 1000 und nutzen 0 als Präfix abhängig von der Länge. Deswegen ist die Länge des Werts immer gleich. Wenn Sie den Anfangswert ändern möchten, müssen Sie den ursprünglichen Startwert mithilfe der nachstehenden API ändern, um die nächste Nummer festzulegen, die für das sequenzielle Segment verwendet werden wird.

Wenn Sie beispielsweise keinen Startwert verwendet haben oder den Startwert auf eine einzelne Ziffer festgelegt haben, ist Ihre erste Zahl eine einzelne Ziffer mit vorangehenden Nullen, um die Länge anzugleichen. Bei einem einstelligen Startwert mit einer Anzeigelänge von 5 wird also die „5“ als „00005“ angezeigt. Wenn Sie einen Startwert verwenden, können Sie mit einem größeren Anfangswert beginnen. Wenn Sie also Ihren Startwert auf „10000“ festlegen, wird der Wert von 5 als „10005“ angezeigt.

Wenn Sie einen anderen Startwert auswählen möchten, müssen Sie, nachdem Sie das automatische Nummerierungsattribut erstellt haben, die SetAutoNumberSeed-Nachricht verwenden. Verwenden Sie die SetAutoNumberSeedRequest-Klasse, wenn Sie die SDK-Assemblys und SetAutoNumberSeed-Aktion mithilfe der Web-API verwenden.

Die AutoNumberSeed-Nachricht hat die folgenden Parameter:

Name	Typ	Beschreibung
EntityName	Zeichenfolge	Der logische Name der Entität, der das Attribut enthält, für das Sie den Startwert festlegen möchten.
AttributeName	Zeichenfolge	Der logische Name des Attributs, für das Sie den Startwert festlegen möchten.
Wert	Int	Nächster Wert der automatischen Nummer fürs Attribut.

Notiz

Festlegen des Startwerts ändert nur den aktuellen Zahlenwert für das angegebene Attribut in der aktuellen Umgebung. Es gibt keinen allgemeinen Startwert für das Attribut an. Der Startwert ist nicht in einer Lösung enthalten, wenn er in einer anderen Umgebung installiert ist. Um die Startzahl nach dem Import einer Lösung festzulegen, verwenden Sie SetAutoNumberSeed-Nachricht in der Zielumgebung.

Beispiele

Die folgenden Beispiele legen den Seed auf 10000 für ein Auto-Nummern-Attribut mit dem Namen Neue_Seriennummer für eine angepasste Entität mit dem Namen Neues_Widget fest.

Verwenden des Organisationsdienstes mit der SetAutoNumberSeedRequest-Klasse der SDK-Assemblys:

//Define the seed 
SetAutoNumberSeedRequest req = new SetAutoNumberSeedRequest();
req.EntityName = "newWidget";
req.AttributeName = "newSerialnumber";
req.Value = 10000;
_serviceProxy.Execute(req);

Verwenden der SetAutoNumberSeed-Aktion der Web-API.

Weitere Informationen: Verwenden der Web-API-Aktionen > Ungebundene Aktionen

Anfordern

POST [Organization URI]/api/data/v9.1/SetAutoNumberSeed HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
 "EntityName": "new_Widget",
 "AttributeName": "new_Serialnumber",
 "Value": 10000
} 

Antworten

HTTP/1.1 204 No Content
OData-Version: 4.0

Community-Tools

Automatischer Nummerierungsmanager

Auto Number Manager für XrmToolBox ist ein von der Community betriebenes Tool für Dynamics 365 Customer Engagement (on-premises), das eine Benutzeroberfläche zum Festlegen, Aktualisieren und Entfernen des automatischen Nummernformats für neue oder bestehende Attribute bietet. Weitere Informationen finden Sie im Entwicklertools Artikel für Community entwickelte Tools und anm.xrmtoolbox.com zum automatischen Zahlen-Manager.

Notiz

Die Communitytools sind kein Produkt von Microsoft Dynamics, und es wird kein Support für die Communitytools angeboten. Wenn Sie Fragen zu dem Tool haben, setzen Sie sich bitte mit dem Herausgeber in Verbindung. Weitere Informationen: XrmToolBox.

Siehe auch

Metadaten und Datenmodelle
Anpassen von Entitätsattributmetadaten