Adobe Acrobat Sign for ServiceNow: installations- og konfigurationsvejledning (v2.2)

Oversigt

Programmet Adobe Acrobat Sign for ServiceNow gør det muligt at sende dokumenter til underskrivelse ved hjælp af den indbyggede funktion i ServiceNow-platformen. Acrobat Sign-integration med ServiceNow giver dig adgang til følgende funktioner:

  • Send dokumenter til underskrivelse til flere modtagere.
  • Spor underskrivelsesprocessen gennem dens livscyklus, og identificer de forventede underskrivere på hvert trin.
  • Hent det underskrevne dokument med et integreret eller separat revisionsspordokument.
  • Formulardata, der angives i dokumentet før eller under underskrivelsesprocessen, hentes også.
  • Opret udkast til signaturproces til en indledende gennemgang og efterfølgende indsendelse. Ændringer foretaget af underskrivere før indsendelse synkroniseres i ServiceNow.
  • Generér og send mailnotifikationer til enkeltpersoner under underskrivelsesprocessen.
  • Find dokumenterne til underskrivelse fra de lokale filer i ServiceNow eller fra en ekstern kilde.
  • Et skabelondokument kan indeholde felter, som kan udfyldes med data fra ServiceNow-poster før indsendelse. Dette tillader, at en enkelt skabelon kan bruges til at generere brugerspecifikke dokumenter baseret på en valgt emnepost såsom en hændelse eller tjenesteanmodning.
  • Brug din Acrobat Sign-kontos biblioteksskabeloner, der er synkroniseret med ServiceNow og kan vælges under indsendelsesprocessen.

Vejledningen Adobe Acrobat Sign til ServiceNow: installation og tilpasning indeholder instruktioner i, hvordan du gør følgende:

Når du har installeret og konfigureret Acrobat Sign til ServiceNow-programmet, kan du bruge det til at sende, underskrive, spore og administrere aftaler. Se Adobe Acrobat Sign for ServiceNow: brugervejledning.

Installér Acrobat Sign for ServiceNow-programmet

Du skal være Adobe Acrobat Sign-administrator og ServiceNow-systemadministrator (administrator) for at kunne installere programmet på ServiceNow.  

  1. Gå til siden ServiceNow Store, og søg efter Adobe Acrobat Sign.  

    servicenow-store-search

  2. Fra søgeresultaterne skal du vælge Adobe Acrobat Sign og derefter vælge Hent.

    Bemærk:

    Deaktiver enhver pop-up blocker under installationen af appen.

    get-sign-app

  3. Hvis du bliver bedt om det, skal du logge på med dine ServiceNow-administratoroplysninger og følge installationsvejledningen.

  4. For at bekræfte installationen skal du fra topmenuen på ServiceNow-forekomsten vælge Alle > Systemprogrammer > Mine virksomhedsprogrammer og derefter vælge fanen Installeret . Her vises listen over den nyeste version af Adobe Acrobat Sign.

    installerede apps

    Bemærk:

    Ekstramodulet (plugin) Adobe Acrobat Sign til ServiceNow er konfigureret til at fungere med følgende domæner:

    • service-now.com
    • servicenowservices.com

    servicenowservices.com er til Government Cloud-kunder og kræver en ekstra indstilling for systemegenskab. Hvis dit domæne er på domænet servicenowservices.com, skal du vælgeOpret/angiv systemegenskaben x_adosy_as.oauth_redirect_host med fuldt underdomæne af din forekomst (f.eks. mydomain.servicenowservices.com).

    Menuen "Selvbetjening" viser den nye indstilling for Adobe Acrobat Sign med følgende to moduler:

    • Mine underskrevne dokumenter – en liste over aftaler i en fuldført tilstand, hvor den indloggede bruger enten er anmoderen eller en underskriver.
    • Til underskrivelse – en liste over aftaler, der afventer underskrivelse af den bruger, der er logget på. Aftalerne er i statussen "Sendt til underskrivelse" eller "Sendt til godkendelse".

    Bemærk: Selvbetjeningsmenuerne er kun synlige for brugere med rollen Underskriver (x_adosy_as.adobe_sign_signer).  

    menu-acrobat-sign

    Menuen Alle programmer indeholder en Adobe Acrobat Sign-funktion, der indeholder følgende moduler:

    • Send til underskrivelse – åbner en postfremstiller, hvorfra en aftale oprettes og sendes.
    • Mine aftaler – en liste over alle aftaler i, hvor den indloggede bruger enten er en anmoder eller en underskriver.
    • Mine signaturer – detaljer af poster, hvor den indloggede bruger er en deltager (underskriver) i en aftale.

    Operationel

    • Aftaler – backend-detaljer om signaturprocessen.Inkluderer JSON samt alle Adobe Acrobat Sign-hændelser, der modtages eller handles på.
    • Kildedokumenter – repræsenterer et dokument, der kan føjes til en aftale. Kan være lokal eller bibliotek
    • Deltagere – underskrivere og detaljer om deres signaturproces.
    • Hændelser – backend-detaljer om det, der sendes og modtages for hver Adobe Acrobat Sign-hændelse.
    • Formulardata – tabel, der indeholder de returnerede formulardata, når en aftale er blevet underskrevet. Dette kan bruges til rapportering af dokumenter og deres feltdata.

    Administration

    • Opret forbindelse til Acrobat Sign – forbindelsesskærm, hvor en gyldig Adobe Sign-konto kan knyttes til ServiceNow.
    • Acrobat Sign-grupper – indeholder listen over Acrobat Sign-gruppers navne og id'er.
    • Acrobat Sign-brugere – indeholder oplysninger om Acrobat Sign-brugerne.
    • Elektroniske segl
    • Dokumentskabeloner – skabelondokumenter, der kan føjes til en aftale. Kan være lokal eller bibliotek.
    • Dokumentfelterdetaljer om de formularfelter, der er integreret i skabelonens dokument.
    • Fletningsregler – associerer en dokumentskabelon med en bestemt type emnepost i ServiceNow.
    • Flet felter – poster, der linker en feltformular og emneposten til et felt, der befinder sig i den relevante dokumentskabelon.
    • Egenskaber – Adobe Acrobat Signs standardindstillinger for URL-omdirigering efter underskrivelse, notifikationer og revisionsspor.

    Hjælp og support – links til Adobe Acrobat Sign Hjælp.

    Bemærk:
    • Modulerne "Send til underskrivelse", "Mine aftaler" og "Mine signaturer" er synlige for brugere med rollen Afsender (x_adosy_as.adobe_sign_sender). 
    • Menuerne "Operativ" og "Administration" er kun synlige for brugere med rollen Administrator (x_adosy_as.adobe_sign_admin) eller rollen Chef (x_adosy_as.adobe_sign_manager)

    Tjenesteportalwidgets

    Hvis du vil føje Adobe Acrobat Sign til din Tjenesteportal, kan du se en demo på URL'en /adobe_sign.

    Denne portal er begrænset til rollerne 'x_adosy_as.adobe_sign_sender' og 'x_adosy_as.adobe_sign_signer'.

    For at føje denne funktionalitet til din egen portal skal du duplikere dine widgets og ændre rollerne som ønsket.

    • Adobe Acrobat Dashboard-elementliste – den elementliste, der bruges af sidehovedwidgetten Aftaleliste.
    • Adobe Acrobat Sign Send til signatur – en widget til oprettelse af en ny aftale fra en skabelon eller fil.
    • Adobe Acrobat Sign-aftaleliste – en widget til visning af listen over aftaler.

    Tjenesteportalsider

    • Adobe Acrobat Sign – denne side indeholder widgetten Adobe Acrobat Sign Popup og kan bruges fra poster i ServiceNow til at generere nye aftaler løbende.
    • Adobe Acrobat Sign-startside – dette er startsiden for demoversionen af den Tjenesteportal, der følger med programmet.

    Der er fire roller inkluderet i programmet:

    • Underskriver (x_adosy_as.adobe_sign_signer)
      • ServiceNow-brugere med rollen x_adosy_as.adobe_sign_signer tildeles adgang til Adobe Acrobat Signs selvbetjeningsmoduler. 
      • De får også adgang til brugeres Tjenesteportalwidget 
      • Denne rolle skal føjes til brugere/grupper, der skal underskrive dokumenter/aftaler
    • Afsender (x_adosy_as.adobe_sign_sender)
      • ServiceNow-brugere med rollen x_adosy_as.adobe_sign_sender tildeles adgang til programmet for at fungere
      • Denne rolle skal føjes til brugere/grupper, der skal kunne spore dokumenter/aftaler, de har anmodet om eller skal underskrive
    • Chef (x_adosy_as.adobe_sign_manager)
      • ServiceNow-brugere med rollen ‘x_adosy_as.adobe_sign_manager’ har chefadgang til Acrobat Sign-funktioner
      • Chefen kan administrere de aftaler, der er oprettet af alle afsendere
      • Denne rolle giver tilladelse til at annullere aftaler, der er oprettet af andre brugere
    • Administrator (x_adosy_as.adobe_sign_admin)
      • ServiceNow-brugere med rollen ‘x_adosy_as.adobe_sign_admin’ har fuld adgang til alle funktioner

    Programmet har som standard en rolle, der bør tildeles til brugere, som skal kunne underskrive dokumenter. For at give alle brugere adgang til at underskrive dokumenter skal du opdatere indstillingerne.

    Forsigtig:

    Ændringer, du foretager af programfiler, forhindrer fremtidige opdateringer i at blive anvendt.

    Registrer alle ændringer, der foretages af et opdateringssæt, så de ændringer kan genanvendes efter en opdatering af programmet.

    Test altid tilpasninger i et dedikeret testmiljø, før de sættes i produktion.

