Externí nástroje v Pohodě E1

Štítky můžete vytvářet a tisknout přímo v Pohodě E1 – v agendách Přijaté objednávky, Vydané faktury a Výdejky, bez přepínání do Balíkobotu. V Pohodě vyberete doklady a spustíte externí nástroj Balíkobotu. Balíkobot štítky vytvoří podle nastavení svého profilu (mapování dopravy, výchozí služby, tiskárny), vytiskne je a výsledek uvidíte v Pohodě.

Jde o prémiovou funkci 5. Štítky přímo z Pohody E1, kterou Balíkobot umí od verze 3.0.23.

Jak to funguje

  1. V Pohodě dáte Záznam › Externí nástroje › Balíkobot – štítky…
  2. Pohoda spustí skript balikobot_pohoda.ps1, který je součástí instalace Balíkobotu.
  3. Skript předá povel Balíkobotu přes bServer.
  4. Balíkobot si doklady načte z Pohody, vytvoří a vytiskne štítky.
  5. Skript ukáže v Pohodě hlášku s výsledkem.

Balíkobot přitom musí běžet – na stejném počítači jako Pohoda, nebo na jiném počítači v síti.

Co potřebujete

  • Pohodu E1.
  • Balíkobot verze 3.0.23 nebo novější.
  • Licenci s prémiovou funkcí 5. Štítky přímo z Pohody E1.
  • Pro automatické zapsání nástrojů do Pohody prémiovou funkci 6 s vyplněným připojením k SQL serveru Pohody. Bez ní zadáte nástroje v Pohodě ručně (viz níže).
  • Počítač s Balíkobotem musí „dosáhnout“ na mServer Pohody, pokud je Balíkobot nainstalovaný na jiném PC než Pohoda.
  • Počítač s Balíkobotem musí „dosáhnout“ na SQL server Pohody, pokud chcete využít automatické vytvoření externích nástrojů.

Nastavení v Balíkobotu

Zapnutí štítků z Pohody

  1. Vyžádejte si ode mě prémiovou funkci 5.
  2. Na kartě Expedice v rámečku bServer zaškrtněte Štítky z Pohody E1.
  3. Zadejte port (výchozí 9876) a klikněte na Test funkčnosti. bServer se pak spouští s Balíkobotem, i když nepoužíváte expedici.
  4. Potvrzovat počet vyfiltrovaných dokladů doporučujeme nechat zapnuté – před vytvořením štítků se zobrazí, kolik dokladů je ve výběru.

Nastavení se ukládá do profilu. Zapněte ho v každém profilu, který budete z Pohody používat.

Automatické vytvoření externích nástrojů do Pohody do SQL databáze

Pro automatické vytvoření externích nástrojů do Pohody do SQL databáze musíte mít koupenou prémiovou funkci 6 pro zápis do Pohody SQL/E1.

  1. Na kartě Pohoda v rámečku Zápis dat do Pohody SQL/E1 klikněte na Externí nástroje… Tlačítko je přístupné se zápisem do Pohody SQL/E1.
  2. Zkontrolujte údaje.
    • Skript je cesta ke skriptu balikobot_pohoda.ps1, jak ji vidí počítač s Pohodou – předvyplněná je složka Balíkobotu.
      • Skript musí být dostupný z počítače s Pohodou. Pokud běží Balíkobot na stejném PC jako Pohoda, nemusíte nic dělat.
      • Pokud běží Balíkobot na jiném PC než Pohoda, tak musí být skript z Pohody dosažitelný – zkopírujte ho k Pohodě nebo na sdílený disk a v dialogu zadejte jeho cestu.
    • bServer je počítač s Balíkobotem, jak ho vidí počítač s Pohodou (localhost = stejný počítač); port se bere z nastavení bServeru.
      • Pokud běží Balíkobot na jiném PC než Pohoda, tak do pole bServer zadejte název nebo IP adresu počítače s Balíkobotem. Na počítači s Balíkobotem povolte ve firewallu příchozí spojení na port bServeru.
    • Profil je profil Balíkobotu, do kterého se Balíkobot při povelu z Pohody přepne – předvyplněný je aktuální profil.
  3. Klikněte na Vyzkoušet skript. Balíkobot spustí skript stejně jako Pohoda a řekne, jestli ho Windows pustí a jestli se skript spojí s Balíkobotem. Zkouška platí pro tento počítač a uživatele Windows – běží-li Pohoda jinde, vyzkoušejte po zapsání některý z nástrojů přímo v Pohodě.
  4. Klikněte na Zapsat externí nástroje do Pohody. Balíkobot zapíše šest nástrojů, do každé agendy dva: Balíkobot – štítky pro vyfiltrované objednávky (faktury, výdejky) a Balíkobot – štítek pro aktuální objednávku (fakturu, výdejku).
  5. V Pohodě zavřete a znovu otevřete agendu. Nástroje najdete v nabídce Záznam › Externí nástroje.

Pro další profil vyplňte jeho název a nástroje zapište znovu. Každý profil má vlastní nástroje, jméno profilu je v názvu nástroje v závorce. Opakované zapsání nástroje jen aktualizuje, nezdvojí je.

Nástroje zapište znovu, když:

  • je po přechodu do nového účetního roku v Pohodě nevidíte – Pohoda ukládá externí nástroje ke každému roku zvlášť,
  • změníte port bServeru,
  • přesunete Balíkobot nebo skript na jiný počítač nebo do jiné složky.

Ruční zadání nástrojů (bez funkce 6)

