Anslut AEM Forms as a Cloud Service med Adobe Acrobat Sign integrate-adobe-sign-with-aem-forms
Adobe Acrobat Sign aktiverar e-signaturarbetsflöden för adaptiva Forms- och AEM. E-signaturer förbättrar arbetsflödena för att bearbeta dokument inom juridik, försäljning, löneadministration, personaladministration och många andra områden.
I ett typiskt Adobe Acrobat Sign- och Adaptivt Forms-scenario fyller en användare i ett adaptivt formulär som kan användas för en tjänst. Till exempel kan en kreditkortsansökan och en medborgare få förmåner. När en användare fyller i, skickar och signerar ansökningsformuläret skickas formuläret till tjänsteleverantören för ytterligare åtgärder. Tjänsteleverantören granskar programmet och använder Adobe Acrobat Sign för att markera programmet som godkänt. AEM Forms stöder både Adobe Acrobat Sign och Adobe Acrobat Sign Solutions for Government. Beroende på licens och krav kan du integrera eller ansluta AEM Forms med någon av lösningarna:
Anslut AEM Forms till Adobe Acrobat Sign adobe-sign
Om du vill ansluta AEM Forms till Adobe Acrobat Sign ställer du in programvaran och kontona som listas i avsnittet Krav och konfigurerar Adobe Sign Cloud Service i Forms as a Cloud Service Author och Publish:
Krav för att ansluta AEM Forms till Adobe Acrobat Sign prerequisites-for-adobe-sign
Du behöver följande konfiguration för att integrera Adobe Acrobat Sign med AEM Forms:
- Ett aktivt Adobe Acrobat Sign-utvecklarkonto.
- Ett Adobe Acrobat Sign API-program.
- Autentiseringsuppgifter (klient-ID och klienthemlighet) för API-programmet Adobe Acrobat Sign.
- (Endast för myndighets-ID-baserad autentisering) Aktivera autentiseringsmetoden för autentisering av myndighets-ID.
Koppla samman AEM Forms Author och publicera förekomster med Adobe Acrobat Sign configure-adobe-sign-with-aem-forms
När förutsättningarna är uppfyllda utför du följande steg för att konfigurera Adobe Acrobat Sign med AEM Forms på författarinstanserna.
-
I AEM Forms-författarinstans går du till Tools > General > Configuration Browser.
-
Välj Create på sidan Configuration Browser.
-
I dialogrutan Create Configuration anger du Title för konfigurationen, aktiverar Cloud Configurations och väljer Create. Den skapar en konfigurationsbehållare för lagring av Cloud Service. Kontrollera att mappnamnet inte innehåller något utrymme.
-
Navigera till Tools > Cloud Services > Adobe Acrobat Sign och öppna konfigurationsbehållaren som du skapade i föregående steg.
note note NOTE När du skapar ett adaptivt formulär anger du behållarnamnet i fältet Configuration Container. -
På konfigurationssidan väljer du Create för att skapa Adobe Acrobat Sign-konfigurationen i AEM Forms.
-
På fliken General på sidan Create Adobe Acrobat Sign Configuration anger du Name för konfigurationen och väljer Next. Du kan också ange en Title och bläddra för att välja en Thumbnail för konfigurationen.
-
Nu kan du Select solution välja Adobe Acrobat Sign.
-
Kopiera URL:en som finns i det aktuella webbläsarfönstret till ett anteckningsblock och ta bort delen
/ui#/aem
från URL:en. Den ändrade URL:en krävs sedan för att konfigurera Adobe Acrobat Sign-programmet med AEM Forms, i ett senare steg. Välj Next. -
På fliken Settings
-
fältet OAuth URL innehåller standardwebbadressen som innehåller Adobe Sign-databasdelning. URL-formatet är:
https://<shard>/public/oauth/v2
Till exempel:
https://secure.na1.echosign.com/public/oauth/v2
-
fältet Access token URL innehåller standardwebbadressen som innehåller Adobe Sign-databasdelning. URL-formatet är:
https://<shard>/oauth/v2/token
Till exempel:
https://api.na1.echosign.com/oauth/v2/token
där:
na1 refererar till standarddatabasdelningen. Du kan ändra värdet för databasdelningen. Kontrollera att Adobe Acrobat Sign-molnkonfigurationerna pekar på rätt kort.
note note NOTE - Håll sidan Skapa Adobe Acrobat Sign-konfiguration öppen. Stäng den inte. Du kan hämta klient-ID och klienthemlighet efter att OAuth-inställningarna för Adobe Acrobat Sign-programmet har konfigurerats, vilket beskrivs i kommande steg.
- När du har loggat in på ditt Adobe Sign-konto går du till Acrobat Sign API > API Information > REST API Methods Documentation > OAuth Access Token för att få tillgång till information om Adobe Sign OAuth URL och Access Token URL.
-
-
Konfigurera OAuth-inställningar för programmet Adobe Acrobat Sign:
-
Öppna ett webbläsarfönster och logga in på ditt Adobe Acrobat Sign-utvecklarkonto.
-
Markera programmet som är konfigurerat för AEM Forms och välj Configure OAuth for Application.
-
I rutan Redirect URL lägger du till den URL som kopierades i ett tidigare steg (steg 8) och klickar på Save.
-
Aktivera följande scope för programmet Adobe Acrobat Sign och klicka på Save.
- aggrement_read
- aggrement_write
- aggrement_send
- widget_read
- widget_write
- workflow_read
Stegvis information om hur du konfigurerar OAuth-inställningar för ett Adobe Acrobat Sign-program och hämtar nycklarna finns i Konfigurera autentiseringsinställningar för programmetsutvecklardokumentation.
-
-
Gå tillbaka till sidan Create Adobe Acrobat Sign Configuration. På fliken Settings anger du [Client ID (kallas även program-ID) och Client Secret]. Använd Klient-ID och Klienthemlighet för det Adobe Acrobat Sign-program som du skapade i föregående steg.
-
Välj alternativet Enable Adobe Acrobat Sign for attachments om du vill lägga till filer som är kopplade till ett adaptivt formulär i motsvarande Adobe Acrobat Sign -dokument som skickats för signering.
-
Välj Connect to Adobe Acrobat Sign. När du uppmanas att ange autentiseringsuppgifter anger du användarnamn och lösenord för kontot som används när Adobe Acrobat Sign-programmet skapas. Åtkomst till
your developer account
, klicka på Allow Access när du uppmanas att bekräfta. Om inloggningsuppgifterna är korrekta och du tillåter AEM Forms att få åtkomst till ditt Adobe Acrobat Sign-utvecklarkonto, visas ett meddelande om att åtgärden lyckades som det nedan. -
Välj Create om du vill skapa Adobe Acrobat Sign-konfigurationen.
-
Markera konfigurationen och klicka på Publish, markera konfigurationen och klicka på Publish. Konfigurationen replikeras till motsvarande publiceringsmiljöer.
-
Upprepa alla ovanstående steg på din utvecklare, scen och produktionsinstanser (beroende på vad som återstår) för att slutföra konfigurationen av Adobe Acrobat Sign med AEM Forms för din miljö.
Nu kan du använda för att lägga till Adobe Acrobat Sign-fält i ett anpassat formulär. Se till att du lägger till konfigurationsbehållaren som används för Cloud Servicen i alla adaptiva Forms som aktiveras för Adobe Acrobat Sign. Du kan ange en konfigurationsbehållare bland egenskaperna för ett adaptivt formulär.
Felsökning resolve-config-error
När du ansluter Adobe Acrobat Sign till AEM Forms och hittar ett fel Unable to authorize access because the client configuration is invalid: invalid_request
som visas i bilden nedan. Du löser detta genom att följa stegen nedan:
- Kopiera URL:en som finns i det aktuella webbläsarfönstret till ett anteckningsblock och ta bort delen
/ui#/aem
från URL:en. - Öppna ett webbläsarfönster och logga in på ditt Adobe Acrobat Sign-utvecklarkonto.
- Markera programmet som är konfigurerat för AEM Forms och välj Configure OAuth for Application.
- I rutan Redirect URL lägger du till den URL som kopierades i ett tidigare steg och klickar på Save.
Koppla AEM Forms till Adobe Acrobat Sign Solutions för myndigheter adobe-acrobat-sign-for-government
Att knyta AEM Forms till Adobe Acrobat Sign Solutions för myndigheter är en flerstegsprocess. Den innehåller följande uppgifter:
- Skapar omdirigerings-URL för dina AEM
- Dela omdirigerings-URL:er och omfattningar med Adobe Sign Solutions for Government-teamet
- Få inloggningsuppgifter från Adobe Sign team
- Använda inloggningsuppgifterna för att ansluta AEM Forms till Adobe Acrobat Sign Solutions för myndigheter
AEM Forms as a Cloud Service erbjuder utvecklings-, scen- och produktionsmiljöer. Du kan börja med att ansluta utvecklingsmiljön för med Adobe Acrobat Sign Solutions för myndigheter och senare koppla samman scen- och produktionsmiljöerna.
Innan du börjar prerequisites-for-adobe-sign-for-acrobat-sign-for-government
Innan du börjar ansluta AEM Forms med Adobe Acrobat Sign Solution måste du kontrollera att ditt Adobe Acrobat Sign Solutions for Government-konto har etablerats.
Anslut AEM Forms as a Cloud Service till Adobe Acrobat Sign Solutions för myndigheter connect-adobe-acrobat-sign-for-government
Skapa en omdirigerings-URL för AEM
- På Forms as a Cloud Service författarinstans går du till Tools > General > Configuration Browser.
- Välj Create på sidan Configuration Browser.
- I dialogrutan Create Configuration anger du Title för konfigurationen, aktiverar Cloud Configurations och väljer Create. Den skapar en konfigurationsbehållare för lagring av Cloud Service. Kontrollera att mappnamnet inte innehåller något utrymme.
- Navigera till Tools > Cloud Services > Adobe Acrobat Sign och öppna konfigurationsbehållaren som du skapade i föregående steg. När du skapar ett adaptivt formulär anger du behållarnamnet i fältet Configuration Container.
- På konfigurationssidan väljer du Create för att skapa Adobe Acrobat Sign-konfigurationen i AEM Forms.
- Kopiera URL-adressen för det aktuella webbläsarfönstret till ett anteckningsblock och ta bort
/ui#/aem
från URL-adressen. Denna URL kallasre-direct URL
.
I nästa avsnitt delar dure-direct URL
ochScopes
med Adobe Sign-teamet och begär autentiseringsuppgifter (klient-ID och klienthemlighet).
Dela omdirigerings-URL:en och omfattningarna med Adobe Sign team och få inloggningsuppgifter
Adobe Acrobat Sign for Government Solutions-teamet kräver att re-direct URL
och vissa omfattningar är aktiverade för ditt Adobe Acrobat Sign-program (se nedan) för att generera autentiseringsuppgifter (klient-ID och klienthemlighet) som gör att du kan ansluta AEM Forms till Adobe Acrobat Sign Solutions för myndigheter.
Dela scopes
(visas nedan) och re-direct URL
skapade och noterade det sista steget i föregående avsnitt med din Adobe Acrobat Sign for Government Solution-representant (Adobe Professional Services-teammedlem).
Omfång
- aggrement_read
- aggrement_write
- aggrement_send
- widget_read
- widget_write
- workflow_read
- offline_access
Representanten genererar och delar uppgifter med dig. I nästa avsnitt använder du inloggningsuppgifterna (Klient-ID och Klienthemlighet) för att ansluta AEM Forms till Adobe Acrobat Sign Solutions för myndigheter.
Använd de inloggningsuppgifter som tas emot för att ansluta AEM Forms till Adobe Acrobat Sign Solutions för offentlig sektor
-
Öppna
re-direct URL
i webbläsaren. Du skapade och lade märke tillre-direct URL
i det sista steget i avsnittet Skapa en omdirigerings-URL för din AEM. -
På fliken General på sidan Create Adobe Sign Configuration anger du Name för konfigurationen och väljer Next. Du kan också ange en Title och bläddra för att välja en Thumbnail för konfigurationen. Klicka på Next.
-
Välj Adobe Acrobat Sign Solutions for Government för alternativet Select solution på fliken Settings på sidan Create Adobe Sign Configuration.
-
I fältet Email anger du den e-postadress som är kopplad till ditt Adobe Acrobat Sign Solutions for Government-konto.
-
På fliken Settings
-
fältet OAuth URL innehåller standardwebbadressen som innehåller Adobe Sign-databasdelning. URL-formatet är:
https://<shard>/api/gateway/adobesignauthservice/api/v1/authorize
Till exempel:
https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/authorize
-
fältet Access token URL innehåller standardwebbadressen som innehåller Adobe Sign-databasdelning. URL-formatet är:
https://<shard>/api/gateway/adobesignauthservice/api/v1/token
Till exempel:
https://secure.na1.adobesign.us/api/gateway/adobesignauthservice/api/v1/token
där:
na1 refererar till standarddatabasdelningen. Du kan ändra värdet för databasdelningen. Kontrollera att Adobe Acrobat Sign-molnkonfigurationerna pekar på rätt kort.
note note NOTE - När du har loggat in på ditt Adobe Sign-konto går du till Acrobat Sign API > API Information > REST API Methods Documentation > OAuth Access Token för att få tillgång till information om Adobe Sign Autentiserings-URL och Access Token URL.
-
-
Använd de inloggningsuppgifter som delas av Adobe Acrobat Sign for Government Solution manager ([Adobe Professional Services team member]) i föregående avsnitt som [Client ID och Client Secret].
-
Välj alternativet Enable Adobe Acrobat Sign for attachments om du vill lägga till filer som är kopplade till ett adaptivt formulär i motsvarande Adobe Acrobat Sign -dokument som skickats för signering.
-
Välj Connect to Adobe Sign. När du uppmanas att ange autentiseringsuppgifter anger du användarnamn och lösenord för kontot som används när programmet Adobe Acrobat Sign skapas. När du uppmanas att bekräfta åtkomst för
your developer account
klickar du på Allow Access. Om inloggningsuppgifterna är korrekta och du tillåter AEM Forms att få åtkomst till ditt Adobe Acrobat Sign-utvecklarkonto, visas ett meddelande om att åtgärden lyckades som det nedan. -
Välj Create för att skapa konfigurationen.
-
Markera konfigurationen och klicka på Publish, markera konfigurationen och klicka på Publish. Konfigurationen replikeras till motsvarande publiceringsmiljöer.
-
Upprepa alla ovanstående steg på din utvecklare, scen och produktionsinstanser (beroende på vad som återstår) för att slutföra konfigurationen av Adobe Acrobat Sign Solutions for Government med AEM Forms för din miljö.
Nu kan du använda Adobe Acrobat Sign-fält i ett anpassat formulär eller AEM. Se till att du lägger till den konfigurationsbehållare som används för Cloud Servicen i alla adaptiva Forms som aktiveras för Adobe Acrobat Sign. Du kan ange en konfigurationsbehållare bland egenskaperna för ett adaptivt formulär.
Konfigurera schemaläggaren för Adobe Acrobat Sign för att synkronisera signeringsstatusen configure-adobe-sign-scheduler-to-sync-the-signing-status
AEM Forms as a Cloud Service tillhandahåller en schemaläggningstjänst som kontrollerar signerarnas status med definierade intervall. Scenerna där du konfigurerar schemaläggningstjänsten:
- Om du använder Skicka formuläret (när alla mottagare har slutfört signeringsceremonin) för att signera ett dokument, skickas formuläret endast när alla signerare har signerat formuläret.
- Om du använder Signeringssteget i ett AEM arbetsflöde för att signera ett dokument väntar signeringssteget på att alla signerare ska signera dokumentet innan du fortsätter till nästa steg i arbetsflödet.
Som standard kontrollerar Adobe Acrobat Sign Scheduler Services (enkäter) signerarens svar efter var 24:e timme. Du kan ändra standardintervallet för din miljö.
Om du vill ändra standardintervallet anger du ett cron-uttryck för egenskapen sign.status.exp i konfigurationen för Adobe Acrobat Sign Configuration Service.
Om du till exempel vill köra konfigurationstjänsten varje dag kl. 00:00 anger du egenskapen sign.status.exp för konfigurationen av Adobe Acrobat Sign Configuration Service till 0 0 0 1/1 * ? *
. I följande JSON-fil visas exemplet som ska köra konfigurationstjänsten varje dag klockan 00:00:
{
"sign.status.exp":"0 0 0 1/1 * ? *"
}
Generera OSGi-konfigurationer med AEM SDK och distribuera konfigurationen till din Cloud Service om du vill ange värden för en konfiguration.