UTPLUKK/UTSKRIFT AV SELVAVLESNINGSKORT - Side 1 / 10 R301 Hensikt UTPLUKK/UTSKRIFT AV SELVAVLESNINGSKORT Beskrivelse sist revidert: År: 2005. Måned: 12. Dag: 08. UTPLUKK/UTSKRIFT AV SELVAVLESNINGSKORT (OBS: FORELØPIG BESKRIVELSE) Formålet med rapporten er å plukke og skrive ut selvavlesningskort. Installasjonsparameter selvavl_ink_everk styrer om foretaksnummer og everksnavn kommer med på selvavlesningsfil, jf. felt 34 og 35 i fil. Parameteren kan ha verdi J (= Ja) dersom opplysningene skal med på filen, ellers settes den lik N (= Nei) eller verdi oppgis ikke. Telenor Link tilbyr en tjeneste hvor kundene kan ringe inn sine avlesninger. Det skrives en egen fil til Telenor Link med samme filnavn som selvavlesningskortet, men med.tel som extention. Denne filen er semikolonseparert med opplysninger om maalerid, siste målerstand, antall siffer, siste avlest dato (yyyymmdd), beregnet årsforbruk og id som skal brukes (kundeident eller målerident). Filformatet finnes i en tabell mot slutten av denne rapportbeskrivelsen. For netteiere som vil benytte denne rutinen, må grunnlagsdata tas ut på vanlig måte fra IS Customer og avlesningene legges inn i IS Customer ved hjelp av rapport R320, som benytter filformat på GS2 versjon 1.0 format 1. Opplegget er basert på at kundene skal ringe inn avlesningene, nøkkelen (se under parameterbeskrivelsen Telenor Link) må være numerisk med kontrollkode, denne nøkkelen må finnes på selvavlesningskortet. Nøkkel er enten kundeident (ledende nuller må ikke tastes) eller målerident, her forutsettes det at everket har entydige numeriske måler_id (bokstavkoder er ofte brukt i måler_id). Rapporten produserer avlesningsmateriell i henhold til oppgitt materielltype på anlegget, eventuelt på salgsordrenivå. Materiellkode på salgsordren overstyrer materiellkode på anlegget dersom kjøredato på rapporten er innenfor fra-/tildato på overstyringen i Ordre Info. Dersom gjeldende kode er <blank> eller S (= Selvavlesningskort) produseres printfil med selvavlesningskort og evt. fil til printleverandør dersom J (= Ja) er valgt i parameteren til fil. Dersom tekstkode er registrert på anlegget eller salgsordren, kommer også dette med på fila. Dersom gjeldende kode er H (= Håndterminal) legges data i tabellen avl_haandterm i databasen. Dersom kodene K - Effektanlegg med mekaniske målere, P (= PC), F - Terminal uten kommunikasjon eller T (= Toveiskomunikasjon) velges, skrives det ut avlesningskort med eget utseende for disse kodene. Dersom leveringspunktet har mer enn to telleverk, skrives ikke sistnevnte avlesningskort ut. Ved arbeidsordre tilknyttet salgsordre med årsakskode L (= Leverandørbytte), produseres avlesningsmateriell automatisk dersom denne rapporten kjøres og avl_matr_v_levbytte er satt til A. Dersom byttedato faller på samme dag som avlesningsdato for annet avlesningsmateriell, kommer bare avlesningsmateriell for leverandørbytte med på fila. Disse forekomstene får tekstkode for leverandørbytte.
UTPLUKK/UTSKRIFT AV SELVAVLESNINGSKORT - Side 2 / 10 Energiselskap som praktiserer preliminær avlesning (prel) må merke seg at den siste avlesningen blir hoppet over hvis det er en prel. Da får du årsforbruket på telleverkene/salgsordren frem i stedet for forbruket på prelen. I forbindelse med PowerSMS-løsningen kan rapporten generere SMS-meldinger til kunder som har målerkode = 33 og har mobiltelefonnummer i en tabell som heter 'sms' (denne tabellen inneholder en kobling mellom salgsordrenummer og mobiltelefonnummer. Denne koblingen oppstår når kunden registerer sin mobiltelefon for SMS-avlesning. Da settes også målerkode til 33 for det aktuelle anlegget.). Det blir laget en fil som kan leses inn i et annet system for å generere SMS-meldinger. For salgsordrer som skal ha SMS-meldinger, blir det ikke laget selvavlesnings- eller påminnelseskort. Se for øvrig egne rutiner for SMS lenger nede i denne beskrivelsen. Ved hjelp av bestillingsparameter kan en velge hvilken tekst en ønsker å få skrevet på SMS-meldingen. Det må da være definert rapporttekst i IS Customer med gitt kode som oppgis ved bestilling av rapporten. Hvis bestillingsparameter er tom vil rapporten avbrytes. Rapporttekstkodene er energiselskapet ansvarlig for å vedlikeholde, dette gjøres fra Definer rapporttekstkoder (DRTK) og Ajourhold rapportkodetekster (RKT). Når man definerer teksten som skal ut i SMS-meldingen, kan man legge $KID$, $KID6$, $KID7$, $KID8$, $ABM1$, $ABM2$, $ABM3$, $ABM4$, $MLR$ inn i teksten for å spesifisere hvor man vil ha kundeid (uten løpenr), salgsordreløpenummer og målerid. Man velger selv hvilke data man vil ha. Det vil si man kan velge å ha med kundeid og målernummer og sløyfe salgsordreløpenummeret. $KIDX$ (der X er en av 6-8) gir kundeid på X antall siffer med ledende nuller. $KID$ gir kundeid uten ledende nuller. $ABMX$ (der X er en av 1-4) viser til hvor mange siffer/ledende nuller man vil ha i løpenummeret. Dersom man har løpenummer 11, vil $ABM1$ og $ABM2$ gi 11, mens $ABM3$ og $ABM4$ vil gi henholdsvis 011 og 0011. Ønsker man ingen ledende nuller, bruker man $ABM1$. Forhåndsbetingelser Installasjonsparameteren avl_matr_v_levbytte har betydning for hva som skrives ut i forbindelse med leverandørbytter ved kjøring av denne rapporten: N - avl_materiell/arb_ordre skrives ikke ut automatisk ved leverandørbytte. O - arb_ordre skrives automatisk ut ved leverandørbytte (tilsvarer dagens løsning med kjøring av R300). A - avl_materiell skrives automatisk ut ved leverandørbytte - betinger at rapportene R301 kjøres jevnlig. Prosessmanualen inneholder ingen prosess-skjema med henvisning hit. Rapportparametere Frist Sorteringskode for å returnere kortet Denne datoen kommer ut på avlesningskortet som innsendingsfrist. Valgfri sortering Kode for hvordan sortering skal være, se Sorteringskoder i IS Customer.
UTPLUKK/UTSKRIFT AV SELVAVLESNINGSKORT - Side 3 / 10 Faktureringsgruppe Tariff Geografisk område Målerkode Avlest etter dato Stedsangivelse til fil Rutenr Alle når ingen er oppgitt Dersom faktureringsgruppe oppgis, vil selvavlesningskort kun skrives ut for salgsordre i denne gruppen. Alle når ingen er oppgitt Dersom tariff oppgis, vil selvavlesningskort kun skrives ut for salgsordre som har denne tariffen. Alle når ingen er oppgitt Dersom geografisk område oppgis, vil selvavlesningskort kun skrives ut for salgsordre med anlegg i dette området. Vanligvis blank Dersom målerkode oppgis, vil selvavlesningskort kun skrives ut for salgsordre som har måler med denne målerkoden. får ikke avlesningskort. Salgsordre som har avlesning etter angitt dato, får ikke avlesningskort. J/N/I/B J (= Ja) Du vil få trykket målerplasskode (Målepunkt (MPKT)) på selvavlesningskortet. N (Standardverdi) (= Nei) Du vil få trykket beskrivelse knutepunkt (Knutepunkt (KNP)). I (= Id) Du vil få trykket knutepunktid. (Installasjonsdata (INS)). B (= Beskrivelse) Se N. J/N/B Ja gir ingen print. B=begge deler I forbindelse med kjøring av rapporten, kan det bli opprettet en egen fil med data som man eksempelvis kan behandle videre i en MS Access-rapport eller i et regneark. J (= Ja) N (Standardverdi) (= Nei) B (= Begge) Begge deler, både print og fil. Alle når 0 er oppgitt Med denne parameteren vil en kunne plukke ut kun de avlesningskortene som finnes på det oppgitte rutenummeret. Hvis det ikke oppgis noen verdi (= 0), får en alle.
UTPLUKK/UTSKRIFT AV SELVAVLESNINGSKORT - Side 4 / 10 Telenor Link Virksomhetsid. Forbrukskode Kunde id før løpenr Avlesningsmateriell Overføringstariffer Min antall dager før leverandørbytte Maksimalt antall dager til lev.bytte. K(U)/M(U)-Kunde-/Målerident. <blank> Ingen fil til Telenor Link. K (= Kunde-identifikator) Fil lages til Telenor Link med kundeident: "abm.løpenr. + kundeid+mod10". M (= Måleridentifikator) Fil lages til Telenor Link med målerident: "numerisk del av målerid+mod10". KU (= Kunde-identifikator Uten kontrollsiffer) Gir det samme som K, men uten kontrollsiffer. MU (= Måleridentifikator Uten kontrollsiffer) Gir det samme som M, men uten kontrollsiffer. J=kundeid+løpenr i kundeident J (= Ja) Gir kundeid før abm.løpenr. i kundeident hvis K eller KU i Telenor Link parameter. N (= Nei) Gir abm.løpenr. før kundeid i kundeident. <blank> Se N. Alle når ingen er oppgitt En el kommaseparert. Alle ved blank Koder for avlesningsmateriell. Kan oppgi en eller flere (med komma mellom) eller <blank>. <blank> gir alle. En el kommaseparert. Alle ved blank Utplukk basert på forbrukskoder. Kan oppgi en eller flere (med komma mellom) eller <blank>. <blank> gir alle. En el kommaseparert. Alle ved blank Utplukk basert på overføringstariffer. Kan oppgi en eller flere (med komma mellom) eller <blank>. <blank> gir alle. Ved 0 blir det ikke generert ved bytte Avlesningsmateriell produseres dersom antall dager til leverandørbytte er større enn antall dager oppgitt i denne parameteren. Dersom 0 oppgis produseres ikke avlesningsmateriell. Uforkortet: Ved 0 blir alle lev.bytter tatt med Avlesningsmateriell produseres dersom antall dager til leverandørbytte er mindre enn antall dager oppgitt i denne parameteren. Dersom 0 oppgis får alle leverandørbytter avlesningsmateriell uansett hvor langt frem i tid et leverandørbytte skal foretas. Avhengig av at parameteren Min antall dager før leverandørbytte er utfylt.
UTPLUKK/UTSKRIFT AV SELVAVLESNINGSKORT - Side 5 / 10 Avlesningmatriell for SMS Tekstkode SMS Script for behandling av sms-fil J/N. Ved J kan det bli laget SMS fil J (= Ja) To filer produseres; 1 fil med grunnlag for selvavlesningskort samt 1 fil med grunnlag for avlesninger vha Power SMS. Salgsordre som skal ha SMS kommer ikke med i filen for selvalesningskort. Hvis det er to eller flere telleverk vil en ikke kunne benytte SMS. Om det er registrert avlesningsmateriell med type F,K,T,P på leveringspunktet eller salgsordren, vil det ikke genereres SMS. N (Standardverdi) (= Nei) Én fil produseres; filen vil inneholde grunnlag for selvavlesningskort. Da vil alle salgsordre som er registrert med SMS i stedet få selvavlesningskort. Blank: ingen tekst Tekstkoden defineres i Definer rapporttekstkoder (DRTK) og det er koden som oppgis her. Selve teksten er definert i Ajourhold rapportkodetekster (RKT). Parameteren gjelder kun de som har målerkode = 33 (ref. feltet Mlrkode i Anleggsdata (ANL) eller Målerkode i KABA). Det er en forutsetning at det er registrert kobling mellom salgsordre og et mobiltelefonnummer i tabellen 'sms'. Rapporten lager ikke selve SMSmeldingen, men en fil som kan leses inn i et annet system for å generere meldingen. Imidlertid kan rapporten kjøre et script som kan kalle nødvendig programvare for å få sendt ut SMS-meldingene (se parameteren [Script for behandling av sms-fil]). Dersom det ikke er lagt inn tekst, genereres det ikke SMS-fil. Blank: ingen behandling Bane og navn til et script som rapporten kan kalle etter at SMS-fila er produsert. Scriptet kalles med to parametere, slik: script <SMS-fil> <returkodefil>parameterforklaring:<sms-fil> = fila som inneholder SMSmeldinger<returkodefil> = fil der scriptet skal legge et tall som angir om SMS-utsending gikk bra eller ikke. Tallet 0 (null) er suksess-verdi. Alle andre verdier tolkes som fiasko.rapporten finner selv ut hva SMS-fila og returkodefila skal hete. Dersom parameter 'Script SMS' er oppgitt, vil rapporten først prøve å åpne scriptet for lesing for å sjekke at scriptet finnes. Dersom parameter 'Script SMS' er blank, hopper rapporten ganske enkelt over det steget som kjører scriptet. Da har du fått produsert en SMS-fil som manuelt må følges opp for å få produsert SMS-meldinger.
UTPLUKK/UTSKRIFT AV SELVAVLESNINGSKORT - Side 6 / 10 Avlesningmatriell for e-post Tekstkode e-post J/N/Bare Ved J/B kan det bli e-postfil. Blank: ingen tekst Tekstkoden defineres i Definer rapporttekstkoder (DRTK) og det er koden som oppgis her. Selve teksten er definert i Ajourhold rapportkodetekster (RKT). Parameteren gjelder kun de som har målerkode = 33 (ref. feltet Mlrkode i Anleggsdata (ANL) eller Målerkode i KABA). Det er en forutsetning at det er registrert kobling mellom salgsordre og et mobiltelefonnummer i tabellen 'e-post'. Rapporten lager ikke selve e-postmeldingen, men en fil som kan leses inn i et annet system for å generere meldingen. Imidlertid kan rapporten kjøre et script som kan kalle nødvendig programvare for å få sendt ut e-post-meldingene. Dersom det ikke er lagt inn tekst, genereres det ikke en semikolon fil som det skal lages e-postmelding av. Rutiner Illustrasjon på hvordan saksgangen ser ut ved bruk av Telenor Link: Rutiner for SMS-meldinger: Dersom rapporten kjøres med mulighet for å ta ut SMS-meldinger, gjelder følgende: Filnavnet oppgis på kvitteringslista. SMS-fila har spesielt format (finnes beskrevet nedenfor). Antall SMS-meldinger i fila oppgis også på kvitteringslista. Kvitteringslista inneholder informasjon om det er bestilt et script som skal kjøres på SMS-fila. Dersom script er bestilt, inneholder kvitteringslista også informasjon om hvordan kjøring av scriptet gikk Siden en SMS-melding har en begrensning på 160 tegn, testes hver eneste melding mot denne lengden. Dersom en melding er for lang, vil den ikke bli skrevet til SMS-fila. I slike tilfeller vil de to antallene som oppgis på kvitteringslista bli forskjellige. Man må derfor være forsiktige når rapportteksten defineres for SMS-meldingen. Det er to hovedmuligheter for å få for lang meldingstekst:
UTPLUKK/UTSKRIFT AV SELVAVLESNINGSKORT - Side 7 / 10 1. Rapportteksten i seg selv er for lang, slik at meldingen blir for lang for samtlige abonnenter. 2. Rapportteksten i seg selv er på kanten, og inneholder makroer som ekspanderes til f.eks. kundenummer, salgsordrenummer eller målernummer. Da kan man risikere at noen meldinger blir for lange (og dermed utelates fra SMS-fila), mens andre meldinger er OK. I begge tilfellene må man korte ned på rapporttekstene. I tillegg vil tom rapporttekst føre til at rapporten avbrytes. Årsaken til at meldinger fjernes fra SMS-fila dersom de er for lange, er at en uforståelig tekst lett kan oppfattes som telefonsjikane. Noe av den samme tanken ligger bak avgjørelsen om å avbryte rapporten dersom rapportteksten er tom: det kan oppleves som skremmende for enkelte å få en tom melding (altså oppleves som telefonsjikane). Formatet på SMS-fila skiller seg fra de andre filformatene som rapporten opererer med. SMS-fila genereres i ett av to format: Format 1: <mobilnummer 1-8 til 15 tegn><mellomrom><melding 1 -- opp til 160 tegn> <mobilnummer 2-8 til 15 tegn><mellomrom><melding 2 -- opp til 160 tegn> <etc.> Eksempel på format 1: 4798765432 Denne meldingen sendes til 98765432 i Norge. 441234567890 Denne meldingen går til 1234567890 i Storbritannia. Format 2: <mobilnummer 1-8 til 15 tegn><mellomrom><melding 1 -- opp til 160 tegn> <mobilnummer 2-8 til 15 tegn> <mobilnummer 3-8 til 15 tegn> <etc.> Eksempel på format 2: 4712345678 Denne meldingen går til alle mobiltlf, fra denne linja og ned. 4798765432 441234567890 Rapporten finner selv ut om den bør bruke format 1 eller 2. Dersom makroer er oppgitt i rapportteksten, vil format 1 bli brukt, ettersom meldingene da vil inneholde data (f.eks. målernummer) som er forskjellig for hver salgsordre. Dersom makroer ikke er brukt, vil format 2 bli benyttet. Fila vil dermed bli mindre, og antakelig enklere å overføre til andre systemer som foretar utsendelse av SMS-meldingene. Maks 10 rapporttekstlinjer vil bli skrevet ut. Merk at mobiltelefonnummeret må inneholde landskode dersom CorporateSMS fra Viva Technologies benyttes til utsending av SMS-meldinger. Dersom det er flere mobilnummer registrert på salgsordre, vil det laveste nummeret brukes.
UTPLUKK/UTSKRIFT AV SELVAVLESNINGSKORT - Side 8 / 10 Dag/Natt kjøring Feilsituasjoner Importfil Resultatfiler Natt. Om filformat Dersom det tas utskrift til fil, er det en installasjonsparameter i USAapplikasjonen som bestemmer om filen skal ha fast lengde på feltene eller om feltene skal være atskilt med semikolon. Parameteren heter fast_feltlengde_r301, og den kan ha verdi J (= Ja) eller N (= Nei). Verdi J betyr at feltene som kommer på fila, skal ha fast lengde. Verdi N betyr at feltene i fila skal være semikolonseparert. Dersom det er valgt fast lengde på kolonnene, blir det satt en * som markerer "end of record" i fila. Felt nr Feltnavn / beskrivelse (Maks ) lengde Typ e Format 1 kunde_id 8 N 99999999 2 abm_lopenr 4 N 9999 3 maalerid 12 S 4 installasjonsid 10 S 5 anleggsid 4 S 6 rutenr 4 N 9999 7 sekvens_i_rute 5 N 99999 8 omraade_id 4 S 9 adkomst 150 S 10 navn (kundenavn) 30 S 11 abm_gruppe 4 S 12 adresse_1 (fra kunde) 30 S 13 adresse_2 (fra kunde) 30 S 14 nasjon 30 S 15 poststed (postnr + poststed eller poststed utland) 16 anleggsadresse_1 (gate og husnr) 17 anleggsadresse_2 (beskrivelse eller leilighet, etasje) 40 S 40 S 40 S
UTPLUKK/UTSKRIFT AV SELVAVLESNINGSKORT - Side 9 / 10 Felt nr Feltnavn / beskrivelse 18 knutepunkt (inneholder målerplasskode eller knutepunkt eller knutepunktbeskrivelse, alt etter bestillingsparameter og datainnhold) (Maks ) lengde 40 S 19 returdato 10 Dato DD.MM.ÅÅÅÅ 20 tariff 4 S 21 ovf_tariff 4 S Typ e Format 22 avlesttidspunkt 10 Dato DD.MM.ÅÅÅÅ 23 konstant_1 11 N ZZZZZZ9,999 24 konstant_2 11 N ZZZZZZ9,999 25 forbruk_1 8 N ZZZZZZZ9 26 forbruk_2 8 N ZZZZZZZ9 27 ant_kryss_1 (beregnet utfra antall siffer og 7 felt på kortet) 1 N 9 28 ant_kryss_2 1 N 9 29 tekst_1 (ledetekst for telleverk) 30 tekst_2 (ledetekst for telleverk 2) 14 S 14 S 31 stand_1 8 N ZZZZZZZ9 32 stand_2 8 N ZZZZZZZ9 33 ant_siffer_1 1 N 9 34 ant_siffer_2 1 N 9 35 foretaksnr (everk) 11 S 36 navn (everk) 30 S 37 unikt målepunktid 35 S 38 PIN-kode 4 S Personal Identification Number. 4 posisjoner maskingenerert vilkårlig tallkode.
UTPLUKK/UTSKRIFT AV SELVAVLESNINGSKORT - Side 10 / 10 Felt nr 39 Tekstkode 5 S Avlesningsmateriellets tekstkode. Felt 23, 24: Verdi i feltet bare dersom avregningskonstant er ulik 1. Felt 35, 36: Verdi i feltet bare dersom installasjonsparameteren selvavles_ink_everk = J. Filformat for fil som skal sendes til Telenor Link: Felt nr Feltnavn / beskrivelse Feltnavn / beskrivelse (Maks ) lengde Maks lengde Typ e Typ e Format Format 1 maalerid 12 S 2 siste målerstand 8 N 3 antall siffer 1 N 4 sist avlest dato 10 dato 5 beregnet årsforbruk 9 N 6 K_avl_id eller M_avl_id 13 S 7 Konstant 11 N ZZZZZZ9,999 er 1 Rejectliste for selvavl.kort 2 Selvavlesningskort 3 Avl.kort mat.kode K,P,F,T mpkt