Lomakemallin määrittäminen niin, että se tunnistaa lomakkeen yhteystilan

Jos suunnittelet lomakemallia, jonka lomakkeet ovat riippuvaisia verkkoyhteydestä tietojen käsittelemiseksi tai palauttamiseksi ja osaat kirjoittaa komentosarjan, voit kirjoittaa komentosarjan, joka tunnistaa lomakkeiden verkon yhteystilan lomakemallin perusteella. Voit käyttää tätä komentosarjaa, jotta Microsoft Office InfoPath tarkistaa, kun uusi lomake on yhdistetty verkkoon ja voidaanko lomake yhdistää ulkoiseen tietolähteeseen, ennen kuin se lähettää kyselyn ulkoiseen tietolähteeseen. Tämä artikkeli sisältää Microsoft JScript- ja Visual Basic Scripting Edition (VBScript) -esimerkkejä sen määrittämiseen, ovatko lomakemalliin perustuvat lomakkeet yhteydessä verkkoon ja voidaanko nämä lomakkeet yhdistää ulkoiseen tietolähteeseen.

Tässä artikkelissa käsiteltävät aiheet

Yleiskatsaus

JScript-esimerkki

VBScript-esimerkki

Komentosarjaesimerkin käyttäminen lomakemallissa

Yleiskatsaus

Voit määrittää lomakemalliin perustuvan lomakkeen verkkoyhteystilan käyttämällä Sovellus-objektin MachineOnlineState-ominaisuutta. Sen jälkeen voit määrittää, löytääkö lomake ulkoisen tietolähteen, käyttämällä saman Sovellus-objektin IsDestinationReachable-menetelmää. MachineOnlineState-ominaisuus sisältää arvon, joka edustaa lomakkeen yhteystilaa. Tällä ominaisuudella voi olla seuraavat arvot:

Arvo

Kuvaus

0

Tietokone ei ole yhteydessä verkkoon. Ominaisuudella voi olla tämä arvo, jos tietokone ei ole yhteydessä verkkoon tai jos tietokoneen verkkokortti ei ole käytössä.

1

Tietokone on yhdistetty verkkoon. Jos tietokone on yhdistetty verkkoon verkkokaapelilla, tämä arvo ilmoittaa, että tietokone on yhteydessä verkkoon. Jos tietokoneessa on toimiva langaton verkkokortti, tämä arvo ilmoittaa, että langaton verkkokortti toimii. Voi kuitenkin olla, ettei tietokone ole yhteydessä langattomaan verkkoon.

2

Tietokone on yhdistetty verkkoon, mutta Windows Internet Explorer on määritetty toimimaan offline-tilassa. Kun Internet Explorer on määritetty toimimaan offline-tilassa, tietoyhteys tietokantaan tai Web-palveluun ei välttämättä toimi kunnolla.

Kun olet määrittänyt, että käyttäjän tietokone on yhdistetty verkkoon, voit käyttää IsDestinationReachable-menetelmää sen määrittämiseen, voidaanko lomake yhdistää ulkoiseen tietolähteeseen. Tämän menetelmän parametrina on ulkoisen tietolähteen Uniform Resource Locator (URL) tai Uniform Resource Name (URN), ja se palauttaa jonkin seuraavista totuusarvoista:

Tosi    Lomake on löytänyt ulkoisen tietolähteen verkossa.

Epätosi    Lomake ei löydä ulkoista tietolähdettä. Ulkoinen tietolähde voi olla offline-tilassa tai verkossa, jossa se ei kuitenkaan ole käytettävissä.

Tämän artikkelin komentosarjaesimerkit määrittävät vain, onko lomake yhdistetty verkkoon. Komentosarjaesimerkkejä käytetään tässä artikkelissa, kun käyttäjä avaa lomakkeen. Voit kuitenkin myös aina halutessasi tarkistaa verkkoyhteyden ennen toiminnon suorittamista tämän komentosarjan avulla. Voit esimerkiksi käyttää tätä komentosarjaa käyttäjän napsauttaessa tiettyä lomakkeen painiketta, kun haluat määrittää, onko ulkoiseen tietolähteeseen muodostettu verkkoyhteys. Huolimatta siitä, milloin käytät tätä komentosarjaa, voit myös lisätä komentosarjan, joka suorittaa toiminnon sen perusteella, onko lomake yhdistetty verkkoon vai ei. Jos tietokone on esimerkiksi offline-tilassa tai et voi yhdistää ulkoiseen tietolähteeseen, voit antaa InfoPathin näyttää käyttäjälle varoitussanoman, joka ilmoittaa, ettei ulkoinen tietolähde ole käytettävissä. Voit mukauttaa varoitussanoman niin, että se ilmoittaa käyttäjille, mitä heidän tulee tehdä, jos ulkoinen tietolähde ei ole käytettävissä. Voit esimerkiksi pyytää heitä täyttämään lomakkeen myöhemmin tai pyytää heitä ottamaan yhteys tukipalveluun.

Sivun alkuun

JScript-esimerkki