Log på Acrobat Sign

ProgrammetAdobe Acrobat Sign for ServiceNow er designet til at fungere med både kommercielle og offentlige konti (FedRAMP). Hvis du er usikker på, hvilken konto du har, skal du følge instruktionerne for kommercielle cloud-kunder.

For kunder med kommerciel cloud:

Når Adobe Acrobat Sign-programmet er installeret i ServiceNow, skal gruppe- eller -kontoadministratorer fra Adobe Acrobat Sign forbinde ServiceNow med Adobe Acrobat Sign Commercial Cloud ved hjælp af nedenstående trin:

  1. Gå til Adobe Acrobat Sign > Administration > Opret forbindelse til Adobe Acrobat Sign.

  2. I den dialogboks, der vises, skal du vælge Opret.

    connect-sign-1

  3. Log på din Acrobat Sign-konto ved hjælp af dine administratoroplysninger.

    connect-sign-2

  4. I dialogboksen Tilladelser, der vises, skal du vælge Tillad adgang for at give tilladelser og etablere forbindelsen. 

    connect-sign-3

    Bemærk:

    Godkendelsen sker i et popup-vindue.  Hvis du ikke ser godkendelsespanelet, skal du sikre, at din pop op-blocker er deaktiveret.

    Når forbindelsen er oprettet, vises en bekræftelsesmeddelelse med den forbundne Acrobat Sign-konto og den ServiceNow-konto, den er tilknyttet.

    Acrobat Sign har forbindelse til kommerciel cloud

For kunder med Government Cloud:

Når Adobe Acrobat Sign-programmet er installeret i ServiceNow, kan en gruppe- eller kontoadministratorbruger fra Adobe Acrobat Sign Government Cloud forbinde ServiceNow med Adobe Acrobat Sign Government Cloud.

  1. I panelet til venstre skal du vælge Adobe Acrobat Sign > Administration > Egenskaber.

    Aktivér fedramp i Sign til ServiceNow.

  2. På siden med programegenskaber, der åbnes:

    1. Aktivér Brug Adobe Acrobat Sign Government Cloud til/fra.
    2. Find den ejendom, der kaldes Tip til forbindelseslogin, og angiv værdien til den mailadresse, du vil bruge til at logge på Adobe Acrobat Sign Government Cloud.
    3. Vælg Gem.
  3. Gå til Adobe Acrobat Sign > Administration > Opret forbindelse til Acrobat Sign.

  4. På den næste side skal du vælge Opret forbindelse.

    fedramp-2

  5. Log på din Adobe Acrobat Sign Government Cloud-konto, hvis du bliver bedt om det.

    Når forbindelsen er etableret, omdirigerer programmet tilbage til ServiceNow og opdaterer automatisk forbindelsesstatussen.

    fedramp-3

Konfigurer Acrobat Sign til ServiceNow-programmet

Angiv programegenskaber

Du kan få adgang til og indstille programegenskaber ved at gå til Adobe Acrobat Sign > Administration > Egenskaber.

