Mukautettujen yhdistimien käyttäminen aikajanan ohjausobjektin kanssa

Mukautetut yhdistimet on ominaisuus, jonka avulla kehittäjät voivat käyttää Dataversen TimelineWallControl-komponentin tietuemerkintöjä, kuten taulukon rivejä, ulkoisia tietolähteitä ja niin edelleen. Se mahdollistaa laajemmat skenaariot olemassa olevien valmiiden muistiinpanojen, julkaisujen ja aktiviteettien lisäksi.

Lisätietoja aikajanan määrittämisestä ja käyttämisestä on seuraavissa ohjeaiheissa:

• Aikajanan käyttö
• Aikajanan määritys
• Aikajanan tietuekortin määritys

Mukautetuissa yhdistimissä määritetyt tietueet ovat IRecordSource-liittymän mukaisia JavaScript-WWW-resursseja. WWW-resurssin nimi sekä konstruktori (nimi mukaan lukien nimitila) ja valinnainen JSON-WWW-resurssipolku voidaan lisätä UClientRecordSourcesJSON-parametrin määrityksenä FormXML:ssä.

<UClientRecordSourcesJSON>
  {"recordSources": [{
    "name": "new_SecondaryRecordSource", 
    "constructor": "SampleNamespace.SecondaryRecordSource"}]
  }
</UClientRecordSourcesJSON>

TimelineWallControlin odotetaan lataavan JavaScript-www-resurssin ja luovan sitten IRecordSource-esiintymän määritetystä konstruktorista.

Tämän jälkeen IRecordSource alustetaan (init), jossa pyydetään tietueiden sivuja (getRecordsData), pyydetään suodattimen tietoja (getFilterDetails) ja pyydetään yksittäisen tietueen (getRecordUX) UX-esitystä.

Tietueiden pyytämisen vastaus säilyy, jotta usean istunnon skenaarioissa esiintyvien tietuepyyntöjen määrä voidaan minimoida.

Aikajanan ohjausobjektin mukautetun yhdistimen määrittäminen

Voit lisätä tai muokata aikajanan ohjausobjektin mukautetun yhdistimen mukauttamalla sen tekijän kokemuksessa.

1. Valitse aikajanan ohjausobjektissa lomake, jolle haluat lisätä tai muokata mukautetun yhdistimen.

2. Tee jokin seuraavista:

   • Kun haluat lisätä uuden mukautetun yhdistimen, valitse aikajanataulukon Ominaisuudet -ruudun kohdassa Mukautetut yhdistimet Lisää yhdistin. Näkyviin tulee Uusi mukautettu yhdistin -ruutu.

     

   • Jos haluat muokata aiemmin luotua ja lataamaasi mukautettua yhdistintä, valitse aikajanaentiteetin Ominaisuudet-ruudusta mukautettu yhdistin ja valitse sitten Muokkaa. Näkyviin tulee Mukautetun yhdistimen muokkausruutu.

     

3. Muokkaa sivu ja valitse sitten Tallenna.

Suodattimen tuki

Mukautetun yhdistimen suodattimen tuki sisältää seuraavat ominaisuudet.

• Uuden suodatintyypin lisääminen aiemmin luotuun suodatinryhmään
• Uuden suodatinryhmän lisääminen
• Aiemmin luodun suodatintyypin määrän päivittäminen
• Hakuavaimella suodattaminen

Mukautettujen yhdistinten on käytettävä init()-yhteydellä välitettyjen UserSettings-aikavyöhyketietoja ollakseen yhdenmukainen aikajanan hahmonnuksen kanssa.

Käyttöalue

Mukautetut yhdistimet -ominaisuutta tuetaan yhden istunnon ja usean istunnon taulukkolomakkeissa Unified Interface -asiakasmallisovelluksissa.

Vaikutusalueen ulkopuolella

Mukautetut yhdistimet-ominaisuudessa ei ole käytettävissä seuraavia toimintoja:

• Offline- ja offline oletusarvoisesti -tilanteet
• Raporttinäkymät
• Sijainnit, joissa TimelineWallControl ei ole käytettävissä (kuten konverktiosovellukset, pohjaan perustuvat sovellukset, Power Pages, mukautetut sivut ja niin edelleen)

Tunnetut rajoitukset

Määritettyjä WWW-resursseja ei ole virallisesti määritetty riippuvuuksiin lomakkeeseen. Tämä tarkoittaa, että lomakkeen vieminen ei vie www-resursseja automaattisesti ja ne on lisättävä kyseiseen vientiin manuaalisesti. Lisäksi näiden www-resurssien poistaminen vahingossa voi olla helppoa.

Tietuelähteen kehittäminen

Kun kehität tietuelähdettä, noudata seuraavia käytäntöjä:

• Varmista, että haet tietoja turvallisesti. Unified Interface -suojausmalli pitää JS- ja JSON-verkkoresursseja epäluotettavina, joten tällaisten resurssien ei pitäisi sisältää niissä rahakkeita tai salaisuuksia, koska ne tallennetaan vain teksti -muodossa.
• Jos tiedot ovat Dataverse -järjestelmässä, käytä init-toiminnan kontekstiobjektia pyyntöjen tekemiseen Dataverseen. Puhelut kontekstista Dataverseen ovat pyyntöjä, jotka on jaettu suojatun iframe-kehyksen kautta. Näin TimelineWallControlin epäviralliset tietuelähteet hakevat tietoja.
• Jos tiedot ovat Dataverse -järjestelmässä, hae ulkoiset tiedot käyttämällä alustan aiemmin luotuja mekanismeja.
• Testaa muutoksia paikallisesti Fiddlerin avulla: Paranna JavaScript-verkkoresurssien kehittämisen ja virheenkorjauksen ketteryyttä Fiddler AutoResponderin avulla. Lisätietoja: Komentosarjan WWW-resurssikehitys Fiddler AutoResponderin avulla.
• Vähennä XSS-hyökkäysten riskiä: XSS-hyökkäysten riski ilmenee, kun HTML lisätään/sidotaan DOM:iin. Käytä vain teksti -tekstiä aina kun mahdollista tämän riskin vähentämiseksi. Jos HTML on pakollinen, sinun on puhdistettava tämä sisältö ennen sen lisäämistä tietueeseen.
• Noudata asiakkaan komentosarjojen yleisiä parhaita käytäntöjä. Lisätietoja: Asiakaskomentosarjat mallipohjaisissa sovelluksissa
• Varmista osallistavat suunnittelukäytännöt, mukaan lukien automaattisten testaustyökalujen, kuten helppokäyttötoimintojen, käyttö.

Ratkaisuesimerkki

Alkuun pääsee mukautetun yhdistimen ratkaisumallin avulla. Siinä on SecondaryRecordSource-verkkoresurssi, joka on määritetty Tili vuorovaikutteisia kokemuksia varten- ja Tili monikäyttökokemuksia varten -lomakkeille.

Katso myös

Aikajanan käyttö
Aikajanan määritys

Huomautus

Voitko kertoa meille dokumentaatiota koskevan kielimäärityksesi? Vastaa lyhyeen kyselyyn. (Huomaa, että tämä kysely on englanninkielinen.)

Kyselyyn vastaaminen kestää noin seitsemän minuuttia. Henkilökohtaisia tietoja ei kerätä (tietosuojatiedot).