Yleisimmät virheet ja ratkaisut Omnistudiossa

1. Kirjaudu sisään järjestelmän pääkäyttäjänä.
2. Etsi ja avaa Määritykset-valikosta Omnistudio.
3. Ota Omnistudio-käyttöoikeus käyttöön organisaatiollesi.

Jos et näe tätä vaihtoehtoa, varmista, että organisaatiollasi on Omnistudio-lisenssejä. Ota yhteyttä Salesforce-asiakkuuspäällikköösi, jos tarvitset lisenssejä.

Vihje Kun olet ottanut Omnistudio-käyttöoikeudet käyttöön, muutosten levittäminen organisaatiossasi saattaa kestää muutaman minuutin. Jos näet tämän virheen edelleen, kokeile kirjautua ulos ja takaisin sisään.

• Aktiivisen Omniscript-koodin poistamisen yritys
• Yrittää päivittää rakenteellisia kenttiä aktiivisessa Omniscript-koodissa
• Yrität muuttaa tyyppiä, alatyyppiä tai kieltä aktiivisessa Omniscript-koodissa

1. Etsi ja avaa sovelluskäynnistimestä Omniscripts.
2. Etsi Omniscript, jota haluat muokata tai poistaa.
3. Huomioi tämänhetkinen versio ja varoita käyttäjiä tulevasta deaktivoinnista.
4. Poista Active-valintaruudun valinta deaktivoidaksesi Omniscriptin ja tallentaaksesi muutoksesi.
5. Nyt voit tehdä haluamasi muutokset tai poistaa Omniscript-koodin.
6. Jos teit muutoksia, voit aktivoida ne uudelleen valitsemalla Active -valintaruudun uudelleen.

Varoitus Omniscriptin deaktivointi vaikuttaa välittömästi kaikkiin käyttäjiin ja prosesseihin, jotka käyttävät sitä tällä hetkellä. Harkitse uuden version luomista aktiivisen version muokkaamisen sijaan, jos sinun täytyy ylläpitää palvelun jatkuvuutta.

• Toinen Omniscript, jolla on sama tyyppi, alatyyppi ja kieli, on jo aktiivinen
• Uuden version luominen poistamatta edellisen version aktivointia
• Useita versioita luotu ja useamman kuin yhden aktivoinnin yritys

Varmista, että sinulla on Omniscript-tietueiden muokkausoikeudet ja seuraavat tehtävät.

1. Etsi ja avaa sovelluskäynnistimestä Omniscripts.
2. Käytä suodattimia tai hae Omniscripts-objekteja, joilla on vastaava tyyppi ja alatyyppi.
3. Tunnista tällä hetkellä aktiivinen Omniscript, jolla on sama tyyppi/alatyyppi/kieli.
4. Tarkasta molemmat versiot määrittääksesi, mitkä niistä pysyvät aktiivisina.
5. Avaa Omniscript, jonka aktivoinnin haluat deaktivoida.
6. Poista Active-valintaruudun valinta ja tallenna muutoksesi.
7. Palaa uuteen versioon ja aktivoi se.

Varoitus Ennen kuin aktivoit uuden version, testaa se huolellisesti esikatselussa tai sandbox-ympäristössä. Kun olet valmis käyttöönottoon, deaktivoi vanha versio ja aktivoi uusi välittömästi välttyäksesi käyttökatkoksilta.

• Tyyppikenttä on tyhjä tai null
• Alatyyppikenttä on tyhjä tai null
• Kielikenttää ei ole valittu
• Yrität tallentaa uutta Omniscript-koodia täyttämättä kaikkia pakollisia kenttiä

Varmista, että sinulla on Omniscript-tietueiden muokkausoikeudet ja seuraavat tehtävät.

