Automatiska värden för egenskapsdefinition

Du kan ställa in ett automatiskt värde för en egenskap. Det betyder till exempel att fakturor kan numreras i följd. Ett automatiskt värde kan även innehålla text. I dessa fall är det en kombination av andra egenskaper. Du kan till exempel skapa förslag på rubriker i ett fast format såsom Klass/produkt/kund genom att använda dessa egenskaper (Förslag/Mach20A/ESTT Corporation) för att automatiskt skapa rubrikerna.

Automatiska värden erbjuder ökad användning av dokument- och objektmetadata för att lagra och söka efter information. Dessutom blir namnen på dokument och objekt mer konsekventa och behovet av upprepade dataposter minskar om du använder automatiska värden.

Automatiska värden är särskilt användbara för att namnge objekt (mer information finns i Ny klass) och automatiskt inkludera metadata i dokumentinnehåll (mer information finns i Infoga M-Files-egenskap).

Automatiska nummer och värden

En egenskap kan ha ett automatiskt nummer eller ett automatiskt värde.

Ett automatiskt nummer beräknas en gång och förändras inte. Sådan automatisk numrering är praktisk till exempel i olika interna företagsprocesser och för registerhållning.

Ett automatiskt värde kan innehålla andra egenskaper, vanligtvis genom att sammanlänka två eller fler egenskaper. Till exempel kan ett dokumentnamn (automatiskt värde) definieras som Klass (kund), vilket skulle returnera bland annat Förslag (ESTT). Det automatiska värdet förändras när objektet redigeras. Om det automatiska värdet skapas genom att använda klass- och kundnamn (Förslag (Kund A)) förändras det automatiska värdet när en annan kund väljs (Förslag (Kund B)).

Exemplet ovan illustrerar en egenskap med numrering i följd som stegras i enstaka heltal (ökning: 1). Det värde som använts senast ställs in som 1000. Nästa objekt som använder den här egenskapen kommer därför att få numret 1001. Värdet för beräkningsordningen är 100 (se Beräkningsordning nedan).

Enkel automatisk numrering

Genererar ett ökande numeriskt värde. Ökningen kan även anges i fältet Ökning. Standardvärdet är ett (1).

Anpassad automatisk numrering (VBScript)

Genererar ett automatiskt nummer som kan innehålla bokstäver, nummer eller både och. Mer detaljer om att skapa ett anpassat automatiskt nummer genom att använda M-Files API och generiska funktioner i VBScript.

Följande M-Files-variabler kan användas med det här scriptet: PropertyDef, Output, LastUsed, ObjVer, DisplayID, Vault, CurrentUserID, CurrentUserSessionInfo, PropertyValues, VaultSharedVariables, SavepointVariables, TransactionCache, MFScriptCancel, GetExtensionObject, MasterTransactionID, CurrentTransactionID, ParentTransactionID. Mer information om variablerna finns i Tillgängliga VBScript-variabler.

Det önskade anpassade värdet tilldelas utmatningsvariabeln, till exempel Utmatning = ”Automatiskt värde”. Mer information om att ange anpassad automatisk numrering finns i Ange ett automatiskt egenskapsvärde med hjälp av VBScript.

Enkel sammanfogning av egenskaper

Förenar utvalda egenskaper (till exempel Förslag/Enhet/Kund). Vilka tecken eller vilken text som helst kan infogas mellan de utvalda egenskaperna. Till exempel: Förslag: Kund (Projekt) eller Förslag, Kund, Projekt.

En lista över tillgängliga platshållare kan öppnas när du anger ett automatiskt värde för en egenskap. Knappen Lägg till platshållare… öppnar listan över egenskapsdefinitioner och andra platshållare som finns tillgängliga att använda.

Du kan även lägga till platshållarna manuellt i fältet. De används genom att omringa dem med %-tecken. Exempelvis skulle %PROPERTY_23% (%PROPERTY_21%) kunna ge oss ”John Smith (09/25/2016 12:39 PM)”, givet att 23 är ID:t för egenskapen Senast ändrad av och 21 ID:t för tidsstämpelegenskapen Senast ändrad.

Förutom ID:t kan du även lägga till platshållare med hjälp av alias. För att specificera en aliasplatshållare, använd syntaxen %PROPERTY_{Property.Definition.Alias}%. Mer information om att definiera alias finns i Tilldela alias för metadatadefinitioner.

Indirekta platshållare