var machineState = Application.MachineOnlineState;
var displayMessage = machineState;
switch(machineState)
{
case 0:
{
displayMessage = "The computer is not connected to a network.";
break;
}
case 1:
{
if (!Application.IsDestinationReachable("http://example"))
{
displayMessage = "The computer is connected to a network, "
+ "but the external data source is not "
+ "available. Contact the data source "
+ "administrator for more information.";
}
else
{
displayMessage = "The computer is connected to a network.";
}
break;
}
case 2:
{
displayMessage = "The computer is connected to a network, but "
+ "Internet Explorer is in offline mode. Some "
+ "data connections may not work until you "
+ "set Internet Explorer to online mode. To "
+ "switch to online mode, on the File menu in "
+ "Internet Explorer, click Work Offline.";
break;
}
default:
{
displayMessage = "An unknown error occurred: Error: "
+ machineState;
}
}
XDocument.UI.Alert(displayMessage);

Sivun alkuun

VBScript-esimerkki

Dim machineState, displayMessage, returnValue
machineState = Application.MachineOnlineState
displayMessage = machineState
returnValue = False
Select Case machineState
Case 0
displayMessage = "The computer is not connected to a network."
Case 1
returnValue = Application.IsDestinationReachable("http://example")
If returnValue = False Then
displayMessage = "The computer is connected to a network, but "
displayMessage = displayMessage + "the external data source is "
displayMessage = displayMessage + "not available. Contact the "
displayMessage = displayMessage + "data source administrator "
displayMessage = displayMessage + "for more information."
Else
displayMessage = "The computer is connected to a network."
End If
Case 2
displayMessage = "The computer is connected to a network, but "
displayMessage = displayMessage + "Internet Explorer is in "
displayMessage = displayMessage + "offline mode. Some data "
displayMessage = displayMessage + "connections may not work "
displayMessage = displayMessage + "until you set Internet "
displayMessage = displayMessage + "Explorer to online mode. "
displayMessage = displayMessage + "To switch to online mode, "
displayMessage = displayMessage + "on the File menu in "
displayMessage = displayMessage + "Internet Explorer, click "
displayMessage = displayMessage + "Work Offline."
Case Else
displayMessage = "An unknown error occurred: Error: "
displayMessage = displayMessage + machineState + "."
End Select
XDocument.UI.Alert(displayMessage)

Sivun alkuun

Komentosarjaesimerkin käyttäminen lomakemallissa

Jos haluat testata komentosarjaesimerkkiä, ennen kuin käytät sitä lomakemallissa, voit luoda tyhjän lomakemallin seuraavan menettelyn avulla ja kopioida sitten toisen tämän artikkelin komentosarjaesimerkeistä OnLoad-tapahtumaan. OnLoad-tapahtuman komentosarja suoritetaan aina, kun luodaan uusi lomakemalliin perustuva lomake. Sen jälkeen voit testata esikatselun avulla komentosarjaesimerkin tietokoneessa, joka on yhdistetty verkkoon, joka ei ole yhteydessä verkkoon tai joka on yhdistetty verkkoon, mutta Internet Explorer on määritetty offline-tilaan.

  1. Kopioi toinen tässä artikkelissa esitetyistä komentosarjaesimerkeistä ja liitä se sitten tekstieditoriin, kuten Microsoft Notepadiin.

    Huomautus: Kun kopioit komentosarjaesimerkin tekstieditoriin ennen sen lisäämistä lomakemalliin, estät Hypertext Markup Language (HTML) -muotoilumerkkien näkymisen komentosarjassa.

  2. Napsauta InfoPathissa Tiedosto-valikosta Suunnittele lomakemalli.

  3. Napsauta Lomakemallin suunnitteleminen -valintaikkunan Suunnittele uusi -kohdasta Lomakemalli, napsauta Tyhjä ja napsauta sitten OK.

  4. Oletusarvon mukaan uudet lomakemallit määritetään käyttämään JScriptiä komentosarjakielenä. Jos haluat käyttää VBScriptiä komentosarjakielenä, muuta lomakemallin komentosarjakieli.

    Toimintaohjeet

    1. Napsauta Työkalut-valikosta Lomakkeen asetukset.

    2. Napsauta Luokka-luettelosta Ohjelmointi.

    3. Napsauta Ohjelmointikieli-kohdan Lomakemallin koodin kieli -luettelosta VBScript ja napsauta sitten OK.

  5. Osoita Työkalut-valikosta Ohjelmointi ja napsauta sitten Lataamistapahtumassa. Microsoft Script Editor käynnistyy osoittimen ollessa OnLoad-tapahtumassa.

  6. Korvaa Microsoft Script Editorin OnLoad-tapahtumassa // Write your code here (JScript)- tai ' Write your code here (VBScript) -teksti tekstieditoriin kopioimallasi komentosarjaesimerkillä.

  7. Muokkaa komentosarjaesimerkkiä ympäristöön sopivaksi. Voit esimerkiksi muokata viestejä ja muuttaa ulkoisen tietolähteen URL:ään tai URN:ään http://example.

  8. Napsauta Microsoft Script Editorissa Tiedosto-valikosta Tallenna.

  9. Testaa muutokset valitsemalla vakiotyökaluriviltä Esikatselu tai painamalla CTRL+VAIHTO+B-näppäinyhdistelmää.

Sivun alkuun

Kehitä taitojasi
Tutustu koulutusmateriaaliin
Saat uudet ominaisuudet ensimmäisten joukossa
Liity Office Insider -käyttäjiin

Oliko näistä tiedoista hyötyä?

Kiitos palautteesta!

Kiitos palautteestasi! Näyttää siltä, että Office-tukiedustajamme avusta voi olla sinulle hyötyä.

×