Initial OSF for Drupal Configuration

= Introduction =

The OSF for Drupal Configuration manual will drives you all the initial OSF for Drupal configuration steps that you have to do in order to connect it to an operational OSF Web Services instance. It assumes that you just finished to install OSF for Drupal using the OSF Installer and that the OSF instance is running on the same instance (but it can be running from anywhere, as long as the Drupal server as access to it).

The first time you will get to you newly installed Drupal portal, you will see that page appearing:

= Registering the Initial OSF Web Services Endpoint =

To register a new OSF Web Services endpoint, you have to click on the top  menu item. Note that this page is the main Drupal page where you can configure all the enabled modules. Then, you have to click the.



Now you get to the main OSF for Drupal configuration page. All the configurations for all the OSF modules are accessible from that page. What you want to make sure is that the  tab is selected. Then you have to click on the  link to get to the page where you will register your new endpoint.



Then you get to the form where you have to specify all the information that is required to register a new OSF Web Services endpoint to the OSF for Drupal module. The information you have to provide is:


 * This is the title that will be use to refere to this endpoint in the user interface across Drupal
 * This is the base URL of the OSF Web Services endpoint. It usally ends with
 * This is the application ID that will be used by Drupal to communicate with the OSF instance. If you don't use a default one, you will have to check with the OSF instance administrator such that he can provide one to you.
 * This is the API Key that is linked with the Application ID you provided above. This is required such that the Drupal instance can authenticate all the web service queries that it sends to the OSF instance.
 * This is the color that is used to highligth that network in the user interface
 * This is used to specify if this OSF endpoint instance is the default one. Depending on the OSF for Drupal module, some of them are only using with the default endpoin, others will all the endpoints. For example, the Search module only works with the default endpoint.
 * This is the API Key that is linked with the Application ID you provided above. This is required such that the Drupal instance can authenticate all the web service queries that it sends to the OSF instance.
 * This is the color that is used to highligth that network in the user interface
 * This is used to specify if this OSF endpoint instance is the default one. Depending on the OSF for Drupal module, some of them are only using with the default endpoin, others will all the endpoints. For example, the Search module only works with the default endpoint.
 * This is the color that is used to highligth that network in the user interface
 * This is used to specify if this OSF endpoint instance is the default one. Depending on the OSF for Drupal module, some of them are only using with the default endpoin, others will all the endpoints. For example, the Search module only works with the default endpoint.
 * This is used to specify if this OSF endpoint instance is the default one. Depending on the OSF for Drupal module, some of them are only using with the default endpoin, others will all the endpoints. For example, the Search module only works with the default endpoint.

Then you have to click the  button to register that new endpoint.

Once you saved the OSF Web Services to register, you will see it appearing in the list of available OSF endpoints to that Drupal instance. From that section, you will be able to edit, modify, create and delete all the endpoints. Now that we have successfully registered a OSF instance, the next step is to import a new dataset to test this new installation. What you have to do is to click the  link on the   tab. The Import Dataset page will let you import a dataset serialized in one of the following formats: What you have to specify to import a new dataset is:
 * RDF+XML
 * RDF+N3
 * structJSON
 * structXML
 * ironJSON
 * commON
 * Select the RDF file you want to import from your local computer
 * Select the type of RDF file you are trying to import
 * Define the name of the Dataset you are importing
 * Optionally define the description of that dataset
 * Define the URI of the dataset. If you don't provide any URI, then OSF for Drupal will create one for you
 * Choose on which OSF Web Services endpoint you want to import that dataset
 * Determine which users' role should have full CRUD permissions on this dataset
 * Optionally define the description of that dataset
 * Define the URI of the dataset. If you don't provide any URI, then OSF for Drupal will create one for you
 * Choose on which OSF Web Services endpoint you want to import that dataset
 * Determine which users' role should have full CRUD permissions on this dataset
 * Choose on which OSF Web Services endpoint you want to import that dataset
 * Determine which users' role should have full CRUD permissions on this dataset
 * Determine which users' role should have full CRUD permissions on this dataset