Indirekta platshållare är metadata som är indirekt kopplade till ett objekt. Om ett avtal till exempel är kopplat till ett kundobjekt är kundens land indirekt metadata för dokumentet.

För att ange kundens land som en indirekt platshållare används syntaxen %PROPERTY_1079.PROPERTY_1090%, där 1079 är egenskapsdefinitions-ID för Kund och 1090 är egenskapsdefinitions-ID för Land.

Alternativt kan du lägga till indirekta platshållare med hjälp av alias. I det tidigare exemplet skulle syntaxen med alias vara %PROPERTY_{PD.Customer}.PROPERTY_{PD.Country}%, där PD.Customer är alias för egenskapsdefinitionen Kund och PD.Country är alias för egenskapsdefinitionen Land.

Beräknat värde (VBScript)

Mer detaljer om att skapa ett automatiskt värde genom att använda M-Files API och generiska funktioner i VBScript.

Följande M-Files-variabler kan användas med det här scriptet: PropertyDef, Output, ObjVer, DisplayID, Vault, CurrentUserID, CurrentUserSessionInfo, PropertyValues, VaultSharedVariables, SavepointVariables, TransactionCache, MFScriptCancel, GetExtensionObject, MasterTransactionID, CurrentTransactionID, ParentTransactionID. Mer information om variablerna finns i Tillgängliga VBScript-variabler.

Det önskade anpassade värdet tilldelas utmatningsvariabeln, till exempel Utmatning = ”Automatiskt värde”. Mer information om att ange beräknade värden finns i Ange ett automatiskt egenskapsvärde med hjälp av VBScript.

Senast använda värde

Startvärdet för nummer eller värden i följd. Standard är noll (0). Värdet kan ändras, till exempel kan numrering i följd starta på 3000.

Beräkningsordning

Beräkningsordning fastställer ordningen i vilken automatiska värden beräknas (från lägst till högst). Det är viktigt när flera automatiska värden används och deras kombinationer bildar nya automatiska värden.

Exempelvis är beräkningsordningen avgörande om namnet på ett objekt är ett automatiskt egenskapsvärde som består av två andra automatiska värden. Dessa två automatiska värden bör beräknas först och deras kombinerade värde efteråt.

Värdena i sig själva gör ingen skillnad förutom att beräkningsordningen går från lägst till högst. Beräkningsordningsvärdena för olika egenskaper kan till exempel vara 10, 12, 17 och 20. Egenskapen med beräkningsordningsnummer 10 beräknas därför först, följt av egenskapsordningen med nummer 12 och så vidare.

Beräkna om

Kommandot Beräkna om... är tillgängligt i M-Files Admins aktivitetsområde (eller genom att högerklicka på en egenskap i listan Egenskapsdefinitioner och välja Beräkna om... i kontextmenyn)när en egenskap med ett automatiskt värde väljs. Du kan välja mellan att beräkna om tomma värden eller beräkna om alla värden.

Beräkna om tomma värden

Beräknar automatiska värden för egenskaper som ännu inte har beräknats. Det här är standard för att beräkna automatiska värden. Ändringar i inställningarna gäller bara för nya värden. Om du till exempel redigerar fältet Senast använda värde får bara nya objekt det nya värdet. Gamla värden bevaras, vilket betyder att ett värde som har definierats inte kommer att ändras.

Beräkna om alla värden

Beräknar om automatiska värden för alla egenskaper. Beräkna om alla värden beräknar därmed även om tidigare definierade värden. Om exempelvis numrering i följd används och Senast använda värde ändras omnumrerar den här funktionen alla befintliga objekt.

Namnge en mall utan att använda automatiska värden

Dokumentmallar fungerar på ett annat sätt när automatiska värden används. Alla egenskaper i mallens metadata arbetar utan att ett automatiskt värde beräknas. Därmed arbetar automatiska egenskapsvärden i mallar som om de inte vore automatiska. Deras värden kan definieras normalt och servern beräknar inte ett automatiskt värde för egenskapen.

Till exempel kan objekt i klassen Förslag använda automatiska värden i sina titlar (till exempel Förslag <nummer> – <kundnamn>). Det är dock rimligt att kalla mallarna i klassen Förslag för mallar. Titlar med automatiska egenskaper är bara användbara för faktiska förslag, inte för mallar. Det betyder att mallen kan kallas Förslagsmall, medan de faktiska förslagsdokument som skapas med hjälp av mallen kommer att ha namn som skapas av automatiska värden, till exempel Förslag 35 – ESTT.

Mer information finns i Använda dokumentmallar ochNy klass.