1. Etsi ja avaa sovelluskäynnistimestä Omniscripts.
2. Etsi Tyyppi-kenttä Omniscript-ominaisuuksien paneelista.
3. Syötä kuvaava tyypin nimi, kuten CustomerOnboarding tai ClaimSubmission.
4. Etsi Alatyyppi-kenttä ja syötä tietty Alatyyppi-nimi, kuten Asunto tai Kaupallinen.
5. Valitse kieli alasvetovalikosta.
6. Varmista, että kaikki kolme kenttää on täytetty ja tallenna muutoksesi.
7. Palaa uuteen versioon ja aktivoi se.

Vihje Valitse hyödyllisiä tyyppien ja alatyyppien nimiä, jotka osoittavat selkeästi Omniscript-sovelluksesi käyttötarkoituksen. Nämä arvot ovat osa tapaa, jolla viittaat Omniscript-ominaisuuteen sovelluksissasi, eikä niitä voi helposti muuttaa niiden luomisen jälkeen.

• Tyyppi- tai alatyyppi-kentät sisältävät välilyöntejä
• Tyyppi- tai alatyyppi-kentät sisältävät alaviivoja
• Tyyppi- tai alatyyppi-kentät sisältävät erikoismerkkejä, joita ei tueta: !@#$%^&*, jne.
• Tyyppi- tai Alatyyppi-kentät sisältävät väliviivoja tai muita välimerkkejä

1. Tarkasta Tyyppi- ja Alatyyppi-arvosi.
2. Poista välilyönnit - käytä sen sijaan UpperCamelCase (tai PascalCase). Esimerkiksi CustomerOnboarding.
3. Poista kaikki alaviivat ja korvaa ne UpperCamelCase-muodolla (tai PascalCase-muodolla).
4. Poista kaikki erikoismerkit.
5. Varmista, että vain kirjaimia (A–Z, a–z) ja numeroita (0–9) käytetään.
6. Tallenna muutokset.

Vihje Käytä Tyyppi- ja Alatyyppi-arvoille PascalCase-metodia (joita kutsutaan myös UpperCamelCase-metodiksi). Tämä parantaa luettavuutta ilman välilyöntejä tai alaviivoja.

• Tyyppiarvo on liian pitkä.
• Alatyyppi-arvo on liian pitkä.
• Yhdistetty tyyppi + alatyyppi + kieli ylittää merkkirajoituksen.

1. Tarkasta virheviesti nähdäksesi sallitun enimmäispituuden.
2. Lyhennä Tyyppi- tai Alatyyppi-arvoa.
3. Tallenna muutokset.

Vihje Käytä tarvittaessa lyhenteitä. Poista tarpeettomat sanat. Käytä lyhyempää nimeämiskäytäntöä.

Tyyppi- tai Alatyyppi-kenttä käyttää varattuja avainsanoja. Rajoitettuihin avainsanoihin sisältyy: in, out, exc, cb, kt, vt, v, x785f, x5f

Korvaa rajoitettu avainsana toisella arvolla virheviestissä ehdotetulla tavalla. Lisätietoja on kohdassa Varatut sanat Omnistudio-nimeämiskäytännöt -sivulla.

• Yrität lisätä uutta elementtiä aktiiviseen Omniscript-komponenttiin.
• Yrittää muokata olemassa olevaa elementtiä aktiivisessa Omniscript-koodissa.
• Yrittää poistaa elementin aktiivisesta Omniscript-koodista.
• Omniscript on aktiivinen ja käytössä.

Varmista, että sinulla on Omniscript-tietueiden muokkausoikeudet ja seuraavat tehtävät.

1. Tarkasta, onko Omniscript tällä hetkellä aktiivinen.
2. Harkitse uuden version luomista aktiivisen version muokkaamisen sijaan.
3. Uuden version luominen: Napsauta Omniscriptista Kloonaa.
4. Olemassa olevien tietojen muokkaaminen: Poista aktivointi poistamalla Active-valintaruudun valinta ja tallentamalla muutoksesi.
5. Nyt voit lisätä, päivittää tai poistaa elementtejä.
6. Testaa muutoksesi.
7. Aktivoi Omniscript, kun se on käyttövalmis.

