Vormimalli konfigureerimine vormi ühenduse oleku tuvastamiseks

NB! :  See artikkel on masintõlgitud, vaadake lahtiütlust. Selle artikli ingliskeelse versiooni leiate aadressilt (viiteks).

Kui koostate vormimalli, mille vormid sõltuvad võrguühendus töödelda või tagasi andmete ja olete tuttav skripti kirjutamise, saate kirjutada skripti, mis tuvastab võrguühenduse oleku teie vormimallil põhinevaid vorme. Saate kontrollida, kas uue vormi on ühendatud võrku, ning kui vormi saate luua ühenduse välise andmeallikaga enne vormi saadab päringu välise andmeallika Microsoft Office InfoPathi selle skripti. Selles artiklis antakse võrku ühendatud JScripti ja Visual Basic Scripting Editioni (VBScript) näiteid, millega, kui teie vormimallil põhinevaid vorme ja kui nende vormide saate luua ühenduse välise andmeallikaga.

Selle artikli teemad

Ülevaade

JScripti näide

VBScripti näide

Näiteskripti kasutamine vormimallil

Ülevaade

Teie vormimallil põhineva vormi võrguühenduse oleku tuvastamiseks kasutage objekti Application suvandit MachineOnlineState. Seejärel saate kasutada samal objektil Application meetodit IsDestinationReachable, mis tuvastab, kas vorm suudab leida välise andmeühenduse. Suvand MachineOnlineState sisaldab väärtust, mis esindab vormi ühenduse olekut. Sellel suvandil võivad olla järgmised väärtused.

Väärtus

Kirjeldus

0

Arvuti ei ole võrku ühendatud. Suvandi väärtuseks on null, kui arvuti ei ole võrku ühendatud või kui arvuti võrgukaart on keelatud.

1

Arvuti on võrku ühendatud. Kui arvuti ühendamisel võrku kasutatakse võrgukaablit, siis näitab see väärtus, et arvuti on võrku ühendatud. Kui arvuti ühendamisel võrku kasutatakse traadita side võrgukaarti, siis näitab see väärtus, et võrgukaart töötab. Arvuti ei pruugi siiski olla traadita võrku ühendatud.

2

Arvuti on võrku ühendatud, kuid Windows Internet Explorer on konfigureeritud töötamiseks võrguühenduseta. Kui Internet Explorer on konfigureeritud töötamiseks võrguühenduseta, ei pruugi andmebaasi või veebiteenusega loodav andmeühendus korralikult töötada.

Kui olete kontrollinud, kas kasutaja arvutil on võrguühendus või mitte, saate kasutada meetodit IsDestinationReachable, mis määratleb, kas vorm saab välise andmeallikaga suhelda. Selle puhul kasutatakse välise andmeallika URL-i või URN-i parameetrina ja see meetod tagastab ühe järgmistest kahendväärtustest.

Tõene     – vorm leidis võrgus välise andmeallika.

Väär     – vorm ei leia välist andmeallikat. Väline andmeallikas võib olla võrguühenduseta või on küll võrgus, aga pole saadaval.

Selles artiklis toodud näiteskriptid aitavad ainult määratleda, kas vormil on võrguühendus. Näiteskripte kasutatakse siis, kui kasutaja avab vormi esmakordselt. Siiski saate seda skripti kasutada ka suvalisel hetkel mõne toimingu jaoks vajalikuks osutuva võrguühenduse kontrollimiseks. Näiteks saate selle skripti abil kontrollida, kas välise andmeallikaga on võrguühendus olemas (kasutaja klõpsab mingit kindlat vorminuppu). Olenemata sellest, millal otsustate skripti kasutada, saate lisada ka skripti, mis teeks vajaliku toimingu (sõltuvalt sellest, kas vormil on võrguühendus või mitte). Kui näiteks arvuti on võrguühenduseta või ei saa luua ühendust välise andmeallikaga, saate määrata InfoPathi kuvama kasutajale hoiatusteadet, mis osutab, et väline andmeallikas pole saadaval. Saate kasutaja juhendamiseks hoiatusteadet kohandada, et kasutaja teaks, mida teha juhul, kui väline andmeallikas pole saadaval. Näiteks saate paluda neil proovida hiljem vormi täita või pöörduda abi saamiseks tugiteenuste pakkuja poole.

