Skip to content

Commit c6eca3e

Browse files
committed
changed location of images
1 parent 8e21644 commit c6eca3e

24 files changed

Lines changed: 23 additions & 23 deletions

content/en/docs/refguide/modeling/integration/altair-graph-studio.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ A source layer allows you to import data from various sources or start from a JS
3636
* Transform and map data to your ontology
3737
* Keep data synchronized with source systems
3838

39-
{{< figure src="/attachments/partners/altair/howto-ags/add-layer.png" >}}
39+
{{< figure src="/attachments/refguide/modeling/integration/altair/add-layer.png" >}}
4040

4141
### Uploading and Validating JSON Data
4242

@@ -46,7 +46,7 @@ Upload the JSON source data into the source layer.
4646

4747
You can review the JSON structure and the data in the file you just uploaded in Graph Studio. It will show you a tree structure of your JSON file, data types, and sample values.
4848

49-
{{< figure src="/attachments/partners/altair/howto-ags/sample-data-plm.png" class="no-border" >}}
49+
{{< figure src="/attachments/refguide/modeling/integration/altair/sample-data-plm.png" class="no-border" >}}
5050

5151
### Reviewing the Generated Ontology
5252

@@ -67,7 +67,7 @@ Now that you have data and an ontology in Graph Studio, create a SPARQL query to
6767

6868
Create a new query in the Query Playground. Enter the SPARQL query and test the result.
6969

70-
{{< figure src="/attachments/partners/altair/howto-ags/sparql.png" >}}
70+
{{< figure src="/attachments/refguide/modeling/integration/altair/sparql.png" >}}
7171

7272
The following is an example SPARQL query for customers:
7373

@@ -111,65 +111,65 @@ Create a new OData API in your graphmart. To do this, follow the steps below.
111111

112112
1. Go **Graphmarts** > **Exports** and select **Create OData REST Endpoint**.
113113

114-
{{< figure src="/attachments/partners/altair/howto-ags/create-odata-rest.png" >}}
114+
{{< figure src="/attachments/refguide/modeling/integration/altair/create-odata-rest.png" >}}
115115

116116
2. Choose **Auto generated Endpoint**. This is a one-click method to expose your entire graph through an OData API.
117117

118-
{{< figure src="/attachments/partners/altair/howto-ags/auto-generated-endpoint.png" >}}
118+
{{< figure src="/attachments/refguide/modeling/integration/altair/auto-generated-endpoint.png" >}}
119119

120120
3. Provide a name and a description for the endpoint.
121121

122-
{{< figure src="/attachments/partners/altair/howto-ags/endpoint-title.png" >}}
122+
{{< figure src="/attachments/refguide/modeling/integration/altair/endpoint-title.png" >}}
123123

124124
The **ODBC (SQL)** endpoint listed on this page can be used to access the endpoint. You should now be able to open this endpoint in a browser and see the OData response.
125125

126-
{{< figure src="/attachments/partners/altair/howto-ags/odbc-endpoint.png" >}}
126+
{{< figure src="/attachments/refguide/modeling/integration/altair/odbc-endpoint.png" >}}
127127

128128
4. To see the contract of the endpoint, use the endpoint URL displayed in the endpoint configuration page under **ODBC (SQL)** and append `/$metadata` to this URL. You will need it when using the endpoint in Studio Pro.
129129

130130
#### Using the OData Endpoint in a Mendix Project
131131

132132
Add a [consumed OData service](/refguide/consumed-odata-service/) in your project by opening Studio Pro and right-clicking your module > **Add other** > **Consumed OData service**. In the **Add Consumed OData Service** dialog, provide the location of the endpoint `$metadata` contract, as well as your username and password credentials. Studio Pro will read the contract to determine all the entities and actions provided by this endpoint.
133133

134-
{{< figure src="/attachments/partners/altair/howto-ags/add-consumed-odata.png" >}}
134+
{{< figure src="/attachments/refguide/modeling/integration/altair/add-consumed-odata.png" >}}
135135

136136
In the consumed OData service document, you can provide configuration for the endpoint location and credentials. The **Location** is the root endpoint URL you copied from Graph Studio (without the `$metadata` suffix).
137137

