Pro zprovoznění tohoto připojení je třeba od dovatele Vaultu získat doplňky Holixa ERP connector4VLT a Holixa PublisherVLT.
Vault je MS SQL Server databáze výkresů, do které konstruktéři exportují zboží. K této databázi lze přistoupit přes ssh pomocí IntelliJ přes záložku Databáze. Factorify z ní co 10 minut přebírá informace o zboží, kusovníku a výkresech. Také do ní FY exportuje změněné stavy zboží.
SQL server obsahuje 2 databáze - Ec_Vault (testovací) a Klientovu (produkční). Každá databáze obsahuje 4 tabulky.
- EcEntity - obsahuje informace o zboží.
- EcAssoc - obsahuje informace u kusovnících.
- EcLink - obsahuje informace o přílohách (výkresech).
- EcLog - logování.
¶ Import
Nové položky (volné atributy) se nově definují v agendě Vault column mapping
- Zboží
- EcEntity
- id -> fa:CAD_EC_ENITITY_ID
- name -> kód
- version/revision -> workflow.version/revision
- base_uom -> jednotka
- thumbnail -> fotografie
- volné atributy (viz. Vault Column Mapping pro definici)
- HMOTNOST -> weight kg
- NAZEV_CZ/NAZEV_EN -> jméno
- CISLO_SOUCASTI -> fa:CAD_PART_NUMBER
- PUVODNI_REG_CISLO -> fa:CAD_ORIGINAL_REGISTRATION_NUMBER
- PUVODNI_SKUP_ZBOZI -> fa:CAD_ORIGINAL_GOODS_GROUP
- OBJ_CISLO_DODAVATELSKE -> fa:CAD_ORDER_EXTERNAL_NUMBER
- ROZMER_A -> A (vynasobeni 100 a zaokrouhleni na cele cislo)
- ROZMER_B -> B (vynasobeni 100 a zaokrouhleni na cele cislo)
- ROZMER_C -> C (vynasobeni 100 a zaokrouhleni na cele cislo)
- AUTOR -> fa:CAD_AUTHOR
- MATERIAL -> fa:CAD_MATERIAL
- POVRCHOVA_UPRAVA -> fa:CAD_SURFACE_FINISH
- TYP_STROJE -> fa:CAD_MACHINE_TYPE
- DODAVATEL -> fa:CAD_DODAVATEL
- CATEGORY -> fa:CAD_CATEGORY
- EcASSOC / kusovník
- qty_total -> kvantita (zaokrouhleno)
- position -> position
- EcLINK
- link_type
- 10 -> vault url
- 20 -> přílohy (viz Pravidla)
- 30 -> pdf (cesta + vykres)
- link_type
- EcEntity
¶ Pravidla
- import se nakouskuje přes bulk_id - každý kousek proběhne buď celý nebo vůbec, při chybě se pokračuje dalším bulk_id
- pro každý bulkd_id se importuje pouze top sestava (tj. 1 zboží, protože 1 bulk obsahuje pouze 1 top sestavu). Import zboží kusovníku (podsestav) jde povolit v properties
vault.importBomGoods=true. - import se řídí standardními pravidly importu výkresů
- stav zboží
- nelze upravit stav zboží z ne-výchozího stavu do výchozího ("Nový")
- pokud nelze rozpoznat stav z importu pro top sestavu, import selže
- typ zboží se nastavuje jen pro nově vytvořené zboží
- v globálních parametrech lze zapnout pravidlo: NE položky můžou být jen v kusovníku VE položek
- výkresy - pro link typ = 20 se přílohy nahrají s kategorií VAULT a všechny předchozí přílohy s touto kategorií se smažou
- pokud jméno výkresu má jednu z předpon níže, tak se smaže a umístí se do příšlušné přílohy:
- předpona $$$ -> přílohy zobrazené na pracovišti
- předpona %%% a nebo bez přípony-> (normální) přílohy
- pokud jméno výkresu má jednu z předpon níže, tak se smaže a umístí se do příšlušné přílohy:
- fotografie na zboží je aktualizována pouze pokuď žádná neexistuje nebo je pojmenována preview.png
- kódy zboží ve FY se upravují podle pravidel níže
¶ Nastavení
¶ číselník - VAULT_CATEGORY
- NE, VM, NM
- nastaveno na typu zboží - použito v exportu pro sloupec "category"
¶ čísleník - VAULT_GROUP
- nakupované, vyráběné
- pro import/export k určení stavu zboží
¶ entita - Vault state
- 51 Uvolněno, apod.
- typ + id stavu ve Vault DB
- pro import rozhoduje jméno stavu, na id se nehledí
¶ entita - Vault mapping
Nastavuje mapování stavů při importu/exportu
- import - "typ zboží - vault group" (nikoliv ten sloupec v importu) + vault state (sloupec lfcyst name z importu) -> FY stav zboží
- export - "typ zboží - vault group" + FY stav zboží -> vault state
¶ entita - Vault column mapping
Nastavuje mapování sloupců při importu. Názvy sloupů kromě několika základních společných ve Vault databázi se můžou u každého klienta lišit. Proto je zde potřeba pro tyto nestandardní definovat mapování na očekávané názvy ve Factorify aplikaci.
Sloupečky
- název Vault tabulky
- název sloupečku ve Vault tabulce
- název proměnné ve Factorify
- je uživatelská proměnná, pokud je zaškrtnuto, bude importováno jako FA
CAD_ + název proměnné)
Názvy proměnných které jsou očekávány přímo v kódu Factorify. Tyto nejsou standardně importovány jako FA (není nutné, ale je možné po zaškrtnutí, že je uživatelská proměnná).
- ORIGINAL_GOODS_GROUP
- ORIGINAL_REGISTRATION_NUMBER
- NAME_CZ / NAME_EN
- NOTE
- WEIGHT
- DIMENSION_A / DIMENSION_B / DIMENSION_C
Pokud by bylo třeba importovat údaj (například hmotnost) duplicitně i do FA, ale pod specifickám názvem, je to možné zduplikováním definice řádku v tabulce.
např.
vault tabulka vault sloupec proměnná uživatelská proměnná poznámka EcENTITY HMOTNOST WEIGHT false (bude nastaveno přímo na entitě zboží jako expediční hmotnost) EcENTITY HMOTNOST ORIGINAL_HMOTNOST true (bude importováno jako CAD_ORIGINAL_HMOTNOST)
¶ Plech
- pro zboží kde typ zboží v FY má vyplněno "Typ zboží plechu" (FA SHEET_METAL_GOODS_TYPE)
- do importu jdou 2 položky
- produkt - bez registračního čísla, originální kód
- plech - s originálním registračním číslem, za kód se přidá "-R", upraví se typ zboží dle FA "Typ zboží plechu"
¶ Oprava kódů zboží
- name ve Vaultu (FY kód) se může lišit od name z Heliosu
- import se řídí podle kódu -> je třeba opravit kódy ve FY před importem z Vaultu
- před importem se najdou zboží podle CAD_ORIGINAL_REGISTRATION_NUMBER s odlišným kódem, než je v importu, opraví se kód
- pro plech se najde zboží, kterému chybí to s "-R" - a přejmenuje se na to s Rkem
- nelze mít 2 nesmazaná zboží se stejným registračním číslem (jinak import selže, nelze určit, které zboží přejmenovat)
¶ Export
- exportuje se zboží, které
- není smazané
- přišlo z Vaultu (tj. mají FA:CAD_EC_ENITITY_ID)
- stav se změnil od posledního exportu/importu
- existuje záznam v vault-mapping pro kombinaci "typ zboží - vault group", stavu zboží a zaškrtnuto "export mapping"
¶ Jednotky
Kus ea (-> pc)
Gram g
Centimetr cm
Millilitr ml
Čtverečný centimetr sqcm ( -> cm2)
Buňka bx
Milligram mg
Unce oz
Libra lb
Millimetr mm
Metr m
Palec in
Stopa stopa
Yard yd
Litr l
Unce kapaliny lqd oz
Kvart qt
Galon gal
Čtverečný palec sqin
Čtverečná stopa sqft
Čtverečný metr sqm (-> m2)