Valkoposkihanhi: tuntomerkit, elintavat ja tunnistusopas Suomessa
Tunnista valkoposkihanhi valkoisista kasvoista ja mustasta kaulasta. Lue, missä se elää, mitä se syö ja miten erotat sen kanadanhanhesta.
Salesforce Workbench -virheet: API-työkalujen vianmääritys käyttökatkon aikana
Salesforce Workbench -virheet käyttökatkon aikana: aloita erottamalla työkalun vika alustan vikaantumisesta
Kun Salesforce Workbench lakkaa yhtäkkiä kirjautumasta sisään, REST Explorer palauttaa virheen tai minuutteja sitten toiminut kysely alkaa aikakatkaista, nopein tapa on olla napsauttamatta Yritä uudelleen -painiketta jatkuvasti. Selvitä ensin, mikä taso epäonnistuu: Workbench-verkkosovellus, selaimesi tai verkkosi, Salesforce-todennus, tietty Salesforce-instanssisi vai itse API-pyyntö.
Tällä erolla on merkitystä, koska Workbench on yhteisön ylläpitämä, verkkopohjainen API-apuohjelma eikä täysin tuettu Salesforce-tuote. Salesforce sanoo nimenomaisesti, ettei se ylläpidä Workbenchiä ja suosittelee tuettuja vaihtoehtoja, kuten Salesforce CLI:tä, Code Builderia ja Salesforce Extensions for Visual Studio Codea. Itse Workbench-projekti kuvailee työkalua myös vain ylläpitoa vaativaksi. Katso Salesforcen Workbenchin korvausohjeet ja alkuperäinen Workbenchin lähdekoodiarkisto .
Käytä tätä sivua käytännön apuvälineenä, kun epäilet käyttökatkosta tai palvelun heikentymistä. Tavoitteena on säilyttää todisteet, välttää tarpeettomia uudelleenyrityksiä ja päättää, kannattaako odottaa, vaihtaa työkaluja vai korjata jokin paikallinen vika.
Nopea triage-tarkistuslista
| Tarkista | Mitä etsiä | Mitä se kertoo sinulle |
|---|---|---|
| Salesforce-luottamus | Tapahtuma-, heikkenemis-, ylläpito- tai instanssikohtainen vaikutus | Ilmoittaako Salesforce alustapuolen ongelmasta |
| Työpöytä itse | Voiko kirjautumissivu latautua? Toimiiko OAuth-uudelleenohjaus oikein? | Onko yhteisön ylläpitämä työkalu tavoitettavissa |
| Salesforce-kirjautuminen | Voitko kirjautua organisaatioon normaalisti? | Vaikuttaako todennus laajasti |
| Minimaalinen API-kutsu | Kokeile kevyttä päätepistettä, kuten /services/data/tai/services/data/v66.0/limits | Toimiiko API-polku itsenäisesti monimutkaisesta kyselystä |
| Virhekoodi | 401, 403, 404, 5xx, aikakatkaisu, REQUEST_LIMIT_EXCEEDED,UNSUPPORTED_API_VERSION | Mitä vianmäärityshaaraa seurata |
| Toinen asiakas | Salesforce CLI, olemassa oleva integraatio tai jokin muu hyväksytty API-asiakasohjelma | Onko vika Workbench-kohtainen |
1. Tarkista Salesforcen luotettavuus ennen määritysten muuttamista
Siirry Salesforcen viralliselle luottamustilan sivustolle ja hae organisaatioosi liittyvää instanssia, toimialuetta, podia tai vuokraajaa. Salesforce-tapaukset voivat olla alueellisia tai instanssikohtaisia, joten vihreä tila toiselle instanssille ei todista, että organisaatiosi on terve.
Jos Trust raportoi palveluhäiriöstä, suorituskyvyn heikkenemisestä, kirjautumisongelmasta tai ympäristöösi vaikuttavasta huollosta, kirjaa tapahtumatunnus ja aika. Vältä sitten spekulatiivisten muutosten tekemistä yhdistettyihin sovelluksiin, tunnistetietoihin, profiileihin, käyttöoikeusjoukkoihin, verkkokäytäntöihin tai API-versioihin, ellei virhe viittaa nimenomaisesti näihin asetuksiin. Katkoksen aikana tehdyt määritysmuutokset voivat aiheuttaa toisen ongelman alustan palautumisen jälkeen.
2. Säilytä tarkka Workbench-virhe ja luokittele se
Workbench usein välittää Salesforce API -virhevastaukset läpi lähes tulkittuna. Tämä on hyödyllistä vianmäärityksessä: tarkka HTTP-tila, Salesforce-virhekoodi, päätepiste ja viesti kertovat yleensä enemmän kuin yleinen selainbanneri.
Yhteysvirhe, aikakatkaisu tai HTTP 5xx
Aikakatkaisu, 502, 503 tai muu 5xx-vastaus voi viitata palvelun heikkenemiseen, ylikuormitettuun infrastruktuuriin tai verkon vikaantumiseen. Älä oleta, että 5xx todistaa koko Salesforcen laajuisen käyttökatkoksen. Vertaa samaa kevyttä pyyntöä toiselta hyväksytyltä asiakkaalta ja tarkista luotettavuus. Jos useat asiakkaat epäonnistuvat samaa Salesforce-instanssia vastaan samanaikaisesti, todisteet viittaavat muualle kuin Workbench.
401-virheet tai virheellisen istunnon virheet
Nämä viittaavat yleensä todennus- tai istunto-ongelmiin. Suorita todennus uudelleen OAuthilla sen sijaan, että kopioisit vanhoja istuntotunnuksia selainten välillä. Jos normaali Salesforce-kirjautuminen epäonnistuu myös ja Trust raportoi kirjautumisen vaikutuksesta, odota palvelun palautumista ennen tunnistetietojen kierrättämistä. Jos Salesforce-kirjautuminen toimii, mutta Workbench OAuth ei, tutki Workbenchin yhdistetyn sovelluksen polkua tai käytä tuettua vaihtoehtoista asiakasohjelmaa.
403- ja valtuutusvirheet
403-virhe tarkoittaa yleensä, että pyyntö saavutti palvelun, joka hylkäsi sen. Tarkista käyttäjäoikeudet, yhdistetyn sovelluksen käytäntö, IP-rajoitukset ja tarkka Salesforce-virhekoodi. Yksi tunnettu Workbench-kohtainen esimerkki on OAUTH_APP_BLOCKED, joka voi ilmetä, kun järjestelmänvalvoja estää Workbench-yhdistetyn sovelluksen. Workbench-projektin yhdistettyjen sovellusten ohjeistus kuvaa tämän skenaarion.
3. Pienennä testi pienimpään turvalliseen API-pyyntöön
Epäillyn käyttökatkoksen aikana älä käytä massalatausta, metatietojen käyttöönottoa, pitkää SOQL-kyselyä tai monivaiheista skriptiä. Aloita vain luku -tilassa olevalla päätepisteellä, jonka suorittaminen on edullista. REST Explorerissa pyyntö, kuten , GET /services/data/tarkistaa API:n perussaavutettavuuden. Tällainen pyyntö GET /services/data/v66.0/limitsvoi auttaa sinua tarkastamaan organisaation rajoituksia, kun API toimii.
Salesforce dokumentoi Workbench REST Explorerin tapana kutsua REST-päätepisteitä, mutta Workbench ei ole ihanteellinen suurille tai suorituskykyintensiivisille toiminnoille. Alkuperäisessä Workbenchin dokumentaatiossa todetaan, että selaimen ja yhteyden aikakatkaisut tekevät siitä paremmin sopivan nopeisiin, reaaliaikaisiin API-vuorovaikutuksiin kuin suuriin datan lataus- tai vientimenetelmiin.
4. Käsittele API-rajoitusvirheitä eri tavalla kuin käyttökatkoksia
REQUEST_LIMIT_EXCEEDEDei ole sama asia kuin alustan käyttökatkos. Salesforce käyttää API-pyyntöjen allokointeja, ja kun organisaatio ylittää liukuvan käyttörajansa, lisä API-kutsuja voidaan estää, kunnes käyttö laskee kynnyksen alapuolelle. Salesforcen heinäkuun 2026 tukiartikkeli vahvistaa, että REST API-, SOAP API-, Bulk API- ja Bulk API 2.0 -kutsujen käyttö vaikuttaa kaikki API-kulutukseen. Katso Salesforcen ohjeet REQUEST_LIMIT_EXCEEDED-arvolle ja sen liukuvan API-rajoituksen selitykselle .
Jos virhe on rajaehto, toistuvat uudelleenyritykset pahentavat tilannetta kuluttamalla enemmän kutsuja, kun pyyntöjä vielä hyväksytään. Tunnista suuren volyymin integraatiot, keskeytä ei-välttämättömät työt, jos se on toiminnallisesti turvallista, ja valvo käyttöä Salesforce-asetuksissa. Älä odota luottamustapausta ratkaistaksesi vuokraajakohtaisen rajoitusongelman.
5. Tarkista API-versioiden yhteensopimattomuus
UNSUPPORTED_API_VERSIONansaitsee oman haaransa. Salesforce julkaisi toukokuussa 2026 tukiartikkelin, jossa selitettiin, että Workbench voi oletusarvoisesti käyttää uudempaa API-versiota ennen kuin tuotanto- tai Developer Edition -organisaatio tukee sitä. Suositeltu Workbench-korjaus on alentaa oletus-API-versio kohdeorganisaation tukemaan versioon. Katso Salesforcen UNSUPPORTED_API_VERSION-vianmääritysartikkeli .
Tällä on merkitystä julkaisuikkunoiden aikana, koska API-versioiden yhteensopimattomuus voi näyttää käyttökatkokselta, jos keskityt vain ajoitukseen. Tarkista itse versiovirhe ennen kuin odotat alustan palautumista.
6. Vertaa Workbenchiä tuettuun asiakasohjelmaan
Jos tehtävä on kiireellinen ja Workbench on ainoa viallinen komponentti, toista pienin pyyntö Salesforce CLI:n tai muun tuetun, hyväksytyn asiakasohjelman avulla. Tarkoitus on diagnoosi, ei aidon Salesforce-käyttökatkoksen ohittaminen. Jos molemmat asiakasohjelmat epäonnistuvat samassa organisaatiossa vertailukelpoisten palvelinpuolen virheiden vuoksi, työkalujen vaihtaminen ei todennäköisesti palauta palvelua. Jos CLI onnistuu, kun taas Workbench epäonnistuu, sinulla on vahvempia todisteita siitä, että Workbenchin hosting, selainistunto tai yhdistetyn sovelluksen polku on ongelma.
7. Käytä uudelleenyrityskuria uudelleenyritysmyrskyjen sijaan
Vahvistetun palveluhäiriön aikana aggressiiviset manuaaliset uudelleenyritykset harvoin auttavat. Automatisoitujen asiakkaiden kanssa käytä rajoitettuja uudelleenyrityksiä eksponentiaalisella peruutuksella ja jitterillä, jos integraatiosuunnittelusi sen sallii. Manuaalisessa Workbench-käytössä odota merkityksellistä tilapäivitystä tai kohtuullista aikaa ennen saman pyynnön toistamista.
Kirjoitustoimintojen kanssa on oltava erityisen varovainen. Aikakatkaisu ei aina todista, että Salesforce ei tehnyt mitään; asiakas on saattanut kadottaa vastauksen palvelimen käsiteltyä pyynnön. Ennen kuin lähetät luonti-, päivitys-, poisto- tai käyttöönottopyynnön uudelleen, tarkista, onko alkuperäinen toiminto suoritettu. Kaksoiskirjoitukset ovat usein vahingollisempia kuin viivästynyt uudelleenyritys.
Yleiset oireet ja seuraavat toimenpiteet
| Oire | Hyödyllisin seuraava tarkistus | Välttää |
|---|---|---|
| Työpöytäsivu ei lataudu | Tarkista Workbenchin saavutettavuus ja käytä toista hyväksyttyä asiakasohjelmaa | Salesforce-käyttöoikeuksien muuttaminen välittömästi |
| OAuth-uudelleenohjaukset epäonnistuvat | Tarkista Salesforcen kirjautumis-, luottamus- ja yhdistettyjen sovellusten käytäntö | Istuntotunnusten tai tunnistetietojen jakaminen |
| REST Explorer palauttaa arvon 5xx | Tarkista Luota ja toista minimaalinen vain luku -kutsu toiselta asiakkaalta | Suurempien testitöiden suorittaminen |
REQUEST_LIMIT_EXCEEDED | Tarkista organisaatiorajapinnan kulutus ja liukuvat rajoitukset | Nopeat uudelleenyritykset |
UNSUPPORTED_API_VERSION | Valitse kohdeorganisaation tukema API-versio | Odotetaan katkosta, jota ei ehkä ole olemassa |
| Vain yksi monimutkainen kysely aikakatkaistaan | Yksinkertaista kyselyä ja tarkista selektiivisyys/tilavuus | Olettaen koko alustan seisokkiaikaa |
Mitä todisteita sinun tulisi kerätä onnettomuuslipuketta varten?
- UTC-aikaleima ja paikallinen aikavyöhykkeesi.
- Salesforce-organisaation ja -instanssin tunnisteet, jotka on turvallista jakaa sisäisesti.
- Tarkka päätepiste ja HTTP-metodi, josta on poistettu arkaluontoiset parametrit.
- HTTP-tila, Salesforce
errorCodeja lyhyt vastauksen ote. - Toimiko normaali Salesforce-kirjautuminen.
- Epäonnistuiko sama minimaalinen pyyntö toiselta hyväksytyltä asiakkaalta.
- Asiaankuuluva Salesforce Trust -tapauksen tunnus tai huomautus, ettei vastaavaa tapausta näkynyt.
- Oliko toiminto vain luku -tilassa vai olisiko siihen voitu tehdä kirjoitus.
Älä koskaan liitä käyttöoikeustunnuksia, salasanoja, istuntotunnuksia, OAuth-valtuutuskoodeja tai kokonaisia arkaluonteisia hyötykuormia jaettuihin tiketteihin tai keskustelukanaviin.
Milloin lopettaa Workbenchin ja vaihtotyökalujen vianmääritys
Siirry pois Workbenchistä, kun vika on selvästi rajattu Workbenchiin, kun operaatio on liian suuri selainpohjaiselle apuohjelmalle, kun tarvitset toistettavaa komentosarjojen toimintaa tai kun tarvitset tuetun kehitystyönkulun. Salesforcen omat korvaavat ohjeet ohjaavat kehittäjiä erityisesti Code Builderiin, Salesforce CLI:hen ja Salesforce Extensions for VS Codeen.
Älä vaihda työkaluja vain jatkaaksesi käyttämättömän Salesforce-palvelun mollaamista. Eri asiakas ei voi korjata palvelinpuolen käyttökatkosta, ja toistuvat pyynnöt voivat tehdä diagnoosista meluisampaa. Käyttökatkoksen aikana paras tulos on selkeä luokittelu: vahvistettu alustahäiriö, vain Workbench-käyttöjärjestelmän vika, paikallisverkon/selaimen ongelma, API-versioiden yhteensopimattomuus, käyttöoikeus-/todennusongelma, API-rajoituksen umpeutuminen tai pyyntökohtainen vika.
Lopputulos
Salesforce Workbench -virheitä on helpompi käsitellä, kun niitä käsitellään signaaleina, ei diagnooseina. Tarkista Salesforcen luotettavuus, tallenna tarkka virhe, pienennä pyyntöä, vertaa yhteen tuettuun asiakkaaseen ja noudata virhekoodia. Tämä auttaa välttämään tarpeettomia määritysmuutoksia käyttökatkosten aikana ja samalla havaitsemaan ongelmia, jotka näyttävät käyttökatkoksilta, mutta ovat todellisuudessa vuokraaja- tai Workbench-kohtaisia.
Influenssan oireet: mistä taudin tunnistaa ja milloin pitää hakeutua hoitoon?
Influenssan oireita ovat äkillinen kuume, lihassärky ja yskä. Lue, miten tauti eroaa flunssasta, milloin kotihoito riittää ja milloin pitää hakea apua.
HIFK:n uutiset ja tulokset Yle Urheilusta – näin löydät oikean joukkueen ja ottelun
Näin haet HIFK:n uutiset Yle Urheilusta, erotat jääkiekon ja jalkapallon sekä tarkistat ottelutulokset Liigan ja seuran virallisista lähteistä.
Ampumahiihdon maailmancup 2026–2027: mistä löydät kilpailukalenterin ja tulokset?
Katso ampumahiihdon maailmancupin 2026–2027 kilpailukalenteri, viralliset tulokset ja pistetilanteet sekä Kontiolahden avauksen ajat Suomessa.
Fleetwood Town–Arsenal: tulos, maalit ja mitä ottelusta tiedetään
Fleetwood Town yllätti Arsenalin liigacupissa 27.10.2026. Katso tulos, rangaistuspotkukilpailun ratkaisu, otteluaika Suomen ajassa ja jatkopaikan merkitys.
Israelin vaalit 2026: näin vaalijärjestelmä ja hallituksen muodostaminen toimivat
Israelin vaalit 2026 järjestettiin 27. lokakuuta. Näin 120 paikkaa jaetaan, mitä 3,25 prosentin äänikynnys merkitsee ja miten uusi hallitus muodostetaan.
Olkiluoto 1: mikä voimalaitosyksikkö se on ja miten se tuottaa sähköä?
Olkiluoto 1 on Eurajoen kiehutusvesireaktori. Tutustu OL1:n toimintaperiaatteeseen, 890 MW:n tehoon, vuosihuoltoihin ja merkitykseen Suomen sähköntuotannossa.
Liikaa velkaa? Näin selvität velkatilanteesi ja saat apua Suomessa
Jos velkaa on liikaa, aloita velkalistasta ja realistisesta budjetista. Katso, miten sovit maksuista ja haet maksutonta velkaneuvontaa Suomessa.
Tuska 2027: tarkista nämä asiat ennen festivaalilipun ostamista
Tuskan 2027 päivät ja artistien esiintymispäivät on julkaistu. Vertaa lippuvaihtoehtoja, hintoja, ikärajaa, palautusehtoja ja käytännön järjestelyjä ennen ostoa.
Tuska 2027: mistä löydät ajankohdan, liput ja esiintyjät?
Tuska 2027 järjestetään 2.–4.7. Suvilahdessa Helsingissä. Katso, mistä tarkistat päiväkohtaisen ohjelman, lippujen hinnat ja viralliset esiintyjäuutiset.