138-
{{< figure src="/attachments/partners/altair/howto-ags/endpoint-location.png" >}}
138+
{{< figure src="/attachments/refguide/modeling/integration/altair/endpoint-location.png" >}}
139139

140140
#### Creating External Entities for Datasets from the OData Endpoint
141141

142142
The [Integration pane](/refguide/integration-pane/) in the right column displays all the graph classes exposed via the OData REST API. You can see the attributes (properties) of these classes and the associations. The Integration pane also shows the capabilities of the data provided by the endpoint. In this example, all the data is read-only, as the Altair Graph Database only provides read-only access to the data.
143143

144144
Select which classes you need for your application and drag and drop them into a domain model. Here, they will be displayed as purple external entities. This indicates that the data is available to your application but is retrieved from an external service (in this case, the Altair Graph Database).
145145

146-
{{< figure src="/attachments/partners/altair/howto-ags/create-external-entities.png" >}}
146+
{{< figure src="/attachments/refguide/modeling/integration/altair/create-external-entities.png" >}}
147147

148148
#### Building Pages Using External Entities
149149

150150
You can use these external entities in your pages and microflows similarly to persistent entities. For this example, create your overview pages by right-clicking the entity and selecting **Generate overview pages**.
151151

152-
{{< figure src="/attachments/partners/altair/howto-ags/building-pages.png" >}}
152+
{{< figure src="/attachments/refguide/modeling/integration/altair/building-pages.png" >}}
153153

154154
#### Running the Application and Test
155155

156156
You can now start the application and test the results. Whenever you open a page using external entities from the Integration pane, the data will automatically be retrieved from Altair Graph Studio via an OData REST call.
157157

158-
{{< figure src="/attachments/partners/altair/howto-ags/testing.png" >}}
158+
{{< figure src="/attachments/refguide/modeling/integration/altair/testing.png" >}}
159159

160160
Filtering, sorting, and pagination are automatically done server-side by your graph database. This is essential for large datasets to avoid overloading the front-end with too many objects.
161161

162162
#### Lazy-Loaded Tree Widget
163163

164164
Altair Graph Studio automatically provides associations for linked entities in your graph. These graph associations are part of the OData endpoint and part of your external entities. When you drag your OData datasets into your domain model, the resulting external entities will show associations from the OData endpoint.
165165

166-
{{< figure src="/attachments/partners/altair/howto-ags/tree-widget.png" >}}
166+
{{< figure src="/attachments/refguide/modeling/integration/altair/tree-widget.png" >}}
167167

168168
This example page shows a tree that retrieves BOMs from the graph database. It will only load required data: first, the top-level BOMs, then, when you open one, its components will be retrieved over the association. Only when you open a component will it load the subcomponents.
169169

170170
This is done automatically when you set the external entities as the data source for the widgets in your tree.
171171

172-
{{< figure src="/attachments/partners/altair/howto-ags/data-source.png" >}}
172+
{{< figure src="/attachments/refguide/modeling/integration/altair/data-source.png" >}}
173173

174174
### Query SPARQL in Mendix {#query-sparql}
175175

@@ -181,7 +181,7 @@ Run SPARQL queries from Mendix by using the SPARQL API in Altair Graph Studio. T
181181

182182
1. Create a new consumed REST service document and paste the query in the request body.
183183

184-
{{< figure src="/attachments/partners/altair/howto-ags/paste-query.png" >}}
184+
{{< figure src="/attachments/refguide/modeling/integration/altair/paste-query.png" >}}
185185

186186
The endpoint contains two main parts: the endpoint of the SPARQL API, and the graphmart you want to work with. You can define these in the endpoint.
187187

@@ -190,19 +190,19 @@ Run SPARQL queries from Mendix by using the SPARQL API in Altair Graph Studio. T
190190
* Set **Accept** to `application/sparql-results+json`
191191
* Set **Content-Type** to `application/sparql-query`
192192

193-
{{< figure src="/attachments/partners/altair/howto-ags/content-type.png" >}}
193+
{{< figure src="/attachments/refguide/modeling/integration/altair/content-type.png" >}}
194194