Den viser følgende standardindstillinger:

  • Værtsnavn [x_adosy_as.redirect_host]Hvis du har en brugerdefineret forekomst-URL, skal du angive den fuldt kvalificerede vært, der skal bruges i omdirigerings-URI'en for OAuth- og API-tilbagekald (f.eks. webhooks).
    Som standard er denne værdi tom, og værten er den værdi, som systemegenskaben "glide.servlet.uri" indeholder.
    Den gælder kun for omdirigering af ServiceNow-forekomsten. Hvis du vil omdirigere underskriveren efter underskrivelsen til en anden vært, skal du angive værten i egenskaben Underskriveromdirigering-URI (post_sign_uri).
  • Standardwebadresse efter underskrivelse [x_adosy_as.post_sign_uri]Standardstedet, hvor en bruger omdirigeres, efter de har underskrevet et dokument i Acrobat Sign. Den bruges, når webadressen efter underskrivelse ikke er angivet under oprettelsen af aftalen. Denne webadresse er i forhold til det angivne forekomstnavn, men dette kan tilsidesættes ved at inkludere en protokol (f.eks. https://www.adobe.com/), som tillader omdirigering efter underskrivelse et andet sted end denne ServiceNow-forekomst. Sys_id'et for den oprettede aftale kan injiceres ved hjælp af "{sys_id}" i URL'en. Standardværdien er "/x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5EORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5Estate=Complete%5EORDERBYDESCsys_created_on", som fører brugeren til en liste over fuldførte aftaler.
  • Forsinkelse af omdirigering af underskriver [x_adosy_as.post_sign_delay]Forsinkelsen (i sekunder), før en bruger omdirigeres, efter de har underskrevet et dokument i Acrobat Sign. Standardværdien er 3.
  • Clickjacking-forsvar [x_adosy_as.clickjacking_domains]Angiv en kommasepareret liste over overordnede domæne-URL'er, hvor dokumenter, der sendes til underskrivelse, kan inkluderes i en iframe, f.eks. service-now.com.
    Dette er nødvendigt for kunder i Government Cloud. Hvis dette felt efterlades tomt, kan det resultere i tomme sider fra Acrobat Sign, når de vises i en ramme.
  • Tillad mails fra Acrobat Sign [x_adosy_as.send_adobe_sign_emails]Kontrollér, om der sendes notifikationsmails af Acrobat Sign under underskrivelsesprocessen. Standardværdien er falsk.
  • Popout-kladdeaftaler [x_adosy_as.popout_draft]Ved at klikke på knappen Se detaljer på en aftale åbnes kladden som standard i Acrobat Sign i det samme browservindue.
    Sæt denne indstilling til sand for at åbne et nyt vindue i stedet. Standardværdien er falsk.
  • Medtag revision [x_adosy_as.include_audit]Kontrollér revisionssporet, der inkluderes i underskrevne dokumenter. Standardværdien er sand.
  • Brug Adobe Acrobat Sign Government Cloud [x_adosy_as.fedramp]Adobe Government Cloud-kunder skal aktivere denne egenskab for at få Acrobat Sign til ServiceNow til at bruge Acrobat Sign Government Cloud-tjenester. Standardværdien er falsk.
  • Tip til forbindelseslogin [x_adosy_as.login_hint]Værdien login_hint, der bruges, første gang der oprettes forbindelse til Adobe Acrobat Sign Government Cloud. Dette udfylder automatisk siden "Opret forbindelse til Acrobat Sign", som normalt er kontoadministratorens brugermail. Standardværdien er tom.
  • Felter til aftaleaktivitet [glide.ui.x_adosy_as_agreement_activity.fields]Angiv, hvilke felter der skal vises i det aktivitetsformat, der vises på aftaleposten.
    Standardværdien er "name, state, status, agreement_id, compose_url, post_sign_uri,etag".
  • Forespørgsel om "Mine aftaler" [x_adosy_as.my_agreements_query]Den forespørgsel, der skal bruges, når mine aftaler vises på steder som portalen. Standardværdien er "requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe^ORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe", som returnerer aftaler, hvor brugeren er anmoderen eller en underskriver.
  • Flerdelt filudvidelse [x_adosy_as.multipart_extension]Filnavnudvidelsen, der skal bruges til de midlertidige vedhæftede filer med flere dele. Standardværdien (anbefales) er "mpfd".
  • Programlogføring [x_adosy_as.logging.verbosity]Kontrolsystemlogføring. Standardværdien er "info".
  • Debug Connect [x_adosy_as.connect_debug]Vis diagnosticeringsadvarsler, når der oprettes forbindelse til Acrobat Sign. Standardværdien er falsk.

Standardegenskaben for omdirigerings-URL'en gælder for alle aftaler, hvor værdien i feltet "URL efter underskrivelse" ikke er blevet indstillet.

Bemærk:

Ukodede specielle tegn eller mellemrum understøttes ikke i omdirigerings-URL'erne. Hvis 'URL-standardadresse efter underskrivelse' i programegenskaben omfatter et cirkumfleks (^), skal du derfor kode den som %5E.

F.eks.  /x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe^ORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe^state=Complete^ORDERBYDESCsys_created_on skal ændres til:

 /x_adosy_as_agreement_list.do?sysparm_query=requested_byDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5EORsignersDYNAMIC90d1921e5f510100a9ad2572f2b477fe%5Estate=Complete%5EORDERBYDESCsys_created_on 

De resterende egenskaber styrer, om der sendes notifikationer fra Acrobat Sign under underskrivelsesprocessen (standard = Nej), og om revisionssporet er inkluderes i de underskrevne dokumenter (standard = Ja).

Konfigurer brugerdefinerede komponenter

Adobe Acrobat Sign-programmet indeholder brugerdefinerede komponenter, der kan konfigureres efter behov. Se nedenstående liste med komponenter for at se, hvordan de skal ændres.

"Underskriv med Adobe Acrobat" er en grænsefladehandlingsknap på tabellen Opgave [task]. Den er kun tilgængelig for brugere med rollen Afsender (x_adosy_as.adobe_sign_sender). Den giver afsenderen mulighed for at føje dokumenter og underskrivere til en aftale og sende det vedhæftede dokument til Adobe Acrobat Sign til underskrivelse.

ui-action-1

Systemadministratorer kan føje handlingen "Underskriv med Adobe Acrobat" til andre tabeller som følger:

  1. Åbn den eksisterende "Underskriv med Adobe Acrobat"-handling på en af følgende to måder: 
    • I enhver formular, der er udvidet fra Opgave (f.eks. Incident), skal du højreklikke > Konfigurer grænsefladehandlinger.
    • Gå til Systemdefinition >  Grænsefladehandlinger, og søg derefter på Underskriv med Adobe Acrobat
  2. Skift om nødvendigt tabelnavnet.
  3. Højreklik på den øverste handlingslinje, og vælg Indsæt og bliv for at oprette en kopi af den eksisterende post med den nye tabel.

Den relaterede Adobe Acrobat Sign-liste viser de aftaler, der er relateret til den post, hvorpå listen er konfigureret.Kun brugere med rollen Bruger (x_adosy_as.adobe_sign_user) eller dem, der er anmodere eller underskrivere af aftalen, kan se aftalerne på den relaterede liste.

Administratorer eller brugere med rollen 'personalize_form' kan konfigurere layoutet af formularen og den relaterede liste.

Sådan føjes den relaterede liste til formularer:

  1. Højreklik på den relevante formular, og gå til Konfigurer > Relaterede lister.
  2. Fra listen Tilgængelig  skal du vælge Adobe Acrobat Sign
  3. Klik på højre pil for at føje den til listen Valgt.
  4. Vælg Gem.

Du returneres til den formular, du var i gang med at konfigurere, og den relaterede Adobe Acrobat Sign-liste er synlig nederst på formularen.

related-list-3

Konfigurer tjenesteportalkomponenter

Programmet Acrobat Sign for ServiceNow leveres med følgende tjenesteportalelementer, der kan bruges eller kopieres med dine egne tjenesteportaler.

Adobe Acrobat Sign-tjenesteportalen, der følger med programmet, er ikke beregnet til at blive brugt eller udvidet. Den understøtter kun grænsefladen Send til underskrivelse.

Du kan få adgang til portalen på /adobe_sign.

Programmet indeholder to Tjenesteportalsider:

  • Adobe Acrobat Sign (x_adosy_as_send)
  • Adobe Acrobat Sign-startside (x_adosy_as_home)

Siden Adobe Acrobat Sign (x_adosy_as_send) bruges udelukkende til grænsefladen Send til underskrivelse og bør ikke ændres.

Adobe Sign-startside (x_adosy_as_home) er angivet som startsiden for Tjenesteportal og er tænkt som et eksempel på de inkluderede widgets.

Du kan bruge de widgets, der følger med programmet, alt efter behov. For at kunne registrere widgetændringer og hente opdateringer fra dit program skal du kun foretage ændringer i en klon af widgeten.

  • Adobe Acrobat Sign Send til underskrivelse: Det bruges til at oprette en aftale fra skabeloner og/eller uploadede filer. Den er tilgængelig fra menupunktet Send til underskrivelse og grænsefladehandlingen Underskriv med Adobe Acrobat og er tilgængelig for brugere med rollen Afsender.

Indstillinger for widget: Widgeten er designet til at blive tilpasset efter behov via widgetforekomstens indstillinger eller URL-parametre. Brug dokumentskabeloner og fletningsregler til automatisk at udfylde formulardata. Du kan indstille de booleske indstillinger til "true" eller "1", når du bruger URL-parametre.

Navn

Type

Beskrivelse

subject_table

Streng

Navnet på den tabel, som aftalen tilhører.

subject_id

Streng

sys_id'et for den post, som aftalen tilhører.

agreement_name

Streng

Den nye aftales navn.

vedhæftede filer

Streng

En liste over vedhæftede sys_ids, der skal bruges i aftalen.

skabeloner

Streng

En liste over dokumentskabelonen sys_ids, der skal bruges i aftalen.

underskrivere

Streng

En liste over brugere eller mailadresser, der skal tilføjes som underskrivere.

ccs

Streng

En liste over brugere eller mailadresser, der skal tilføjes som CC-poster.

password_protect

Boolesk

Kræv, at brugeren indstiller en adgangskode for at beskytte aftalen. Brugeren skal angive en adgangskode, selvom hide_options eller lock_options er sande.

send_emails

Boolesk

Få Adobe til at sende mailbeskeder ved underskrivelsen.

submit_as_draft

Boolesk

Opret en kladdeaftale i stedet for straks at sende til underskrivelse.

copy_to_subject

Boolesk

Kopiér den underskrevne aftalefil til emneposten. Der skal angives en gyldig subject_table og subject_id.

post_sign_uri

Streng

Angiv en brugerdefineret omdirigering for underskriverne, når de er færdige med at underskrive. Standardomdirigeringen sender brugeren til aftaleposten.

hide_options

Streng

En kommasepareret liste over indstillinger, der skal skjules (password_protect, send_emails, submit_as_draft, copy_to_subject). Angiv true for at skjule alle indstillinger for brugeren.

lock_options

Streng

En kommasepareret liste over indstillinger til at gøre skrivebeskyttet (password_protect, send_emails, submit_as_draft, copy_to_subject). Indstil til sand for at forhindre, at alle indstillinger ændres af brugeren.

hide_subject

Boolesk

Undgå, at vedhæftede filer om emnet markeres.

skip_documents

Boolesk

Spring det første dokumentpanel over. Dette gælder kun, når vedhæftede filer eller skabeloner er blevet valgt på forhånd.

  • Adobe Acrobat Dashboard-elementliste: Den kan bruges til at tilføje en liste over aktuelle aftaler, der skal underskrives, til din medarbejder eller kundeserviceportal. Denne liste bruges i funktionen Gøremål på Adobe Sign-startsiden.
    Du kan få adgang til de poster, der vises på denne liste, ved at gå til Selvbetjening > Adobe Acrobat Sign > Til underskrivelse.
  • Adobe Acrobat Sign-sidehoved: Den bruges på Adobe Signs startside til at vise funktionen Gøremål.
Widget

Opret dokumentskabeloner

En dokumentskabelon definerer en skabelon, der kan vælges til inklusion i en aftale.  En skabelon kan bruges til at tilbyde et standarddokument, der kan genbruges for mange individuelle aftaler. Posten "Kildedokument" henviser til en skabelon for at gøre funktionerne i den skabelon tilgængelige for den tilknyttede aftale.

Skabelonen kan være lokal for ServiceNow-forekomsten, eller den kan være en biblioteksskabelon, hvis detaljer er blevet synkroniseret fra den forbundne Adobe Acrobat Sign-konto.

Synkroniser biblioteksskabeloner

Når programmet er installeret og konfigureret, kan administratorer synkronisere biblioteksskabelonerne.  En Adobe Acrobat Sign-biblioteksskabelon er defineret i Acrobat Sign-kontoen, og dens detaljer synkroniseret i ServiceNow.  Det definerende dokument i en biblioteksskabelon gemmes også i den forbundne Acrobat Sign-konto, og derfor kræves der ikke upload ved indsendelse.

Sådan synkroniserer du biblioteksskabeloner med ServiceNow:

  1. Gå til Adobe Acrobat Sign > Administration > Dokumentskabeloner.
  2. Vælg Opdater bibliotek.

Dette opdaterer listevisningen med biblioteksskabeloner fra den forbundne Acrobat Sign-konto.

refresh-library

Opret lokale skabeloner

Det definerende dokument i en lokal skabelon holdes som en vedhæftningspost i ServiceNow og vil skulle uploades til Acrobat Sign som del af indsendelsesprocessen.

En skabelons dokument kan indeholde formularfelter, der skal forudfyldes med data fra en aftales emnepost. Du skal bruge en skabelon, hvis et dokument indeholder sådanne formularfelter.

  1. Gå til Acrobat Sign > Administration > Dokumentskabeloner.
  2. Vælg Ny.
  3. På skabelonen Ny post side:
    1. Giv skabelonen et Navn.
    2. Indstil Type til Lokal.
    3. Højreklik, og vælg derefter Gem.
  4. Hvis du vil knytte et dokument til skabelonen, skal du vælge og trække filen til skabelonposten eller vælge papirklipsikonet i sidehovedet og vælge filen. Når filen er tilføjet, skal du vælge X-ikonet for at lukke dialogboksen.

Dokumentet vedhæftes til dokumentskabelonen og refereres i feltet "Dokument".

create-template-without-field-1

create-template-without-field-2

create-template-without-field-3

Du skal følge de samme trin som angivet for Oprettelse af skabeloner uden felter. Når dokumentet er tilknyttet, skal du dog udføre følgende yderligere konfigurationstrin efter behov: 

  • Kontrollér, at feltet "Udfyldelig" er indstillet til sand.

Den kontrolleres automatisk, når et dokument, der indeholder udfyldelige felter, er knyttet til skabelonen.

  • Opret dokumentfeltposter.

Dokumentfeltposter oprettes for en overordnet dokumentskabeloner og definerer detaljerne for de formularfelter, som integreres i skabelonens dokument.

For at gøre det skal du vælgeGem dokumentskabelonposten og derefter vælge Opdater felter.

Den relaterede liste "Dokumentfelter" udfyldes med poster, der svarer til de udfyldelige formularfelter på det vedhæftede dokument.

create-template-with-fields

  • Konfigurer fletningsregler

En fletningsregel associerer en dokumentskabelon med en bestemt type emnepost i ServiceNow.

En enkelt dokumentskabelon kan have flere fletningsregler knyttet til sig (én for hver type emnepost, der blev brugt til at forudfylde skabelonens felter).

En skabelon kan eksempelvis udfyldes med data fra en Hændelse, en Tjenesteanmodning eller en Ændringsanmodning (i hvilket tilfælde skabelonen vil have tre fletningsregler – én for hver emnetabel).

Sådan konfigurerer du fletningsreglen:

  1. Gå til den relaterede liste for fletningsregler.
  2. Vælg Ny.
  3. Vælg en Tabel, for eksempel Hændelse.
  4. Højreklik, og tryk på Gem.
fletteregel

  • Konfigurer flettefelter

En Fletningsfelt-post linker et felt fra emneposten til et felt, der befinder sig i den relevante dokumentskabelon.  Fletningsfelter skal oprettes manuelt ved konfiguration af fletningsreglen.

Sådan opretter du Fletningsfeltposter:

  1. Gå til Adobe Acrobat Sign > Administration > Fletningsregler.
  2. Vælg Opdater felter på posten Fletningsregel.
    Den udfylder den integrerede liste "Fletningsfelter" med dokumentfelterne.  
  3. Hvis du vil knytte de relevante dokumentfelter til deres tilsvarende postfelter, skal du vælge linket til det tilsvarende Postfelt af Dokumentfelt, du vil tilknytte (f.eks. navn).
  4. Vælg det relevante Postfelt (f.eks. Opkalder) i rullemenuen. 
  5. Vælg Opdater.

Du omdirigeres tilbage til posten Fletningsregel.Den relaterede liste Fletningsfelter indeholder nu værdien af det Postfelt, der blev valgt i det forrige trin.

Af hensyn til ryddelighed skal du slette (og bekræfte) de resterende Fletningsfelter, der ikke skal tilknyttes, så den integrerede liste over Fletningsfelter kun indeholder de værdier, som tilknyttes.

merge-fields-1

Opret et servicekatalogelement

Acrobat Sign til ServiceNow giver dig mulighed for at oprette nye aftaler, som brugere kan få adgang til gennem tjenestekataloget ved at oprette en postfremstiller. Du kan konfigurere Postfremstiller til at indsamle alle data, du vil flette ind i dokumentet, og automatisk oprette og sende aftalen til brugeren.

Brugere med catalog_admin eller administrator kan oprette et katalogelement. Trinene nedenfor forklarer, hvordan du opretter et katalogelement, der kaldes Postfremstiller. Du kan replikere trinene til oprettelse af andre katalogelementer.

Bemærk: Sørg for, at Adobe Acrobat Sign-programmet ikke er valgt, når du konfigurerer din forekomst.

Processen med at oprette hver postfremstiller kan variere baseret på de specifikke krav til dokumentfelterne, skabelonen, variablen med mere. De samme principper gælder dog.  Eksemplet i denne vejledning demonstrerer oprettelse af en parkeringstilladelsesaftale. 

Sådan opretter du en postfremstiller:

  1. Gå til Tjenestekatalog > Katalogdefinition > Postfremstillere , og vælg derefter Ny.

  2. På den nye Postfremstillerside, der åbnes:

    1. Giv posten et navn.
    2. Indstil Tabelnavn til Aftale [x_adosy_as_agreement].
    3. Angiv en kort beskrivelse.
    4. Indstil feltet "Omdiriger til" til Genereret opgavepost.
    Generer en opgavepost

  3. Vælg fanenTilgængelighed , og angiv felterne Kataloger, Kategoriog Tilgængelighed efter behov. Højreklik derefter på sidehovedlinjen, og vælg Gem.

    Du kan indstille disse felter ved hjælp af de relaterede lister "Kategorier" og "Kataloger".

    Fanen Tilgængelighed

  4. På den relaterede liste Variabler skal du tilføje variabler som ønsket for at matche dokumentfelterne.

    I dette eksempel tilføjer vi felterne navn, medarbejder og leder.

    Fanen Variabler

    Bemærk:

    Standardværdien for spørgsmålsvariablen "Tilladelsesnavn" er: ‘javascript:'Parking Permit for ' + gs.getUserDisplayName()’

  5. Konfigurer Postfremstiller-scriptet, der tager variablerne og opretter den aftale, der skal sendes til underskrivelse. I feltet "Script":

    1. Kopíer og indsæt følgende script, der læser katalogelementvariablerne.
    2. Opdater variabeldefinitionerne for at indsamle oplysninger fra fremstilleren.
    3. Opdater den dokumentskabelon sys_id, du bruger.
    4. Opdater post_sign_uri, hvis du ønsker, at brugeren skal gå et andet sted hen efter underskrivelse.

    // Eksempel på en skabelon til parkeringstilladelse i Adobe Acrobat Sign-postfremstiller

    (function() {

      // Indsaml de oplysninger, vi har brug for, fra de variabler, som brugeren har udfyldt

      var employee_id = producer.employee + '';

      var employee_name = producer.employee.getDisplayValue() + '';

      var manager_id = producer.manager + '';

      var manager_name = producer.manager.getDisplayValue() + '';

      var agreement_name = "Parkeringstilladelse til " + employee_name;

      // Hardcoded sys_id for den anvendte dokumentskabelon

      var document_template = '5a2e0131db4c7c10c39151fcd39619af'; // Parkeringstilladelse

      // Konfigurer de data, der skal flettes med dokumentskabelonen ovenfor.

      // Hver egenskab er navnet på et Dokumentfelt, som vi vil knytte til.

      var merge_data = {

        navn : agreement_name,

        medarbejdernavn : employee_name,

        managernavn: manager_name,

      };

      // Konfigurer den nye aftale

      var agreement = new x_adosy_as.Agreement(current);

      // Tilføj de dokumenter, vi ønsker underskrevet

      agreement.addDocument(document_template, merge_data);

      // Tilføj underskriverne

      agreement.addSigner(employee_id);

      agreement.addSigner(manager_id);

    // Indstil aftalenavnet

      current.name = agreement_name;

      // Indstil den URL-adresse, som underskrivere omdirigeres til efter underskrivelse

      current.post_sign_uri = '/x_adosy_as_agreement.do?sys_id=' + current.sys_id;

      // Indstil tilstanden til "Klar" for straks at sende til underskrivelse

      current.state = 'Ready';

    })();

Opret en aftale fra en arbejdsforløbaktivitet

Hvis du vil føje dokumenter til underskrivelse til eksisterende katalogelementer, kan du føje en opgave til dit arbejdsforløb, der genererer aftalen, og en katalogopgave, der tildeler den til en bruger til dennes underskrivelse.

Det følgende eksempel viser, hvordan du kan bruge Acrobat Sign-programmet, men de specifikke detaljer for konfigurationstrinene kan variere afhængigt af kravene i din proces.

For at oprette en aftale fra en arbejdsforløbaktivitet skal du konfigurere følgende komponenter: 

  • Katalogopgave: Den opretter aftalen, sender den til underskrivelse og tildeler en opgave til underskriveren.
  • Script-handling: Den reagerer på den hændelse, der udløses, når aftalen underskrives, og lukker derefter opgaven, hvilket giver feedback-løkken og lader arbejdsforløbet fortsætte. 

Sådan oprettes en katalogopgave:

  1. I Editor til arbejdsforløb, skal du vælge fanen Kerne.
  2. Gå til Kerneaktiviteter > Opgaver, og træk derefter aktiviteten Katalogopgave til det rette sted i dit arbejdsforløb.
  3. Giv opgaven et Navn, og angiv dens prioritet.
  4. Indstil Vent på fuldførelse til sand.
  5. I sektionen Script skal du indstille flaget Avanceret til sand, og i feltet Avanceret script skal du derefter skrive din kode. En eksempelkode er angivet nedenfor.
  6. Vælg Opdater.
Opret aftale fra en arbejdsforløbaktivitet.

// Oprettelse af arbejdsforløbaktivitet for eksempelopgave

(function () {

  // Den bruger, der skal underskrive aftalen

  var signer_id = current.request.requested_for + '';

  var signer_name = current.request.requested_for.getDisplayValue() + '';

  // Aftalens navn

  var agreement_name = current.short_description + ' for ' + signer_name;

  // Hardcoded sys_id for Adobe Sign-dokumentskabelonen for denne handling

  // Dette bør virkelig være en arbejdsforløbvariabel til at styre den.

  var document_template = '2a9b1f57db508810257e73278c9619dc'; // Min skabelon

  // indstil GUID uden at kalde newRecord() - kræves til aftaleemnet

  task.setNewGuid(gs.generateGUID(task.getTableName()));

  // Indstil opgaven

  task.short_description = current.short_description;

  task.assigned_to = signer_id;

  task.description = 'Aftale: ' + '\'' + agreement_name + '\'' +

    ' er blevet sendt til underskrivelse af dig.\n' +

    'Underskriv, enten:\n' +

    '- Gå til: \'Selvbetjening > Adobe Sign > Til underskrivelse\', eller\n' +

    '- Klik på linket til aftalen i \'Adobe Acrobat Sign\' '+

    "Relateret liste (nedenfor).";

  // Aftaleindstillinger (felter på aftaleposten)

  var options = {

    submit_as_draft: true // gennemgå aftalen i Adobe før afsendelse

  };

// Opret et objekt for at assistere med underskrivelsesprocessen

  var adobe = new x_adosy_as.AdobeSign();

  // Opret aftalen, og angiv opgaveposten som emnet

  adobe.createAgreement(aftalenavn, opgave, indstillinger);

  // Tilføj dokumentskabelonen.

  adobe.addDocument(document_template);

  // Tilføj underskriverne. Dette kan være bruger sys_ids eller mailadresser.

  adobe.addSigner(signer_id);

  // Send aftalen til Adobe.

  adobe.submitAgreement();

})();

Du kan nu konfigurere en scripthandling til automatisk at indstille katalogopgaven til tilstanden Lukket fuldført, når aftalen er fuldført. Du skal konfigurere din scripthandling til at blive udløst af hændelsen x_adosy_as.agreement.complete på tabellen Aftale.

Sådan opretter du en ny scripthandling:

  1. Gå til Systempolitik > Hændelser > Scripthandlinger, og klik på Ny.
  2. På siden Ny scripthandling:
    1. Giv scripthandlingen et navn.
    2. Indstil Hændelsesnavn til x_adosy_as.agreement.complete.
    3. Markér afkrydsningsfeltet Aktiv
    4. I feltet Script skal du kopiere og indsætte scriptet fra Scripthandling: eksempelkode nedenunder.
  3. Højreklik på overskriftslinjen, og vælg Gem.
worflow-actitivty-script-action

Scripthandling: eksempelkode

// Scripthandling til at indstille katalogopgavetilstanden til Luk fuldført

(function () {

  var catalog_task = current.subject_id.getRefRecord();

  if (!catalog_task.isValidRecord() || catalog_task.getTableName()!= 'sc_task') {

    tilbagesendelse;

  }

  catalog_task.state = 3; // Lukket udført

  catalog_task.update();

})();

Brug Acrobat Sign med kontraktadministration

Du kan bruge Acrobat Sign med andre poster end de opgavebaserede poster som beskrevet ovenfor i Brugerdefinerede komponenter. Instruktionerne nedenfor viser, hvordan du bruger Acrobat Sign til kontraktadministration. De specifikke detaljer om konfigurationstrinene kan variere iht. dine proceskrav.

For at bruge Acrobat Sign til kontraktadministration skal du konfigurere følgende to komponenter:

  • Grænsefladehandlingen:Den opretter aftalen og sender den til underskrivelse.  Når aftalen er blevet underskrevet, udløses der en hændelse. 
  • Scripthandlingen: Den svarer på en hændelse og giver en feedbackløkke, så processen rykkes, og kontrakten opdateres. 

Bemærkning: Kun brugere med rollen ‘ui_action_admin’ eller ‘admin’ kan definere grænsefladehandlinger. Brugere med Rollen "admin" kan kun definere en scripthandling.

Opret brugergrænsefladehandling

Sådan opretter du en brugergrænsefladehandling på kontraktformularen [ast_contract]:

  1. Gå til Systemdefinition > Brugergrænsefladehandlinger, og vælg derefter Ny.

    Alternativt kan du højreklikke på formularen Kontrakt [ast_contract] og derefter vælge Konfigurer > Brugergrænsefladehandlinger > Ny.

  2. På siden Brugergrænsefladehandlingens nye post skal du angive følgende oplysninger:

    1. Sørg for, at tabellen er "Kontrakt [ast_contract]". 
    2. Angiv et navn til posten i feltet Navn.
    3. Vælg en tabel i rullemenuen Tabel.
    4. Angiv en Rækkefølge.
    5. Markér afkrydsningsfeltet Aktiv.
    6. Vælg afkrydsningsfeltet Vis indsæt.
    7. Vælg afkrydsningsfeltet Vis opdatering.
    8. Vælg afkrydsningsfeltet Knappen Formular.
    9. Når det er gjort, skal du højreklikke på den øverste linje og derefter vælge Gem

    Den gemmer formularen og genindlæser den.

    ui-action-new-record

  3. I feltet Betingelse skal du indtaste din betingelse for at vise brugergrænsefladehandlingen. 

    I det aktuelle eksempel vælges betingelsen som: "current.state == 'draft' andand current.substate == 'under_review' andand !current.approver.nil()".  

    Betingelse

  4. I feltet Script skal du indtaste en kode (se eksempelkoden nedenfor) for at oprette en aftalepost, indstille bestemte feltværdier og sende den til Adobe Acrobat Sign. 

    Den kode, du angiver, kan variere baseret på vores specifikke krav, men det generelle princip gælder.

    Bemærk:

    Den hardcodede sys_id for dokumentskabelonen henviser til den skabelon, vi bruger i vores eksempel. 

    Din vil være den skabelon, som du opretter ( se Opret lokale skabeloner for at få detaljer om, hvordan du opretter en skabelon).

    // Eksempel på grænsefladehandling til oprettelse af en ny Adobe Acrobat Sign-aftale

    (function() {

      // Aftalens navn

      var agreement_name = 'Kontrakt: ' + current.short_description;

      // Hardcoded sys_id for dokumentskabelonen for denne handling

      var document_template = '6d0cdc26db708c50257e73278c9619c4'; // Kontrakt

    // Opret et objekt for at assistere med underskrivelsesprocessen

      var adobe = new x_adosy_as.AdobeSign();

      // Opret aftalen, og angiv den aktuelle post som emnet

      adobe.createAgreement(agreement_name, current);

      // Tilføj dokumentskabelonen. Dette kan også være et sys_id for en vedhæftet fil.

      adobe.addDocument(document_template);

      // Tilføj underskriverne. Dette kan være bruger sys_ids eller mailadresser.

      adobe.addSigner(current.approver);

      // Send aftalen til Adobe.

      adobe.submitAgreement();

      // Omdiriger brugeren tilbage til denne post.

      action.setRedirectURL(current);

    })();

Opret scripthandling

Vi kan udløse scripthandlinger gennem kun hændelser.Scripthandlingen er konfigureret til at blive udløst af én af hændelserne på den aftaletabel, der sendes med Adobe Acrobat Sign: x_adosy_as.agreement.complete

Sådan opretter du en ny scripthandling:

  1. Gå til Systempolitik >Hændelser > Scripthandlinger.

  2. Vælg Ny.

  3. På siden Scripthandlingens nye post:

    1. Giv scriptet et navn.
    2. Vælg det Hændelsesnavn, der udløser scripthandlingen.
    3. Markér afkrydsningsfeltet Aktiv.
    4. Skriv din kode. Se eksempelkoden nedenfor.
    Giv scripthandlingen et navn

    (function () { 
       
      var contract = current.subject_id.getRefRecord(); 
      
      if (!contract.isValidRecord() || contract.getTableName() != 'ast_contract') { 
        return; 
      } 
    
      contract.state = 'active'; 
      contract.update(); 
    })();

    I denne kode henter vi kontrakten fra feltet subject_id i den aktuelle aftale og kontrollerer, at det er en gyldig post på kontrakttabellen. I så fald ændrer vi tilstanden til aktiv og opdaterer.

  4. Vælg Indsend.

Brug script-API'er

Du kan nemt udvide Adobe Acrobat Sign-programmet til at fungere med alle dine processer ved hjælp af de interne API'er. API'en er tilgængelig via navneområdet x_adosy_as.

AdobeSign()

Opretter en AdobeSign-forekomst.

Eksempel:

// Opret en ny forekomst af AdobeSign

var adobe = new x_adosy_as.AdobeSign();

 #addCcUser(String user_id)

Føj en CC-post til den aktuelle aftale til deling med brugere, der ikke deltager. Brugere, der ikke er registreret som ServiceNow-brugere, kan tilføjes ved at angive en mailadresse.

Parametre:

Navn

Type

Status

Beskrivelse

user_id

Streng

Obligatorisk

En brugers sys_id eller en e-mailadresse.

Returnering:

Type

Beskrivelse

ugyldig

Metoden returnerer ikke en værdi

Eksempel:

// Føj en CC-bruger til aftalen

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('Min aftale');

adobe.addCcUser(current.requested_by);

adobe.addCcUser('abel.tuter@example.com');

#addDocument(String doc_selector, Object merge_data)

Føj et dokument eller en skabelon til den aktuelle aftale.

Parametre:

Navn

Type

Status

Beskrivelse

doc_selector

Streng

Obligatorisk

Navnet på en skabelon eller sys_id'et på en skabelon eller vedhæftet fil.

merge_data

Objekt

Valgfri

Et objekt med nøgleværdi af dokumentfeltnavne til dokumentfeltværdier.

Returnering:

Type

Beskrivelse

Streng

Hvis det lykkes, skal sys_id'et for den oprettede kildedokumentpost angives.

Eksempel:

// Opret en aftale med en skabelon

var template_id = '2a9b1f57db508810257e73278c9619dc';

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('Min aftale');
adobe.addDocument(template_id);

#addElectronicSeal(String seal_id)

Føj et elektronisk segl til den aktuelle aftale.

Parametre:

Navn

Type

Status

Beskrivelse

seal_id

Streng

Obligatorisk

Sys_id'et, navnet eller segl-id'et for et elektronisk segl, der skal tilføjes.

Returnering:

Type

Beskrivelse

String|Boolean

Sys_id for den nye deltagerpost eller falsk, hvis seglet ikke blev fundet.

Eksempel:

// Føj et elektronisk segl til aftalen

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('Min aftale');

adobe.addElectronicSeal('<SEAL>');

 #addParticipant(String user_id, String participant_role)

En alternativ metode til addSigner() tillader, at deltagere kan føjes til en aftale med en angivet rolle. Deltagere, der ikke er registreret som ServiceNow-brugere, kan tilføjes ved at angive en mailadresse.

Bemærk: Denne metode bør kun bruges sammen med eksisterende aftaleposter, der er gemt i databasen.

Parametre:

Navn

Type

Status

Beskrivelse

user_id

Streng

Obligatorisk

En brugers sys_id eller en e-mailadresse.

rolle

Streng

Valgfri

Deltagerens rolle i aftalen. Standard er UNDERSKRIVER. Andre værdier omfatter APPROVER, ACCEPTOR, CERTIFIED_RECIPIENT, FORM_FILLER.

Returnering:

Type

Beskrivelse

String|Boolean

Sys_id for den nye deltagerpost eller falsk, hvis brugerposten ikke blev fundet eller ikke havde en mailadresse.

Eksempel:

// Føj en deltager til aftalen

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('Min aftale');

adobe.addParticipant('abel.tuter@example.com', 'APPROVER');

#addSigner(String user_id)

Føj en underskriver til den aktuelle aftale. Underskrivere, der ikke er registreret som ServiceNow-brugere, kan tilføjes ved at angive en mailadresse.

Parametre:

Navn

Type

Status

Beskrivelse

user_id

Streng

Obligatorisk

En brugers sys_id eller en e-mailadresse.

Returnering:

Type

Beskrivelse

ugyldig

Metoden returnerer ikke en værdi.

Eksempel:

// Føj en deltager til aftalen

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('Min aftale');

adobe.addSigner('abel.tuter@example.com');

#copySignedDocumentToRecord(GlideRecord record)

Kopiér det underskrevne dokument fra en aftale til en anden post.

Parametre:

Navn

Type

Status

Beskrivelse

post

GlideRecord

Obligatorisk

Den målpost, som det underskrevne dokument skal kopieres til.

Returnering: 

Type

Beskrivelse

String|Boolean

sys_id for den nye vedhæftede fil eller falsk, hvis handlingen mislykkedes.

Eksempel:

// Hent målposten

var target = new GlideRecord('...');

// Kopiér det underskrevne dokument fra aftalen til destinationen
var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);

