Workiva kundestøttesenter

Med BlackLine® OAuth2-kontakten kan du bruke kommandoer i en kjede for å samhandle med BlackLine, for eksempel for å:

• Liste opp og laste ned rapporter fra BlackLine
• Importer og administrer data i BlackLine, inkludert:
  • Regnskap
  • Balanser
  • Valutakurser
  • Delreskontroer
  • Enheter
  • Oppgaver
  • Brukere

Merk: Denne kontakten er bygget av Workiva og kobles til et tredjepartssystem. Supportteamet vårt kan hjelpe deg med å konfigurere denne koblingen i arbeidsområdet ditt, men vi kan ikke feilsøke eller på annen måte hjelpe deg med problemer som oppstår utenfor Workiva-plattformen.

Forutsetninger

For å sette opp kontakten trenger du

• Vertsnavnet til BlackLine-instansen du skal koble til, for eksempel sbus2.api.blackline.com
• Brukernavnet og API-nøkkelen til en integrasjonsbruker som er konfigurert for en BlackLine-tjenestekonto

  Merk: Integrasjonsbrukeren trenger API-autorisasjonsroller og integrasjonstillatelser, i tillegg til rollene og omfanget som kreves for oppgavene som koblingen skal utføre. For å opprette API-nøkkelen i BlackLine klikker du på Generer for API-nøkkel under Brukerinformasjon på integrasjonsbrukerens detaljer.

• Kun Blackline API versjon 2.0 støttes
• Integrasjonsbrukerens klientlegitimasjon og OAuth-omfang, levert av BlackLine-integrasjonsteamet

  Merk: Hvis du trenger klient-ID, klienthemmelighet eller omfang, kan du kontakte BlackLine-representanten din.

Konfigurer BlackLine OAuth2-kontakten

Merk: For å gjøre kontakten tilgjengelig for bruk i organisasjonens kjeder, må en sikkerhetsadministrator i organisasjonen først aktivere den fra Configuration.

1. Fra Chain Builder klikker du på Connectionscompare_arrows, og deretter Create øverst til høyre.
2. Under Connector Connection velger du BlackLine OAuth2 og standard CloudRunner.
   
3. Angi et unikt navn og en beskrivelse for å identifisere tilkoblingen.
4. Under Properties angir du detaljer om tilkoblingen:
   
   

   Egenskap	Detaljer
   Brukernavn	Skriv inn brukernavnet til BlackLine-integrasjonsbrukeren.
   Passord	Skriv inn API-nøkkelen som er generert for BlackLine-integrasjonsbrukeren. Merk: For å opprette eller oppdatere API-nøkkelen i BlackLine klikker du på Generer for API-nøkkel under Brukerinformasjon på integrasjonsbrukerens detaljer. Dette er ikke passordet som brukes til å logge på BlackLine online.
   Klient-ID	Skriv inn klient-ID-en som du har fått fra BlackLine-integrasjonsteamet ditt.
   Klienthemmelighet	Skriv inn klienthemmeligheten som du har fått fra BlackLine-integrasjonsteamet.
   Omfang	Angi integrasjonsbrukerens OAuth-scope, som du får fra BlackLine-integrasjonsteamet ditt. Kontakten vil bruke de samme omfangene.
   Forekomstens vertsnavn	Skriv inn vertsnavnet for BlackLine-forekomsten du vil koble deg til, uten https://. For eksempel, for standard utviklingsmiljø, sbus2.api.blackline.com.

   Merk: Alle sensitive opplysninger krypteres automatisk og lagres med Advanced Encryption Standard (AES)-256-kryptering.

5. Velg miljøene som skal bruke tilkoblingen, og klikk på Lagre.
6. For å teste tilkoblingen, opprett og kjør en kjede med BlackLine OAuth2-kontaktens List Reports-kommando, og kontroller at den returnerer en gyldig utdata.

Feilsøking

Hvis tilkoblingen til BlackLine mislykkes:

• Bekreft klientlegitimasjonen og OAuth-omfanget som BlackLine-integrasjonsteamet har gitt deg. Hvis du trenger OAuth-scopes eller klient-ID eller -hemmelighet, kan du kontakte BlackLine-representanten din.
• Sørg for at integrasjonsbrukerens brukernavn og API-nøkkel er korrekte.

  Merk: Integrasjonsbrukerens API-nøkkel kan utløpe. For å oppdatere API-nøkkelen i BlackLine klikker du på Generer for API-nøkkel under Brukerinformasjon på integrasjonsbrukerens detaljer.

• Kontroller at integrasjonsbrukeren har API-autorisasjon og de riktige rollene og omfangene for å utføre oppgavene knyttet til tilkoblingskommandoene.
• Kontroller at riktig BlackLine-instansvertsnavn er angitt for kontakten.