Adobe Sign for SharePoint Online – Työnkulun asennusopas

Adobe Sign Workflow Actions for SharePoint Online antaa SharePoint-työnkulun järjestelmänvalvojille mahdollisuuden lisätä Adobe Sign -toimintoja SharePoint-työnkulkuihin SharePoint-työnkulkujen suunnittelusovelluksella. Ratkaisu on saatavilla Microsoft SharePoint Online -esiintymiin laajennuksena. Sen avulla käyttäjät voivat luoda mukautettuun luetteloon tai dokumenttikirjastoon luettelotyönkulun, jolla SharePoint-käyttäjät voivat

• lähettää dokumentteja yksittäiselle vastaanottajalle tai vastaanottajaerälle käyttämällä SharePoint-luetteloita ja määrittämällä tietojen vastaavuus SharePoint-luetteloista asiakirjoihin, kun asiakirjat lähetetään allekirjoitettavaksi
• tarkistaa sopimuksen tilan
• peruuttaa sopimuksen sen jälkeen, kun se on lähetetty allekirjoitettavaksi
• ladata allekirjoitetun sopimuksen luetteloliitteenä (mukautettujen luetteloiden tapauksessa) tai erinimisenä dokumenttina (dokumenttikirjastojen tapauksessa).

Vaatimukset

Adobe Sign -ratkaisun voi asentaa ja määrittää vain Microsoft SharePoint -järjestelmänvalvoja. Järjestelmänvalvojan käyttöoikeudet tarvitaan myös SharePoint-palvelimella ratkaisun asentamista varten. Tarkista SharePoint-ohjelmalisäkkeiden asentamiseen mahdollisesti vaadittavat järjestelmän lisäkäyttöoikeudet SharePoint-dokumentaatiosta ja organisaatiosi SharePoint-järjestelmänvalvojalta. Ratkaisun määrittämiseksi sinun on oltava myös tilin järjestelmänvalvoja Adobe Signissa ja sinulla on oltava pääsy Adobe Sign-tilisi API-avaimeen. Alla olevat järjestelmävaatimukset koskevat sekä palvelinta että asiakkaan komponentteja, jotka vaaditaan Adobe Sign for SharePointin onnistunutta asentamista ja suorittamista varten.

• Microsoft SharePoint, ylläpidetty
• Internet Explorer 11+

Asenna Adobe Sign WSP -sivustokokoelma.

Lataa ja aktivoi .wsp-paketti.

1. Hanki viimeisin .wsp-paketti menestyspäälliköltäsi (vain aiemmat asennukset)

• Huom. Työnkulku on poistettu, eikä sitä ole saatavana uusiin asennuksiin. Katso lisätietoja Microsoft Flow -ohjeista

2. Valitse Sivustokokoelma > Sivustoasetukset > Web Designer -galleriat > Ratkaisut.

Huomautus: _catalogs/solutions/Forms/AllItems.aspx

3. Lataa .wsp-tiedosto.

4. Sivusto-ominaisuuden aktivointi manuaalisesti:

• Valitse Sivustoasetukset > Sivustotoiminnot > Sivusto-ominaisuuksien hallinta.
• Napsauta Aktivoi-painiketta Adobe eSignin työnkulkutoiminnot -kohdan vieressä.
• Napsauta Aktivoi-painiketta Adobe eSignin työnkulkutoimintojen määritysluettelo -kohdan vieressä.

eSign-määritysluettelon täyttäminen

eSign-määritysluettelon täyttäminen edellyttää, että luot ja täytät useamman yksilöllisen kentän. 

Suosittelemme, että avaat Notepadin tai muun tekstieditorin, jotta voit tallentaa luodut avaimet. Syötä ne sen jälkeen kaikki yhdellä kerralla.

Suorita seuraavat toimenpiteet:

• Luo eSignIntegrationKey (suoritettu Adobe Sign -sovelluksessa).
• Hanki spTenantID SharePointissa.
• Luo spClientID ja spClientSecret -avaimet SharePointissa.
• Myönnä uuden palvelun periaatteen käyttöoikeudet SharePointiin.
• Lisää eSignConnectorURL.

Vaihe 1: Luo eSignIntegrationKey.

Voit luoda integrointiavaimen Adobe Signissa seuraavasti:

1. Kirjaudu Adobe Sign -tiliisi järjestelmänvalvojana.

2. Valitse Tili > Adobe Sign API > API-tiedot.

3. Napsauta Integrointiavain -linkkiä sivun keskellä.

Näyttöön tulee Luo integrointiavain -ruutu:

1. Anna avaimelle helposti ymmärrettävä nimi (esim. SharePoint).

2. Integrointiavaimen seuraavat elementit pitää olla käytössä:

• agreement_read
• agreement_write
• agreement_send
• library_read

3. Kun avain on määritetty, valitse Tallenna.

Näkyviin tulee Käyttöoikeustunnukset-sivu, jossa ovat tiliisi määritetyt avaimet.

4. Napsauta SharePointille luodun avaimen määritystä.

• Integrointiavain-linkki näkyy määrityksen yläpuolella.

5. Napsauta Integrointiavain-linkkiä.

Integrointiavain tulee näkyviin:

6. Kopioi tämä avain ja tallenna se eSign-määritysluetteloon lisäämistä varten.

7. Valitse OK.

• Olet suorittanut kaikki toimenpiteet Adobe Sign -sovelluksessa ja voit kirjautua ulos.

Vaihe 2: Hanki spTenantID.

Voit hankkia spTenantID-arvon seuraavasti:

1.        Valitse Sivuston asetukset > Käyttäjät ja käyttöoikeudet > Sivustosovelluksen käyttöoikeudet.

2.       Kopioi sovellustunnisteen alla osa after @.

• ie: i:0i.t|ms.sp.ext|d559ac84-d8e6-4515-9229-89w01@870fe83b-ye9d-96d3-n1d0-9et51ar2e792e

3. Tallenna arvo eSign-määritysluetteloon lisäämistä varten.

Vaihe 3: Luo avaimet spClientID ja spClientSecret.

Luo avaimet spClientID ja spClientSecret seuraavasti:

1. Liitä SharePoint-sivuston URL-osoitteeseen kohdan sharepoint.com/sites/{yoursite} jälkeen seuraava merkkijono: _layouts/15/appregnew.aspx

• Avautuvalla uudella sivulla voit luoda molemmat avaimet.

2. Napsauta Luo-painikkeita sekä kohdassa Asiakastunnus että kohdassa Asiakassalaisuus.

3. Kopioi molemmat avaimet ja tallenna se eSign-määritysluetteloon lisäämistä varten.

4. Lisää seuraavat sanatarkat arvot jäljellä oleviin kenttiin:

• Otsikko – Adobe Sign
• Sovelluksen toimialue – spintegration.echosign.com/sharepoint
• Uud. ohj. URL – https://spintegration.echosign.com/sharepoint

5. Valitse Luo.

• Tämän vuoksi uusi palvelun periaate on Azure AD:ssä.
• Samaa periaatetta voidaan käyttää uudelleen sivustokokoelmissa.

Vaihe 4: Uuden palvelun periaatteen käyttöoikeuksien myöntäminen

Myönnä uuden palvelun periaatteen käyttöoikeudet sivustoon seuraavasti:

1. Liitä SharePoint-sivuston URL-osoitteeseen kohdan sharepoint.com/sites/{yoursite} jälkeen seuraava merkkijono: _layouts/15/appinv.aspx.

• Tämä toimenpide on tehtävä jokaiselle sivustolle, joilla työnkulkuja halutaan suorittaa.

Kentissä tulisi olla sovelluksen sisältö edellisestä vaiheesta:

• Sovellustunnus – Tämä on juuri luomasi asiakastunnus.
• Otsikko – Adobe Sign
• Sovelluksen toimialue – spintegration.echosign.com/sharepoint
• Uud. ohj. URL – https://spintegration.echosign.com/sharepoint

2. Kopioi ja liitä alla oleva koodi Käyttöoikeuspyyntö XML: -kenttään.

3. Valitse Luo.

4. Valitse Luota, kun sivu latautuu.

Voit nähdä tuloksena saatavat käyttöoikeudet valitsemalla Sivustoasetukset > Sivuston sovelluksen käyttöoikeudet.

Vaihe 5: Lisää eSignConnectorURL

eSignConnectorURL on sanatarkka arvo: https://spintegration.echosign.com/sharepoint

Määritä eSignConfig-luettelo.

1. Kohdassa Sivustosisällöt sivustolla, jossa Adobe eSignin työnkulun määritysluettelo -omaisuus on aktivoituna, etsi ja napsauta eSignConfig-luetteloa.

2. Avaa uusi määrityslomake luomalla uusi kohde.

3. Täytä seuraavat arvot:

• Otsikko – "Config"
• spClientID – Lisää asiakastunnusarvo vaiheesta 3.
• spClientSecret – Lisää Asiakassalaisuus-arvo vaiheesta 3.
• spTenantID – Lisää vuokraajatunnus vaiheesta 2.
• eSignIntegrationKey – Lisää Adobe Sign -integrointiavain vaiheesta 1.
• eSignConnectorURL – Syötä: https://spintegration.echosign.com/sharepoint
• debugStatements – Ei.

4. Valitse Tallenna.

eSignConfig-luettelon lukemista työnkulkutoiminnosta koskevia suojausnäkökohtia

Parhaana käytäntönä on, että vain sivustokokoelman järjestelmänvalvojilla on pääsy eSignConfig-luetteloon.

Jos työnkulun käynnistää käyttäjä, jolla on pääsy eSignConfig.luetteloon, työnkulku suoritetaan ilman ongelmia. Jos käyttäjällä ei kuitenkaan ole pääsyä luetteloon, työnkulkutoiminnot on koottava sovellusvaiheeksi.

1. Sivustolla, jolla työnkulku on julkaistu:

• Valitse Sivustoasetukset > Sivusto-ominaisuudet.
• Aktivoi Työnkulut voivat käyttää sovelluksen käyttöoikeuksia -ominaisuus.

2. Hanki työnkulun palveluperiaatteen tunnus.

• Valitse Sivustoasetukset > Sivustosovelluksen käyttöoikeudet.

Esimerkki: työnkulku i:0i.t|ms.sp.ext|d55e6c84-d8e6-4515-9229-896we4554601@870f107b-dc9d-47d3-9ad0-9d851rr2e762e

3. Anna työnkulun palveluperiaatteen käyttöoikeudet _layouts/15/appinv.aspx samalla tavalla, kuin me teimme todellisessa sovelluksessa.

4. Luota työnkulun palveluperiaatteeseen.

Sovellusvaiheen pitäisi olla nyt käytettävissä SharePoint Designerissa (uudelleenkäynnistys vaaditaan):

Ladattava PDF-kopio