Pokud nemáte možnost zápisu do SQL databáze Pohody přes Balíkobot, můžete externí nástroje v Pohodě vytvořit ručně. V Pohodě otevřete Nastavení › Externí nástroje a pro každý nástroj založte nový záznam (může administrátor):

PoleHodnota
Názevnapř. Balíkobot – štítky pro vyfiltrované objednávky
AgendaPřijaté objednávky, Vydané faktury nebo Výdejky
PříkazC:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
Parametrypodle tabulky níže
Dotázat na parametry při spuštěníne
Počkat na dokončení činnosti externího nástrojeano
Při spuštění skrýt okno externího nástrojeano
Povolit ukončení externího nástrojeano

Parametry začínají vždy stejně (cestu upravte podle složky, kam je Balíkobot nainstalovaný):

-NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File "C:\Program Files (x86)\Balikobot\balikobot_pohoda.ps1"

a pokračují podle nástroje:

NástrojPokračování parametrů
Přijaté objednávky – vyfiltrované-akce stitky -doklady vyfiltrovane -agenda OBJ -ico $(ICO) -filtr $(@Filter) -server localhost -port 9876
Přijaté objednávky – aktuální-akce stitky -doklady aktualni -agenda OBJ -id $(#ID) -ico $(ICO) -server localhost -port 9876
Vydané faktury – vyfiltrované-akce stitky -doklady vyfiltrovane -agenda FV -ico $(ICO) -filtr $(@Filter) -server localhost -port 9876
Vydané faktury – aktuální-akce stitky -doklady aktualni -agenda FV -id $(#ID) -ico $(ICO) -server localhost -port 9876
Výdejky – vyfiltrované-akce stitky -doklady vyfiltrovane -agenda SKPV -ico $(ICO) -filtr $(@Filter) -server localhost -port 9876
Výdejky – aktuální-akce stitky -doklady aktualni -agenda SKPV -id $(#ID) -ico $(ICO) -server localhost -port 9876
  • Kolem $(…) nepište uvozovky – Pohoda je doplní sama.
  • -server a -port upravte, když Balíkobot běží na jiném počítači nebo má bServer jiný port.
  • Na konec můžete přidat -profil "název profilu" – Balíkobot se do profilu přepne. Bez něj použije profil, který je v Balíkobotu právě vybraný.

Práce v Pohodě

Štítky pro více dokladů

  1. V agendě vyberte doklady, pro které chcete štítky – filtrem nebo dotazem. Pro označené doklady použijte filtr Moje označené.
  2. Dejte Záznam › Externí nástroje › Balíkobot – štítky pro vyfiltrované objednávky (faktury, výdejky).
  3. Balíkobot ukáže počet dokladů ve výběru a zeptá se, jestli má štítky vytvořit. Dotaz se zobrazí, pokud máte Balíkobot takto nastavený.
  4. Po potvrzení Balíkobot štítky vytvoří a vytiskne a na konci se zobrazí hláška s výsledkem.

Pozor: bez filtru je ve výběru celá agenda. Proto doporučujeme nechat potvrzování počtu dokladů zapnuté.

Štítek pro jeden doklad

Postavte se na doklad a dejte Balíkobot – štítek pro aktuální objednávku (fakturu, výdejku). Filtr ani označení se neberou v úvahu.

Co při tom dělá Balíkobot

  • Přepne se do profilu, pro který je nástroj zapsaný, a do správné agendy (objednávky, faktury, výdejky).
  • Povel přijme jen z firmy (IČ), na kterou je profil nastavený.
  • Načte vybrané doklady z Pohody (jeden nebo více) a vytvoří/vytiskne k nim štítky.

Když něco nefunguje

Nejdřív v Balíkobotu otevřete Externí nástroje… a klikněte na Vyzkoušet skript – zkouška řekne, co je špatně.

Hláška nebo projevCo dělat
Balíkobot neodpovídáSpusťte Balíkobot. Zkontrolujte, že má v profilu zaškrtnuté Štítky z Pohody E1 a stejný port jako nástroj. Když běží na jiném počítači, zkontrolujte i název počítače a firewall.
Povely z Pohody jsou v Balíkobotu v profilu XY vypnutéV tomto profilu zaškrtněte Štítky z Pohody E1 v rámečku bServer.
Povely z Pohody: Pro tuto funkci nemáte zakoupenou licenci…Licence nemá funkci 5 – kontaktujte nás.
Povel přišel z firmy s IČ …Nástroj patří k jinému profilu nebo firmě. Zapište nástroje do správné účetní jednotky v Pohodě.
Ve výběru v Pohodě nejsou žádné objednávkyVe vybraném filtru nic není – například u Moje označené nemáte nic označené.
Tato verze Balíkobotu povel z POHODY neznáAktualizujte Balíkobot.
Skript Balíkobotu skončil chybouNeočekávaná chyba – pošlete nám text hlášky.
Po spuštění nástroje se nezobrazí vůbec nicWindows skript nespustily nebo ho spustily v omezeném režimu. Nejčastěji zásady skupiny dovolují jen podepsané skripty: skript je podepsaný certifikátem Ing. Jan Bláha (BlahaSoft) a správce ho přidá mezi důvěryhodné vydavatele. PowerShell může blokovat také AppLocker, WDAC nebo antivir – pak musí skript povolit správce. Když se skript spustil, ale hlášku ukázat nemohl, najdete popis chyby v souboru %TEMP%\balikobot_pohoda.log uživatele, který Pohodu spustil.

Skript neupravujte – každá změna zneplatní jeho podpis. Server, port a profil se nastavují v parametrech nástroje.