Anslut AEM Forms as a Cloud Service med Adobe Acrobat Sign integrate-adobe-sign-with-aem-forms

Version
Artikellänk
AEM 6.5
Klicka här
AEM as a Cloud Service
Den här artikeln

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:

  1. Ett aktivt Adobe Acrobat Sign-utvecklarkonto.
  2. Ett Adobe Acrobat Sign API-program.
  3. Autentiseringsuppgifter (klient-ID och klienthemlighet) för API-programmet Adobe Acrobat Sign.
  4. (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.

  1. I AEM Forms-författarinstans går du till Tools hammer > General > Configuration Browser.

  2. Välj Create på sidan Configuration Browser.

  3. 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.

  4. Navigera till Tools hammer > 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.
  5. På konfigurationssidan väljer du Create för att skapa Adobe Acrobat Sign-konfigurationen i AEM Forms.

  6. 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.

  7. Nu kan du Select solution välja Adobe Acrobat Sign.

    Adobe Acrobat Sign Solutions

  8. 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.

  9. 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.
  10. Konfigurera OAuth-inställningar för programmet Adobe Acrobat Sign:

    1. Öppna ett webbläsarfönster och logga in på ditt Adobe Acrobat Sign-utvecklarkonto.

    2. Markera programmet som är konfigurerat för AEM Forms och välj Configure OAuth for Application.

    3. I rutan Redirect URL lägger du till den URL som kopierades i ett tidigare steg (steg 8) och klickar på Save.

    4. 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.

    OAuth-konfiguration

  11. 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.

  12. 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.

  13. 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.

    Konfigurationen av Adobe Acrobat Sign Cloud lyckades

  14. Välj Create om du vill skapa Adobe Acrobat Sign-konfigurationen.

  15. Markera konfigurationen och klicka på Publish, markera konfigurationen och klicka på Publish. Konfigurationen replikeras till motsvarande publiceringsmiljöer.

  16. 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.

NOTE
Om du vill konfigurera Adobe Sign-sandlådan kan du följa samma konfigurationssteg som beskrivs i Adobe Sign.

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:

Konfigurationsfel

  1. Kopiera URL:en som finns i det aktuella webbläsarfönstret till ett anteckningsblock och ta bort delen /ui#/aem från URL:en.
  2. Öppna ett webbläsarfönster och logga in på ditt Adobe Acrobat Sign-utvecklarkonto.
  3. Markera programmet som är konfigurerat för AEM Forms och välj Configure OAuth for Application.
  4. 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

Adobe Sign Government Workflow

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

  1. På Forms as a Cloud Service författarinstans går du till Tools hammer > General > Configuration Browser.
  2. Välj Create på sidan Configuration Browser.
  3. 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.
  4. Navigera till Tools hammer > 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.
  5. På konfigurationssidan väljer du Create för att skapa Adobe Acrobat Sign-konfigurationen i AEM Forms.
  6. Kopiera URL-adressen för det aktuella webbläsarfönstret till ett anteckningsblock och ta bort /ui#/aem från URL-adressen. Denna URL kallas re-direct URL.
    I nästa avsnitt delar du re-direct URL och Scopes 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

  1. Öppna re-direct URL i webbläsaren. Du skapade och lade märke till re-direct URL i det sista steget i avsnittet Skapa en omdirigerings-URL för din AEM.

  2. 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.

  3. Välj Adobe Acrobat Sign Solutions for Government för alternativet Select solution på fliken Settings på sidan Create Adobe Sign Configuration.

    Adobe Acrobat Sign Solutions för offentlig sektor

  4. I fältet Email anger du den e-postadress som är kopplad till ditt Adobe Acrobat Sign Solutions for Government-konto.

  5. 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.
  6. 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].

  7. 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.

  8. 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.

    Konfigurationen av Adobe Acrobat Sign Cloud lyckades

  9. Välj Create för att skapa konfigurationen.

  10. Markera konfigurationen och klicka på Publish, markera konfigurationen och klicka på Publish. Konfigurationen replikeras till motsvarande publiceringsmiljöer.

  11. 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:

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.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab