Jaa

Mukautettujen tilamallien siirtymien määrittäminen

Voit määrittää mukautettuja tilasiirtymiä (palvelupyyntö)-entiteetille Incident tai mukautetuille entiteeteille. EntityMetadata-IsStateModelAwareominaisuus on tarkoitettu true entiteeteille, jotka tukevat tilamallien siirtymiä.

Mukautetut tilasiirtymät ovat valinnainen suodatustaso, jolla määritetään, mitkä tilasiirtymät ovat kelvollisia tietyssä tilassa olevalle tietueelle. Erityisesti silloin, kun kelvollisten tilojen ja tila-arvojen yhdistelmiä on paljon, rajoitetun asetusluettelon määrittäminen voi helpottaa tietueen oikean tilan valitsemista.

Mikä on valtiomalli?

Tilan käsitettä tukevilla entiteeteillä on pari määritettä, jotka sieppaavat nämä tiedot, kuten tässä taulukossa näkyy.

Looginen nimi Näyttönimi Kuvaus
statecode Tila Ilmaisee tietueen aktiivisuustilan. Mukautetuissa entiteeteissä tämä on Aktiivinen tai Passiivinen. Tapaus (palvelupyyntö) -entiteetti käyttää Aktiivinen, Ratkaistu ja Peruutettu. Et voi lisätä muita tila-asetuksia, mutta voit muuttaa asetusotsikoita.
statuscode Tilan syy Edustaa tilaa, joka on linkitetty tiettyyn tilaan. Jokaisella osavaltiolla on oltava vähintään yksi mahdollinen asema. Voit lisätä tilavaihtoehtoja ja muuttaa olemassa olevien vaihtoehtojen otsikoita.

Määritteiden metatiedot määrittävät, mitkä tila-arvot ovat kelvollisia tietylle osavaltiolle. Esimerkiksi Incident (Palvelupyyntö)-entiteetin oletustila- ja tila-asetukset näkyvät seuraavassa taulukossa.

Vaihe Tila
Label: Aktiivinen

Value: 0		 Label: Käynnissä

Value: 1

State: 0
Label: Aktiivinen

Value: 0		 Label: Pidossa

Value: 2

State: 0
Label: Aktiivinen

Value: 0		 Label: Odotetaan yksityiskohtia

Value: 3

State: 0
Label: Aktiivinen

Value: 0		 Levy-yhtiö: Researching

Value: 4

State: 0
Label: Ratkaistu

Value: 1		 Label: Ongelma ratkaistu

Value: 5

State: 1
Label: Ratkaistu

Value: 1		 Etiketti: Annetut tiedot

Value: 1000

State: 1
Levy-yhtiö: Peruutettu

Value: 2		 Label: Peruutettu

Value: 6

State: 2
Levy-yhtiö: Peruutettu

Value: 2		 Label: Yhdistetty

Value: 2000

State: 2

Nämä tiedot tallennetaan luokkaan StatusOptionMetadata , joka edustaa luokan vaihtoehtoja StatusAttributeMetadata .

Jos haluat tarkastella organisaatiosi entiteetin metatietoja, asenna Metadata Browser -ratkaisu, joka on kuvattu kohdassa Organisaation metatietojen selaaminen. Voit myös selata entiteettien viitedokumentaatiota entiteettiviittauksessa.

Kelvollisten tilasiirtymien tunnistaminen

Voit muokata statuscode määritettä määrittääksesi, mitkä muut tila-asetukset edustavat kelvollisia siirtymiä nykyisestä tilasta. Katso ohjeet Mukautusoppaan aiheesta: Tilan syyn siirtymien määrittäminen

Kun mukautettuja tilasiirtymiä käytetään entiteetissä, EntityMetadata.EnforceStateTransitions -ominaisuus on true. Lisäksi jokaisella StatusOptionMetadata kokoelman StatusAttributeMetadataOptions jäsenellä on uusi TransitionData ominaisuus. Tämä ominaisuus sisältää String-arvon, joka edustaa XML-dokumenttia. Tämä asiakirja sisältää sallittujen siirtymien määrityksen. Esimerkiksi oletusarvoisella Incident (Case) StatusCode -määriteasetuksella voi olla seuraava TransitionData arvo.

<allowedtransitions xmlns="https://schemas.microsoft.com/crm/2009/WebServices">
<allowedtransition sourcestatusid="1" tostatusid="6" />
<allowedtransition sourcestatusid="1" tostatusid="1000" />
<allowedtransition sourcestatusid="1" tostatusid="2000" />
<allowedtransition sourcestatusid="1" tostatusid="5" />
</allowedtransitions>

Huomautus

Kun nämä tiedot noudetaan hallitsemattomana koodina verkkopalvelusta, esimerkiksi JavaScriptiä käytettäessä, ne suojataan ja näyttävät seuraavan esimerkin kaltaisilta.

&lt;allowedtransitions xmlns="https://schemas.microsoft.com/crm/2009/WebServices"&gt;
&lt;allowedtransition sourcestatusid="1" tostatusid="6" /&gt;
&lt;allowedtransition sourcestatusid="1" tostatusid="1000" /&gt;
&lt;allowedtransition sourcestatusid="1" tostatusid="2000" /&gt;
&lt;allowedtransition sourcestatusid="1" tostatusid="5" /&gt;
&lt;/allowedtransitions&gt;

Kun nämä tiedot ovat olemassa ja Entity-ominaisuus EnforceStateTransitions on true, mikä tahansa tapausesiintymä voidaan muuttaa vain yhdeksi sallituista statuscode arvoista. Voit käyttää .IOrganizationServiceUpdate määrittääksesi minkä statuscodeOptionSetValue tahansa sallitun arvon, joka ei edusta tilan muutosta. Jos haluat muuttaa tilaa, aseta SetStateRequest sallittu- State ja ominaisuusarvot Status tai CloseIncidentRequest asetusominaisuus Status johonkin nykyiselle statuscode arvolle sallituista arvoista. Virheellisen arvon asettaminen aiheuttaa virheen.

Katso myös

Esimerkki: Kelvollisten tilasiirtymien noutaminen
Tietueen tila ja status
Hae ja tunnista muutokset metatietoihin