THotPDF.AddFacturXAssociatedFile Method
Povzetek metode: THotPDF.AddFacturXAssociatedFile Method
Deklaracija
function AddFacturXAssociatedFile(const XMLBytes : TBytes; const ConformanceLevel : AnsiString; const FileName : AnsiString = 'factur-x.xml'; const Description : AnsiString = 'Factur-X invoice XML'; const Relationship : AnsiString = 'Alternative'; const Version : AnsiString = '1.0'; const CountryCode : AnsiString = ''): THPDFDictionaryObject;Unit
HPDFDoc
Parametri
| Name | Namen |
|---|---|
XMLBytes | Biti računa XML, vdelani dobesedno v tok EmbeddedFile PDF/A-3; identifikator smernic XML ali profila se mora ujemati s ConformanceLevel |
ConformanceLevel | Dovoljeni profil računa ali raven skladnosti, kot je EN 16931, EXTENDED, XRECHNUNG ali COMFORT za ZUGFeRD 1.0 |
FileName | Ime vdelane datoteke XML, zapisano v /F, /UF, imensko drevo EmbeddedFiles in vrednost XMP DocumentFileName |
Opis | Izbirno besedilo Filespec /Desc, prikazano orodjem za porabo |
Relationship | Odnos pridružene datoteke, zapisan kot /AFRelationship in dovoljen z izbranim profilom računa |
Version | Različica metapodatkov računa, vključno z 1.0, 2p0 or ujemajočo se različico XRECHNUNG, kot je 3.0 |
CountryCode | Koda regionalne politike, ki jo uporablja preverjanje profila; uporabite prazno vrednost, DE ali FR |
Vrnjena vrednost
Vrne posredni slovar Filespec, registriran za primarni XML računa
Opombe o uporabi
- Pred uporabo te metode nastavite PDFACompliance na 3A, 3B ali 3U in pokličite BeginDoc
- Metoda zavrne neveljavne kombinacije imena datoteke, profila in različice metapodatkov, zato se xrechnung.xml uporablja samo z XRECHNUNG, ZUGFeRD-invoice.xml se uporablja samo s profili ZUGFeRD 1.0, zugferd-invoice.xml se uporablja samo z različico Version 2p0, factur-x.xml pa se uporablja za trenutne profile Factur-X
- Metoda preveri smernice XML ali identifikator profila glede na ConformanceLevel, vključno z URN-ji profilov ZUGFeRD 1.0, trenutnimi URN-ji profilov Factur-X, francoskimi podnabori EXTENDED, psevdonimom XMP ali profila EN16931, URN-ji profilov ZUGFeRD 2.0 in znanimi URN-ji profilov XRechnung CII ali UBL z ujemajočimi se različicami metapodatkov
- Za XRECHNUNG prenesite Version kot 1.2, 2.0, 2.1, 2.2, 2.3 ali 3.0, da ohranite ta fx:Version; obstoječi klici, ki pustijo privzeto vrednost Version na 1.0, se normalizirajo na 3.0
- Za vsebnike ZUGFeRD 1.0 prenesite FileName kot ZUGFeRD-invoice.xml, Version kot 1.0 in ConformanceLevel kot BASIC, COMFORT ali EXTENDED
- Za vsebnike ZUGFeRD 2.0 prenesite FileName kot zugferd-invoice.xml in Version kot 2p0
- Prenesite CountryCode kot DE, ko mora vsebnik računa slediti nemškim pravilom za odnose ZUGFeRD; MINIMUM in BASIC WL zahtevata Data kot AFRelationship, medtem ko BASIC, EN 16931, EXTENDED in XRECHNUNG zahtevajo Alternative
- Prenesite CountryCode kot FR, ko mora račun slediti francoskim pravilom Factur-X; XRECHNUNG je zavrnjen, BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR in EXTENDED-B2B-FR pa lahko uporabljajo Alternative, Source ali Data
- Metoda uporablja vrsto MIME text/xml, zapisuje /Params /Size, /ModDate in /CheckSum, registrira Filespec v Catalog /AF ter doda vnos Catalog /Names /EmbeddedFiles za orodja za ekstrakcijo XML
- Po registraciji primarnega XML računa lahko kasnejši klici AddPDFA3AssociatedFile dodajo podporne dokumente; preglejte FacturXWarnings za neusodna opozorila o vrsti MIME, ko so te priloge zunaj priporočenih formatov podpornih dokumentov
- Ustvarjeni paket XMP vključuje shemo razširitve PDF/A, specifično za profil, ter polja DocumentType, DocumentFileName, Version in ConformanceLevel pod ujemajočim se imenskim prostorom računa
- Ne nastavite CustomXMP pri uporabi tega pomočnika, ker bi paket XMP, ki ga zagotovi klicatelj, zamenjal ustvarjene metapodatke računa
- V poteku dela z dokumentom je mogoče prek tega pomočnika priložiti le en primarni XML računa
Povezani API-ji
- THotPDF.AddPDFA3AssociatedFile Method
- THotPDF.FacturXWarnings Property
- THotPDF.AddPDFAOutputIntent Method
- THotPDF.PDFACompliance Property