Űrlapsablon testreszabása parancsfájl használatával

A témakör tartalma

• – Áttekintés

• Kompatibilitási kapcsolatos szempontok

• Űrlapsablon parancsnyelvének beállítása

• Minden alkalommal, amikor egy esemény üzenet megjelenítése

• Futtatja, ha egy felhasználó az űrlap adatainak mentése parancsfájlok hozzáadása

• Az űrlap adatainak a felhasználó által beadott futó parancsfájlok hozzáadása

• Adja meg a parancsfájlt, lefut, amikor a felhasználó a gombra kattint

• Meglévő űrlapot egyesítésekor futtató parancsfájlok hozzáadása

• A meglévő űrlapot frissítése parancsfájlok hozzáadása

• Más események parancsfájlok hozzáadása

Áttekintés

Testre szabhatja az InfoPath-űrlapsablonná szabályok, a képletek, az adatok érvényesítése és a feltételes formázás használatával. Bár ezek a funkciók rugalmas, és kezelheti a feladatokat számos különböző, ezek a funkciók a funkcióinak túl vannak a tevékenységek. Ha például szabályok használatával nem lehet e-mail üzenet küldése, amikor a felhasználó szövegdoboz értéket ad egy űrlapon. Ha testre szeretné szabni űrlapsablon oly módon, amely túl az ezek a szolgáltatások és funkciók ismerősek parancsfájlok írása a JScript vagy VBScript parancsfájl nyelv használatával, és felvehet olyan parancsfájlt, ami lefut, amikor a felhasználó új űrlap megnyitása vagy módosítja egy ex tlook űrlapot, amely az űrlapon.

Parancsfájl űrlapsablon beállításakor az InfoPath elindítja a Microsoft Script Editor (MSE), amely lehetővé teszi, hogy hozzáadása, szerkesztése és parancsfájlok hibakeresése űrlapsablon, és elhelyezi a kurzort a választott esemény. Az InfoPath eseménykezelő automatikusan hozzáadja a parancsfájl. Eseménykezelő az InfoPath-űrlapsablonná felhasználói műveletek és az XML-adatok űrlapokon módosításának válaszoló lévő függvény kódot. Például ha azt szeretné, hogy a felhasználóknak, hogy azok űrlapok mentése több hálózati helyek, vehet egy parancsprogramot OnSaveRequest eseménykezelő. Amikor felvesz egy parancsfájl, amikor a felhasználó menti a sablonon alapuló űrlap futtatásához, az InfoPath elindítja a parancsfájl-szerkesztő, és felveszi végre a következő kódokat a a parancsfájl.

//=======
// The following function handler is created by Microsoft Office InfoPath.
// Do not modify the name of the function, or the name and number of arguments.
//=======
function XDocument::OnSaveRequest(eventObj)
{
   // Write the code to be run before saving here.
   eventObj.IsCancelled = eventObj.PerformSaveOperation();
   // Write the code to be run after saving here.
   eventObj.ReturnStatus = true;
}

'=======
' The following function handler is created by Microsoft Office InfoPath.
' Do not modify the name of the function, or the name and number of arguments.
'=======
Sub XDocument_OnSaveRequest(eventObj)
' Write the code to be run before saving here.
eventObj.IsCancelled = eventObj.PerformSaveOperation
' Write the code to be run after saving here.
eventObj.ReturnStatus = True
End Sub

Kompatibilitási kapcsolatos szempontok

Parancsfájl nem vehet fel egy böngészőkompatibilis űrlapsablon. Parancsfájl csak egy űrlapsablon, amelynek űrlapokat az InfoPath alkalmazásban csak kitöltendő adhat hozzá. Testre szabhatja a böngészőkompatibilis űrlapsablon csak felügyelt kód segítségével.

Vissza a lap tetejére

Űrlapsablon parancsnyelvének beállítása