195195
3. Run the API call and validate the resulting response message. The **Response** table will show the response JSON payload provided by your graph database.
196196

197-
{{< figure src="/attachments/partners/altair/howto-ags/response.png" >}}
197+
{{< figure src="/attachments/refguide/modeling/integration/altair/response.png" >}}
198198

199199
4. View the resulting entities in the **Response structure** tab. Here, you can rename and generate entities to capture the data in Studio Pro.
200200

201-
{{< figure src="/attachments/partners/altair/howto-ags/response-structure.png" >}}
201+
{{< figure src="/attachments/refguide/modeling/integration/altair/response-structure.png" >}}
202202

203203
The resulting domain model should look like this:
204204

205-
{{< figure src="/attachments/partners/altair/howto-ags/domain-model.png" >}}
205+
{{< figure src="/attachments/refguide/modeling/integration/altair/domain-model.png" >}}
206206

207207
#### Microflow to Execute the SPARQL Query
208208

@@ -213,20 +213,20 @@ Define a microflow that will execute the API call with the SPARQL query and retu
213213

214214
By using constants, you can override these on deployment to match the environment you are deploying to.
215215

216-
{{< figure src="/attachments/partners/altair/howto-ags/microflow-sparql.png" >}}
216+
{{< figure src="/attachments/refguide/modeling/integration/altair/microflow-sparql.png" >}}
217217

218218
#### Customers Overview Page
219219

220220
Create a page that will show the retrieved data. This example uses a [Data Grid 2](/appstore/modules/data-grid-2/) with a microflow data source. The microflow data source is configured to use the microflow that was created in the previous step.
221221

222-
{{< figure src="/attachments/partners/altair/howto-ags/overview-page.png" >}}
222+
{{< figure src="/attachments/refguide/modeling/integration/altair/overview-page.png" >}}
223223

224224
#### Testing the Result
225225

226226
You can now run your application to validate the result. It should have a data grid showing all objects and a detail form showing the details of one specific object, as seen below:
227227

228-
{{< figure src="/attachments/partners/altair/howto-ags/result.png" >}}
228+
{{< figure src="/attachments/refguide/modeling/integration/altair/result.png" >}}
229229

230230
You should also see the detail pages that show data from a single concept in your graph database:
231231

232-
{{< figure src="/attachments/partners/altair/howto-ags/detail-page.png" >}}
232+
{{< figure src="/attachments/refguide/modeling/integration/altair/detail-page.png" >}}

static/attachments/partners/altair/howto-ags/add-consumed-odata.png renamed to static/attachments/refguide/modeling/integration/altair/add-consumed-odata.png

File renamed without changes.

static/attachments/partners/altair/howto-ags/add-layer.png renamed to static/attachments/refguide/modeling/integration/altair/add-layer.png

File renamed without changes.

static/attachments/partners/altair/howto-ags/auto-generated-endpoint.png renamed to static/attachments/refguide/modeling/integration/altair/auto-generated-endpoint.png

File renamed without changes.

static/attachments/partners/altair/howto-ags/building-pages.png renamed to static/attachments/refguide/modeling/integration/altair/building-pages.png

File renamed without changes.

static/attachments/partners/altair/howto-ags/content-type.png renamed to static/attachments/refguide/modeling/integration/altair/content-type.png

File renamed without changes.

static/attachments/partners/altair/howto-ags/create-external-entities.png renamed to static/attachments/refguide/modeling/integration/altair/create-external-entities.png

File renamed without changes.

static/attachments/partners/altair/howto-ags/create-odata-rest.png renamed to static/attachments/refguide/modeling/integration/altair/create-odata-rest.png

File renamed without changes.

static/attachments/partners/altair/howto-ags/data-source.png renamed to static/attachments/refguide/modeling/integration/altair/data-source.png

File renamed without changes.

static/attachments/partners/altair/howto-ags/detail-page.png renamed to static/attachments/refguide/modeling/integration/altair/detail-page.png

File renamed without changes.

0 commit comments

Comments
 (0)