adobe.copySignedDocumentToRecord(target);

#copySignedDocumentToSubject()

Kopiér det underskrevne dokument fra en aftale til emneposten.

Returnering:

Type

Beskrivelse

String|Boolean

sys_id for den nye vedhæftede fil eller falsk, hvis handlingen mislykkedes.

Eksempel:

// Kopiér det underskrevne dokument fra aftalen til emneposten
var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);

adobe.copySignedDocumentToSubject();

#createAgreement(strengnavn, GlideRecord-emne, objektindstilling)

Opretter en aftale. Den kan bruges af scripts, der har brug for at oprette en ny aftale.

Parametre:

Navn

Type

Status

Beskrivelse

navn

Streng

Obligatorisk

Aftalenavnet.

emne

GlideRecord

Valgfri

Emneposten, f.eks. en kontrakt eller en anmodning

indstillinger

Objekt

Valgfri

Et nøgleværdiobjekt af aftalepostens feltnavne til værdier.

Returnering:

Type

Beskrivelse

String|null

sys_id'et for den nye aftale eller nul.

Eksempel:

// Opret en ny kladdeaftale

var options = {

  submit_as_draft: true

};

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement("Min aftale", aktuel, indstillinger);

#getAgreement()

Hent den aftaleforekomst, der i øjeblikket er i omfanget.