Lehe algusse

JScripti näide

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);

Lehe algusse

VBScripti näide

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)

Lehe algusse

Näiteskripti kasutamine vormimallil

Kui soovite näiteskripti katsetada enne selle kasutamist oma vormimallil, saate järgmise toimingu abil luua tühja vormimalli ja seejärel kopeerida ühe selles artiklis toodud näiteskripti sündmusele OnLoad. Sündmuses OnLoad käivitub skript iga kord, kui luuakse vormimallil põhinev uus vorm. Seejärel saate vaadata oma vormimalli eelvaadet, et katsetada näiteskripti võrguühendusega arvutis, võrguühenduseta arvutis või võrguühendusega arvutis, kus Internet Explorer on seatud võrguühenduseta režiimi.

  1. Kopeerige üks näiteskriptidest (selle artikli varasemas teemas) ja kleepige see tekstiredaktorisse (nt Microsoft Notepad).

    Märkus. : Näiteskripti kopeerimine tekstiredaktorisse enne vormimallile lisamist hoiab ära HTML-i vormindusmärkide kuvamise skriptis.

  2. Klõpsake InfoPathi menüüs Fail käsku Kujunda vormimall.

  3. Klõpsake dialoogiboksi Vormimalli kujundamine jaotises Kujunda uus raadionuppu Vormimall, varianti Tühi ja seejärel nuppu OK.

  4. Vaikimisi seatakse uus vormimall kasutama skriptimiskeelt JScript. Skriptimiskeelena VBScript kasutamiseks muutke vormimalli skriptimiskeel.

    Kuidas?

    1. Klõpsake menüü Tööriistad käsku Vormisuvandid.

    2. Klõpsake loendis Kategooria valikut Programmeerimine.

    3. Jaotises Programmeerimiskeel klõpsake loendis Vormimalli koodi keel väärtust VBScript ja seejärel nuppu OK.

  5. Valige menüü Tööriistad käsk Programmeerimine ja seejärel klõpsake käsku Laadimise sündmus. Käivitatakse Microsoft Script Editor ja kursor asub sündmuses OnLoad.

  6. Microsoft Script Editoris asendage sündmuses OnLoad tekst // Write your code here (JScript) või ' Write your code here (VBScript) tekstiredaktorisse kopeeritud näiteskriptiga.

  7. Muutke näiteskript kasutatavale keskkonnale vastavaks. Näiteks saate muuta sõnumeid ning muuta http://näide oma välise andmeallika URL-iks või URN-iks.

  8. Klõpsake Microsoft Script Editori menüüs Fail käsku Salvesta.

  9. Muudatuste kontrollimiseks klõpsake tööriistaribal Standard nuppu Eelvaade või vajutage klahvikombinatsiooni CTRL+SHIFT+B.

Lehe algusse

Märkus. : Masintõlke lahtiütlus. Selle artikli tõlkis arvutisüsteem ilma inimese sekkumiseta. Microsoft pakub selliseid masintõlkeid, et inglise keelt mittekõnelevad kasutajad saaksid vaadata sisu Microsofti toodete, teenuste ja tehnoloogiate kohta. Kuna artikkel on masintõlgitud, võib see sisaldada sõnavara-, süntaksi- või grammatikavigu.

Täiendage oma oskusi
Tutvuge koolitusmaterjalidega
Kasutage uusi funktsioone enne teisi
Liituge Office Insideri programmiga

Kas sellest teabest oli abi?

Täname tagasiside eest!

Täname tagasiside eest! Tundub, et võiksime teid kokku viia ühega meie Office'i tugiagentidest, kes aitab teil probleemi lahendada.

×