Integrera Create Correspondence UI med din anpassade portal integrating-create-correspondence-ui-with-your-custom-portal

Ökning overview

I den här artikeln beskrivs hur du kan integrera Create Correspondence Solution med din miljö.

URL-baserat anrop url-based-invocation

Ett sätt att anropa programmet Create Correspondence från en anpassad portal är att förbereda URL:en med följande frågeparametrar:

  • identifieraren för bokstavsmallen (med parametern cmLetterId).

  • URL:en till XML-data som hämtats från den önskade datakällan (med parametern cmDataUrl).

Den anpassade portalen skulle till exempel förbereda URL:en som
https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL]som kan vara href från en länk på portalen.

NOTE
Anrop på ett sådant sätt är inte säkert eftersom de nödvändiga parametrarna skickas som en GET-förfrågan, eftersom samma (tydligt synliga) visas i URL-adressen.
NOTE
Innan du anropar programmet Create Correspondence sparar och överför du data för att anropa användargränssnittet Create Correspondence på angiven dataURL. Detta kan antingen göras från den anpassade portalen eller genom en annan back end-process.

Inline databaserat anrop inline-data-based-invocation

Ett annat (och säkrare) sätt att anropa programmet Create Correspondence kan vara att bara trycka på URL:en på https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html när du skickar parametrar och data för att anropa programmet Create Correspondence som en POST (dölja dem för slutanvändaren). Det innebär också att du nu kan skicka XML-data för Create Correspondence-programmet (som en del av samma begäran, med parametern cmData), vilket inte var möjligt/idealiskt i den tidigare metoden.

Parametrar för att ange bokstav parameters-for-specifying-letter

Namn
Typ
Beskrivning
cmLetterInstanceId
Sträng
Bokstavsinstansens identifierare.
cmLetterId
Sträng
Namnet på brevmallen.

Parametrarnas ordning i tabellen anger inställningarna för parametrar som används för att läsa in bokstaven.

Parametrar för att ange XML-datakällan parameters-for-specifying-the-xml-data-source

Namn
Typ
Beskrivning
cmDataUrl
URL
XML-data från en källfil med hjälp av grundläggande protokoll som cq, ftp, http eller file.
cmLetterInstanceId
Sträng
Använda XML-data som är tillgängliga i Letter Instance.
cmUseTestData
Boolean
Om du vill återanvända testdata som bifogats i dataordlistan.

Parametrarnas ordning i tabellen anger inställningarna för de parametrar som används för att läsa in XML-data.

Andra parametrar other-parameters

Namn
Typ
Beskrivning
cmPreview
Boolean
True to open the letter in preview mode
Slumpmässig
Tidsstämpel
Lös problem med webbläsarcachning.

Om du använder http- eller cq-protokoll för cmDataURL bör URL:en för http/cq vara anonym.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2