Returnering:

Type

Beskrivelse

Agreement|null

Aftaleforekomsten eller nul.

Eksempel:

// Hent aftaleforekomsten

var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement("Min aftale", aktuel, indstillinger);
var agreement = adobe.getAgreement();

#getAgreementRecord()

Returner den aktuelle aftalepost.

Returnering:

Type

Beskrivelse

GlideRecord|null

Den aktuelle aftalepost eller nul.

Eksempel:

// Hent aftaleposten

var adobe = new x_adosy_as.AdobeSign();
adobe.createAgreement("Min aftale", aktuel, indstillinger);
var agreement = adobe.getAgreementRecord();

#saveAgreement(String state)

Gem den aktuelle aftalepost. Aftaletilstanden kan valgfrit overføres. Dette udløser ikke en indsendelse til Adobe Acrobat Sign, medmindre tilstandsparameteren er indstillet til "Klar".

Parametre:

Navn

Type

Status

Beskrivelse

tilstand

Streng

Valgfri

Aftalens tilstand.

Returnering:

Type

Beskrivelse

Streng

Sys_id for den gemte aftalepost eller nul.

Eksempel:

// Opret en aftale

var adobe = new x_adosy_as.AdobeSign();

adobe.createAgreement('Min aftale');

adobe.addSigner('abel.tuter@example.com');

