0% found this document useful (0 votes)
19 views5 pages

Hands-On Practice - Create an Integration

This document provides a hands-on guide for creating an integration using Appian, specifically connecting to the NHTSA Vehicle Product Information Catalog API. It includes instructions on setting up the Appian Community Edition, naming conventions, and saving work frequently. Additionally, it outlines the steps to create an integration that retrieves vehicle makes and offers resources for further learning and support.

Uploaded by

nikhilbajaj962
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
19 views5 pages

Hands-On Practice - Create an Integration

This document provides a hands-on guide for creating an integration using Appian, specifically connecting to the NHTSA Vehicle Product Information Catalog API. It includes instructions on setting up the Appian Community Edition, naming conventions, and saving work frequently. Additionally, it outlines the steps to create an integration that retrieves vehicle makes and offers resources for further learning and support.

Uploaded by

nikhilbajaj962
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 5

Hands-On Practice: Create an

Integration
Integrations 101

Introduction 2
How Can I Practice? 2
Appian Version 2
Appian Community Edition Naming Conventions 2
Save Often 2
Additional Resources 3
Create an Integration 4
Create an Integration 4

Notice of Rights

This document was created by Appian Corporation, 7950 Jones Branch Dr, Tysons, Virginia 22102.
Copyright 2024 by Appian Corporation. All rights reserved. Information in this document is subject to
change. No part of this document may be reproduced or transmitted in any form by any means, without
prior written permission of Appian Corporation. For more information on obtaining permission for
reprints or excerpts, contact Appian Training at [email protected].

© Appian Corporation, 2024


Introduction
How Can I Practice?
You can practice in your own environment or in Appian Community Edition.

Keep in mind that this is a community environment not suitable for production workloads or
sensitive information.

Appian Version
Appian Community Edition is on the latest Appian version. If you are following the exercises
from a previous Appian version, go to academy.appian.com to download the latest version.

Appian Community Edition Naming Conventions


When you register for Appian Community Edition, you gain access to a workspace, which is
your personal area within the community environment. When your workspace has been
assigned, you will receive a confirmation email with a workspace ID.

Use this workspace ID when creating new applications and objects. Otherwise, you could run
into naming conflicts with objects created by other users. Pre-loaded apps in your workspace
also include the workspace ID. In the example below, the application prefix for the Acme
Auto Solution app is W0000AS. So, the workspace identifier is W0000, which would be
included in any new app’s prefix.

Save Often
Appian does not automatically save updates, so save your objects frequently.

24.3

© Appian Corporation, 2024 2


Additional Resources
Appian provides a number of training resources for Appian developers. The following
resources are particularly popular with our learners:

● Academy Online - Appian’s online courses provide useful survey courses, step-by-step
tutorials, and practice exercises. Explore these resources at your own pace. Survey
courses will help you develop a better grasp of the topics you need to learn. Video
and print tutorials will help you with getting hands-on experience with Appian.

● Community Discussions for New Users - Check out the New to Appian thread in
Community. Join our community of experts to ask questions and find answers from
past discussions.

● Appian Documentation - Appian’s product documentation will provide you with an


overview of key Appian features, newest release information, additional tutorials,
and helpful patterns and recipes to implement in your app.

24.3

© Appian Corporation, 2024 3


Create an Integration
Before beginning this exercise, you should have completed the previous exercise: Hands-On
Practice: Create a Connected System.

In this exercise, you will create an integration that connects to the National Highway Traffic
Safety Administration’s (NHTSA) Vehicle Product Information Catalog (vPIC) API. This API
provides information on vehicles and their specifications provided by their manufacturers.

Create an Integration
1. Navigate to Appian Designer.

2. In the Applications view, select your IE101 Integrations 101 Exercise application.

3. In the Build view, select NEW > Integration.

4. In the Create Integration dialog, configure the following properties:

● Connected System: IE101 Vehicle API CS (HTTP)


● Name: IE101_GetAllVehicleMakes
● Description: Integration to retrieve all vehicle makes from
the NHTSA.

NOTE: If you are using Appian Community Edition, change the prefix to W#IE101.

5. Click CREATE.

6. In the Configuration Pane, configure the following Connection properties:

● Relative Path: /vehicles/GetAllMakes

Leave the remaining properties as default.

7. In the Configuration Pane, go to Query Parameters.

8. Select +Add Query Parameter, configure the following fields:

● Name: format
● Value: json

9. In the Configuration Pane, go to Response.

10. Using the Response Body Parsing dropdown, select Convert JSON to Appian Value.

11. Click Save Changes.

12. Let’s give it a test! Click TEST REQUEST.

24.3

© Appian Corporation, 2024 4


13. In the preview pane, under Result, you will see a green “Success!” banner if everything
was configured correctly. If not, revisit earlier steps.

14. Review the returning response and notice it is in a Dictionary format. Scroll down
under body and Results to see the list of vehicle makes.

And that’s it! Try creating an expression rule to parse out just the vehicle makes by indexing
the Make_Name field. You will then be able to reference your list of vehicle makes in
interfaces and process models.

24.3

© Appian Corporation, 2024 5

You might also like