You can authorize customers, suppliers or job applicants to access certain information or even create certain transactions on your __dokos__ instance.
For example, you can let anyone create an account on your website (created with __dokos__ or connected via the API) and apply for a job. You can let your customers see the details of their invoices, issue tickets they have registered or give them the possibility to upload new documents directly themselves.
:::tip
There are two types of in-built interfaces available in __dokos__: The *Desk View* and the *Web View*.
- The Desk is for users within your organization with access to potentially confidential data
- Web View is for users outside your organization who need to interact and to whom you want to provide a self-service access
Web forms are similar to the forms you generally fill in various websites on the internet. They are part of the *Web View* interface.
:::
## 1. Create a new web form
To create a new **Web Form** go to:
> Website > Web Form
Select the **DocType** based on which you want to build your Web Form.
You are simply giving a controlled access to this document type to your users and allowing them to modify part of this document or create a new one.
The **Route** will be set based on the **Title** of your Web Form. You can also add an introduction text to show a friendly message above your form.
Add some fields to your Web Form.
These are the fields from the DocType you have selected. You can change the labels of these fields.
Try to keep the number of fields to a minimum as long forms are cumbersome to fill.
Click on **See on Website** in the sidebar to view your Web form.
Checkboxes on the right:
1.**Published**: The web form will only be accessible if this is enabled.
2.**Login Required**: User can fill the Web Form only if they are logged in.
When Login Required is checked:
2.1. **Route to Success Link**: Go to the success link after the form is submitted.
2.2. **Allow Edit**: If this is unchecked the form becomes read-only once it is saved.
2.3. **Allow Multiple**: Allow user to create more than one record.
2.4. **Show as Grid**: Show records in a table format.
2.5. **Allow Delete**: Allow user to delete the records that he/she has created.
2.6. **Allow Comments**: Allow user to add comments on the created form.
9.**Allow Print**: Allow user to print the document in the selected print format.
10.**Allow Incomplete Forms**: Allow user to submit form with partial data.
## 2. Features
### 2.1 Sidebar
You can also show contextual links in a sidebar on your Web Form.
### 2.2 Creating Web Forms with child tables
You can add child tables to your web forms, just like in regular forms.
### 2.3 Payment Gateway Integration
You can add a Payment Gateway to the web form.
When your users save their form, they are redirected to a payment form.
### 2.4 Portal User
In portal settings, you can set a role against each menu item so that only users with that role are allowed to see this item.
### 2.5 Custom Script
You can write custom scripts for your Web Form for things like validating your inputs, auto-filling values, showing a success message, or any arbitrary action.
### 2.6 Actions
You can add a text in the 'Success Message' field and this text will be shown to user once he successfully submits the web form.
The user will be redirected to the URL set as 'Success URL' when clicked on 'Continue' button.
This is only applicable to webforms accessible to unregistered users (webforms with 'Login Required' checkbox unchecked).
### 2.6 Result
When a website user submits the form, the data will be stored in the document/doctype for which a web form is created.
Vous pouvez autoriser vos clients, fournisseurs ou postulants à accéder à certaines information ou à créer certaines transactions sur votre intance __dokos__.
Par example: vous pouvez laisser n'importe qui se créer un compte sur votre site web (créé avec __dokos__ ou connecté via l'API) et postuler pour un emploi. Vous pouvez laisser vos clients voir le détail de leurs factures, leurs tickets de support ou leur donner la possibilité de télécharger un nouveau document eux-même.
:::tip
Il y a deux types d'interfaces intégrées à __dokos__: Le *Bureau* et la *vue Web*.
- Le Bureau est pour les utilisateurs au sein de votre organisation avec accès à des informations potentiellement confidentielles
- La vue Web est pour les utilisateurs en dehors de votre organisation qui ont besoin d'intéragir avec vous et à qui vous souhaitez fournir un 'self-service'
Les formulaires web sont similaires aux formulaires que vous remplissez habituellement sur internet. Ils font partie de la "vue Web".
:::
## Créer un nouveau formulaire web
Pour créer un nouveau **Formulaire web**, allez à:
> Site web > Formulaire web
Sélectionnez un **DocType** qui servira de base pour construire votre formulaire web.
Vous donnez simplement un accès contrôlé à ce type de document à vos utilisateurs et les autorisez à en modifier des parties ou à en créer un nouveau.
La **Route** sera définie sur la base du **Titre** de votre formulaire web. You pouvez aussi ajouter un texte d'introduction pour afficher un message d'accueil au dessus de votre formulaire.
Ajoutez des champs à votre formulaire web.
Ces champs sont ceux du type de document que vous avez sélectionné. Vous pouvez modifier les libellés de ces champs.
Essayez de minimiser le nombre de champs car les formulaires trop longs sont ennuyeux à renseigner.
Cliquez sur **Voir sur le site web** dans la barre latérale pour voir votre formulaire web.
Options sur la droite:
1.**Publié**: Le formulaire webThe web form will only be accessible if this is enabled.
2.**Connexion obligatoire**: L'utilisateur peut renseigner le formulaire web uniquement s'il est connecté.
Lorsque Connexion Obligatoire est coché:
2.1. **Rediriger vers le lien de succès**: Redirige vers le lien de succès après validation du formulaire.
2.2. **Autoriser les modifications**: Si cette case n'est pas cochée, le formulaire sera en lecture seule après validation.
2.3. **Autoriser plusieurs documents**: Autorise l'utilisateur à créer plus d'un seul enregistrement.
2.4. **Afficher en grille**: Affiche les enregistrements dans un tableau.
2.5. **Autoriser les suppressions**: Autoriser l'utilisateur à supprimer les enregistrements qu'il/elle a créé·e.
2.6. **Autoriser les commentaires**: Autoriser l'utilisateur à ajouter des commentaires sur le formulaire créé.
9.**Autoriser les impressions**: Autoriser l'utilisateur à imprimer le document avec le format d'impression sélectionné.
10.**Autoriser les formulaires incomplets**: Autoriser l'utilisateur à soumettre un formulaire avec des données partielles.
## 2. Fonctionnalités
### 2.1 Barre latérale
Vous pouvez aussi afficher des liens contextuels dans une barre latérale sur votre formulaire web.
### 2.2 Créer des formulaires web avec tables enfant
Vous pouvez ajouter des tables enfants à vos formulaires web, comme dans les formulaires classiques.
### 2.3 Intégration de passerelles de paiement
Vous pouvez ajouter une passerelle de paiement à un formulaire web.
Lorsque vos utilisateurs enregistrent leur formulaire, il sont redirigés vers un formulaire de paiement.
### 2.4 Utilisateur de portail
Dans les paramètres de portail, vous pouvez définir un rôle pour chaque élément de menu pour que seuls les utilisateurs avec ce rôle puissent voir cet élément.
### 2.5 Scripts personnalisés
Vous pouvez écrire des scripts personnalisés pour vos formulaires web afin de valider les entrée, pré-remplir les champs, afficher un message de succès ou toute autre action personnalisée.
### 2.6 Actions
Vous pouvez ajouter un texte dans le champ 'Message de succès' qui sera ensuite affiché à l'utilisateur après validation du formulaire web.
L'utilisateur sera redirigé vers l'URL définie dans le champ 'Lien de succès' en cliquant sur le bouton 'Continuer'.
Ceci est valable uniquement pour les utilisateur non enregistrés (formulaires web avec le bouton 'Connexion requise' non coché).
### 2.6 Résultat
Lorsqu'un utilisateur de site web soumet son formulaire, les données sont enregistrée dans le type de document auquel est lié ce formulaire.
