Release note

Nye api funktioner til brug i din egen emulering (useremul) af 5250 skærmbilleder

Nye api'er:
• emlArea2Panel: Omdanner et detail skærmbillde til et panel, som kan indsættes i andre komponenter, ex. et faneblads panel
• emlIgnoreArea: Markering af et område på skærmbilledet, som skal ignores

Api'erne er dokumenteret under 'Administration' / 'IceCap emulator API documentation'

Ny metode (icecaped) til at emulere subfiler. Metoden prøver at genkende subfilen og gemme genkendelsen i en xml file. Metoden bruger area2xxx funktionerne til at emulere.

Følgende parameter fra icecap_config.xml bruges:

Styring af emulering:

                <emulator 
                  program="/menu/icecap.aspx" 
                  method="icecaped"Bestemmer emuleringsmetode: simple, advanced eller icecaped (ny).
                  useHints="yes"Brug 'hints', som er gemt i xml filen: yes eller no.
                  hintsXMLhive="menu"Hive for xml file med 'hints'.
                  hintsXMLpath="icecaped.xml"Navn for xml file med 'hints'
                  numberOfSubfilePagesToStack="2"Antal subfile sider, som skal stacket i grid'en.
                  defaultOption="2,5,1"NY - Prioteret liste med standard valg muligheder. Bliver valgt ved dobbeltklik på række.
                  selectTextWhenFieldFocus="yes"NY - Markér tekst ved fokus i felt: yes eller no.
                  openSubProgramsInWindows="yes"NY - Åbne under programmer i vinduer: yes eller no.
                />

Til genkendelse af subfile:

                <optionText>Bruges til at finde valg muligheder (1=valg, 2=Revider, etc.).
                  <item text="TYPE OPTION" startPosition="1" endPosition="20"/>
                  ...
                </optionText>
                <optionField>Bruges til at finde valg felter, samt subfile start.
                  <item text="OPT" startPosition="1" endPosition="8"/>
                  ...
                </optionField>
                <subfileEndTextBruges til at finde subfile slut, samt position ifht. subfile data og funktionstaster.
                  subfileEndBeforeFKeys="2" subfileEndColumn="79" subfileMoreText="+" dataEndBeforeSubfileEnd="0">
                  <item text="MERE" startPosition="60" endPosition="132" moreIndicator="yes"/>
                  <item text="SLUT" startPosition="60" endPosition="132"/>
                  ...
                </subfileEndText>

Eksempel på gemt genkendelse i xml filen af en subfile:

                <panel id="Arbejd med noter" token="1">
                  <select>
                    <when line="12" column="1" length="80" equal=" Valg Typ          Nummer Applikation          Dato       Tekst                 "/>
                  </select>
                  <areas>
                    <property type="ignoreArea" startLine="1" startColumn="1" endLine="1" endColumn="80"/>
                    <property type="ignoreArea" startLine="2" startColumn="1" endLine="2" endColumn="80"/>
                    <property type="area2columns" xPosition="0" yPosition="2" startLine="4" startColumn="1" endLine="7" endColumn="80" columnWidth="" removeLabelDots="true"/>
                    <property type="area2grid" xPosition="0" yPosition="98">
                      <menu startLine="9" endLine="10" moreOptionKey="">
                        <item id="1" text="Opret"/>
                        <item id="2" text="Revider"/>
                        <item id="3" text="Kopier"/>
                        <item id="4" text="Slet"/>
                        <item id="5" text="Vis"/>
                      </menu>
                      <column startLine="12" endLine="12" showOptionField="true" optionFieldColumn="1" optionFieldLength="1">
                        <item header="Valg" columnStart="2"/>
                        <item header="Typ" columnStart="7"/>
                        <item header="Nummer" columnStart="11"/>
                        <item header="Applikation" columnStart="27"/>
                        <item header="Dato" columnStart="48"/>
                        <item header="Tekst" columnStart="59"/>
                      </column>
                      <quickOption line="13"/>
                      <data startLine="14" endLine="21" subfileEndLine="21" subfileEndColumn="79" subfileMoreText="+" subfileBottomText=" "/>
                      <toolbar>
                        <item id="F3" text="Afslut"/>
                        <item id="F4" text="Liste"/>
                        <item id="F5" text="Opfrisk"/>
                        <item id="F12" text="Annuller"/>
                        <item id="F17" text="Udsnit"/>
                      </toolbar>
                    </property>
                    <property type="label" line="24" contentLocation="east"/>
                  </areas>
                  <keys startLine="23" endLine="23">
                    <item id="F3" text="Afslut"/>
                    <item id="F4" text="Liste"/>
                    <item id="F5" text="Opfrisk"/>
                    <item id="F12" text="Annuller"/>
                    <item id="F17" text="Udsnit"/>
                  </keys>
                </panel>