adobe.saveAgreement();

#setAgreementRecord(String|GlideRecord agreement)

Indstiller aftalekonteksten til den givne post.

Parametre:

Navn

Type

Status

Beskrivelse

aftalen

GlideRecord|String

Obligatorisk

Posten Aftale.

Returnering: 

Type

Beskrivelse

ugyldig

Metoden returnerer ikke en værdi.

Eksempel:

// Arbejd på en aftale

var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);

#setSubject(GlideRecord subject

Indstil aftalens emnepost.

Parametre:

Navn

Type

Status

Beskrivelse

emne

GlideRecord

Obligatorisk

Posten emne.

Returnering:

Type

Beskrivelse

ugyldig

Metoden returnerer ikke en værdi.

Eksempel:

// Hent en emnepost
var subject = new GlideRecord('...')

// Opdater aftalens emne

var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);
adobe.setSubject(subject);
adobe.saveAgreement();

#submitAgreement()

Gem den aktuelle aftale, og send den til Adobe Acrobat Sign ved at indstille tilstanden til "Klar".

Returnering:

Type

Beskrivelse

Streng

Sys_id for den gemte aftalepost eller nul.

Eksempel:

// Send en aftale

var adobe = new x_adosy_as.AdobeSign();

adobe.setAgreementRecord(agreement);
adobe.submitAgreement();

