De Premium BigQuery-connector van ons platform biedt een directe koppeling naar de BigQuery-databaseservice van Google. Met dit hulpmiddel kun je je formulierinzendingen automatisch als nieuwe rijen in een doel-BigQuery-databasetabel invoegen.

Dit creëert een eenrichtingssynchronisatie, waarbij nieuwe formulierinzendingen rechtstreeks naar je database worden gestuurd.

Voordat je de BigQuery-connector toevoegt, moet je de volgende instellingsstappen voltooien:

• Zorg ervoor dat een geldige Google Cloud Platform (GCP)-verbinding al voor je organisatie is geconfigureerd.
• Stel enkele basisconfiguaties in binnen de GCP Console.

De connector toevoegen

Volg deze stappen om de connector aan je specifieke formulier toe te voegen:

1. Ga naar App Workshop > Formulieren.
2. Beweeg je muis over het gewenste formulier en klik op het pictogram Verbinden.
3. Klik op de knop Connector toevoegen (rechtsboven).
4. Selecteer Google BigQuery uit de opties.

Opmerking: De pagina wordt vernieuwd met de toegevoegde connector. Wijzigingen zijn pas actief als je op Opslaan klikt.

Tip voor snelle toegang

Als je al in het formuliergereedschapskist of de weergave Instellingen bent, hoef je niet terug naar het hoofdmenu. Klik gewoon op het tabblad Connectors dat zich rechtstreeks onder de formuliertitel aan de bovenkant van het scherm bevindt.

De connector configureren

Nadat je de formulierconnector hebt toegevoegd, zijn de volgende configuratieopties beschikbaar.

Project-ID

Geef de Google Cloud Platform Project-ID op die je doel-BigQuery-dataset bevat.

Datasetnaam

Geef de datasetnaam op waar de tabel zich bevindt.

Tabelconfiguratie

Geef aan welke formuliervelden je wilt invullen als rijwaarden in je doeldataset.
Bij je eerste formulierinzending wordt automatisch een kolom van dezelfde naam aangemaakt voor elk geselecteerd formulierveld, als deze nog niet bestaat.

De typen zijn: Auto-onderhoud, Toegewezen velden en Aangepaste SQL-sjabloon.

Auto-onderhoud (rijen toevoegen)

Dit is een aanbevolen instelling, omdat kolommen automatisch worden toegevoegd/gewijzigd wanneer het formulierontwerp tussen versies verandert. Ons platform maakt en onderhoudt automatisch een tabel in je BigQuery-dataset wanneer dit is ingeschakeld. Vanwege beperkingen in de BigQuery API kunnen onze connectors de kolommen van een BigQuery-tabel niet wijzigen. Als gevolg hiervan maakt elke nieuwe versie van je formulier een nieuwe tabel in BigQuery, met de formulierversie toegevoegd aan de opgegeven tabelnaam als achtervoegsel, bijvoorbeeld MyExampleTableName_v1…v2…v3 enz.

Toegewezen velden (rijen bijwerken/toevoegen)

De connector voegt standaard nieuwe rijen in de doeltabel in. Als je wilt dat de connector bestaande rijen bijwerkt, gebruik je de optie Sleutel om een sleutelkolom te definiëren die wordt gebruikt om een overeenkomende rij te vinden wanneer de connector wordt uitgevoerd. Als een overeenkomende rij wordt gevonden, wordt die rij bijgewerkt. Anders wordt een nieuwe rij toegevoegd.

Aangepaste SQL-sjabloon

Voer een aangepaste SQL-query in om in een enkele transactie door deze connector uit te voeren. Gebruik onze gegevenssjabloon-syntaxis om formulierveldaanduidingen in te voegen en secties te herhalen. bijv.

DELETE FROM DataSetName.MyTableName 
WHERE Id = CAST({{%ENTRYGUIDFULL}} as string);
INSERT INTO DataSetName.MyTableName ( id, itemno,   formversion, myField1, myfield2,  myfieldn)
VALUES {{!REPEATSTART}} 
(  CAST({{%ENTRYGUIDFULL}} as string),  
CAST({{%ITEMNO as int64}}), 
CAST({{%FORMVERSION}} as int64), 
CAST({{myField1}} as datetime), 
CAST({{myfield2}} as string), 
CAST({{myfield2}} as int64),), 
{{!REPEATEND}};

Een unieke ingebouwde functie, {{%UTCNOW}}, is beschikbaar voor databaseconnectors en retourneert de datum en tijd waarop de query wordt uitgevoerd in UTC. Deze ingebouwde ENTRYGUID, ENTRYGUIDFULL en ITEMNO hebben altijd een waarde, ongeacht de instelling ‘NULL gebruiken in herhaalde rijen’.

Tabelnaam

Geef de tabelnaam op die inzendingsgegevens voor dit formulier ontvangt.
Een standaard tabelnaam wordt gegenereerd met behulp van de externe formulier-ID als deze leeg wordt gelaten.

Gegevenskolommen

Geef aan welke formuliervelden je wilt invullen als rijwaarden in je doeldataset.

Bij je eerste formulierinzending wordt automatisch een kolom van dezelfde naam aangemaakt voor elk geselecteerd formulierveld, als deze nog niet bestaat.

URL-mediavelden gebruiker

Als ingeschakeld, worden mediabestandsnamen omgezet naar hun volledige URL’s.

Aanduidingen vervangen door weergavetekst

Standaard worden aanduidingen vervangen door de onbewerkte antwoordwaarde uit de formulierinzending.

Datumwaarden worden bijvoorbeeld opgeslagen als UTC-tijd in ISO 8601-onbewerkt formaat, bijv. 2015-10-23T15:05:07Z.

Selecteer deze optie als je in plaats daarvan wilt vervangen door door gebruikers weergegeven tekst, bijv. 23-Oct-2015 05:05:07, ervan uitgaande dat je tijdzone UTC-10 is

NULL gebruiken in herhaalde rijen

Als ingeschakeld, worden formuliervelden die in herhalingsgedeelten voorkomen, op NULL ingesteld in alle behalve de eerste herhaling.
Het volgende wordt NIET beïnvloed door deze optie:

• ENTRYGUID, ENTRYGUIDFULL, ITEMNO en UTCNOW
• Velden die binnen een tabel of herhalende pagina voorkomen
• Formules die verwijzen naar een herhalend veld

Persoonlijke gegevens anonimiserenmitation door de formulierversiesuffix aan de tabelnaam toe te voegen. Als je wijzigingen aanbrengt in de connector of formulierontwerp zodat nieuwe velden aan nieuwe kolommen worden toegewezen, zullen volgende connectoruitvoeringen mislukken terwijl ze nog in testmodus zijn. Om dit op te lossen, verwijder je de tabel in Google BigQuery zodat de volgende uitvoering van de connector deze opnieuw aanmaakt, of publiceer je het formulierontwerp zodat het _vx-achtervoegsel wordt gebruikt.