AEM Forms as a Cloud Service Communications Synchronous APIs Processing

Logboek in Adobe Cloud Manager

1. Ga aan ​ my.cloudmanager.adobe.com ​
2. Meld u aan bij uw Adobe ID

ga aan het Overzicht van het Programma

1. Selecteer uw programma in de lijst. U wordt omgeleid naar de pagina Program Overview

plaats de Details van het Milieu

1. Selecteer het ellipsis (…) pictogram naast de milieunaam en klik Update

2. Klik voorleggen knoop en stel de voorgestelde FullstackPipeline in werking.

   

plaats van de Sectie van de Bewaarplaats

1. Op de pagina van het Overzicht van het 0} Programma, klik de Bewaarplaatsen tabel

2. Zoek de naam van de opslagplaats en klik op het weglatingenmenu (…)

3. De URL van de gegevensopslagruimte kopiëren

   note note
   NOTE
   De URL-indeling is doorgaans https://git.cloudmanager.adobe.com/<org>/<program>/

Kloon die het Bevel van het Git gebruiken

1. De opdrachtprompt of terminal openen

2. Voer de opdracht git clone uit om de Git-opslagplaats te klonen.

   code language-bash
   git clone [repository-url]

   note note
   NOTE
   Als u de Git-opslagplaats wilt klonen, gebruikt u de gegevens die door Adobe Cloud Manager zijn opgegeven.

   Als u bijvoorbeeld uw Git Repository wilt klonen, voert u de volgende opdracht uit:

   code language-bash
   https://git.cloudmanager.adobe.com/formsinternal01/AEMFormsInternal-ReleaseSanity-p43162-uk59167/

   

Logboek in Adobe Cloud Manager

1. Ga aan ​ my.cloudmanager.adobe.com ​
2. Meld u aan bij uw Adobe ID

ga aan het Overzicht van het Programma
Selecteer uw programma in de lijst. U wordt omgeleid naar de pagina Program Overview

Toegang en de Omgeving van de Dienst van de Wolk AEM

U kunt de details van de AEM Cloud Service Environment weergeven of openen met een van de volgende twee opties:

• Optie 1: Van de Pagina van het Overzicht

  1. Op de pagina van het Overzicht van het Programma

  2. Klik "Milieu's" in het linkerzijmenu. U ziet een lijst met alle omgevingen

     

  3. Klik op de naam van de specifieke omgeving om details weer te geven

     

• Optie 2: Van de Sectie van Milieu's

  1. Op de pagina Programmaoverzicht

  2. Bepaal de plaats van de sectie van Milieu's

  3. Klik "tonen allen" om alle milieu's te bekijken

  4. Klik het weglatingsmenu (…) naast het milieu
     

  5. Selecteer "Details van de Mening"

     

vind Uw Eindpunt van AEM Forms

Van de detailspagina van het Milieu Milieu, neem nota van de volgende details:

URL van de Dienst van de Auteur

• URL: https://author-pXXXXX-eYYYYY.adobeaemcloud.com
• Emmertje: auteur-pXXXXX-YYYY
  Voorbeeld: https://author-p43162-e177398.adobeaemcloud.com

publiceer de Dienst URL

• URL: https://publish-pXXXXX-eYYYYY.adobeaemcloud.com
• Emmertje: publish-pXXXXX-YYYY
  Voorbeeld: https://publish-author-p43162-e177398.adobeaemcloud.com

Toegang Adobe Developer Console

1. Ga aan ​ Adobe Developer Console ​
2. Meld u aan bij uw Adobe ID

creeer Nieuw Project

1. Van de Snelle sectie van het Begin, klik creeer nieuw project

2. Een nieuw project wordt gecreeerd met een standaardnaam

   

3. Klik uitgeven project in de hoogste juiste hoek

   uit

4. Geef een betekenisvolle naam op (bijvoorbeeld "formsproject")

5. Klik sparen

   

Klik toevoegen API

toe

Selecteer Communicatie APIs van Forms

1. In voeg API dialoog toe, filter door Experience Cloud
2. Selecteer "Communicatie APIs van Forms"

Selecteer Server-aan-Server authentificatiemethode

klik toevoegen API

• In uw project, klik toevoegen API knoop

toe

Uitgezochte AEM Forms Levering en Runtime API

• In voeg API dialoog toe, filter door Experience Cloud
• Selecteer "AEM Forms Delivery and Runtime API"
• Klik daarna

toe

Methode van de Authentificatie

• Selecteer Server-aan-Server authentificatiemethode.

Selecteer het aangewezen Profiel van het Product dat op vereist toegangsniveau wordt gebaseerd:

Selecteer het Profiel van het Product dat uw Dienst URL van de Auteur (https://author-pXXXXX-eYYYYY.adobeaemcloud.com) aanpast. Selecteer bijvoorbeeld https://author-pXXXXX-eYYYYY.adobeaemcloud.com .

Klik sparen gevormde API. De API en het Profiel van het Product worden toegevoegd aan uw project

toegang tot Uw geloofsbrieven

1. Ga naar uw project in Adobe Developer Console
2. Klik op Server-aan-Server referentie
3. Bekijk de Credentials details sectie

Opname API geloofsbrieven

API Credentials:
================
Client ID: <your_client_id>
Client Secret: <your_client_secret>
Technical Account ID: <tech_account_id>
Organization ID: <org_id>
Scopes: AdobeID,openid,read_organizations

ga aan uw Project

1. Open uw project in Adobe Developer Console
2. Klik Server-aan-Server

produceer het Token van de Toegang

1. Klik "produceer toegangstoken" knoop in de API van uw project sectie
2. Het gegenereerde toegangstoken kopiëren

plaats of creeer Folder Config

1. Navigeer naar de gekloonde AEM Project-opslagplaats en ga naar de map config .
2. Als het niet bestaat, creeer het op het niveau van de projectwortel:

mkdir config

Maak een nieuw bestand met de naam api.yaml in de map config :

touch config/api.yaml

Voeg de volgende code toe aan het api.yaml -bestand:

kind: "API"
version: "1"
metadata:
envTypes: ["dev"]  # or ["prod", "stage"] for production environments
data:
allowedClientIDs:
    author:
    - "<your_client_id>"
    publish:
    - "<your_client_id>"
    preview:
    - "<your_client_id>"

In het volgende voorbeeld worden de configuratieparameters uitgelegd:

• soort: Altijd plaats aan "API" (identificeert dit als API configuratie)

• versie: API versie, typisch "1" of "1.0"

• envTypes: Serie van milieutypes waar dit config van toepassing is

  • ["dev"] - Alleen ontwikkelomgevingen
  • ["stage"] - Alleen testomgevingen
  • ["prod"] - Alleen productieomgevingen

• allowedClientIDs: De cliënt IDs wordt toegestaan om tot uw instantie van AEM toegang te hebben

  • auteur: De identiteitskaart van de cliënt voor auteursrij
  • publiceert: De identiteitskaart van de cliënt voor publiceer rij
  • voorproef: De identiteitskaart van de cliënt voor voorproefrij

Voeg bijvoorbeeld allowedClientIDs as 6bc4589785e246eda29a545d3ca55980 en envTypes als dev toe:

zet en duw Veranderingen vast

1. Navigeer naar de hoofdmap van uw gekloonde opslagplaats en voer de onderstaande opdrachten uit:

    git add config/api.yaml
    git commit -m "Whitelist client id for api invocation"
    git push origin <your-branch>

Opstelling Config Pipeline

1. Logboek in Cloud Manager

   1. Ga aan ​ my.cloudmanager.adobe.com ​
   2. Meld u aan bij uw Adobe ID

2. ga aan Uw Programma
   Selecteer uw programma in de lijst en u wordt omgeleid op de pagina van het Overzicht van het Programma

3. plaats van de Kaart van Pijpleidingen

   1. Bepaal de plaats van Pijpleidingen kaart op de pagina van het Overzicht van het Programma
   2. Klik "toevoegen" knoop

4. Uitgezochte Type van Pijpleiding

   • voor de milieu's van de Ontwikkeling: Selecteer "voeg niet-productiepijpleiding toe". Niet-productiepijpleidingen zijn bestemd voor ontwennings- en werkruimten

   • voor de milieu's van de Productie: Selecteer "Voeg de Pijpleiding van de Productie toe". Voor productiepijpleidingen zijn aanvullende goedkeuringen vereist

     note note
     NOTE
     In dit geval, creeer een niet-Productiepijpleiding aangezien een ontwikkelomgeving beschikbaar is.

5. vorm Pijpleiding - het Lusje van de Configuratie

   In het lusje van de Configuratie:

   a. Type van Pijpleiding

   • Selecteer "Pipeline van de Plaatsing"

   b. Naam van de Pijpleiding

   • Geef een beschrijvende naam op. Geef de pijpleiding bijvoorbeeld de naam api-config-pipieline

   c. Trigger van de Plaatsing

   • Hand: Implementeer slechts wanneer manueel teweeggebracht (geadviseerd voor aanvankelijke opstelling)
   • op de Veranderingen van het Git: Auto-stel op wanneer de veranderingen aan de tak worden geduwd

   d. Belangrijk Metrisch Gedrag van Mislukt

   • vraag telkens als: Vraag om actie op mislukkingen (gebrek)
   • Onmiddellijk Fail: Automatisch ontbreken pijpleiding op metrische mislukkingen
   • ga onmiddellijk verder: ondanks mislukkingen

   e. Klik "ga" verder om aan het Source Code lusje te werk te gaan

   

6. vorm Pijpleiding - het Lusje van de Code van Source

   In het lusje van de Code van 0} Source:

   a. Type van Plaatsing

   • Selecteer "gerichte plaatsing"

   b. Opties van de Plaatsing

   • Selecteer "Config" (stel configuratiedossiers slechts op). Het vertelt Cloud Manager dit een config plaatsing is.

   c. Uitgezochte In aanmerking komende Milieu van de Plaatsing

   • Kies het milieu waar u config wilt opstellen. In dit geval is dit een dev -omgeving.

   d. bepaal de Details van de Code van Source

   • Bewaarplaats: Selecteer de bewaarplaats die uw api.yaml dossier bevat. Selecteer bijvoorbeeld de AEMFormsInternal-ReleaseSanity-p43162-uk59167 repository.
   • Tak van de Git: Selecteer uw tak. In dit geval wordt de code bijvoorbeeld geïmplementeerd in de main -vertakking.
   • Plaats van de Code: ga de weg aan config folder in. Terwijl api.yaml zich in de config -map bij de hoofdmap bevindt, voert u /config in

   e. Klik "sparen" om de pijpleiding tot stand te brengen

   