Varoitus Suosittelemme, että luot uuden version merkittäville muutoksille sen sijaan, että deaktivoisit ja muokkaisit aktiivista versiota. Tämä sallii sinun testata niitä huolellisesti ennen käyttöönottoa ja tarjoaa helpon peruutusvaihtoehdon ongelmien varalta.

• Saman Omniscriptin toisella elementillä on sama nimi.
• Anna elementtien väliselle ristiriidalle nimi eri vaiheissa.
• Elementti kopioitiin eikä sen nimeä muutettu.

1. Tarkasta kaikki Omniscript-komentosarjasi elementit.
2. Tunnista elementit, joilla on ristiriitaiset nimet.
3. Päätä, mikä elementti säilyttää nimen.
4. Nimeä toinen elementti uudelleen yksilöllisellä nimellä.
5. Sinun kannattaa käyttää etuliitteitä osoittaaksesi vaiheen tai osion, esimerkiksi step1_firstName, step2_firstName.
6. Päivitä kaikki kaavat tai datakartoitukset, jotka viittaavat uudelleennimettyyn elementtiin, ja tallenna muutoksesi.

• Omniscript on saatu hallitusta paketista, eikä sinulla ole oikeuksia sen muokkaamiseen tai poistamiseen.
• Yrität päivittää pakattua Omniscript-tiedostoa paketin nimitilan ulkopuolelta.

1. Tarkasta, onko Omniscript peräisin hallitusta paketista.
2. Jos sinun täytyy mukauttaa Omniscript-koodia, kloonaa se sen sijaan.
3. Nimeä kloonattu versio uudelleen käyttämällä omaa tyyppi/ala-tyyppi/kieli-yhdistelmääsi.
4. Tee haluamasi muutokset kloonattuun versioon, tallenna ja aktivoi Omniscript-komponenttisi.
5. Päivitä kaikki kaavat tai datakartoitukset, jotka viittaavat uudelleennimettyyn elementtiin, ja tallenna muutoksesi.

Vihje Ota yhteyttä paketin tarjoajaan tai Salesforce-pääkäyttäjääsi, jos sinun täytyy tehdä muutoksia pakattuihin komponentteihin. Ne saattavat tarjota määritysvaihtoehtoja tai laajennuspisteitä, jotka eivät vaadi pakatun Omniscript-koodin muokkaamista suoraan.

• Omniscript on uudelleenkäytettävissä.
• Omniscript sisältää Omniscript-elementtejä (upotetut Omniscriptit).
• Omniscriptiä yritetään käyttää uudelleen upotettujen Omniscriptien lisäämisen jälkeen

1. Päätä, tulisiko tämä Omniscript olla uudelleenkäytettävä vai sisältääkö se upotettuja Omniscriptejä.
2. Vaihtoehto 1: Pidä se uudelleenkäytettävissä - Poista kaikki upotetut Omniscript-elementit
3. Vaihtoehto 2: Salli upottaminen: Poista uudelleenkäytettävä -valintaruudun valinta.
4. Jos olet poistamassa upotettuja Omniscripteja, harkitse integrointitoimenpiteiden käyttämistä niiden sijaan. Voit muuttaa logiikkaa uudelleen Omniscriptista kutsuttaviksi integraatiotoimenpiteiksi.

Vihje Käytä integrointitoimenpiteitä jaetulle liiketoimintalogiikalle käyttämällä uudelleenkäytettäviä Omniscriptejä sisäkkäin. Tämä luo puhtaamman arkkitehtuurin ja välttää monimutkaisuutta Omniscript-riippuvuuksissa.

• Toinen Flexcard, jolla on sama nimi, on jo aktiivinen.
• Yrittää aktivoida uuden version deaktivoimatta vanhaa.

