Share the Wealth: Track Shipments Using the Integration Framework
my name is Cody Janowski today I will be facilitating a discussion on shipment tracking integration within your service sound environment today we'll be discussing what the shipment track integration is a brief overview about it and the technicals behind how this works and what you will need to get this going so what is this shipment tracking integration with this you can track your shipments in real time by integrating your service instance to a thirdparty integration typically your carrier such as UPS USPS FedEx any carrier that has a shipment integration where you can get an API key and an API endpoint from how do I manage the integration it will create an integration script include this script include will house all the logic needed to process the information and get a response back to do something with there is a base script include called the itam shipment integration you will extend this script include to create your own script include where you'll handle the business logic not all carriers will be the same so you'll need to pass in the API key and other information to process the information you may also want to create different script includes for different functionality that you will be developing you will then connect your service now instance with a shipping carrier so you'll do this by going to the hardware asset workspace asset operations including the carrier shipment integration profile you also need to create a new shipping carrier you can do that too by going to the hardware asset workspace asset operations shipping carriers and linking the carrier to the integration you created now please note this integration is just the the API is just the script include so this is that script include that I mentioned where you you use the itam shipment integration and you extend it to create your own script include with this we can process this by many different ways either on a scheduled job a UI action or any other trigger based event now what is in the script include you will need two methods the fetch shipment info what this does this receives tracking numbers invokes carrier API and processes the API response so this is basically what you will use to send the information to the carrier to then receive back all the details related to the tracking numbers in the process response function we will receive the response API and update shipment records with details this sends back all this information including carrier link carrier status carrier status detail carrier pickup date carrier delivered date currency delivery service cost and partial weight some next steps that you will need to think about is how you're going to have that connection between your instance in the shipping carrier you can create functionality to track those numbers you can use jobs like ski jobs to update assets with tracking numbers UI actions so if you want to ad hoc update your shipment information you can create a UI action to execute the API now next I'm going to go into the environment give a brief overview on how we're going to create some of these records now that we are within our service now environment we can navigate to the Harware asset workspace do this by going to workspaces Hardware asset workspace and it will bring you to a screen that look similar to this please know that this is a demo environment it may not look like yours next we need to navigate down here to the asset operations under shipment we will have a few different options the shipments is where we can track all the different status changes related to our assets and all of our shipments shipment assets this will tell us the current life cycle and where these assets are at so as we order assets and we get our shipping information into the environment we can start tracking this immediately and understand okay well maybe this is still on order now it's in transit now it's delivered we can really automate the life cycle of these assets and understand when they're ready to be used and ready to be put into the stock room our shipping carriers here we can identify or different shipping carriers so we'll look at UPS for example please note you'll probably have more information than me the integration profile is where you'll select that integration profile we'll go back carry your integration profile this is where you create that carry integration profile you'll add in your API give it a name and Link it back to your shipping carrier now let's go take a look at the script include there's not much in it as this is just a base level script include and we don't actually have access to it that's why we have to extend it do this by go into script includes system definition script includes let do the star search for itam this is what we're looking for the itam shipment integration now you won't have access to this it's protected through out ofox UI policies and access controls you can't actually edit this that's why we have to extend it and we extend it for each shipping carrier that we need hence why one will not fit all so now you've set up your shipping carriers your carry integration create your script includes for extending that IAM shipment integration util setting up a scheduled job or UI options or both you are now ready to process your shipments thank you very much I hope you found this helpful [Music] a
https://www.youtube.com/watch?v=mv0sMWBK0Yw