Ændring af 'hints' gemt i xml filen:
Man kan ændre direkte i xml filen, eller man kan benytte 'tandhjuls-funtionen' ved at klikke på tandhjulet.

Tandhjuls-funktionen er kun mulig, hvis man har specificeret 'icecaped' i 'method', samt 'yes' i 'useHints' i icecap_config.xml filen.

Vha. tandhjuls-funktionen kan man ændre, tilføje og slette 'hints', som er genkendt af emulatoren:

Nye api funktioner til brug i din egen emulering (useremul) af 5250 skærmbilleder

Nye api'er:
• emlArea2Grid: Tager et område (subfile) af skærmbilledet og danner en web 2.0 grid
• emlArea2Colunms: Tager et område, ex. et detail skærmbilldet og sætter ledetekst og input felter op i kolonner
• emlArea2CommandLine: Tager et område og danner et tekst areal.

Api'erne er dokumenteret under Administration / IceCap emulator API documentation

Mht. til emlArea2Grid er følgende ikke understøttet endnu:
• Horisontal bladring - højre og venstre
• Subfile drop
Lettere forståelig bruger -og menu punkt administration

Nyt menupunkt under administration: System setting

Med dette punkt kan man styre følgende:
• Skal menu punkt starte i nyt faneblad ved enkelt eller dobbelt klik.
• Skal brugerne oprettes automatisk ved login, hvis de allerede findes som IBMi profil.
Mulighed for at angive 'initial kommando' på system niveau. Herefter er prioteringen:
• Hvis 'initial kommando' angivet på system niveau benyttes denne
• Ellers hvis 'initial kommando' angivet på bruger gruppe niveau benyttes denne
• Ellers ingen
Mulighed for at angive, at dette er en kritisk applikation, som ikke må lukkes ved klik på 'luk faneblad'. Denne markering sætter man på det enkelte menu punkt.
Det er også muligt, at styre lukning af fanebladet fra user emulator (USEREMUL) programmet på følgende måde:

if vtSaaTitleContains(pVts:'Change customer')
or vtSaaTitleContains(pVts:'Display customer');
  // Disable tab closable (ex. critical application)
  // In this example the tab close is disable,
  // if the customer name = 'System & Metode A/S'
  name = vtGetValueFor(pVts : 'Customer Name');
  if name = 'System & Metode A/S';
    emlAddMetaField ('{+
      configOptions:{tabClosable:false}+
    }');
  else;
    emlAddMetaField ('{+
      configOptions:{tabClosable:true}+
    }');
  endif;
- I dette tilfælde fjernes 'luk fanebladsikonet' på 'Display' -eller 'Change customer' billedet fra IceCap Demo, hvis feltet 'Customer Name' indeholder værdien 'System og Metode A/S'. Dette eksempel findes i source: ICECAP/QSAMPLE(EX16).

Bedre styring af numeriske input dds keywords
Bruger med 'limit capabilities' specificeret på deres IBM™ profil, kan nu også bruge IceCap™ med minimal ændringer i bruger opsætning.
Følgende linie skal lægges ind i brugerens 'initial program':
icebreak/stricecap
Linien skal lægges ind efter al miljø opsætning, men før kald til bruges normale menu program eller lign.
Ex.

Kommandoen tjekker om brugeren kommer fra IceCap™ eller normal 'grøn skærm'. Hvis normal 'grøn skærm' gør stricecap ingen ting, ellers fortsætte i IceCap™.

Værktøj til styring af farve temaer for IceCap™
Nyt menu punkt under administration: Change colors in IceCap™.
- med dette menu punkt er det muligt at revider eksisterende temaer, samt at lave nye.

Temaer gemmes i iceCap_themes.xml istedet for iceCap_config.xml.
Valg af temaer er flyttet til 'tandhjul'

Hvis man starter IceCap™ fra ejet system, kan man angive IceCap™ tema i config filen vha. følgende tag:

                <defaults 
                  ...
                  defaultIceCapTheme="default"
                />

Bedre håndtering af input felter og funktionstaster i samme linie.