1. Hae Flex-kortit, joilla on sama Nimi-kenttä.
2. Tarkasta ne määrittääksesi, mitkä tulisi säilyttää aktiivisina.
3. Avaa Flexcard, jonka aktivoinnin haluat deaktivoida.
4. Poista Active-valintaruudun valinta deaktivoidaksesi Flexcard-kortin ja tallentaaksesi muutoksesi.

Varoitus Flexcard-kortin deaktivointi vaikuttaa välittömästi kaikkiin käyttäjiin ja prosesseihin, jotka käyttävät sitä tällä hetkellä. Harkitse uuden version luomista aktiivisen version muokkaamisen sijaan, jos sinun täytyy ylläpitää palvelun jatkuvuutta.

1. Tarkasta, onko Flexcard saatu hallitusta paketista.
2. Jos sinun täytyy poistaa se käytöstä, deaktivoi se poistamisen sijaan.
3. Tee näin avaamalla Flexcard ja poistamalla Active -valintaruudun valinta.
4. Jos tarvitset Flexcard-kortista mukautetun version, kloonaa se sen sijaan.

Vihje Ota yhteyttä paketin tarjoajaan tai Salesforce-pääkäyttäjääsi, jos sinun täytyy tehdä muutoksia pakattuihin komponentteihin. Ne saattavat tarjota määritysvaihtoehtoja tai laajennuspisteitä, jotka eivät vaadi pakatun Flexcard-kortin muokkaamista suoraan.

• Alitason Flexcard-nimen nimi kirjoitetaan väärin.
• Alitason Flexcard on olemassa, mutta se ei ole aktiivinen.
• Alitason Flexcard poistettiin.
• Alitason Flexcard on toisessa nimitilassa.

1. Etsi ja avaa sovelluskäynnistimestä Huomioi alitason Flexcard-nimi virheviestistä.
2. Hae alitason Flexcard-korttia nimen perusteella.
3. Jos se löytyy, mutta ei aktiivinen, aktivoi se.
4. Jos sitä ei löydy, varmista oikea nimi.
5. Jos nimi on väärä, päivitä ylätason Flexcard-kokoonpano.
6. Etsi ylätason Flexcard-kortista alitason Flexcard-viite.
7. Korjaa nimi vastaamaan olemassa olevaa aktiivista Flex-korttia ja tallenna ylätason Flex-kortti.

Huomautus Alitason Flex-kortit täytyy aktivoida ennen kuin ylätason Flex-kortti voi viitata niihin. Luo ja testaa ensin alitason Flex-kortteja ja määritä sitten ylätason Flex-kortit käyttämään niitä.

• Omniscriptin tyyppi/ala-tyyppi/kieli on virheellinen.
• Omniscript on olemassa, mutta se ei ole aktiivinen.
• Omniscript poistettiin.
• Omniscriptin tyyppi/ala-tyyppi/kieli muuttui.

1. Huomioi virheviestissä oleva Tyyppi, Alatyyppi ja Kieli.
2. Hae Omniscript, jolla on vastaava tyyppi ja alatyyppi.
3. Vahvista kielivastaavuudet.
4. Jos se löytyy, mutta ei ole aktiivinen, aktivoi Omniscript.
5. Jos arvoa ei löydy, tarkasta oikeat tyyppi-/alatyyppi-/kieli-arvot.
6. Palaa Flexcard-korttiisi ja päivitä Omniscript-viite oikeilla arvoilla.
7. Tallenna muutokset.

Vihje Varmista, että viitattu Omniscript on aktiivinen ennen Flexcard-kortin aktivoimista. Jos otat molemmat käyttöön yhdessä, aktivoi Omniscript ensin.

• Datan kartoitajan nimi on kirjoitettu väärin.
• Datakartoitus on olemassa, mutta ei aktiivinen.
• Datakartoitus poistettiin.
• Datan kartoitajan nimeä muutettiin.