stelt Configuratie op

Nu de pijplijn wordt gecreeerd, stel uw api.yaml configuratie op:

1. van het Overzicht van Pijpleidingen

   1. Voor de pagina van het Overzicht van het Programma, bepaal de plaats van de Pijpleidingen kaart
   2. Navigeer aan uw onlangs gecreeerd config pijpleiding in de lijst. Bijvoorbeeld, zoek de pijpleidingsnaam u creeerde (b.v., "api-config-pijpleiding"). U kunt pijpleidingsdetails met inbegrip van status en laatste looppas zien.

2. Begin de Plaatsing

   1. Klik "bouwen" knoop (of speel pictogram ▶) naast uw pijpleiding
   2. Bevestig de plaatsing indien ertoe aangezet en de pijpleidingsuitvoering begint

   in werking

3. verifieer Succesvolle Plaatsing

   • Wacht op de pijpleiding om te voltooien.

     • Als dit lukt, verandert de status in "Succes" (groen vinkje ✓ ).

     • Als dit mislukt, verandert de status in ''Mislukt'' (rood kruis ✗ ). Klik Logboeken van de Download om de foutendetails te bekijken.

       

   U kunt nu de Forms Communications API's testen. Voor testdoeleinden kunt u de API's aanroepen met de Postman, curl of een andere REST-client.

Navigeren naar API-documentatie

• Forms API: ​ Forms API Verwijzing ​
• Document Services: ​ de Verwijzing van de Diensten API van het Document ​
  Open de ​ Document Services APIs ​ documentatie in uw browser.

Breid de sectie van de Generatie van het 0} Document uit en selecteer produceert een invulbare vorm van PDF van een malplaatje XDP of van PDF, naar keuze met gegevens die ​ samenvoegen.

In de juiste ruit, klik probeert het.

Voer de volgende waarden in:

Klik verzenden om API aan te halen

Controleer de reactie in het lusje van de Reactie:

• Als de antwoordcode 200 is, betekent dit dat de PDF is gemaakt.
• Als de antwoordcode 400 is, betekent dit dat de aanvraagparameters ongeldig of onjuist zijn geformuleerd.
• Als de antwoordcode 500 is, betekent dit dat er een interne serverfout is.

In dit geval is de antwoordcode 200 , hetgeen betekent dat de PDF is gegenereerd:

Nu, kunt u ​ gecreeerde PDF ​ downloaden gebruikend de 3} knoop van de Download {en het bekijken in de kijker van PDF:

Open cmd/terminal en stel het bevel in werking:

code .

Het opent het project in de coderedacteur.

Werk het package.json -bestand bij om het type to module -bestand toe te voegen.

{
"name": "demo-nodejs-generate-pdf",
"version": "1.0.0",
"type": "module",
"main": "index.js",
}

.env dossier op het wortelniveau van een project tot stand brengen

Voeg de volgende configuratie toe en vervang placeholders met de daadwerkelijke waarden van OAuth van het Project van ADC Server-aan-Server referentie.

CLIENT_ID=<ADC Project OAuth Server-to-Server credential ClientID>
CLIENT_SECRET=<ADC Project OAuth Server-to-Server credential Client Secret>
SCOPES=<ADC Project OAuth Server-to-Server credential Scopes>