Suchanfrage aus einer anderen Software
1. BvLArchivio bietet anderen Programmen (fremden Softwareherstellern) den Direktzugriff aufs Archiv an. Über die Parameter &BvL1 / &BvL2 / &BvL3 / usw. wird die Suchanfrage übergeben.
2. Wenn z. B. aus einer anderen Software die Rechnung 4711 aus dem Archivio1 abgefragt werden soll, muss die andere Software nur folgenden HTTPS-Aufruf erzeugen können:
https://192.168.1.101/BvLTech1.afp?BvL1=rechnung&BvL2=4711
3. Wenn z. B. alle Rechnungen vom Kunden Toni aus dem Jahr 2015 angezeigt werden sollen, muss folgende URL aufgerufen werden:
https://192.168.1.101/BvLTech1.afp?BvL1=(01.01.2015-31.12.2015)&BvL2=rechnung&BvL3=toni
Es können maximal sieben Suchbegriffe übergeben werden, wobei "ihrsuchbegriff" mit den Begriffen ersetzt werden muss, die der tatsächlichen Suchanfrage entsprechen.
Die vollständige Syntax lautet wie folgt:
https://192.168.1.101/BvLTech1.afp?BvL541b=20&BvL1=ihrsuchbegriff&BvL2=ihrsuchbegriff&BvL3=ihrsuchbegriff&BvL4=ihrsuchbegriff&BvL5=ihrsuchbegriff&BvL6=ihrsuchbegriff&BvL7=ihrsuchbegriff
4. Der Parameter BvL541b=20 ist optional und gibt die Anzahl der angezeigten Suchbegriffe in der Trefferliste vor.
5. Geben Sie den Wert nicht an, wird der Standardwert 20 verwendet.
6. Sie können die Anzahl der angezeigten Suchbegriffe für diese Abfrage auf 100, 500 oder 1.000 einstellen (z. B. BvL541b=500).
7. Wenn die Benutzerverwaltung aktiviert ist, müssen Sie die Session-ID mitliefern, indem Sie den Parameter &BvL2511=ihre_sessionid mit übergeben.
Hinweis:
1. Die Trefferliste (Ihre Suchanfrage) enthält im Quelltext als Kommentarzeilen den direkten Link zu den Dateien.
2. Der Link auf die Dateien ist nur zeitlich begrenzt gültig. Der Link ist kein Deep Link (dauerhafter Link).
3. Zwischen den TAGS <BVL_ARCHIVIO_LINK> und </BVL_ARCHIVIO_LINK>) stehen jeweils die direkten Links zur Datei. Mit Aufruf dieses temporären Links wird die Datei sofort heruntergeladen.
4. Zwischen den Tags %BVLTEXTDATEILINK% und %/BVLTEXTDATEILINK% bekommen Sie den Link zu einer Textdatei.
5. Diese Textdatei wird automatisch mit jeder Suchanfrage zusätzlich erstellt und enthält die Trefferliste in strukturierter Form.
6. Enthalten sind folgende Elemente pro Treffer:
%BvLLink% Enthält den Link zur Datei.
%BvLDatum% Enthält das Archivierungsdatum.
%BvLDatei% Enthält den Dateityp.
%BvLText% Enthält die ersten 20, 100, 500 oder 1.000 Suchbegriffe.
Sie können mit dem zusätzlichen Parameter &BvL8=txt erreichen, dass der Inhalt der Textdatei sofort angezeigt wird.
Beispiel:
https://192.168.1.101/BvLTech1.afp?BvL541b=20&BvL1=rechnungen&BvL2=juli&BvL3=2025&BvL8=txt
Diverse weitere Scriptbeispiele können Sie sich hier herunterladen:
https://www.bvlarchivio.com/wp-content/uploads/SCRIPT_BEISPIEL.zip