Űrlapsablon parancsfájl használatával testreszabásához Microsoft JScript vagy a Microsoft Visual Basic Scripting Edition (VBScript) is használhatja. Az InfoPath alapértelmezés szerint be van állítva parancsfájl felvétele JScript használatával. Ha űrlapsablon nem tartalmaz, felügyelt kódot vagy parancsfájlt, és a parancsfájlok futtatásának VBScript használni szeretne, VBScript űrlapsablonhoz módosíthatja a parancsfájlok futtatásának nyelvet. Az azonos űrlapsablon mindkét parancsfájlok nyelv nem használhatók.

Ha az űrlapsablon már tartalmaz egy parancsfájl, és a más nyelven használni kívánt, akkor kell-e menteni a meglévő parancsfájlt, úgy, hogy a parancsprogram átalakítása más nyelven a parancsfájl eltávolítása az űrlapsablont, a Képernyő-beállítások között párbeszédpanel mezőbe, és kattintson a konvertált parancsfájl újbóli hozzáadásához az űrlapsablon. Az InfoPath nem konvertálható parancsfájlok parancsfájlok új nyelv. Az űrlapsablon csak az Űrlapbeállítások párbeszédpanelen a parancsprogram nyelvének módosítása érinti. Más űrlapsablonok JScript fog rendelkezni, az alapértelmezett nyelv parancsfájlok.

1. Kattintson az eszközök menü Beállítások képernyőn.

2. Kattintson a kategória lista Űrlapbeállítások párbeszédpanelen programozási.

3. Az űrlapsablon kódolási nyelve listában programozási nyelven, kattintson az VBScript.

   Megjegyzések: 

   • Miután a parancsfájlok futtatásának nyelvét, és hozzon létre egy vagy több eseménykezelők az űrlapsablon, az űrlapsablon parancsnyelvének nem módosítható.

   • Ha telepítve van a Microsoft Visual Studio 2005 Tools for Applications, az alapértelmezett nyelv a Microsoft Visual Basic .NET. Ez az eljárás használatával is VBScript parancsfájl nyelvét.

Vissza a lap tetejére

Minden alkalommal, amikor egy esemény üzenet megjelenítése

Ha szeretné, hogy milyen eseménykezelők művelet vagy egyéb esemény válaszul futtatni, ideiglenes kód eseménykezelő fut, amikor egy üzenetben megjelenítendő is hozzáadhat. Csak a megállapítani, hogy mikor eseménykezelő fut, a kód kell használni. Miután felvette a kód, is használhatja előzetes megtekintése az ezen a sablonon alapuló űrlap vagy az űrlapsablon közzététele, és hozzon létre egy új űrlapsablon. Néhány eseménykezelők futtatása csak akkor, ha az űrlapsablon közzététel után űrlapot hoz létre. Kattintson egy műveletet, amely úgy gondolja, hogy az eseménykezelő működni végezheti el. Eseménykezelő fut, amikor egy üzenetben megjelenik.

Meghatározhatja, hogy milyen műveleteket, vagy események eseménykezelő futtatása után távolítsa el a kódot, és ezután folytathatja az űrlapsablon tervezése. Kód nem távolítja el, és kattintson az űrlapsablon közzététel, ha a felhasználók az üzenetpanel jelenik meg az eseménykezelő futtatásakor.

1. Adja hozzá a eseménykezelő.

2. JScript kódot hozzáadni, írja be a XDocument.UI.Alert ("az esemény nevét esemény csak futtatta"); Cserélje a eseménykezelő nevét. Ez a kód hozzáadása a OnValidate eseménykezelő, ha meg szeretné írja be például a XDocument.UI.Alert ("a OnValidate eseménykezelő csak futtatta");

3. Kód hozzáadása a VBScript, például írja XDocument.UI.Alert ("az esemény nevét esemény csak futtatta") , ha ez a kód hozzáadása a OnSaveRequest eseménykezelő, írja be a XDocument.UI.Alert ("a OnSaveRequest eseménykezelő csak futtatta")

4. A kód teszteléséhez kattintson a fájl menü, kattintson az Előnézet gombra vagy nyomja le a CTRL + SHIFT + B, és majd végezze el az esemény együttes felhasználói műveletek. Az esemény kód vonallal bekövetkezésekor egy üzenetben megjelenjen-e meg az üzenetet.

   Megjegyzés: Bizonyos eseményeket megkövetelheti, hogy az űrlapsablon közzététele, és kattintson az ezen a sablonon alapuló az esemény indítása felhasználói műveletek végrehajtása előtt űrlap létrehozása.

