Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Automatically translated by Lango

Vyberte ikonu lupy napište Položky fronty úloh a poté vyberte související odkaz.

Nová položka se vytváří ze seznamu fronty úloh tlačítkem Nový. Seznam fronty úloh vyhledáte kliknutím na Ikonu lupy (Hledat) a vypsáním části textu „Položky fronty úloh”.

Po kliknutí na tlačítko Nový se otevře nová Karta položky fronty úloh.

Popis tlačítek v horní liště:

Záložka Proces (Proces):

  • Nastavit stav na připraveno (Set status to Ready)

    • Stav, v kterém se úloha spouští podle nastavených parametrů

  • Restartovat (Restart)

    • Pokud je úloha v jinem stavu jako „ Připraveno“ tak pomocí tlačítka Restartovat se úloha dostane do stavu „Přípraveno“

  • Zobrazit chybu (Show Error)

    • Pokud úloha skončila na chybu, kliknutím na toto tlačítko se zobrazí Chybová zpráva  s popisem chyby

  • Nastavit Vyčkávat (Set on Hold)

    • Pokud chcete měnit parametre nebo nechcete aby se úloha nějaký čas spouštela nastavíte tlačítkem na stav „Vyčkávat“

  • Spustit jednou (popředí) (Run once (foreground)

    • Po kliknutí na tlačítko se jednou spustí kópie otevřené úlohy. Toto spuštení nemá vlyv na nastavení dané úlohy. Neposouva dané úloze den ani cas spuštení. Uloha se jenom jako kopie spustí a vykoná danou akci.

    • Tato kopie nezaznamená ani řádek v položkách protokolu a v případe chyby ani nezapíše chybu do seznamu chybových zpráv. Chybu s popisem jenom zobrazí po ukončení úlohy v chybové hlášce.

Záložka Fronta úloh (Job queue):

  • Dialog sestavy (Report request page)

    • Pro Typ spouštěného objektu = úlohu typu „Sestava“ je možné spustiť úlohu, která bude filtrovaná možnostemi v dial.okne daé sestavy. Po nastavení dial.okna se přepne pole Parametry dialogu sestavy na hodnotu = ANO

  • Zobrazit záznam (Show Record)

    • Pokud je úloha s dokumenten uloženým v interní databáze, může si ho uživatel tlačítkem zobrazit. (např. faktura)

  • Položky protokolu (Log Entries)

    • Seznam s položkami ukončených úloh. Uživatel vidí s akým stavem úloha skončila, chybové správy

 

Pole:

Záložka obecné (General)

  • Typ spouštěného objektu (Object Type to Run)

    • Určuje typ objektu, reportu nebo procedury, která se spustí pro položku fronty úloh. Poté co určíte typ, vyberte ID objektu tohoto typu v poli ID objektu ke spuštění.

    • Pokud se vybere typ „Procedura“ nebude k dispozici záložka Parametry sestavy

  • ID spouštěného objektu (Object ID to Run)

    • Určuje ID objektu, který je určen k spuštění této práce. Můžete vybrat ID, které je jenom z typu objektu, který jste určili v poli Typ objektu ke spuštěni.

  • Titulek spouštěného objektu (Object Caption to Run)

    • Název objektu, který je zvolen v poli ID spouštěného objektu.

  • Popis (Description)

    • Popis položky fronty úloh. Popis můžete upravovat a aktualizovat na kartě položky fronty úloh. Popis se zobrazí také v okně položky fronty úloh, ale nelze ho aktualizovat.

  • Řetězec parametrů (Parameter String)

    • Určuje textový řetězec, který je použit jako parametr front úloh, když je spuštěna.

  • Kód kategorie fronty úloh (Job Queue Category Code)

    • Určuje kód kategorie fronty úloh, do které položka fronty úloh patří. Vyberte pole ke zvolení kódu ze seznamu.

  • ID uživatele (User ID)

    • Určuje ID uživatele, který úlohu nastavil na připravenu.

  • Maximální počet pokusů o spuštění (Maximum No. of Attempts to Run)

    • Typ pole Integer

    • Velkost 4

    • Určuje, kolikrát by měla být úloha fronty úloh znovu spuštěna v případě, že se vyskytne chyba. Toto je užitečné v situaci, ve které úloha neodpovídá. Např. úloha neodpovídá, protože závisí na externím zdroji, který je nedostupný.

  • Počet pokusů o spuštění (No. of Attempts to Run)

    • Typ pole Integer

    • Velkost 4

    • Určuje, kolik sekund bude systém čekat před opětovným spuštěním této úlohy fronty úloh v případě selhání.

  • Poslední změna na Připraveno (Last Ready State)

    • Určuje datum a čas, kdy byla naposledy položka fronty úloh nastavena na připraveno a odeslána do fronty úloh.

  • Datum a čas prvního spuštění (Earliest Start Date/Time)

    • Typ pole Datatime

    • Hodnota v poli ukazuje čas příštího spuštění úlohy. Existuje několik faktorů, které mohou ovlivnit, zda se položka fronty úloh v daném okamžiku skutečně spustí. Nejběžnějšími faktory jsou počet položek fronty úloh v prostředí a celkový počet naplánovaných úloh. Pro ochranu úrovní výkonu existují provozní limity. Pokud máte ve frontě velké množství položek a například jedna z nich selže nebo položky trvají déle, než se čekalo, další úloha se nemusí spustit v očekávaném čase. Pokud máte jednotky kódu, které generují 100 000 nebo více naplánovaných úloh, měli byste prozkoumat, jestli skutečně potřebujete všechny tyto úlohy. Seznam všech naplánovaných úloh je k dispozici na stránce Naplánované úlohy.

  • Datum a čas expirace (Expiration Date/Time)

    • Typ pole Datatime

    • Určuje datum a čas vypršení platnosti položky fronty úloh, po kterém nebude položka fronty úloh spuštěna. Formát data a času musí být měsíc/den/rok hodina: minuta 10. 3. 2021 12:00.

  • Časový limit úlohy (Job Timeout)

    • Určuje maximální dobu, po kterou může být položka fronty úloh spuštěna

  • Stav (Status)

    • Určuje stav položky řady úloh. Když vytvoříte řadu úloh, je stav nastaven na Přidrženo. Můžete stav nastavit na Připraveno nebo zpět na Přidrženo. Jinak se stav v tomto poli aktualizuje automaticky

    • Stavy:

      • Vyčkávat (On Hold)

        • Výchozí stav položky fronty úloh při jejím vytvoření.

        • Vyberte akci Nastavit stav na Připraveno a změňte stav na Připraveno.

        • Výběrem akce Nastavit Vyčkávat vrátíte stav na Blokováno.

      • Připraveno (Ready)

        • Položka fronty úloh je připravena ke spuštění.

      • Probíhá (In Process)

        • Probíhá zadávání do fronty úloh. Toto pole se aktualizuje, když je fronta úloh spuštěna.

      • Chyba (Error)

        • Něco se pokazilo. Zvolte Zobrazit chybu, aby se zobrazila chybová zpráva

    • Dokončeno (Finished)

      • Položka fronty úloh je úspěšné dokončena.

    • Vyčkávat s časovým limitem nečinnosti (On hold with inaktivity Timeout)

    • Po úspěšném dokončení je úloha odebrána ze seznamu položek fronty úloh, pokud se nejedná o opakovanou úlohu. Pokud se jedná o opakovanou úlohu, pole Datum a čas prvního spuštění se upraví tak, aby ukazovalo příští očekávané spuštění úlohy

    • Stav Blokováno z důvodu nečinnosti se používá především pro položky fronty úloh, které plánují synchronizaci mezi Business Central a jinou aplikací, jako je například Dataverse. Pokud hodnota v tomto poli není nula a fronta úloh během posledního spuštění nenašla žádné změny, Business Central pozastaví položku fronty úloh.

    • Když k tomu dojde, v poli Stav fronty úloh se zobrazí stav “Blokováno z důvodu nečinnosti” a Business Central počká po dobu určenou v poli Časový limit nečinnosti, než znovu spustí položku fronty úloh.

Přiklad:

Například ve výchozím nastavení položka fronty úlohy MĚNA, která synchronizuje měny v Dataverse se směnnými kurzy v Business Central, bude hledat změny směnných kurzů každých 30 minut. Pokud nejsou nalezeny žádné změny, Business Central pozastaví položku fronty úloh.

Poznámka: Business Central automaticky aktivuje položky fronty úloh, které jsou pozastaveny, pouze v případě, že dojde ke změnám v Business Central. Změny v Dataverse neaktivují položky fronty úloh.

MĚNA na 720 minut (dvanáct hodin). Pokud dojde ke změně směnného kurzu v Business Central, zatímco je položka fronty úloh pozastavena, Business Central automaticky znovu aktivuje položku fronty úloh a restartuje frontu úloh.

Záložka Parametry sestavy (Report Parameters)

  • Parametry dialogu sestavy (Report Request Page Options)

    • Určuje, zda jsou nastavené možnosti v dialogovým okně parametrů pro danou úlohu. Pokud je políčko zvoleno, pak možnosti byly zvoleny pro rozvržení dané úlohy.

  • Typ výstupu sestavy (Report Output Type)

    • Určuje výstup plánované sestavy

  • Název tiskárny (Printer Name)

    • Určuje tiskárnu k použití k tisku plánované sestavy

Záložka Perioda (Recurrence)

...

Periodická úloha (Recurring Job)

  • Určuje, zda položka fronty úloh je periodická. Pokud je vybráno pole Periodická úloha, pak se položka fronty úloh opakuje. Pokud pole není vybráno, pak se položka fronty úloh neopakuje. Poté co určíte, že položka fronty úloh je periodická, musíte určit, které dny v týdnu se položka fronty úloh spouští. Volitelně také můžete určit čas dne pro spuštění úlohy a určit počet minut mezi spuštěními

...

Spustit v pondělí (Run on Mondays)

  • Určuje, že položka fronty úloh běží každé pondělí

...

Spustit v úterý (Run on Tuesdays)

  • Určuje, že položka fronty úloh běží každé úterý.

...

Spustit ve středu (Run on Wednesdays)

  • Určuje, že položka fronty úloh běží každou středu

...

Spustit ve čtvrtek (Run on Thursdays)

  • Určuje, že položka fronty úloh běží každý čtvrtek

...

Spustit v pátek (Run on Fridays)

  • Určuje, že položka fronty úloh běží každý pátek

...

Spustit v sobotu (Run on Saturdays)

  • Určuje, že položka fronty úloh běží v soboty

...

Spustit v neděli (Run on Sundays)

  • Určuje, že položka fronty úloh běží každou neděli

...

Vzorec data příštího spuštění (Next Run Date Formula)

  • Určuje vzorec data, který se použije k výpočtu příštího spuštění opakované položky fronty úloh. Pokud použijete vzorec data, všechna ostatní nastavení opakování budou vymazána

...

Počáteční čas (Starting Time)

  • Určuje, kdy nejdříve bude fronta úloh spuštěna.

...

Koncový čas (Ending Time)

  • Určuje nejpozdější dobu dne, kdy položka periodické fronty úloh má být spuštěna

...

Počet minut mezi spuštěními (No. of Minutes between Runs)

  • Určuje minimální počet minut, které mají uplynout mezi spuštěním položek fronty úloh. Hodnota nemůže být menší než jedna minuta. Toto pole má význam pouze v případě, že je položka fronty úloh nastavena jako opakovaná úloha. Pokud nepoužijete počet minut mezi jednotlivými spuštěními, je nastavení vzorce data vymazáno.

Časový limit nečinnosti (Inactivity Timeout Period)

...

Select the magnifying glass icon type Job Queue Entries , and then choose the related link.

A new item is created from the job queue list by clicking the New button. You can find a list of job queues by clicking on the Magnifying Glass Icon (Search) and typing the "Job Queue Items" section.

When you click New, a new Job Queue Item Card opens.

Description of the buttons in the top bar:

Process tab:

  • Set status to Ready

    • The state in which the task runs according to the set parameters

  • Restart

    • If the task is in a different state as "Ready", then using the Restart button will put the task in the "Ready" state

  • Show Error

    • If the task ended with an error, clicking this button displays an Error message with a description of the error

  • Set on Hold

    • If you want to change the parameters or do not want the task to run for some time, set the button to the "Waiting" state

  • Run once (foreground)

    • When the button is clicked, a copy of the open job is run once. This run does not affect the settings of the task. It doesn't shift the start day or time of the task. The task only runs as a copy and performs the action.

    • This copy does not record a single line in the log entries and, in the event of an error, does not write the error to the list of error messages. The error with a description is only displayed in the error message after the task is completed.

Job queue tab:

  • Report request page

    • For Object Type to be executed = task of the "Assembly" type, it is possible to run a task that will be filtered by the options in the dial.window of the report. After setting the dial. window, the Report Dialog Parameters field switches to = YES

  • Show Record

    • If the task is with a document stored in an internal database, the user can use the button to view it. (e.g. invoice)

  • Log Entries

    • A list of completed task entries. The user can see with whom the status of the job ended, error messages

 

Field:

General Tab

  • Object Type to Run

    • Specifies the type of object, report, or procedure that will be executed for the job queue item. After you specify a type, select an object ID of that type in the Object ID to run box.

    • If the "Procedure" type is selected, the Report Parameters tab will not be available

  • Object ID to Run

    • Specifies the ID of the object that is intended to run this work. You can select an ID that is only from the object type that you specified in the Object type to run field.

  • Object Caption to Run

    • The name of the object that is selected in the Object ID field.

  • Description

    • A description of the job queue entry. You can edit and update the description on the Job Queue Items tab. The description also appears in the job queue item window, but it cannot be updated.

  • Parameter String

    • Specifies a text string that is used as a parameter to job queues when it is executed.

  • Job Queue Category Code

    • Specifies the category code of the job queue to which the job queue item belongs. Select the field to choose a code from the list.

  • User ID

    • Specifies the ID of the user who set the task to ready.

  • Maximum No. of Attempts to Run

    • Array Type Integer

    • Size 4

    • Specifies how many times a job queue job should be rerun if an error occurs. This is useful in a situation in which the job is not responding. For example, a task does not respond because it depends on an external resource that is unavailable.

  • No. of Attempts to Run

    • Array Type Integer

    • Size 4

    • Specifies how many seconds the system will wait before rerunning this job queue job in the event of a failure.

  • Last Ready State

    • Specifies the date and time when the job queue item was last set to ready and sent to the job queue.

  • Earliest Start Date/Time

    • Datatime Field Type

    • The value in the field shows the time of the next time the task will run. There are several factors that can affect whether a job queue item actually runs at any given time. The most common factors are the number of job queue items in the environment and the total number of scheduled jobs. There are operating limits to protect power levels. If you have a large number of items in a queue and, for example, one of them fails, or the items take longer than expected, the next job may not start at the expected time. If you have units of code that generate 100,000 or more scheduled tasks, you should investigate whether you actually need all of those tasks. A list of all scheduled tasks is available on the Scheduled tasks page.

  • Expiration Date/Time

    • Datatime Field Type

    • Specifies the expiration date and time of the job queue item, after which the job queue item will not run. The date and time format must be month/day/year hour: minute 3/10/2021 12:00 PM.

  • Job Timeout

    • Specifies the maximum amount of time that a job queue item can run

  • Status

    • Specifies the status of the task series item. When you create a series of jobs, the status is set to On Hold. You can set the status to Ready or back to Hold. Otherwise, the status in this field is updated automatically

    • States:

      • On Hold

        • The default state of the job queue item when it is created.

        • Choose the Set Status to Ready action, and change the status to Ready.

        • Select the Set On Hold action to return the status to Blocked.

      • Ready

        • The job queue item is ready to run.

      • In Process

        • Job queue entry is in progress. This field is updated when the job queue is running.

      • Error

        • Something went wrong. Choose View Error to display the error message

    • Finished

      • The job queue entry is completed successfully.

    • On hold with inactivity Timeout

    • Upon successful completion, the job is removed from the list of job queue items, unless it is a recurring job. If the task is recurring, the First Starting Date and Time adjusts to show the next expected execution of the job

    • The Blocked due to inactivity status is used primarily for job queue items that schedule synchronization between Business Central and another application, such as Dataverse. If the value in this field is not zero and the job queue did not find any changes during the last run, Business Central suspends the job queue item.

    • When this happens, the Job Queue Status field displays a status of "Blocked due to Inactivity", and Business Central waits for the amount of time specified in the Idle Timeout field before rerunning the job queue item.

For example:

For example, by default, the CURRENCY job queue item that synchronizes currencies in Dataverse with exchange rates in Business Central will look for changes in exchange rates every 30 minutes. If no changes are found, Business Central suspends the job queue item.

Note: Business Central automatically activates job queue items that are paused only when changes occur in Business Central. Changes in Dataverse don't trigger job queue items.

CURRENCY for 720 minutes (twelve hours). If the exchange rate changes in Business Central while a job queue item is suspended, Business Central automatically reactivates the job queue item and restarts the job queue.

Report Parameters Tab

  • Report Dialog Parameters (Report Request Page Options)

    • Specifies whether options are set in the parameters dialog box for the job. If the check box is selected, then the options have been selected for the layout of the job.

  • Report Output Type

    • Specifies the output of the scheduled report

  • Printer Name

    • Specifies the printer to use to print the scheduled report

Period Tab (Recurrence)

  • Recurring Job

    • Specifies whether the job queue item is periodic. If the Periodic Task field is selected, then the job queue item is repeated. If the field is not selected, then the job queue item is not repeated. After you specify that a job queue item is recurring, you must specify which days of the week the job queue item runs. Optionally, you can also specify the time of day to run the task and specify the number of minutes between runs

  • Run on Mondays

    • Specifies that the job queue item runs every Monday

  • Run on Tuesdays

    • Specifies that the job queue item runs every Tuesday.

  • Run on Wednesdays

    • Specifies that the job queue item runs every Wednesday

  • Run on Thursdays

    • Specifies that the job queue item runs every Thursday

  • Run on Fridays

    • Specifies that the job queue item runs every Friday

  • Run on Saturdays

    • Specifies that the job queue item runs on Saturdays

  • Run on Sundays

    • Specifies that the job queue item runs every Sunday

  • Next Run Date Formula

    • Specifies the date formula that will be used to calculate the next run of a recurring job queue item. If you use a date formula, all other recurrence settings will be cleared

  • Starting Time

    • Specifies when the job queue will start first.

  • Ending Time

    • Specifies the latest time of the day that the periodic job queue item should be run

  • No. of Minutes between Runs

    • Specifies the minimum number of minutes to elapse between execution of job queue items. The value cannot be less than one minute. This field is relevant only if the job queue item is set up as a recurring job. If you don't use the number of minutes between each run, the date formula setting is cleared.

  • Inactivity Timeout Period

    • Specifies the number of minutes that elapse before a periodic task that has a status of On Hold with idle timeout is automatically restarted. The value cannot be less than five minutes.