Ajastus ja lähetys

Suunniteltu raportti on raportti, joka jonkun on käytävä hakemassa. Ajastukset ratkaisevat yleisimmän tapauksen ilman riviäkään koodia: ”myyntipipeline lähtee johdolle joka maanantai klo 8”.

”Lähetä tämä raportti sähköpostilla sellaisenaan sovittuun aikaan.” Sitä se on, eikä muuta — kaikki mikä tarvitsee enemmän tehdään skriptillä, ja tämä sivu kertoo milloin.

Jatkamme Asiakashallinta-sovelluksen raportissa Oportunidades por conta, ajastuksella Pipeline de segunda-feira.

#Raportin ajastukset

Ajastukset asuvat raportissa itsessään: avaa raportti ja katso vasemman sarakkeen loppua, osiota Ajastukset. Jokainen rivi on sovittu lähetys, tiivistelmä nimen alla — kellonaika, aikavyöhyke, muoto ja kenelle se menee.

Pois päältä kytketty ajastus näkyy merkinnällä pois päältä. Kunkin rivin oikean laidan kuvakkeet muokkaavat ja poistavat.

Raportissa, jolla ei vielä ole yhtään, lista näyttää tekstin ”Ei ajastuksia.” ja jäljellä on vain luoda ensimmäinen:

#Ajastuksen luominen

1. Avaa raportti ja napsauta osion Ajastukset painiketta + (tai painiketta Lisää ajastus listan lopussa).
2. Täytä lomake.
3. Napsauta Tallenna.

#Milloin

Kenttä	Huomiot
Nimi	Yksilöi ajastuksen. Sillä nimellä se näkyy historiassa.
Toistuvuus	Päivittäin, viikoittain tai kuukausittain.
Kello	Lähetyksen kellonaika.
Päivät (päivittäinen toistuvuus)	Kaikki, Arkipäivät tai Viikonloppu.
Viikonpäivä (viikoittainen toistuvuus)	Maanantaista sunnuntaihin.
Kuukauden päivä (kuukausittainen toistuvuus)	1–31.
Aikavyöhyke	Oletuksena Europe/Lisbon. Tällä vyöhykkeellä kellonaika luetaan.

#Mitä

Kenttä	Huomiot
Muoto	PDF tai Excel.
Parametrit	Yksi kenttä jokaista raportin määrittelemää parametria kohden. Näillä arvoilla se ajetaan.
Käytössä	Pois päältä ajastus jää kirjatuksi mutta ei laukea.

Esimerkissä parametri Fase täytetään arvolla Proposta ja Fecho a partir de jää tyhjäksi — sama raportti palvelee useaa ajastusta, kutakin omalla rajauksellaan.

#Kenelle

Kohde voidaan sanoa kolmella tavalla, ja kaikkia kolmea voi käyttää yhtä aikaa:

Kenttä	Huomiot
Vastaanottaja	”Sähköpostiosoitteet pilkuin eroteltuina.” Niille, joilla ei ole tiliä sovelluksessa.
Käyttäjät	”Sovelluksen käyttäjät. Lähtee heidän tietueessaan olevaan sähköpostiin; ne, joilla ei ole osoitetta, jäävät pois.”
Roolit	”Kaikki tämän roolin käyttäjät. Roolin valitseminen osoitteen sijaan pitää ajastuksen oikeana, kun joku tulee tai lähtee.”

#Sähköposti

Aihe on sähköpostin rivi; tyhjänä käytetään raportin nimeä. Viesti avaa oman editorin rungolle:

Raportti lähtee liitteenä, valitussa muodossa, dokumentin nimellä. Runko on vain mukana kulkeva viesti.

#Mitä sovitulla hetkellä tapahtuu

1. Raportti luodaan palvelimella, ajastuksen parametreilla.
2. Tiedosto liitetään sähköpostiin ja lähetetään sovelluksen sähköpostikanavan kautta.
3. Tapahtunut kirjataan: luotu tiedosto ja montako vastaanottajaa sen hyväksyi.

Jos jokin menee pieleen — raportti epäonnistuu, sähköpostikanavaa ei ole määritetty, vastaanottajalla ei ole osoitetta — se kirjataan ja ajastin jatkaa. Epäonnistunut lähetys ei pysäytä muita.

Ajastus ilman vastaanottajia ei myöskään lähetä — kirjataan ”ei vastaanottajia” eikä mitään tapahdu.

#Kun ajastus ei riitä

Oikopolku palvelee yleistä tapausta. Tarvitset Python-skriptin, kun haluat:

• lähettää vain jos rivejä on (”älä lähetä viivästysraporttia, jos viivästyksiä ei ole”);
• yhden sähköpostin asiakasta kohden, kunkin omalla rajauksellaan;
• tallettaa tiedoston muualle sen lähettämisen sijaan;
• luoda dokumentin keskellä isompaa prosessia.

Skriptien SDK tekee juuri sen:

from api_manager import reports, notify

r = reports.render("Oportunidades por conta", {"fase": "Proposta"})
notify.email(
    "Viikon pipeline",
    to=["direccao@exemplo.pt"],
    attachments=[{"filename": r["filename"], "content": r["base64"]}],
)

reports.render(...) saa raportin nimen tai tunnisteen, sen määrittelemät parametrit ja muodon ("pdf", oletuksena, tai "xlsx"), ja palauttaa tiedoston valmiina talletettavaksi tai liitettäväksi. Siitä eteenpäin ajastus on skriptin ajastus — kaikkine vaihtoehtoineen, jotka skriptien Ajastuksilla on, mukaan lukien ajamatta jääneen jälkisuoritus.

#Raportin luonti muualla

Ajastusten ja skriptien lisäksi raportti voidaan luoda:

Mistä	Miten
Sovelluksen näytöltä	TypeScript-tapahtumassa, näyttöjen SDK:lla — avaa PDF:n käyttäjälle tai palauttaa tavut, jotta voit antaa niille toisen kohteen.
Työnkulusta	Sähköposti-vaihe liittää raportin, joka luodaan lähetyshetkellä sen suorituksen tietueelle. Katso Vaiheet, päätökset ja odotukset.
Suunnitelmasta	Painikkeet Esikatsele ja Excel, tarkistamista varten suunnittelun aikana.

Kaikissa raportti ajaa pyytäjän käyttöoikeuksilla: käyttäjä näkee dokumentissa vain ne tietueet, jotka hän näkisi näytöillä. Datan piiri rajataan palvelimella, myös raporteissa.

#Usein kysyttyä

Ajastus on käytössä enkä saanut mitään. Tarkista tässä järjestyksessä: sovelluksen sähköpostikanava on aktiivinen ja testattu; ajastuksella on vastaanottajat; vastaanottajilla on sähköposti tietueessaan; raportti ajaa ilman virhettä (käytä Esikatsele samoilla parametreilla).

Kellonaika on oikein mutta se saapui tuntia myöhemmin. Ajastuksen Aikavyöhyke on se joka määrää, ei palvelimen eikä lukijan. Varmista, että se on Europe/Lisbon (tai haluamallasi vyöhykkeellä).

Voinko lähettää saman raportin kahtena eri kellonaikana? Kyllä — luo kaksi ajastusta samaan raporttiin, kumpikin omalla nimellään, kellonajallaan, vastaanottajineen ja parametreineen.

Poistin ajastuksen vahingossa. Sitä ei voi perua. Luo se uudelleen: ajastus on vain lomake kellonaikoineen ja vastaanottajineen, ja se vie minuutin.