5. Mielőtt az űrlapsablon közzététele és engedélyezése a felhasználóknak, hogy az ezen a sablonon alapuló űrlapok kitöltése, törölje a kódot, amellyel az üzenet mezőbe.

Vissza a lap tetejére

Futtatja, ha egy felhasználó az űrlap adatainak mentése parancsfájlok hozzáadása

1. Kattintson az eszközök menü Beállítások képernyőn.

2. A kategória listában Űrlapbeállítások párbeszédpanelen kattintson a Megnyitás és mentés.

3. Viselkedés menteni, csoportban jelölje be az egyéni kód használatával mentése jelölőnégyzetet, és kattintson a Szerkesztésgombra. A Microsoft Script Editor a kurzor az OnSaveRequest eseménykezelő a kezdődik.

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnSaveRequest(eventObj)
   {
      // Write the code to be run before saving here.
      eventObj.IsCancelled = eventObj.PerformSaveOperation();
      // Write the code to be run after saving here.
      eventObj.ReturnStatus = true;
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnSaveRequest(eventObj)
   ' Write the code to be run before saving here.
   eventObj.IsCancelled = eventObj.PerformSaveOperation
   ' Write the code to be run after saving here.
   eventObj.ReturnStatus = True
   End Sub
   

4. Végezze el az alábbi műveleteket:

   • Az InfoPath menti az űrlap előtt futó parancsfájl hozzáadásához, a kód a Megjegyzés Write the code to be run before saving here.cserélje.

   • Olyan parancsfájlt, ami futása után az InfoPath menti az űrlap hozzáadásához cserélje le a Megjegyzés Write the code to be run after saving here. a kódot.

5. A módosítások teszteléséhez kattintson a Minta gombra a szokásos eszköztáron, vagy nyomja le a CTRL+SHIFT+B billentyűkombinációt.

   Megjegyzés: Eseménykezelő fut, csak azt követően a sablonon alapuló űrlapot hoz létre, ha a fájl menüben kattintson a Közzététel az űrlapsablon közzététele, és kattintson a közzétételi varázsló. Az űrlapsablon közzététel után űrlap létrehozása, és kattintson egy műveletet a eseménykezelő futtatásához.

Vissza a lap tetejére

Az űrlap adatainak a felhasználó által beadott futó parancsfájlok hozzáadása

1. Kattintson az eszközök menü Beállítások elküldése.

2. A Küldés beállításai párbeszédpanelen jelölje be a engedélyezése a felhasználóknak az űrlap elküldése jelölőnégyzetet.

3. Kattintson a kód használatával egyéni művelet végrehajtása, és kattintson a Kód szerkesztésegombra. A Microsoft Script Editor a kurzor az OnSubmitRequest eseménykezelő a kezdődik.

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnSubmitRequest(eventObj)
   {
      // If the submit operation is successful, set
      // eventObj.ReturnStatus = true;
      // Write your code here
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnSubmitRequest(eventObj)
   ' If the submit operation is successful, set
   ' eventObj.ReturnStatus = True
   ' Write your code here
   End Sub
   

4. A Megjegyzés If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here cserélje le a kódot.

5. A módosítások teszteléséhez kattintson a Minta gombra a szokásos eszköztáron, vagy nyomja le a CTRL+SHIFT+B billentyűkombinációt.

Vissza a lap tetejére

Adja meg a parancsfájlt, lefut, amikor a felhasználó a gombra kattint

1. Új gomb felvétele egy nézetbe, az űrlapsablon, és kattintson duplán a gombra.

   Megjegyzés: Parancsfájl hozzáadni egy meglévő gombra, ha inkább kattintson duplán a meglévő gombra.

2. Kattintson az Általános fülre.

3. Kattintson az űrlap kód szerkesztésegombra. A Microsoft Script Editor elindítja a kurzor a e button OnClick eseménykezelő.

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function Button Name::OnClick(eventObj)
   {
   // Write your code here
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub Button Name_OnClick(eventObj)
   ' Write your code here
   End Sub
   

4. A Megjegyzés Write your code here cserélje le a kódot.

5. A módosítások teszteléséhez kattintson a Minta gombra a szokásos eszköztáron, vagy nyomja le a CTRL+SHIFT+B billentyűkombinációt.

Vissza a lap tetejére

Meglévő űrlapot egyesítésekor futtató parancsfájlok hozzáadása

1. Kattintson az eszközök menü Beállítások képernyőn.

2. A kategória listában Űrlapbeállítások párbeszédpanelen kattintson a Speciálisgombra.

3. Kattintson az Űrlapok egyesítésecsoportban jelölje ki az űrlapok egyesítését engedélyezése jelölőnégyzetet.

4. Jelölje be a egyesítése egyéni kód használata jelölőnégyzetet, és kattintson a Szerkesztésgombra. A Microsoft Script Editor elindítja a kurzor a OnMergeRequest eseménykezelő.

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnMergeRequest(eventObj)
   {
   // Write the code that handles each form being merged here.
   XDocument.ImportDOM(eventObj.DOM);
   eventObj.ReturnStatus = true;
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnMergeRequest(eventObj)
   ' Write the code that handles each form being merged here.
   XDocument.ImportDOM(eventObj.DOM)
   eventObj.ReturnStatus = True
   End Sub
   

5. A Megjegyzés Write the code that handles each form being merged here. cserélje le a kódot.

6. Ebben az esetben a kód teszteléséhez az űrlapsablon közzététele, több, ezen a sablonon alapuló űrlapok létrehozása és az űrlapsablonok majd egyesítése.

   Megjegyzés: További információt az űrlapsablon közzététele a Lásd még szakasz hivatkozásait.

Vissza a lap tetejére

A meglévő űrlapot frissítése parancsfájlok hozzáadása

Ha egy korábban közzétett űrlapsablon frissített, és az űrlapokra, a képernyő sablonon alapuló frissíteni szeretné, parancsfájl vehet a frissített űrlapsablon, lefut, amikor a felhasználó megnyitja az űrlapokra közül. Amikor a felhasználó megnyit egy meglévő űrlap, az InfoPath a Közzététel helye a vele társított űrlapsablon verziószámának ellenőrzi. Az űrlapsablon közzététel helyen verziószáma újabb, mint a meglévő űrlapra a verziószámot, ha jelezve, hogy frissült, az InfoPath futtatja a kódot ebben az esetben a meglévő képernyő frissítéséhez.

1. Kattintson az eszközök menü Beállítások képernyőn.

2. A kategória lista Űrlapbeállítások párbeszédpanelen kattintson a verziószámozás.

3. Verzióját frissítése listájában használata egyéni eseménygombra, és kattintson a Szerkesztésgombra. A Microsoft Script Editor a kurzor Az OnVersionUpgrade a kezdődik.

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnVersionUpgrade(eventObj)
   {
   // Write your code here
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnVersionUpgrade(eventObj)
   ' Write your code here
   End Sub
   

4. A Megjegyzés Write your code here cserélje le a kódot.

5. Tesztelje a kód ebben az esetben, az űrlapsablon közzététele, több űrlap létrehozása az űrlapsablon alapján, módosítása és az űrlapsablon frissített verziójának közzététele és nyissa meg a egy meglévő űrlap alapján az űrlapsablon régebbi verzióit.

   Megjegyzés: További információt az űrlapsablon közzététele a Lásd még szakasz hivatkozásait.

Vissza a lap tetejére

Más események parancsfájlok hozzáadása

Ez az eljárás a következő eseménykezelők hozzáadása űrlapsablonhoz használható:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• Betöltésre

• OnSwitchView

• OnSign

• OnValidate

• Kattintson az eszközök menü programozásipontjára, és kattintson az esemény hozzáadása a eseménykezelő. A Microsoft Script Editor elindítja a kurzor a kijelölt eseménykezelő.

• A Megjegyzés Write your code here cserélje le a kódot.

Vissza a lap tetejére