.canSend()

Bestemmer, om den aktuelle bruger kan bruge grænsefladehandlingen "Underskriv med Adobe Acrobat". Afsendelse er tilladt, når forekomsten ikke er FedRAMP, eller hvis den aktuelle bruger har rollen Afsender.

Returnering:

Type

Beskrivelse

Boolesk

Sand, hvis brugeren kan sende.

Eksempel:

// Kontrollér, om den aktuelle bruger kan sende til underskrivelse

if(AdobeSign.canSend()) {

  gs.addInfoMessage('Denne bruger kan bruge underskrivelsesprocessen.');

} eller {

  gs.addErrorMessage('Denne bruger har ikke tilladelse til at bruge underskrivelsesprocessen.');

}

.getAgreements(String subject_table, String subject_id)

Få en GlideRecord-forekomst af aftaler, der er relateret til emnet.

Parametre:

Navn

Type

Status

Beskrivelse

subject_table

String|GlideRecord

Obligatorisk

Emnetabelens navn eller selve emneposten.

subject_id

Streng

Valgfri

Emnets sys_id, når tabelnavnet også overføres.

Returnering:

Type

Beskrivelse

GlideRecord

En GlideRecord-forekomst af aftaler vedrørende emnet.

Eksempel:

// Hent aftaler ved hjælp af tabelnavnet og sys_id