Farve styring med mulighed for selv at bestemme udsendende på ex. highlight eller en rødbjælke
Farverne styres i config xml filen (icecap_config.xml) vha. følgende xml tags:
```
                <styleMap>
                  <map attr="20" foreground="hidden"  background="black"  decoration="none" style=""/>
                  <map attr="21" foreground="black"   background="green"  decoration="none" style="background:green;color:black;"/>
                  <map attr="22" foreground="white"   background="black"  decoration="none" style="color:#000080;"/>
                  ...
              
```
Ret style attributerne til det layout du ønsker. Se style standard her: http://www.w3schools.com/css
Følgende tags er blot ment som forklaring:
• attr = 5250 display attribute
• foreground = 5250 forgrundsfarve
• background = 5250 baggrundsfarve
• decoration = 5250 tekst konvertering (underline, etc.)
Bedre adskillelse imellem input -og output felter
Pænere layout på funktionstasterne
Tydeligere forskel imellem in -og output felter i udsendende

Forbedret svartider
Bemærk at IceCap™ config file (icecap_config.xml) er ændret væsentlig.
Nu er der kun en config file. Dvs. at filen nu indeholder config parameter både for simple, advanced, etc. IceCap™ kaldes nu kun med en parameter, ex. &config=advanced. Hvis parameteren ikke angives bruges afsnit <default> i config xml filen.
Den eksisterende config file er omdøbt til ex. : icecap_config(version 1.53).xml (eksisterende version nummer).

Navigering forbi styresystemets skærmbilleder er lagt i config filen, så den bl.a. kan sprogstyres, vha. følgende xml tag:

                <automaticScreenScripting>
                  <!-- English -->
                  <screen title="Sign Off" action="ENTER" />
                  <screen title="Attempt to Recover Interactive Job" fieldNo="1" value="90" action="ENTER" />
                  <screen title="Display Program Messages" action="ENTER" />
                  <screen title="Sign-on Information" action="ENTER" />
                  ...

Endvidere kan man i config file også angive navnet på ens egen breakout program til navigering.

                <breakOut
                  navigatorProgram="*LIBL/USERNAVI"
                  ...

Eksempel på navigering program ligger i IceCap™ biblioteket og source file QSAMPLE.

Mulighed for længere parameter streng (nu 256 karakter).
Mulighed for at kalde IceCap™ fra egne hjemmeside eller menu system vha. single signon metode.
dvs. at bruger-id og kodeord kan fjernes fra linket, og erstattes med et kald til IceCap™ login procedure. Login proceduren returnere et session-id, som skal bruges i alle efterfølgende kald til IceCap™.

Proceduren fungere på følgende måde. Kald login.aspx vha. ajax og gem session-id, som returneres. Bemærk at der også kan returneres fejl meddelser.

Eksempel på response:
• Ved fejl: {success:false,error:"Password not correct for user profile XXXXX."}
• Okay: {success:true,sessionID:".20100126125355900001"}

Husk at kald logoff.aspx, når IceCap™ ikke skal bruges mere. Så lukkes de virtuelle 5250 terminaler pænt ned.

Se eksempel i 'IceCap demo'.
Tjek at device status ved åbning af ny virtuel terminal.
Markøren navigeres automatisk hen på OK knappen på pop-up vinduet og beskeder.
På bruger information kan man nu angive faste arbejdsstation-id(er) på de virtuelle terminaler.
Icecap™ er nu fuldstændig sprogstyring. Det er muligt at oprette sit ejet sprog, hvis man ønsker det.

Det kan gøres på følgende måde:
• Kopier message file: I18N_DFT i IceCap™ til ex. I18N_DE (tysk).
• Ret tekst beskrivelse på den nye message file.
• Ret teksterne vha. 'Translate' applikationen under 'Administration'

Hvis man starter IceCap™ fra ejet system, kan man angive IceCap™ tema i config filen vha. følgende tag:

                <defaults 
                  ...
                  defaultTheme="xtheme-gray.css"
                />

Hjælp følge skrift af faneblad (pt. ikke skærmbillede)

IceCap™ Version 2.000.000 (Frigivet d. 19. juli 2011)

IceCap™ Version 1.61 (Frigivet d. 5. oktober 2010)

IceCap™ Version 1.60 (Frigivet d. 29. april 2010)

IceCap™ Version 1.59 (Frigivet d. 17. april 2010)

IceCap™ Version 1.58 (Frigivet d. 10. marts 2010)

IceCap™ Version 1.57 (Frigivet d. 17. februar 2010)

IceCap™ Version 1.54 (Frigivet d. 25. januar 2010)