1. Huomioi virheviestissä oleva Datan kartoitajan nimi.
2. Hae datakartoitus nimen perusteella.
3. Jos se löytyy, mutta ei aktiivinen, aktivoi se.
4. Jos sitä ei löydy, varmista oikea nimi.
5. Palaa Flexcard-korttiisi, päivitä Datan kartoitus -viite oikealla nimellä ja tallenna muutoksesi.

Vihje Aktivoi datakartoittimet ennen kuin aktivoit niihin viittaavat Flex-kortit. Testaa datakartoitusta itsenäisesti varmistaaksesi, että se palauttaa odotetun datarakenteen.

• Integrointitoimenpiteen nimi on väärä.
• Datakartoitus on olemassa, mutta ei aktiivinen.
• Datakartoitus poistettiin.
• Käytät väärää nimeämisformaattia (täytyy käyttää Type_SubType-formaattia).

1. Huomioi integraatiotoimenpiteen nimi virheviestistä.
2. Hae integraatiotoimenpide.
3. Varmista, että se on olemassa ja huomioi sen tyyppi ja alatyyppi.
4. Jos se löytyy, mutta ei aktiivinen, aktivoi se.
5. Palaa Flex-korttiisi.
6. Päivitä integraatiotoimenpiteen viite käyttämällä muotoa: Type_SubType ja tallenna muutoksesi.

Varoitus Integrointitoimenpiteisiin viitataan OmniProcessKey-avaimellaan, joka noudattaa Type_SubType-formaattia. Varmista, että käytät oikeaa muotoa, kun määrität Flexcard-korttia.

• Olemassa olevan Flexcard-kortin nimeäminen uudelleen.
• Yrittää muuttaa olemassa olevan Flexcard-kortin tekijää.
• Muissa komponenteissa käytetään UniqueName-arvoa eikä sitä voi muuttaa.

1. Jos tarvitset toisen nimen tai tekijän, kloonaa Flexcard sen sijaan.
2. Etsi FlexCard ja kloonaa se.
3. Syötä uusi Nimi tai Tekijä.
4. Tee kaikki muut tarvittavat muutokset kloonattuun versioon ja aktivoi uusi FlexCard.
5. Päivitä kaikki vanhaan Flexcard-korttiin viittaavat komponentit käyttämään uutta.
6. Poista vanhan Flexcard-kortin aktivointi, kun kaikki viitteet on päivitetty.

• Integrointitoimenpiteen nimi alkaa FileBased-arvolla.
• Integrointitoimenpiteen tyyppi alkaa tiedostopohjaisella.
• Integrointitoimenpiteen alatyyppi alkaa FileBased-arvolla.

1. Avaa integraatiotoimenpide.
2. Tarkasta Nimi-, Tyyppi- ja Alatyyppi-kentät.
3. Jos nimi alkaa FileBased, valitse toinen etuliite.
4. Harkitse etuliitteiden käyttämistä, kuten Tiedosto, asiakirja, Data tai organisaatiosi nimi.
5. Päivitä virheellisiä kenttiä ja tallenna muutoksesi.

• JSON-syöttöskeemassa on sisäkkäisiä objekteja, jotka ovat yli 10 tasoa syvempiä.
• JSON-lähtöskeemassa on sisäkkäisiä objekteja, jotka ovat yli 10 tasoa syvempiä.

1. Tarkasta JSON-skeemasi rakenne.
2. Tunnista syvällisesti sisäkkäiset osiot.
3. Litistä rakenne vähentämällä sisäkkäisiä tasoja.
4. Harkitse syvällisten sisäkkäisten tietojen siirtämistä erillisiin integraatiotoimenpiteisiin.
5. Käytä taulukoita, joissa on litistyneempiä objekteja syvällisten hierarkioiden sijaan.
6. Rakenna uudelleen pitääksesi sisäkkäin alle 10 tasolla.
7. Tallenna päivitetty skeema.