var agreement = x_adosy_as.AdobeSign.getAgreements('sc_req_item', '<sys_id>");

while (agreement.next()) {

  gs.addInfoMessage(agreement.getDisplayValue());

}

// Hent aftaler ved hjælp af en GlideRecord

var req_item = new GlideRecord('sc_req_item');

req_item.get('<sys_id>");

var agreement = x_adosy_as.AdobeSign.getAgreements(req_item);

while (agreement.next()) {

  gs.addInfoMessage(agreement.getDisplayValue());

}

.getMyAgreements(String query)

Få en GlideRecord-forekomst af aftaler, der tilhører brugeren. Denne metode er afhængig af egenskaben x_adosy_as.my_agreements_query for den første forespørgsel. Yderligere forespørgselsfiltre kan tilføjes med forespørgselsparameteren.

Parametre:

Navn

Type

Status

Beskrivelse

forespørgsel

Streng

Valgfri

Valgfri kodet forespørgsel for at begrænse aftalelisten yderligere.

         

Returnering:

Type

Beskrivelse

GlideRecord

Aftaler, der tilhører brugeren.

Eksempel:

// Hent aftaler, der er fuldført for den aktuelle bruger
var query = 'state=Complete^ORDERBYsys_created_on';

var agreement = x_adosy_as.AdobeSign.getMyAgreements(query);

while (agreement.next()) {

  gs.addInfoMessage(agreement.getDisplayValue());

}

.isFedRamp()

Find ud af, om systemet er tilsluttet Adobe FedRAMP (Government Cloud).

Returnering:

Type

Beskrivelse

Boolesk

Sand, hvis egenskaben x_adosy_as.fedramp er angivet til "sand".

Eksempel:

// Kontrollér, om vi bruger en FedRAMP-forbindelse

if(x_adosy_as.AdobeSign.isFedRamp()) {

  gs.addInfoMessage('Acrobat Sign bruger en offentlig cloudforbindelse.');

} eller {

  gs.addErrorMessage('Acrobat Sign bruger ikke en offentlig cloudforbindelse.');

}

 Adobe

Få hjælp hurtigere og nemmere

Ny bruger?

Adobe MAX 2024

Adobe MAX
kreativitetskonferencen

14-16. oktober i Miami Beach og online

Adobe MAX

Kreativitetskonferencen

14-16. oktober i Miami Beach og online

Adobe MAX 2024

Adobe MAX
kreativitetskonferencen

14-16. oktober i Miami Beach og online

Adobe MAX

Kreativitetskonferencen

14-16. oktober i Miami Beach og online