Integraation toimenpiteen JSON-skeemoilla voi olla enintään 500 avainta koko rakenteessa. Tämä sisältää kaikki avaimet kaikilla sisäkkäisillä tasoilla. Tarkalleen ottaen seuraavasti:

• JSON-syöttöskeema sisältää yhteensä yli 500 avainta.
• JSON-lähtöskeema sisältää yhteensä yli 500 avainta.
• Skeema sisältää suuren määrän kenttiä useista sisäkkäisistä objekteista.

1. Tarkasta JSON-skeemasi.
2. Laske kaikkien tasojen avainten kokonaismäärä.
3. Tunnista osiot, joissa on liikaa avaimia.
4. Harkitse integraatiotoimenpiteen jakamista useisiin pienempiin toimenpiteisiin.
5. Poista tarpeettomat tai tarpeettomat avaimet.
6. Käytä array-taulukoita esittääksesi toistuvia rakenteita numeroitujen avainten sijaan.
7. Yhdistä asiaan liittyvät kentät alitason objekteihin.
8. Tallenna optimoitu skeema.

Vihje Jos tarvitset oikeutetusti yli 500 avainta, harkitse prosessin pilkkomista useisiin integrointitoimenpiteisiin, jotka voidaan ketjuttaa yhteen.

• Valittua sObject-objektia ei tueta Datan kartoitus -toiminnoille.
• Valittu sObject on järjestelmäobjekti, joka ei tue kyselyitä.
• Valitulla sObjectilla ei ole tarvittavaa API-tukea datakartoitusten käyttämiseen.

1. Tarkasta syöttötyypiksi valitsemasi sObject ja tarkasta tuettujen objektien Salesforce-ohje.
2. Harkitse toisen tuetun objektiin liittyvän objektin käyttämistä.
3. Jos tarvitset tietoja ei-tuetusta objektista, käytä sen sijaan integrointitoimenpidettä mukautetun Apexin kanssa.
4. Päivitä datan kartoituskokoonpanosi tuetulla objektilla ja tallenna muutoksesi.

Huomautus Useimpia vakiomuotoisia ja mukautettuja objekteja tuetaan. Jos kohtaat objektia, jota ei tueta, harkitse, voitko muuttaa datakulkusi rakennetta käyttämään tuettua vaihtoehtoa.

• OmniAnalytics for Omnistudio ei ole käytössä.
• Organisaatiotasi ei ole määritetty OmniAnalyticsiin.

1. Kirjaudu sisään järjestelmän pääkäyttäjänä ja hae Määritykset-valikosta Omnistudio-asetukset tai Omni Interaction Configurations.
2. Etsi OmniAnalytics for Core -asetus ja ota se käyttöön.
3. Tallenna muutoksesi ja odota muutaman minuutin, kunnes muutos astuu voimaan.
4. Testaa, toimiiko Analytics-seurantasi.

Huomautus Varmista, että päätösten selittäjä on määritetty oikein.

• Tunnus ei ole käypä Salesforce-tunnusmuoto, jossa on 15 tai 18 merkkiä.
• Tunnus ei kuulu OmniTrackingComponentDef-objektiin.
• Seurantakomponentin määritelmä poistettiin.
• Tunnus on null tai muotoiltu väärin.

1. Vahvista käyttämäsi komponentin määritelmän tunnus.
2. Avaa Määritykset > Omnistudio > Analytics-seuranta ja etsi oikea seurantakomponentin määritelmä.
3. Kopioi oikea tunnus tietueesta.
4. Päivitä koodisi tai kokoonpanosi oikealla tunnuksella.
5. Jos määritelmä poistettiin, luo uusi seurantakomponentin määritelmä. Lisätietoja on kohdissa Seurantaryhmän luominen ja Seurattavien komponenttien lisääminen.
6. Testaa seurantaa uudelleen.

Huomautus Varmista, että päätösten selittäjä on määritetty oikein.